industry · 12301-dscp 接口速查

POST /industry/addIndustry 在用管理后台 #

行业-新增 · IndustryController

基本信息

控制器	com.jxxx.dscp.api.controller.industry.IndustryController#addIndustry
所属模块	industry `industry`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表industry

ControllerIndustryController#addIndustry

转换BeanUtils.map → Industry ⇒ 表 industry

ServiceIndustryService#add （IndustryServiceImpl）

MapperIndustryMapper#insert ⇒ 表 industry

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/industry/addIndustry
uat	https://dscp-uat.hn12301.net/manage-api/industry/addIndustry
pro	https://dscp-uat.hn12301.net/manage-api/industry/addIndustry	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IndustryAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
code	String	是	必填	`industry`.`code`	code
name	String	是	必填	`industry`.`name`	名称
state	Boolean			`industry`.`state`	状态
parentCode	String			`industry`.`parent_code`	父code

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　IndustryResponse　（object）

字段	类型	表 / 列	说明
id	Long	`industry`.`id`	id
code	String	`industry`.`code`	code
name	String	`industry`.`name`	名称
state	Boolean	`industry`.`state`	状态
parentCode	String	`industry`.`parent_code`	父code
children	List<IndustryResponse>	—	子列表
children[].…	（循环引用，已折叠）	—

示例

请求示例（自动生成，仅结构参考）

POST /industry/addIndustry

{
  "body": {
    "code": "",
    "name": "",
    "state": false,
    "parentCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "code": "",
    "name": "",
    "state": false,
    "parentCode": "",
    "children": [
      {}
    ]
  }
}

处理逻辑

操作日志industry / 新增行业

逻辑摘要新增（industryService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage addIndustry exact

POST /industry/deleteIndustry 在用管理后台 #

行业-删除 · IndustryController

基本信息

控制器	com.jxxx.dscp.api.controller.industry.IndustryController#deleteIndustry
所属模块	industry `industry`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表industry

ControllerIndustryController#deleteIndustry

ServiceIndustryService#delete （IndustryServiceImpl）

MapperIndustryMapper#deleteById ⇒ 表 industry

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/industry/deleteIndustry
uat	https://dscp-uat.hn12301.net/manage-api/industry/deleteIndustry
pro	https://dscp-uat.hn12301.net/manage-api/industry/deleteIndustry	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`industry`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /industry/deleteIndustry

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志industry / 删除行业

逻辑摘要删除（industryService.delete）

前端调用方

dscp-html-manage deleteIndustry exact

POST /industry/getIndustry 在用管理后台 #

行业-详情 · IndustryController

基本信息

控制器	com.jxxx.dscp.api.controller.industry.IndustryController#getIndustry
所属模块	industry `industry`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表industry

ControllerIndustryController#getIndustry

ServiceIndustryService#get （IndustryServiceImpl）

MapperIndustryMapper#selectById ⇒ 表 industry

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/industry/getIndustry
uat	https://dscp-uat.hn12301.net/manage-api/industry/getIndustry
pro	https://dscp-uat.hn12301.net/manage-api/industry/getIndustry	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`industry`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　IndustryResponse　（object）

字段	类型	表 / 列	说明
id	Long	`industry`.`id`	id
code	String	`industry`.`code`	code
name	String	`industry`.`name`	名称
state	Boolean	`industry`.`state`	状态
parentCode	String	`industry`.`parent_code`	父code
children	List<IndustryResponse>	—	子列表
children[].…	（循环引用，已折叠）	—

示例

请求示例（自动生成，仅结构参考）

POST /industry/getIndustry

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "code": "",
    "name": "",
    "state": false,
    "parentCode": "",
    "children": [
      {}
    ]
  }
}

处理逻辑

逻辑摘要查询详情（industryService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getIndustry exact

POST /industry/queryIndustryCascade 在用管理后台 #

行业-级联列表查询 · IndustryController

基本信息

控制器	com.jxxx.dscp.api.controller.industry.IndustryController#queryIndustryCascade
所属模块	industry `industry`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerIndustryController#queryIndustryCascade

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

IndustryTreeCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/industry/queryIndustryCascade
uat	https://dscp-uat.hn12301.net/manage-api/industry/queryIndustryCascade
pro	https://dscp-uat.hn12301.net/manage-api/industry/queryIndustryCascade	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　KeywordsRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String			—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<IndustryResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	—	id
code	String	—	code
name	String	—	名称
state	Boolean	—	状态
parentCode	String	—	父code
children	List<IndustryResponse>	—	子列表
children[].…	（循环引用，已折叠）	—

示例

请求示例（自动生成，仅结构参考）

POST /industry/queryIndustryCascade

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "code": "",
      "name": "",
      "state": false,
      "parentCode": "",
      "children": [
        {}
      ]
    }
  ]
}

