您的位置:首页 >【Java基础】Java扩展知识
发布于2026-05-02 阅读(0)
扫一扫,手机访问
在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);
}
}
如果说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.Date和Calendar类的种种设计缺陷。(7)
Optional类:空指针异常(NullPointerException)是Ja va开发者的“老朋友”了。Optional类已经成为Ja va 8类库的一部分,它通过封装可能为null的值,鼓励开发者以更安全、更明确的方式处理空值。(8)
Nashorn,Ja vaScript引擎:这个新引擎取代了旧的Rhino,性能大幅提升。它允许我们在JVM上运行特定的ja vascript应用,为JVM平台的动态语言支持增添了重要一环。
在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();
}
}
}
}
技术总是在不断演进。继Ja va 8之后,Ja va 9带来了另一个重量级更新,其中最引人注目的便是模块化系统(Project Jigsaw)。当然,它的新特性远不止于此。
详情参见:Ja va 9 新特性
上一篇:Java修炼手册——初识Java
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
正版软件
正版软件
正版软件
正版软件
正版软件
1
2
3
7
9