0
点赞
收藏
分享

微信扫一扫

13 Java基础语法_5 _包机制 、javadoc


Java基础语法_5 _包机制 、javadoc

包机制

  1. 为了更好地组织类, Java 提供了包机制,用于区别类名的命名空间。
  2. 包语句的语法格式为:

package pkg1[. pkg2[. pk3.]];

  1. 一般利用公司域名倒置作为包名:例如: www.baidu.com com.baidu.www
  2. 13 Java基础语法_5 _包机制 、javadoc_命令行参数

  3. 为了能够使用某一个包的成员,我们需要在Java程序中明确导入该包。使用"import"语句可完成此功能

import package1[ . package..]. (classname |*);

javaDoc

javadoc命令是用来生成自己的API文档的

参数信息:

@author 作者名

@version版本号

@since指明需要最早使用的jdk版本

@param参数名

@return 返回值情况

@throws异常抛出情况

手动

13 Java基础语法_5 _包机制 、javadoc_java_02


13 Java基础语法_5 _包机制 、javadoc_javaSE_03


13 Java基础语法_5 _包机制 、javadoc_java_04


13 Java基础语法_5 _包机制 、javadoc_javad_05


13 Java基础语法_5 _包机制 、javadoc_java_06


13 Java基础语法_5 _包机制 、javadoc_命令行参数_07

利用idea

  1. 打开 idea,点击 Tools-> Generate JavaDoc,这样会打开生成 javadoc 文档的配置页面。
  2. 13 Java基础语法_5 _包机制 、javadoc_java_08

2. 标注的是重要的部分,从上往下分别是配置 javadoc 的范围,输出文件夹路径以及命令行参数。

这里的命令行参数很重要,因为只有使用 utf-8 编码才能保证生成时可以正常处理中文字符,所以一定要加上:

-encoding utf-8 -charset utf-8

还可以配置那些注解需要生成,哪些权限类(private、package、protected、public)需要生成等等精细的控 制。

还有一点需要注意,即不要勾选“Include test sources”,勾选后,生成时会造成很奇怪的错误。

  1. 配置好后,点击生成按钮,生成好后就会自动在浏览器打开进行查看。


举报

相关推荐

0 条评论