作者:Eddy  历史版本:1  最后编辑:龚清  更新时间:2024-09-20 15:13

编写版本:v3.5.3
适用版本:所有

完整目录结构

在此文档中会以骨架项目为例来描述IBPS的目录结构。
下图为骨架项目的相关工程,文档会以每个工程的作用及包含何种类型的文件展开。

注意:ibps-provider-skeleton-other和ibps-provider-skeleton-saas与ibps-provider-skeleton结构一致,other和saas就不再赘述了。ibps-provider-skeleton-spring-boot-sample与ibps-provider-skeleton-spring-boot同理。

ibps-provider-skeleton

1、com.lc.ibps:
(1)config内为骨架启动初始化配置类。
(2)SkeletonApplication:骨架服务的启动类。
(3)skeleton文件夹:

  • mapper:映射接口文件。
  • provider:controller层,主要负责接受前台的数据和请求,并且在底层处理完之后把结果返回。

2、conf:

内部主要包含不同环境的数据源配置文件和项目配置文件。数据源配置文件的具体使用可以参考这里

3、config:

(1)application.yml 为IBPS用来定义应用级别的配置文件。应用程序特有配置信息,可以用来配置后续各个模块中需使用的公共参数等。
系统的配置文件读取、系统环境切换、swagger配置及MQ部分配置等一系列功能在此文件配置。
(2)application-app.yml 为IBPS的环境变量配置文件。IBPS的各类开关、配置类变量都在该文件中配置。
变量的使用方法有多种。

  • 配置类。

  • @Value注解。

  • 使用IBPS包装的AppUtil.getProperty(),具体使用请查看代码。

(3)application-xxxx.yml。
application-dev.yml、application-test.yml和application-prod.yml分别对应devtestprod环境。IBPS不同环境的端口号、端口等参数化配置在此处。

(4)bootstrap.yml
bootstrap.yml 用来程序引导时执行,应用于更加早期配置信息读取。可以理解成系统级别的一些参数配置,这些参数一般是不会变动的。
微服务的 注册中心、配置中心、项目名称spring.application.name

以nacos为例:

(5)caffeine.properties
Caffeine 是基于Java 8 开发的、提供了近乎最佳命中率的高性能本地缓存组件。
caffeine.properties为其配置文件。

(6)log4j2.yml
IBPS日志系统的相关配置。

4、i18n:
国际化的相关配置文件,具体使用见骨架代码的例子。

ibps-provider-skeleton-api

api:模块的请求API接口层。
其他服务调用该模块的相关接口需要通过API接口层。

ibps-provider-skeleton-client


client:模块的client。其他服务调用该服务接口是通过client实现的。
注意:在继承service时,需要加上@FeignClient注解。

ibps-skeleton-biz


biz为该模块的业务层。
(1)Dao及其实现类:
dao分为Dao和QueryDao。

  • Dao(增删改):对于数据库表数据进行增删改操作。
  • QueryDao(查):对于数据库表数据进行查询操作。

(2)Domain:
领域驱动类,用于业务数据的增删改。领域驱动类可看做传统框架的业务层(Service层)。通过Domain可进行相关业务逻辑实现,可实现操作的前后置处理、缓存组件集成、日志生成、数据批处理等功能。

(3)Repository:
查询仓库类,用于数据的查询。查询仓库类可看做传统框架的持久层(DAO层)。通过Repository可以实现数据的查询,缓存组件集成、复杂条件组合查询等功能。

ibps-skeleton-model

(1)entity:
entity文件夹中为其模块对应的持久层对象。

  • PO在IBPS中为实体对象,其继承表对象,即PO对象是表对象的子类。
  • 表对象(TBL)继承抽象PO,其对应着数据库表。表对象的一个属性与表的每一个字段相对应。

(2)mapping:
SQL Map XML映射文件在该文件中。

(3)model:
用于数据传递的对象。