pxf8gw7s3
/
human-resource-management-system
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Labels Milestones
New Pull Request

包括部门，文件，员工管理 #4

Merged
pxf8gw7s3 merged 3 commits from hrm/jwh into develop 3 months ago
Conversation 0 Commits 3 Files Changed 3
3 changed files with 300 additions and 98 deletions
Show Stats Download Patch File Download Diff File

94
hrm/src/main/java/com/qiujie/controller/DeptController.java
Unescape View File

@ -2,7 +2,7 @@ package com.qiujie.controller;
import com.qiujie.entity.Dept;
import com.qiujie.dto.ResponseDTO;
import com.qiujie.service.DeptService;
import com.qiujie.service.DeptService;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.access.prepost.PreAuthorize;
@ -24,68 +24,122 @@ import java.util.List;
* @since 2022-03-07
*/
@RestController
// 标识当前类为REST风格控制器，返回数据为JSON格式
@RequestMapping("/dept")
// 定义基础请求路径，所有接口路径前缀为/dept
public class DeptController {
// 定义基础请求路径，所有接口路径前缀为/dept
@Autowired
private DeptService deptService;
/**
* 新增部门接口
* @param dept 部门实体对象（通过请求体传递）
* @return 统一响应结果（包含操作状态、数据或错误信息）
*/
@ApiOperation("新增")// Swagger文档注解，说明接口功能
@PostMapping// 接收POST请求，完整路径为/dept
@ApiOperation("新增")
@PostMapping
@PreAuthorize("hasAnyAuthority('system:department:add')")
public ResponseDTO add(@RequestBody Dept dept) {
return this.deptService.add(dept);
}
/**
* 逻辑删除部门接口（非物理删除，仅标记删除状态）
* @param id 部门ID（通过URL路径传递）
* @return 统一响应结果
*/
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@PreAuthorize("hasAnyAuthority('system:department:delete')")
@DeleteMapping("/{id}")// 接收DELETE请求，完整路径为/dept/{id}
@PreAuthorize("hasAnyAuthority('system:department:delete')")// 权限控制
public ResponseDTO delete(@PathVariable Integer id) {
return this.deptService.delete(id);
}
/**
* 批量逻辑删除部门接口
* @param ids 部门ID列表（通过URL路径传递，多个ID用逗号分隔）
* @return 统一响应结果
*/
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@PreAuthorize("hasAnyAuthority('system:department:delete')")
@DeleteMapping("/batch/{ids}")// 接收DELETE请求，完整路径为/dept/batch/{ids}
@PreAuthorize("hasAnyAuthority('system:department:delete')")// 权限控制
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.deptService.deleteBatch(ids);
}
/**
* 编辑更新部门信息接口
* @param dept 包含更新信息的部门实体对象（通过请求体传递）
* @return 统一响应结果
*/
@ApiOperation("编辑更新")
@PutMapping
@PreAuthorize("hasAnyAuthority('system:department:edit')")
@PutMapping// 接收PUT请求，完整路径为/dept
@PreAuthorize("hasAnyAuthority('system:department:edit')")// 权限控制
public ResponseDTO edit(@RequestBody Dept dept) {
return this.deptService.edit(dept);
}
/**
* 根据ID查询部门详情接口
* @param id 部门ID（通过URL路径传递）
* @return 统一响应结果（包含查询到的部门信息）
*/
@ApiOperation("查询")//根据ID查询部门
@GetMapping("/{id}")// 接收GET请求，完整路径为/dept/{id}
@ApiOperation("查询")
@GetMapping("/{id}")
public ResponseDTO query(@PathVariable Integer id) {
return this.deptService.query(id);
}
/**
* 查询所有部门接口
* @return 统一响应结果（包含所有部门的列表数据）
*/
@ApiOperation("查询所有")
@GetMapping("/all")
@ApiOperation("查询所有")//查询所有部门
@GetMapping("/all")// 接收GET请求，完整路径为/dept/all
public ResponseDTO queryAll(){
return this.deptService.queryAll();
}
/**
* 条件分页查询部门接口
* @param current 当前页码（默认第1页）
* @param size 每页条数（默认10条）
* @param name 部门名称（查询条件，可选）
* @return 统一响应结果（包含分页查询结果）
*/
@ApiOperation("条件查询")
@GetMapping
@ApiOperation("条件查询")//条件分页查询部门
@GetMapping// 接收GET请求，完整路径为/dept
@PreAuthorize("hasAnyAuthority('system:department:list','system:department:search')")
// 权限控制：拥有两个权限中的任意一个即可访问
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, String name) {
return this.deptService.list(current, size, name);
}
/**
* 部门数据导出接口（导出为文件）
* @param response HTTP响应对象，用于输出文件流
* @param filename 导出的文件名
* @throws Exception 可能抛出IO异常或其他处理异常
*/
@ApiOperation("数据导出接口")
@GetMapping("/export/{filename}")
@PreAuthorize("hasAnyAuthority('system:department:export')")
@ApiOperation("数据导出接口")//部门数据导出接口
@GetMapping("/export/{filename}")// 接收GET请求，完整路径为/dept/export/{filename}
@PreAuthorize("hasAnyAuthority('system:department:export')")// 权限控制
public void export(HttpServletResponse response,@PathVariable String filename) throws Exception {
this.deptService.export(response,filename);
}
/**
* 部门数据导入接口（从文件导入数据）
* @param file 上传的文件（包含部门数据）
* @return 统一响应结果（包含导入成功/失败信息）
* @throws IOException 可能抛出文件读取异常
*/
@ApiOperation("数据导入接口")
@PostMapping("/import")
@PreAuthorize("hasAnyAuthority('system:department:import')")
@PostMapping("/import")// 接收POST请求，完整路径为/dept/import
@PreAuthorize("hasAnyAuthority('system:department:import')")// 权限控制
public ResponseDTO imp(MultipartFile file) throws IOException {
return this.deptService.imp(file);
}

