菜单
Provides Java Controller layer standards including RESTful API design, request mapping, parameter validation, and response handling. Invoke when generating Controller files or RESTful API endpoints.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Complete PRD template with AI-friendly markers. Use for product requirement docs: includes overview, requirements, processes, data, interfaces, acceptance. AI can quickly identify [AI] marked sections for implementation.
Provides API documentation template and standards for RESTful API, gRPC, and other interfaces. Includes request/response format, parameter definitions, error codes, and Markdown documentation structure. Invoke when generating API documentation or interface specifications.
Provides database design templates and documentation structure. Invoke when designing database schemas, creating database design documents, or generating SQL scripts.
Provides common Java coding standards including hutool tool usage and Lombok annotations. Invoke when generating Java code (DO, VO, Service, Controller) or applying coding standards.
Provides Java DAO layer standards including interface specifications, MyBatis XML templates, method naming, parameter annotations, and CRUD operation patterns. Invoke when generating DAO files or MyBatis mappers.
Provides database type to Java type mapping standards for DO (Data Object) generation. Includes type conversion rules and special field handling. Invoke when generating DO files from SQL table structures.
| name | java-controller |
| description | Provides Java Controller layer standards including RESTful API design, request mapping, parameter validation, and response handling. Invoke when generating Controller files or RESTful API endpoints. |
本技能提供Java Controller层的开发规范，包括Controller类规范、RESTful API规范、参数验证规范、返回值处理规范和异常处理规范。
@RestController
@RequestMapping("/模块路径/业务模块")
public class 业务模块名Controller {
@Autowired
private 业务模块名Service 业务模块名Service;
@Autowired
private 其他Service 其他Service;
private static final Logger LOG = LoggerFactory.getLogger(业务模块名Controller.class);
| 操作类型 | HTTP方法 | URL路径 | 示例 |
|---|---|---|---|
| 保存 | POST | /Save业务模块名 | /SaveAdminDepartment |
| 修改 | POST | /Update业务模块名 | /UpdateAdminDepartment |
| 删除 | POST | /Delete业务模块名 | /DeleteAdminDepartment |
| 获取单个 | POST | /GetOne业务模块名 | /GetOneAdminDepartment |
| 获取全部（带分页） | POST | /GetAll业务模块名Table | /GetAllAdminDepartmentTable |
@PostMapping("/Save业务模块名")
@ResponseBody
public BaseRetuenDataVO save业务模块名(@RequestBody @Valid 业务模块名DataSaveVO 业务模块名DataSaveVO) {
// 业务逻辑
}
| 操作类型 | 方法命名 | 示例 |
|---|---|---|
| 保存 | save + 业务模块名 | saveAdminDepartment |
| 修改 | update + 业务模块名 | updateAdminDepartment |
| 删除 | delete + 业务模块名 | deleteAdminDepartment |
| 获取单个 | getOne + 业务模块名 | getOneAdminDepartment |
| 获取全部 | getAll + 业务模块名 | getAllAdminDepartment |
/**
* 保存管理员部门
*
* @param adminDepartmentDataSaveVO 管理员部门
*/
@PostMapping("/SaveAdminDepartment")
@ResponseBody
public BaseRetuenDataVO saveAdminDepartment(@RequestBody @Valid AdminDepartmentDataSaveVO adminDepartmentDataSaveVO) {
// 业务逻辑
}
@PostMapping("/Save业务模块名")
@ResponseBody
public BaseRetuenDataVO save业务模块名(@RequestBody @Valid 业务模块名DataSaveVO 业务模块名DataSaveVO) {
// 业务逻辑
}
| 操作类型 | 参数类型 | 示例 |
|---|---|---|
| 保存 | 业务模块名DataSaveVO | AdminDepartmentDataSaveVO |
| 修改 | 业务模块名DataSaveVO | AdminDepartmentDataSaveVO |
| 删除 | 业务模块名DataIdVO | AdminDepartmentDataIdVO |
| 获取单个 | 业务模块名DataIdVO | AdminDepartmentDataIdVO |
| 获取全部（带分页） | TableConditionDataVO | TableConditionDataVO |
public BaseRetuenDataVO save业务模块名(@RequestBody @Valid 业务模块名DataSaveVO 业务模块名DataSaveVO) {
BaseRetuenDataVO baseRetuenDataVO;
// 业务逻辑
return baseRetuenDataVO;
}
// 成功返回
baseRetuenDataVO = ResultUtil.success("操作成功", 数据对象);
// 失败返回
baseRetuenDataVO = ResultUtil.error("操作失败");
try {
// 业务逻辑
baseRetuenDataVO = ResultUtil.success("操作成功");
} catch (Exception e) {
LOG.error(e.getMessage());
baseRetuenDataVO = ResultUtil.error("操作失败，请您重新操作");
}
业务模块名DO 业务模块名DO = 业务模块名Service.get业务模块名By主键名(主键名);
if (业务模块名DO == null) {
baseRetuenDataVO = ResultUtil.error("此数据不存在，请刷新后重试");
业务模块名DataSaveVO = null;
return baseRetuenDataVO;
}
public BaseRetuenDataVO save业务模块名(@RequestBody @Valid 业务模块名DataSaveVO 业务模块名DataSaveVO) {
BaseRetuenDataVO baseRetuenDataVO;
// 业务逻辑
业务模块名DataSaveVO = null;
业务模块名DO = null;
return baseRetuenDataVO;
}
当用户需要生成以下内容时，应调用此技能：