商城首页欢迎来到中国正版软件门户

您的位置:首页 >【Java基础】Java扩展知识

【Java基础】Java扩展知识

  发布于2026-05-02 阅读(0)

扫一扫,手机访问

【学习参考资料】:菜鸟教程-Ja va教程

1,Ja va文档注释

在Ja va的世界里,注释不仅是写给机器看的,更是写给未来的自己或团队成员看的。而文档注释,则是其中功能最强大、也最正式的一种。它主要包含以下核心内容:

首先,Ja va支持三种注释方式,分别是单行注释//、多行注释/* */,以及我们今天要重点讨论的文档注释/** */。文档注释之所以特殊,是因为它能被ja vadoc工具提取,生成标准的API文档。

其次,ja vadoc工具识别一系列特定的标签,这些标签就像是给文档内容打上的“标记”,让生成的API结构清晰、信息完整。下面这个表格,可以说是编写专业文档注释的“必备清单”:

标签 描述 示例
@author 标识一个类的作者 @author description
@deprecated 指名一个过期的类或成员 @deprecated description
{@docRoot} 指明当前文档根目录的路径 Directory Path
@exception 标志一个类抛出的异常 @exception exception-name explanation
{@inheritDoc} 从直接父类继承的注释 Inherits a comment from the immediate surperclass.
{@link} 插入一个到另一个主题的链接 {@link name text}
{@linkplain} 插入一个到另一个主题的链接,但是该链接显示纯文本字体 Inserts an in-line link to another topic.
@param 说明一个方法的参数 @param parameter-name explanation
@return 说明返回值类型 @return explanation
@see 指定一个到另一个主题的链接 @see anchor
@serial 说明一个序列化属性 @serial description
@serialData 说明通过writeObject( ) 和 writeExternal( )方法写的数据 @serialData description
@serialField 说明一个ObjectStreamField组件 @serialField name type description
@since 标记当引入一个特定的变化时 @since release
@throws 和 @exception标签一样。 The @throws tag has the same meaning as the @exception tag.
{@value} 显示常量的值,该常量必须是static属性。 Displays the value of a constant, which must be a static field.
@version 指定类的版本 @version info

光看理论可能有点抽象,我们来看一个完整的示例。下面这段代码,就生动地展示了如何在实际的类和方法中运用这些标签:

package com.runoob;

import ja va.io.BufferedReader;
import ja va.io.IOException;
import ja va.io.InputStreamReader;

/**
 * 文档注释演示实例
 * @author 张伯成
 * @version 1.0
 */
public class SquareNumber {
    /**
     * This method returns the square of number.
     * This is a multiline description. You can use as many lines as you like.
     * @param number The value to be squared.
     * @return number squared.
     */
    public double square(double number) {
        return number * number;
    }

    /**
     * This method input a number from the user.
     * @return The value input as a double.
     * @throws IOException in input error
     * @see IOException
     */
    public double getNumber() throws IOException {
        InputStreamReader isr = new InputStreamReader(System.in);
        BufferedReader inData = new BufferedReader(isr);
        String str;
        str = inData.readLine();
        return Double.parseDouble(str);
    }

    /**
     * This method demonstrates square().
     * @param args args unused.
     * @throws IOException on input error.
     * @see IOException
     */
    public static void main(String[] args) throws IOException {
        SquareNumber sn = new SquareNumber();
        double val;
        System.out.print("Enter value to be squared:");
        val = sn.getNumber();
        val = sn.square(val);
        System.out.println("Squared value is : " + val);
    }
}

2,Ja va 8 新特性

如果说Ja va的演进史上有几个里程碑式的版本,那么Ja va 8绝对算一个。这个版本(也就是jdk1.8)引入的一系列新特性,彻底改变了Ja va的编程范式,让这门“老牌”语言焕发出新的活力。具体来说,主要包括以下几大块:

(1)Lambda 表达式:这可以说是Ja va 8最核心的特性了。Lambda允许把函数作为一个方法的参数,也就是实现了函数式编程中“函数作为一等公民”的思想,让代码变得更加简洁灵活。

