◆ 三、创建package-info文件

package-info文件不能随便被创建，会报“This is not a valid Java qualified name”错误，类名无效，Java变量定义规范是：字母、数字、下划线，还有那个不怎么常用的$符号，这个中划线可不在之列，那怎么创建这个文件呢？

可以创建一个普通的文件，如图所示，文件名为package-info.java。或者更直接的办法就是从别的项目中拷贝过来一个。

◆ 四、提供包级别的变量

如果想在包里面使用对应的变量，而不想让其他包使用，就可以将变量放到package-info.java下面，实现分包自用的理念。

/**
* This is domain module, the core business logic is implemented here.
*
*/
package com.rickie.tracking.domain;

/**
* 包常量
*/
class PACKAGE_CONST{
 public static final String COLA="《COLA 4.x架构入门和项目实践》技术专栏首先介绍了COLA框架的使用入门，以及与IDEA开发工具的集成等等；然后基于COLA架构，创建DDD经典示例项目-货物运输系统，详细介绍了DDD领域建模、适配层、应用层、领域层和基础设施层的代码开发、防腐层（ACL）设计与实现、领域事件（Domain Event）入门实践、以及基于Kafka消息中间件的消息发布和订阅等等。内容由浅入深，从开发实战出发，逐步掌握基于COLA架构和DDD领域建模思想构建复杂业务应用系统。";
}

在包内的任意类调用包常量，示例代码如下所示：

public class Test {
 public static void main(String[] args) {
 System.out.println(PACKAGE_CONST.COLA);
 }
}

在包外的任意类调用包常量，则会提示报错。

◆ 五、提供包级别的注释

使用JavaDoc的时候，通过在package-info.java添加注释，生成JavaDoc实现对应包的注释说明。

/**
* 描述: COLA 领域模块<br>
* This is domain module, the core business logic is implemented here. <br>
* 创建时间: 2021/8/1 12:00 <br>
* @version v1.0
*/
package com.rickie.tracking.domain;

/**
* 包常量
*/
class PACKAGE_CONST{
 public static final String COLA="《COLA 4.x架构入门和项目实践》技术专栏首先介绍了COLA框架的使用入门，以及与IDEA开发工具的集成等等；然后基于COLA架构，创建DDD经典示例项目-货物运输系统，详细介绍了DDD领域建模、适配层、应用层、领域层和基础设施层的代码开发、防腐层（ACL）设计与实现、领域事件（Domain Event）入门实践、以及基于Kafka消息中间件的消息发布和订阅等等。内容由浅入深，从开发实战出发，逐步掌握基于COLA架构和DDD领域建模思想构建复杂业务应用系统。";
}

生成对应的JavaDoc文档，如图所示：

来源：

https://www.toutiao.com/i6992877750461825544/