Java缺少lang包 缺少javadoc是什么意思
(一)什么是Javadoc百科里是这么解释的:javadoc是Sun公司提供的一个技术,它从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。也就是说,只要在编写程序时以一套特定的标签作注释,在程序编写完成后,通过Javadoc就可以同时形成程序的开发文档了。 简而言之,Javadoc你写的Java程序里每个方法,字段是做什么的注释!然后合成一个文档!便于查阅!
(二)Javadoc的使用详解
1.概要:通常用一句或者一段话简要描述该类的作用,以英文句号作为结束。 Class comment 示例:
/** * A class representing a window on the screen. * For example: * * Window win = new Window(parent); * win.show(); * * * @author Sami Shaio * @version 1.13, 06/08/06 * @see java.awt.BaseWindow * @see java.awt.Button */class Window extends BaseWindow { ...}单行示例:
package org.springframework.util;/** * Miscellaneous {@link String} utility methods. * */public abstract class StringUtils {多行示例:
package java.lang;/** * Class {@code Object} is the root of the class hierarchy. * Every class has {@code Object} as a superclass. All objects, * including arrays, implement the methods of this class. */public class Object {}2.Javadoc标记
3.命令格式
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 不显示状态消息 -J 直接将 传递给运行时系统