javadoc有什么用,JDK JavaDoc有什么用
大家好,如果您还对javadoc有什么用不太了解,没有关系,今天就由本站为大家分享javadoc有什么用的知识,包括JDK JavaDoc有什么用的问题都会给大家分析到,还望可以解决大家的问题,下面我们就开始吧!
JDK JavaDoc有什么用
JDK是一个工具包,里面包括很多高级Java开发时需要用到程序库和调试工具,比如虚拟机监控工具、内存工具、编码工具、打包工具、文档工具等等。其中的javadoc就是文档工具,用来自动根据代码中的带有特定格式的注释来生成HTML格式的文档。典型的一个例子就是Java官网的API解释。这些文档就是根据Java源代码中的注释自动生成的。
javadoc.exe 是什么啊
从源程序中提取java文档,就像我们所看到的 SUN的API文档一样,把你的类、方法、变量全部放进去一个超链接中,方便用户查阅。
下面是调试信息:
用法:javadoc [选项] [软件包名称] [源文件] [@file]
-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<标志>直接将<标志>传递给运行时系统
通过标准 doclet提供:
-d<directory>输出文件的目标目录
-use创建类和包用法页面
-version包含@version段
-author包含@author段
-docfilessubdirs递归复制文档文件子目录
-splitindex将索引分为每个字母对应一个文件
-windowtitle<text>文档的浏览器窗口标题
-doctitle<html-code>包含概述页面的标题
-header<html-code>包含每个页面的页眉文本
-footer<html-code>包含每个页面的页脚文本
-top<html-code>包含每个页面的顶部文本
-bottom<html-code>包含每个页面的底部文本
-link<url>创建指向位于<url>的 javadoc输出的链接
-linkoffline<url><url2>利用位于<url2>的包列表链接至位于<url>的文档
-excludedocfilessubdir<name1>:..排除具有给定名称的所有文档文件子目录。
-group<name><p1>:<p2>..在概述页面中,将指定的包分组
-nocomment不生成描述和标记,只生成声明。
-nodeprecated不包含@deprecated信息
-noqualifier<name1>:<name2>:...输出中不包括指定限定符的列表。
-nosince不包含@since信息
-notimestamp不包含隐藏时间戳
-nodeprecatedlist不生成已过时的列表
-notree不生成类分层结构
-noindex不生成索引
-nohelp不生成帮助链接
-nonavbar不生成导航栏
-serialwarn生成有关@serial标记的警告
-tag<name>:<locations>:<header>指定单个参数自定义标记
-taglet要注册的 Taglet的全限定名称
-tagletpath Taglet的路径
-charset<charset>用于跨平台查看生成的文档的字符集。
-helpfile<file>包含帮助链接所链接到的文件
-linksource以 HTML格式生成源文件
-sourcetab<tab length>指定源中每个制表符占据的空格数
-keywords使包、类和成员信息附带 HTML元标记
-stylesheetfile<path>用于更改生成文档的样式的文件
-docencoding<name>输出编码名称
java高手:javadoc 在哪个文件夹中,它的作用是什么
在JDK目录下的bin子目录中
Javadoc是Sun公司提供的一个技术,它从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。也就是说,只要在编写程序时以一套特定的标签作注释,在程序编写完成后,通过Javadoc就可以同时形式程序的开发文档了。
JBuilder提供了多项对Javadoc支持的功能,可以通过向导在工程窗格的树中创建Javadoc的节点,通过节点的菜单命名创建工程的Javadoc文档,可以通过诱导的方式录入Javadoc的标签,检验注释是否和源代码相匹配等。
本文,我们将讲解如何在源代码中用Javadoc标签写注释及如何创建Javadoc文档。
虽然软件工程中把详细设计作为软件项目的一个重要的阶段,但在实践中往往没有得到落实。并不是这个阶段不重要,而是实施有很大的困难,因为软件需求是天生的易动症患者,好不容易详细设计出来后,需求已和当初的版本大相径庭,而花费巨大,精雕细琢的详细设计已变成昨日黄花了。
Javadoc注释由Javadoc标签和描述性文本组成,你可以为类、接口添加注释,也可为构造函数、值域、方法等类中的元素添加注释。
可以通过代码模板快速的录入Javadoc注释,你也可以选择通过Javadoc对话框以一种形象化的方式录入Javadoc注释。此外,JBuilder还提供了各种Javadoc的辅助功能,如JavadocInsight诱导录入,冲突报告和更正,特殊的todo标签等。
虽然在Java文件中编写注释后,马上可以切换到内容窗格的Doc视图页代码中对应的Javadoc文档,但在Doc视图页中生成的文档仅是不完整的"范本"。首先,没有导航树,其次没有生成通过@see或@link关联内容的链接。所以你可以把Doc视图页中的Javadoc文档看成是Javadoc最终版本的预览。
本文中我们介绍了Javadoc的标签,讲解了如何在JBuilder编辑Javadoc注释,你应该尽量使用JavadocInsight、ClassInsight和ParameterInsight快速而正确地编写Javadoc注释。此外你应该将常用的注释做成模板,方便快速录入。
JBuilder提供的注释冲突报告和恢复的功能可以使你轻松解决注释冲突的问题,免除了单调的手工调整操作。
JBuilder还允许你自定义Javadoc标签,以满足一些个性化的要求。此外JBuilder自定义的todo标签可以使你随时随地在需要的地方作上标记,不至于遗漏未尽的工作。
什么是JavaJava是用来做什么的
我们常常会听说,Java是世界第一语言,很多应用软件的开发都离不开Java。Java真的这么强大吗?其实,Java的内容很丰富,可以实现的功能也有很多。
我们常常说的Java,首先它是一种计算机编程语言,程序员用它来和计算机交流,把要求和设想用Java语言表达出来,这个过程就是我们所说的使用Java编程,所以我们说Java是一种计算机编程语言。为了让计算机看懂,Java会有一系列的规则和约定,这些就是Java的语法。
其次,Java是一种软件开发平台。所谓软件开发简单地理解为:编程的结果是软件或者程序,而编程的过程就是软件开发。
那什么是开发平台?在软件开发的过程中,我们需要很多的工具来辅助我们的工作。我们把编程的环境和相应的辅助工具统称为开发环境,开发平台就是用来提供这个开发环境的。
而Java作为一种开发平台,不单纯是一个编程的语言,它自身提供了一系列开发Java所需要的环境和工具,来进行编译、解释、文档生成、打包等,比如:javac.exe、javadoc.exe等等,所以我们讲Java是一个开发平台。
另外,Java是一种软件运行平台。Java本身提供Java软件所需要的运行环境,Java应用可运行在安装了JRE(JavaRuntimeEnvironment)的机器上,所以我们说Java是一个运行平台。JRE:JavaRuntimeEnvironment,Java运行环境。
Java也是一种软件部署环境。简单地讲,部署就是安装,就是把软件放置到相应的地方,并且进行相应的配置(一般称作部署描述)让软件能够正常运行起来。
Java是一种软件部署环境,Java本身是一个开发的平台,开发后的Java程序也是运行在Java平台上的。也就是说,开发后的Java程序也是部署在Java平台上的,这个尤其在后面学习JEE(Java的企业版)的时候,体现更为明显。
看完以上内容,相信你已经对什么是Java有了一定的了解。Java需求大,应用领域广,有着良好的薪资待遇及发展空间,因此受到不少IT人士的热烈追捧。
免责声明:内容来源于公开网络,若涉及侵权联系尽快删除!
关于javadoc有什么用到此分享完毕,希望能帮助到您。