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

最新推荐文章于 2023-05-13 21:25:31 发布

悬浮海

最新推荐文章于 2023-05-13 21:25:31 发布

阅读量184

点赞数

分类专栏： Java基础文章标签： java javaSE

本文链接：https://blog.csdn.net/wang_luwei/article/details/107233232

版权

80 篇文章 2 订阅

订阅专栏

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

为了更好地组织类, Java 提供了包机制，用于区别类名的命名空间。
包语句的语法格式为:
```
package pkg1[. pkg2[. pk3.]];
```
一般利用公司域名倒置作为包名:例如： www.baidu.com com.baidu.www
为了能够使用某一个包的成员，我们需要在Java程序中明确导入该包。使用"import"语句可完成此功能
```
import package1[ . package..]. (classname |*);
```

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

参数信息：

@author 作者名

@version版本号

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

@param参数名

@return 返回值情况

@throws异常抛出情况

在这里插入图片描述

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

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

-encoding utf-8 -charset utf-8

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

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

关注