(2)方法引用:如果说Lambda是匿名函数的简写,那么方法引用就是Lambda的进一步“语法糖”。它可以直接引用已有Ja va类或对象(实例)的方法或构造器。与lambda联合使用,方法引用可以使语言的构造更紧凑简洁,大幅减少冗余代码。

(3)默认方法:这是一个为了解决接口演化问题而生的特性。默认方法允许在接口中提供一个有具体实现的方法,这样在给接口添加新方法时,就不会破坏所有已有的实现类。

(4)新工具:工欲善其事,必先利其器。Ja va 8也带来了一些新的编译和诊断工具,例如基于Nashorn引擎的jjs命令行工具,以及用于分析类依赖关系的jdeps

(5)Stream API:这是将函数式编程风格引入Ja va集合操作的关键。它提供了一种高效且易于并行处理的数据流操作方式,让集合处理代码的声明性更强、更易读。

(6)Date Time API:终于,Ja va拥有了一个现代、易用且线程安全的日期时间处理库。新的ja va.time包彻底解决了旧版ja va.util.DateCalendar类的种种设计缺陷。

(7)Optional 类:空指针异常(NullPointerException)是Ja va开发者的“老朋友”了。Optional 类已经成为 Ja va 8 类库的一部分,它通过封装可能为null的值,鼓励开发者以更安全、更明确的方式处理空值。

(8)Nashorn, Ja vaScript 引擎:这个新引擎取代了旧的Rhino,性能大幅提升。它允许我们在JVM上运行特定的ja vascript应用,为JVM平台的动态语言支持增添了重要一环。

3,Ja va MySQL连接

在Ja va企业级应用中,与数据库打交道是家常便饭。而使用JDBC连接MySQL数据库,则是每一位Ja va开发者必须掌握的基本功。下面这个名为MysqlDemo.ja va的示例,清晰地展示了从连接、查询到关闭资源的完整流程。

package com.runoob;

import ja va.sql.*;

/**
 * 连接数据库实例
 * @author zhangbocheng
 * @version v1.0
 * @date 2019/3/28 22:14
 */
public class MysqlDemo {

    /**
     * JDBC驱动名及其数据库URL
     */
    static final String JDBC_DRIVER = "com.mysql.jdbc.Driver";
    static final String DB_URL = "jdbc:mysql://127.0.0.1:3306/pyspider_db";

    /**
     * 数据库的用户与密码
     */
    static final String USER = "root";
    static final String PASSWORD = "xxxxxx";

    public static void main(String[] args) {
        Connection conn = null;
        Statement stmt = null;
        try {
            Class.forName(JDBC_DRIVER);
            System.out.println("连接数据库...");
            conn = DriverManager.getConnection(DB_URL, USER, PASSWORD);

            System.out.println("实例化Statement对象...");
            stmt = conn.createStatement();
            String sql;
            sql = "select id, name, url from websites;";
            ResultSet rs = stmt.executeQuery(sql);

            while (rs.next()) {
                int id = rs.getInt("id");
                String name = rs.getString("name");
                String url = rs.getString("url");

                System.out.printf("ID: %d\t站点名称:%s\t站点URL:%s\n", id, name, url);
            }

            rs.close();
            stmt.close();
            conn.close();
        } catch (SQLException se) {
            se.printStackTrace();
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
                if (stmt != null) {
                    stmt.close();
                }
            } catch (SQLException se) {
                se.printStackTrace();
            }

            try {
                if (conn != null) {
                    conn.close();
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

4,Ja va 9 新特性

技术总是在不断演进。继Ja va 8之后,Ja va 9带来了另一个重量级更新,其中最引人注目的便是模块化系统(Project Jigsaw)。当然,它的新特性远不止于此。

详情参见:Ja va 9 新特性

本文转载于:https://blog.csdn.net/tiantangdegezi/article/details/89236191 如有侵犯,请联系zhengruancom@outlook.com删除。
免责声明:正软商城发布此文仅为传递信息,不代表正软商城认同其观点或证实其描述。

热门关注