143
hrm/src/main/java/com/qiujie/controller/DocsController.java
Unescape View File

@ -16,92 +16,161 @@ import java.io.IOException;
import java.util.List;
/**
* 文件上传接口
* 文件文档管理相关接口控制器
* 负责处理文件的增删改查、上传、下载、导入导出等请求
*
* @Author qiujie
* @Date 2022/2/24
* @Version 1.0
*/
@RestController
@RequestMapping("/docs")
@RestController // 标识为REST风格控制器，返回JSON格式响应
@RequestMapping("/docs") // 基础请求路径，所有接口路径前缀为/docs
public class DocsController {
// 自动注入文件文档服务层对象，用于调用业务逻辑
@Autowired
private DocsService docsService;
@ApiOperation("新增")
@PostMapping
/**
* 新增文件文档记录
* @param docs 文件文档实体对象（包含文件相关信息，通过请求体传递）
* @return 统一响应结果（操作状态、数据或错误信息）
*/
@ApiOperation("新增文件文档记录") // Swagger注解，描述接口功能
@PostMapping // 接收POST请求，完整路径为/docs
public ResponseDTO add(@RequestBody Docs docs) {
return this.docsService.add(docs);
}
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@PreAuthorize("hasAnyAuthority('system:docs:delete')")
/**
* 逻辑删除文件文档记录（仅标记删除状态，不物理删除）
* @param id 要删除的文件文档ID（通过URL路径传递）
* @return 统一响应结果
*/
@ApiOperation("逻辑删除文件文档记录")
@DeleteMapping("/{id}") // 接收DELETE请求，完整路径为/docs/{id}
@PreAuthorize("hasAnyAuthority('system:docs:delete')") // 权限控制：仅拥有该权限的用户可访问
public ResponseDTO delete(@PathVariable Integer id) {
return this.docsService.delete(id);
}
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@PreAuthorize("hasAnyAuthority('system:docs:delete')")
/**
* 批量逻辑删除文件文档记录
* @param ids 要删除的文件文档ID列表（通过URL路径传递，多个ID用逗号分隔）
* @return 统一响应结果
*/
@ApiOperation("批量逻辑删除文件文档记录")
@DeleteMapping("/batch/{ids}") // 接收DELETE请求，完整路径为/docs/batch/{ids}
@PreAuthorize("hasAnyAuthority('system:docs:delete')") // 权限控制
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.docsService.deleteBatch(ids);
}
@ApiOperation("编辑更新")
@PutMapping
@PreAuthorize("hasAnyAuthority('system:docs:edit')")
/**
* 编辑更新文件文档记录信息
* @param docs 包含更新信息的文件文档实体（通过请求体传递）
* @return 统一响应结果
*/
@ApiOperation("编辑更新文件文档记录")
@PutMapping // 接收PUT请求，完整路径为/docs
@PreAuthorize("hasAnyAuthority('system:docs:edit')") // 权限控制
public ResponseDTO edit(@RequestBody Docs docs) {
return this.docsService.edit(docs);
}
@ApiOperation("查询")
@GetMapping("/{id}")
/**
* 根据ID查询文件文档详情
* @param id 文件文档ID（通过URL路径传递）
* @return 统一响应结果（包含查询到的文件文档信息）
*/
@ApiOperation("根据ID查询文件文档详情")
@GetMapping("/{id}") // 接收GET请求，完整路径为/docs/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.docsService.query(id);
}
@ApiOperation("分页条件查询")
@GetMapping
@PreAuthorize("hasAnyAuthority('system:docs:list','system:docs:search')")
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, String oldName, String staffName) {
/**
* 分页条件查询文件文档列表
* @param current 当前页码（默认第1页）
* @param size 每页条数（默认10条）
* @param oldName 文件名（查询条件，可选）
* @param staffName 操作人姓名（查询条件，可选）
* @return 统一响应结果（包含分页查询结果）
*/
@ApiOperation("分页条件查询文件文档列表")
@GetMapping // 接收GET请求，完整路径为/docs
@PreAuthorize("hasAnyAuthority('system:docs:list','system:docs:search')") // 权限控制：拥有两个权限中的任意一个即可访问
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current,
@RequestParam(defaultValue = "10") Integer size,
String oldName,
String staffName) {
return this.docsService.list(current, size, oldName, staffName);
}
@ApiOperation("数据导出接口")
@GetMapping("/export/{filename}")
@PreAuthorize("hasAnyAuthority('system:docs:export')")
public void export(HttpServletResponse response,@PathVariable String filename) throws IOException {
this.docsService.export(response,filename);
/**
* 文件文档数据导出接口（将数据导出为文件）
* @param response HTTP响应对象，用于输出文件流
* @param filename 导出的文件名
* @throws IOException 可能抛出文件IO异常
*/
@ApiOperation("文件文档数据导出接口")
@GetMapping("/export/{filename}") // 接收GET请求，完整路径为/docs/export/{filename}
@PreAuthorize("hasAnyAuthority('system:docs:export')") // 权限控制
public void export(HttpServletResponse response, @PathVariable String filename) throws IOException {
this.docsService.export(response, filename);
}
@ApiOperation("数据导入接口")
@PostMapping("/import")
@PreAuthorize("hasAnyAuthority('system:docs:import')")
/**
* 文件文档数据导入接口（从上传的文件导入数据）
* @param file 包含数据的上传文件
* @return 统一响应结果（包含导入结果信息）
* @throws IOException 可能抛出文件读取异常
*/
@ApiOperation("文件文档数据导入接口")
@PostMapping("/import") // 接收POST请求，完整路径为/docs/import
@PreAuthorize("hasAnyAuthority('system:docs:import')") // 权限控制
public ResponseDTO imp(MultipartFile file) throws IOException {
return this.docsService.imp(file);
}
@ApiOperation("文件上传")
@PostMapping("/upload/{id}")
@PreAuthorize("hasAnyAuthority('system:docs:upload')")
/**
* 文件上传接口（将文件内容上传并关联到指定文档记录）
* @param file 要上传的文件
* @param id 关联的文档记录ID（通过URL路径传递）
* @return 统一响应结果（包含上传结果信息）
* @throws IOException 可能抛出文件上传IO异常
*/
@ApiOperation("文件上传接口")
@PostMapping("/upload/{id}") // 接收POST请求，完整路径为/docs/upload/{id}
@PreAuthorize("hasAnyAuthority('system:docs:upload')") // 权限控制
public ResponseDTO upload(MultipartFile file, @PathVariable Integer id) throws IOException {
return this.docsService.upload(file, id);
}
@ApiOperation("文件下载")
@GetMapping("/download/{filename}")
@PreAuthorize("hasAnyAuthority('system:docs:download')")
/**
* 文件下载接口（根据文件名下载文件）
* @param filename 要下载的文件名（通过URL路径传递）
* @param response HTTP响应对象，用于输出文件流
* @throws IOException 可能抛出文件读取或输出异常
*/
@ApiOperation("文件下载接口")
@GetMapping("/download/{filename}") // 接收GET请求，完整路径为/docs/download/{filename}
@PreAuthorize("hasAnyAuthority('system:docs:download')") // 权限控制
public void download(@PathVariable String filename, HttpServletResponse response) throws IOException {
this.docsService.download(filename, response);
}
@ApiOperation("文件下载")
/**
* 头像文件下载接口（本质是复用文件下载逻辑，用于获取头像文件）
* @param filename 头像文件名（通过URL路径传递）
* @param response HTTP响应对象，用于输出文件流
* @throws IOException 可能抛出文件读取或输出异常
*/
@ApiOperation("头像文件下载接口")
@GetMapping("/avatar/{filename}")
// 接收GET请求，完整路径为/docs/avatar/{filename}
public void getAvatar(@PathVariable String filename, HttpServletResponse response) throws IOException {
this.docsService.download(filename, response);
}
}
}

