JavaSE 25 Java基础语法 → 包机制&&JavaDoc

4.10 包机制和JavaDoc

---

4.10.1 包机制

• 为了更好地组织 “类”，Java 提供了包机制，用于区别类名的命名空间。（有一点像 C++ 的命名空间 namespace）
• 包语句的语法格式：

package pkg1[.pkg2[.pkg3...]];

• 一般利用公司域名倒置作为包名; com.baidu.www
• 为了能够使用某一个包的成员，我们需要在Java 程序中 明确导入该包。使用 “import” 语句 就可以完成 导入。

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

其实就是为了 解决一个问题。命名冲突问题。

比如说，我有很多的 输出，不能 都叫 print，但我又感觉 改了名字，不好记。因为它就是输出呀。只是输出的东西不一样。

这个时候，我们就 要 用到 “包机制”，来说明 第一个print 是哪个包里的，第二个 pinrt 是哪个包里的，这样 名字一样，但 不属于同一个包，所以 效果是不同的。也解决了 命名冲突的问题。

• 新建包 需要设置一下 分层（而不是单层）

Projecct 右边的齿轮–>Flatten Packages 和 Hide Empty Middle Packages √ 去掉！

右键 src --> New --> package

最终效果：

String 内的 包：

所以你会发现，很多时候 你想写一些东西，不用原生态的自己写，直接 导包就行。

包：可以理解为 命名空间和库的结合。

导入包演示：
全部导入：import com.xxx.xxx.*
它会导入这个包下 所有的类！

---

4.10.2 JavaDoc

• JavaDoc 命令是用来生成自己API 文档的
• 参数信息

• @author 作者名
• @version 版本号
• @since 指明需要最早使用的 jdk 版本
• @param 参数名
• @return 返回值情况
• @throws 异常抛出情况

• 它是 Java引入的 一种比较新颖的注释方式
  

命令：javadoc -encoding UTF-8 -charset UTF-8 Doc.java