Java包机制:
目的:为了更好地组织类,Java提供包机制,用于区别类名的命名空间。
包机制的语法格式:
package pkg1[.pkg2[.pkg3...]];
为了能够使用某一个包,在写Java程序的时候就需要明确导入该包,使用“import"实现
导入包的语法格式:
import package1[.package2...].(classname|*);//*表示该包的所有类
注意:导入包一定要在包机制下面。
JavaDoc:
目的:javadoc命令是用来生成自己API文档的,使用方式:使用命令行在目标文件所在目录输入javadoc +文件名.java。
1、常用标记:
代码实现:
package Test; /** * @author wei * @version 1.0 */ //Javadoc命令是用来生成自己的API文档 public class Doc { String name; /** * @author wei 作者名 * @version 1.0 版本号 * @since 1.8 指明需要的最早使用的jdk版本 * @param 参数名 * @param name * @return * @throws Exception 抛出异常 */ public String test(String name) throws Exception{ return name; } }
2、命令格式:
Javadoc命令格式如下: javadoc [选项] [软件包名称] [源文件] *****执行的命令***** -overview <文件> 读取 HTML 文件的概述文档 -public 仅显示公共类和成员 -protected 显示受保护/公共类和成员(默认) -package 显示软件包/受保护/公共类和成员 -private 显示所有类和成员 -help 显示命令行选项并退出 -doclet <类> 通过替代 doclet 生成输出 -docletpath <路径> 指定查找 doclet 类文件的位置 -sourcepath <路径列表> 指定查找源文件的位置 -classpath <路径列表> 指定查找用户类文件的位置 -exclude <软件包列表> 指定要排除的软件包的列表 -subpackages <子软件包列表> 指定要递归装入的子软件包 -breakiterator 使用 BreakIterator 计算第 1 句 -bootclasspath <路径列表> 覆盖引导类加载器所装入的类文件的位置 -source <版本> 提供与指定版本的源兼容性 -extdirs <目录列表> 覆盖安装的扩展目录的位置 -verbose 输出有关 Javadoc 正在执行的操作的消息 -locale <名称> 要使用的语言环境,例如 en_US 或 en_US_WIN -encoding <名称> 源文件编码名称 -quiet 不显示状态消息