161
hrm/src/main/java/com/qiujie/controller/StaffController.java
Unescape View File

@ -1,6 +1,5 @@
package com.qiujie.controller;
import com.qiujie.dto.ResponseDTO;
import com.qiujie.entity.Staff;
import com.qiujie.service.StaffRoleService;
@ -17,107 +16,187 @@ import java.util.List;
/**
* <p>
* 前端控制器
* 员工管理模块前端控制器
* 负责处理员工的增删改查、角色分配、密码验证与重置、数据导入导出等请求
* </p>
*
* @author qiujie
* @since 2022-01-27
*/
@RestController
@RequestMapping("/staff")
@RestController // 标识为REST风格控制器，返回JSON格式响应
@RequestMapping("/staff") // 基础请求路径，所有接口路径前缀为/staff
public class StaffController {
// 自动注入员工服务层对象，处理员工核心业务逻辑
@Autowired
private StaffService staffService;
// 自动注入员工-角色关联服务层对象，处理员工角色分配相关业务
@Autowired
private StaffRoleService staffRoleService;
@ApiOperation("新增")
@PostMapping
@PreAuthorize("hasAnyAuthority('system:staff:add')")
/**
* 新增员工
* @param staff 员工实体对象（包含员工基本信息，通过请求体传递）
* @return 统一响应结果（操作状态、数据或错误信息）
*/
@ApiOperation("新增员工") // Swagger注解，描述接口功能
@PostMapping // 接收POST请求，完整路径为/staff
@PreAuthorize("hasAnyAuthority('system:staff:add')") // 权限控制：仅拥有该权限的用户可访问
public ResponseDTO add(@RequestBody Staff staff) {
return this.staffService.add(staff);
}
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@PreAuthorize("hasAnyAuthority('system:staff:delete')")
/**
* 逻辑删除员工（仅标记删除状态，不物理删除数据）
* @param id 要删除的员工ID（通过URL路径传递）
* @return 统一响应结果
*/
@ApiOperation("逻辑删除员工")
@DeleteMapping("/{id}") // 接收DELETE请求，完整路径为/staff/{id}
@PreAuthorize("hasAnyAuthority('system:staff:delete')") // 权限控制
public ResponseDTO delete(@PathVariable Integer id) {
return this.staffService.delete(id);
}
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@PreAuthorize("hasAnyAuthority('system:staff:delete')")
/**
* 批量逻辑删除员工
* @param ids 要删除的员工ID列表（通过URL路径传递，多个ID用逗号分隔）
* @return 统一响应结果
*/
@ApiOperation("批量逻辑删除员工")
@DeleteMapping("/batch/{ids}") // 接收DELETE请求，完整路径为/staff/batch/{ids}
@PreAuthorize("hasAnyAuthority('system:staff:delete')") // 权限控制
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.staffService.deleteBatch(ids);
}
@ApiOperation("编辑更新")
@PutMapping
@PreAuthorize("hasAnyAuthority('system:staff:edit','system:staff:enable')")
/**
* 编辑更新员工信息（含员工状态启用/禁用）
* @param staff 包含更新信息的员工实体（通过请求体传递）
* @return 统一响应结果
*/
@ApiOperation("编辑更新员工信息")
@PutMapping // 接收PUT请求，完整路径为/staff
@PreAuthorize("hasAnyAuthority('system:staff:edit','system:staff:enable')") // 权限控制：拥有两个权限中的任意一个即可访问
public ResponseDTO edit(@RequestBody Staff staff) {
return this.staffService.edit(staff);
}
@ApiOperation("查询")
@GetMapping("/{id}")
/**
* 根据ID查询员工基础信息
* @param id 员工ID（通过URL路径传递）
* @return 统一响应结果（包含查询到的员工基础信息）
*/
@ApiOperation("根据ID查询员工基础信息")
@GetMapping("/{id}") // 接收GET请求，完整路径为/staff/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.staffService.query(id);
}
@ApiOperation("查询员工信息")
@GetMapping("/info/{id}")
/**
* 根据ID查询员工详细信息（可能包含关联的部门、角色等扩展信息）
* @param id 员工ID（通过URL路径传递）
* @return 统一响应结果（包含员工详细信息）
*/
@ApiOperation("根据ID查询员工详细信息")
@GetMapping("/info/{id}") // 接收GET请求，完整路径为/staff/info/{id}
public ResponseDTO queryInfo(@PathVariable Integer id) {
return this.staffService.queryInfo(id);
}
@ApiOperation("多条件分页查询")
@GetMapping
@PreAuthorize("hasAnyAuthority('system:staff:list','system:staff:search')")
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, String name, String birthday, Integer deptId, Integer status) {
/**
* 多条件分页查询员工列表
* @param current 当前页码（默认第1页）
* @param size 每页条数（默认10条）
* @param name 员工姓名（查询条件，可选）
* @param birthday 员工生日（查询条件，可选）
* @param deptId 所属部门ID（查询条件，可选）
* @param status 员工状态（查询条件，可选，如启用/禁用）
* @return 统一响应结果（包含分页查询结果）
*/
@ApiOperation("多条件分页查询员工列表")
@GetMapping // 接收GET请求，完整路径为/staff
@PreAuthorize("hasAnyAuthority('system:staff:list','system:staff:search')") // 权限控制
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current,
@RequestParam(defaultValue = "10") Integer size,
String name,
String birthday,
Integer deptId,
Integer status) {
return this.staffService.list(current, size, name, birthday, deptId, status);
}
@ApiOperation("数据导出接口")
@GetMapping("/export/{filename}")
@PreAuthorize("hasAnyAuthority('system:staff:export')")
/**
* 员工数据导出接口（将员工数据导出为文件）
* @param response HTTP响应对象，用于输出文件流
* @param filename 导出的文件名（通过URL路径传递）
* @throws IOException 可能抛出文件IO异常
*/
@ApiOperation("员工数据导出接口")
@GetMapping("/export/{filename}") // 接收GET请求，完整路径为/staff/export/{filename}
@PreAuthorize("hasAnyAuthority('system:staff:export')") // 权限控制
public void export(HttpServletResponse response, @PathVariable String filename) throws IOException {
this.staffService.export(response, filename);
}
@ApiOperation("数据导入接口")
@PostMapping("/import")
@PreAuthorize("hasAnyAuthority('system:staff:import')")
/**
* 员工数据导入接口（从上传的文件导入员工数据）
* @param file 包含员工数据的上传文件
* @return 统一响应结果（包含导入结果信息）
* @throws IOException 可能抛出文件读取异常
*/
@ApiOperation("员工数据导入接口")
@PostMapping("/import") // 接收POST请求，完整路径为/staff/import
@PreAuthorize("hasAnyAuthority('system:staff:import')") // 权限控制
public ResponseDTO imp(MultipartFile file) throws IOException {
return this.staffService.imp(file);
}
/**
* 为员工分配角色
* @param id 员工ID（通过URL路径传递）
* @param roleIds 角色ID列表（通过请求体传递，指定要分配的角色）
* @return 统一响应结果（包含角色分配结果）
*/
@ApiOperation("为员工设置角色")
@PostMapping("/set/{id}")
@PreAuthorize("hasAnyAuthority('system:staff:set_role')")
@PostMapping("/set/{id}") // 接收POST请求，完整路径为/staff/set/{id}
@PreAuthorize("hasAnyAuthority('system:staff:set_role')") // 权限控制
public ResponseDTO setRole(@PathVariable Integer id, @RequestBody List<Integer> roleIds) {
return this.staffRoleService.setRole(id, roleIds);
}
@ApiOperation("得到员工的角色")
@GetMapping("/staff/{id}")
/**
* 查询指定员工已分配的角色
* @param id 员工ID（通过URL路径传递）
* @return 统一响应结果（包含员工的角色列表）
*/
@ApiOperation("查询员工已分配的角色")
@GetMapping("/staff/{id}") // 接收GET请求，完整路径为/staff/staff/{id}
public ResponseDTO queryByStaffId(@PathVariable Integer id) {
return this.staffRoleService.queryByStaffId(id);
}
@ApiOperation("检查员工的密码")
@GetMapping("/{pwd}/{id}")
/**
* 验证员工密码是否正确
* @param pwd 待验证的密码（通过URL路径传递）
* @param id 员工ID（通过URL路径传递）
* @return 统一响应结果（包含密码验证结果）
*/
@ApiOperation("验证员工密码")
@GetMapping("/{pwd}/{id}") // 接收GET请求，完整路径为/staff/{pwd}/{id}
public ResponseDTO validate(@PathVariable String pwd, @PathVariable Integer id) {
return this.staffService.validate(pwd, id);
}
@ApiOperation("更新密码")
@PutMapping("/reset")
/**
* 重置员工密码
* @param staff 包含员工ID和新密码的实体对象（通过请求体传递）
* @return 统一响应结果（包含密码重置结果）
*/
@ApiOperation("重置员工密码")
@PutMapping("/reset") // 接收PUT请求，完整路径为/staff/reset
public ResponseDTO reset(@RequestBody Staff staff) {
return this.staffService.reset(staff);
}
}
}
Write Preview
Loading…
Cancel
Save