三、命名规约

  1. 【强制】各服务模块工程名统一 以服务名—service 形式命名。如 blog-service ,user-service,order-service 等。
  2. 【强制】config/ 包下存放系统配置类,自定义配置类可以重载Spring-Boot的各项默认配置。工程里的初始配置类原则上不允许擅自修改,可以添加配置类。配置类名前要加@Configuration 注解,配置类必须以 Configuration 作后缀。
  3. 【推荐】工程里默认生成配置属性类 ApplicationProperties 位于 config/,所有属性项在这个类里添加,嵌套属性要在该内部类增加静态类进行属性获取。建议配置文件采用 YAML 格式文件,语义、可读性更友好。

    foo:
      enabled : true
      servers : www.host1.com,ww.host2.com
      list:
        - name: my name
          description: my description
    
  4.     正例:
    
           @ConfigurationProperties("foo")
    
           public class ApplicationProperties {
    
             private boolean enabled;
    
             private List<String>servers;
    
             private final List<MyPojo> list = new ArrayList<>();    
    
             public static class MyPojo{
    
                   private String name;
    
                   private String description;
    
                   /***省略 get/set 方法***/
    
             }
    
             public List<MyPojo> getList() {
    
                   return this.list;
    
              }         
    
              /***省略 get/set 方法***/
    
           }
    
  5. 【强制】实体类必须放置在 domain/ 包下,类名前添加注解@Entity@Document 根据数据源类型来选择,SQL选用@Entity,MongoDB选用@Document。属性前不加@Column 的话,默认生成的数据列名时属性的全小写单词,要求多单词属性添加@Column定义列名为下划线分割,或属性与列名不符时也要通过@Column自定义列名,跟数据库实际列名对应一致。
  6. 【强制】service类必须放置在 service/ 包下,类名前必须通过@Service 注解,原则上必须先定义接口再定义实现类,业务接口以 Service 为后缀,业务实现类以 ServiceImpl 为后缀。DTO相关类要放置在 dto/ 包下,类名以 DTO 为后缀。
  7. 【强制】数据库操作类放在 repository/ 目录下,名称后面以 Repository 为后缀。

  8. 【强制】Rest API 统一放置在 web/rest 包下,统一以 Resource 为后缀名, 若有 VM 对象 ,应放在vm/ 包下面,以VM为后缀。

results matching ""

    No results matching ""