处理逻辑

逻辑摘要调用 isBlank（StringUtils.isBlank）

前端调用方

dscp-html-manage queryIndustryCascade exact

POST /industry/queryIndustryList 在用管理后台 #

行业-列表查询 · IndustryController

基本信息

控制器	com.jxxx.dscp.api.controller.industry.IndustryController#queryIndustryList
所属模块	industry `industry`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表industry

ControllerIndustryController#queryIndustryList

转换BeanUtils.map → IndustryQuery

ServiceIndustryService#queryList （IndustryServiceImpl）

MapperIndustryMapper#selectList ⇒ 表 industry

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/industry/queryIndustryList
uat	https://dscp-uat.hn12301.net/manage-api/industry/queryIndustryList
pro	https://dscp-uat.hn12301.net/manage-api/industry/queryIndustryList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IndustryListRequest

字段	类型	必填	取值/校验	表 / 列	说明
code	String	否	可选(@MvcOptional)	`industry`.`code`	code
name	String	否	可选(@MvcOptional)	`industry`.`name`	名称
state	Boolean	否	可选(@MvcOptional)	`industry`.`state`	状态
parentCode	String	否	可选(@MvcOptional)	`industry`.`parent_code`	父code
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<IndustryResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`industry`.`id`	id
code	String	`industry`.`code`	code
name	String	`industry`.`name`	名称
state	Boolean	`industry`.`state`	状态
parentCode	String	`industry`.`parent_code`	父code
children	List<IndustryResponse>	—	子列表
children[].…	（循环引用，已折叠）	—

示例

请求示例（自动生成，仅结构参考）

POST /industry/queryIndustryList

{
  "body": {
    "code": "",
    "name": "",
    "state": false,
    "parentCode": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "code": "",
      "name": "",
      "state": false,
      "parentCode": "",
      "children": [
        {}
      ]
    }
  ]
}

处理逻辑

逻辑摘要列表查询（industryService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryIndustryList exact

POST /industry/queryIndustryPage 在用管理后台 #

行业-分页查询 · IndustryController

基本信息

控制器	com.jxxx.dscp.api.controller.industry.IndustryController#queryIndustryPage
所属模块	industry `industry`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表industry

ControllerIndustryController#queryIndustryPage

转换BeanUtils.map → IndustryQuery

ServiceIndustryService#queryPage （IndustryServiceImpl）

MapperIndustryMapper#selectPage ⇒ 表 industry

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/industry/queryIndustryPage
uat	https://dscp-uat.hn12301.net/manage-api/industry/queryIndustryPage
pro	https://dscp-uat.hn12301.net/manage-api/industry/queryIndustryPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IndustryPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
code	String	否	可选(@MvcOptional)	`industry`.`code`	code
name	String	否	可选(@MvcOptional)	`industry`.`name`	名称
state	Boolean	否	可选(@MvcOptional)	`industry`.`state`	状态
parentCode	String	否	可选(@MvcOptional)	`industry`.`parent_code`	父code
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<IndustryResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`industry`.`id`	id
code	String	`industry`.`code`	code
name	String	`industry`.`name`	名称
state	Boolean	`industry`.`state`	状态
parentCode	String	`industry`.`parent_code`	父code
children	List<IndustryResponse>	—	子列表
children[].…	（循环引用，已折叠）	—

示例

请求示例（自动生成，仅结构参考）

POST /industry/queryIndustryPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "code": "",
    "name": "",
    "state": false,
    "parentCode": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "code": "",
        "name": "",
        "state": false,
        "parentCode": "",
        "children": [
          {}
        ]
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（industryService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryIndustryPage exact

POST /industry/updateIndustry 在用管理后台 #

行业-更新 · IndustryController

基本信息

控制器	com.jxxx.dscp.api.controller.industry.IndustryController#updateIndustry
所属模块	industry `industry`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表industry

ControllerIndustryController#updateIndustry

转换BeanUtils.map → Industry ⇒ 表 industry

ServiceIndustryService#update （IndustryServiceImpl）

MapperIndustryMapper#updateById ⇒ 表 industry

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/industry/updateIndustry
uat	https://dscp-uat.hn12301.net/manage-api/industry/updateIndustry
pro	https://dscp-uat.hn12301.net/manage-api/industry/updateIndustry	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IndustryUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`industry`.`id`	id
code	String	是	必填	`industry`.`code`	code
name	String	是	必填	`industry`.`name`	名称
state	Boolean			`industry`.`state`	状态
parentCode	String			`industry`.`parent_code`	父code

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /industry/updateIndustry

{
  "body": {
    "id": 1,
    "code": "",
    "name": "",
    "state": false,
    "parentCode": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志industry / 更新行业

逻辑摘要更新（industryService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage updateIndustry exact

industry industry

IndustryController 7/7 在用