增加接口连接成功时间
This commit is contained in:
parent
baffc3abcb
commit
568859ce35
@ -22,7 +22,7 @@
|
|||||||
- 对象转换:使用MapStruct进行转换,继承BaseConverter,显式声明特殊映射
|
- 对象转换:使用MapStruct进行转换,继承BaseConverter,显式声明特殊映射
|
||||||
|
|
||||||
### Service层规范
|
### Service层规范
|
||||||
- 简单CRUD继承BaseServiceImpl,复杂业务需定义专门接口和实现,包含事务控制和异常处理
|
- 简单CRUD继承com.qqchen.deploy.backend.framework.service.impl.BaseServiceImpl,复杂业务需定义专门接口和实现,包含事务控制和异常处理
|
||||||
- 使用@Transactional注解控制事务,合理设置事务传播机制和隔离级别
|
- 使用@Transactional注解控制事务,合理设置事务传播机制和隔离级别
|
||||||
- 实现乐观锁(@Version)或悲观锁(findByIdWithLock)进行并发控制
|
- 实现乐观锁(@Version)或悲观锁(findByIdWithLock)进行并发控制
|
||||||
- 使用@Resource 注入其他BEAN,不要使用构造方法
|
- 使用@Resource 注入其他BEAN,不要使用构造方法
|
||||||
@ -41,7 +41,7 @@ public class ExternalSystemServiceImpl extends BaseServiceImpl<ExternalSystem, E
|
|||||||
}
|
}
|
||||||
|
|
||||||
### Controller层规范
|
### Controller层规范
|
||||||
- REST接口使用BaseController,三方接口命名为模块名ApiController,二方接口为模块名Controller
|
- REST接口使用com.qqchen.deploy.backend.framework.controller.BaseController,三方接口命名为模块名ApiController,二方接口为模块名Controller
|
||||||
- 返回值com.qqchen.deploy.backend.framework.api.Response<T>
|
- 返回值com.qqchen.deploy.backend.framework.api.Response<T>
|
||||||
- 统一使用GlobalExceptionHandler处理异常
|
- 统一使用GlobalExceptionHandler处理异常
|
||||||
- 使用@Resource 注入其他BEAN,不要使用构造方法
|
- 使用@Resource 注入其他BEAN,不要使用构造方法
|
||||||
@ -63,7 +63,7 @@ public class ExternalSystemApiController extends BaseController<ExternalSystem,
|
|||||||
}
|
}
|
||||||
|
|
||||||
### Repository层规范
|
### Repository层规范
|
||||||
- 继承IBaseRepository,定义特定查询方法
|
- 继承com.qqchen.deploy.backend.framework.repository.IBaseRepository,定义特定查询方法
|
||||||
- 使用JPA命名规范定义查询方法
|
- 使用JPA命名规范定义查询方法
|
||||||
- 复杂查询使用@Query注解
|
- 复杂查询使用@Query注解
|
||||||
- 示例:
|
- 示例:
|
||||||
@ -72,7 +72,7 @@ public interface IExternalSystemRepository extends IBaseRepository<ExternalSyste
|
|||||||
boolean existsByNameAndDeletedFalse(String name);
|
boolean existsByNameAndDeletedFalse(String name);
|
||||||
}
|
}
|
||||||
### Converter规范
|
### Converter规范
|
||||||
- 继承BaseConverter,遵循以下规则:
|
- 继承com.qqchen.deploy.backend.framework.converter.BaseConverter,遵循以下规则:
|
||||||
1. 简单场景(字段完全匹配)示例:
|
1. 简单场景(字段完全匹配)示例:
|
||||||
```java
|
```java
|
||||||
@Mapper(config = BaseConverter.class)
|
@Mapper(config = BaseConverter.class)
|
||||||
@ -90,7 +90,7 @@ public interface IExternalSystemRepository extends IBaseRepository<ExternalSyste
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
### 查询规范
|
### 查询规范
|
||||||
- 简单查询使用BaseQuery
|
- 简单查询使用com.qqchen.deploy.backend.framework.query.BaseQuery
|
||||||
- 复杂查询需要:
|
- 复杂查询需要:
|
||||||
继承BaseQuery,使用@QueryField注解标注查询字段指定查询类型
|
继承BaseQuery,使用@QueryField注解标注查询字段指定查询类型
|
||||||
- 示例:
|
- 示例:
|
||||||
@ -107,6 +107,7 @@ public class ExternalSystemQuery extends BaseQuery {
|
|||||||
```
|
```
|
||||||
|
|
||||||
### Entity规范
|
### Entity规范
|
||||||
|
- 继承com.qqchen.deploy.backend.framework.model.Entity<ID>,使用@jakarta.persistence.Entity注解
|
||||||
- 示例:
|
- 示例:
|
||||||
```java
|
```java
|
||||||
@Data
|
@Data
|
||||||
@ -125,7 +126,7 @@ public class ExternalSystem extends Entity<Long> {
|
|||||||
- 增加枚举时,不要修改现有没有,只追加即可
|
- 增加枚举时,不要修改现有没有,只追加即可
|
||||||
|
|
||||||
### 异常规范
|
### 异常规范
|
||||||
- 异常分为系统异常应继承SystemException和业务异常应承BusinessException,使用ResponseCode定义错误码,在messages.properties中定义错误消息
|
- 异常分为系统异常应继承com.qqchen.deploy.backend.framework.exception.SystemException和业务异常应承com.qqchen.deploy.backend.framework.exception.BusinessException,使用ResponseCode定义错误码,在messages.properties中定义错误消息
|
||||||
- 示例
|
- 示例
|
||||||
throw new BusinessException(ResponseCode.EXTERNAL_SYSTEM_DISABLED);
|
throw new BusinessException(ResponseCode.EXTERNAL_SYSTEM_DISABLED);
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user