# sso-auth-center

统一认证中心服务端


工程模块介绍

| **工程模块** | **名称** | **备注** |
| --- | --- | --- |
| sso-auth-center-service | 父工程 | 定义统一依赖版本等 |
| sso-auth-center-admin | 后台web，统一开放网关 | boot项目，后台controller层 |
| sso-business | dao与业务层 | dao层，service层 |
| sso-common  | 公共部分 | 工具类、常量类、注解、枚举、业务自定义异常 |
| sso-framework | 核心配置 | 数据源配置、redis配置、验证码、统一异常处理 等 |



类命名规范<br />

| **所属层级** | **名称规则** | **备注** |
| --- | --- | --- |
| DAO层 | entity | entity包下与数据库表一致的实体 |
|  | xxxMapper | 与表一致的Mapper |
|  | xxxDTO | 中间转换对象，比如关联sql的返回对象 |
|  | xxxQuery | dao层查询对象 |
| service层 | xxxBaseService | 公共service，比如用户公共接口，在业务service多次使用的方法 |
|  | xxxBaseServiceImpl |  |
|  | xxxService | 业务 service层 |
|  | xxxServiceImpl | 业务service层实现 |
| controller层入参 | xxxAddBO或xxxUpdateBO | 新增业务入参 |
|  | xxxEditBO | 修改业务入参 |
|  | xxxListPageBO | 分页查询入参需要继承公共分类 BasePageModel |
| controller层出参 | xxxPageVO或xxxListVO | 分页列表返回对象 |
|  | xxxDetailVO | 查询详情返回对象 |
|  | xxxCountVO | 统计业务返回对象 |
|  | xxOptionVO | 下拉选项返回对象 |




接口命名规范<br />

|  | **请求方式** | **备注** |
| --- | --- | --- |
| /listPage | get |  分页列表 |
| /listxxPage | get |  分页列表 |
| /listxxx | get | 不分页的列表 |
| /detail/{id} | get | _获取用户详细信息_ |
| /getxxx | get | 其它详情接口 |
| /add | post | 新增接口 |
| /update 或/edit | put或post | 修改接口 |
| /delete/{id} | / | 删除接口 |
|  |  |  |

公共返回类<br />

|  | **类名** | **常用方法** |
| --- | --- | --- |
| 公共类 | ResultModel | ResultModel._success_(业务object内容)<br />ResultModel._error_("失败原因") |
| 分页接口公共类 | ResultPageModel | ResultPageModel._success_(resultList,rowCount) |


分页接口统一返回结构<br />

| **参数** | **说明** |  |
| --- | --- | --- |
| code | 成功 | 200成功，非200失败 |
| total | 总条数 |  |
| data [] | 当前页内容列表 |  |
| msg |  |  |

JSON示例<br />

```json
{
    "code": 200,
    "total": 16213,
    "data": [
        {
            "id": 1,
            "name": "张三"
        }
    ],
    "msg": "操作成功"
}
```

<br />详情接口统一返回结构

| **参数** | **说明** |  |
| --- | --- | --- |
| code | 成功 | 200成功，非200失败 |
| data | object类型对象 |  |
| msg |  |  |

JSON示例<br />

```json
{
    "code": 200,
    "data": {},
    "msg": "操作成功"
}
```