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

1 #8

Merged
pxf8gw7s3 merged 17 commits from hrm/wlk into develop 3 months ago
Conversation 0 Commits 17 Files Changed 7
7 changed files with 485 additions and 166 deletions
Show Stats Download Patch File Download Diff File

124
hrm/src/main/java/com/qiujie/controller/AttendanceController.java
Unescape View File

@ -2,7 +2,6 @@ package com.qiujie.controller;
import com.qiujie.service.AttendanceService;
import com.qiujie.entity.Attendance;
import com.qiujie.dto.ResponseDTO;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
@ -15,91 +14,156 @@ import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
/**
* <p>
* 前端控制器
* </p>
*
* 考勤管理前端控制器
* 处理考勤相关的所有HTTP请求，包括考勤记录的增删改查、导入导出等操作
*
* @author qiujie
* @since 2022-03-29
*/
@RestController
@RequestMapping("/attendance")
@RestController // 标识为RESTful控制器，返回数据均为JSON格式
@RequestMapping("/attendance") // 定义基础请求路径为/attendance
public class AttendanceController {
@Autowired
@Autowired // 自动注入考勤服务类
private AttendanceService attendanceService;
/**
* 新增考勤记录接口
* @param attendance 考勤实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("新增")
@PostMapping
@PostMapping // 处理POST请求，路径为/attendance
public ResponseDTO add(@RequestBody Attendance attendance) {
return this.attendanceService.add(attendance);
}
/**
* 逻辑删除考勤记录接口
* @param id 考勤记录ID，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@DeleteMapping("/{id}") // 处理DELETE请求，路径为/attendance/{id}
public ResponseDTO delete(@PathVariable Integer id) {
return this.attendanceService.delete(id);
}
/**
* 批量逻辑删除考勤记录接口
* @param ids 考勤记录ID列表，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@DeleteMapping("/batch/{ids}") // 处理DELETE请求，路径为/attendance/batch/{ids}
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.attendanceService.deleteBatch(ids);
}
/**
* 编辑更新考勤记录接口
* @param attendance 考勤实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("编辑更新")
@PutMapping
@PutMapping // 处理PUT请求，路径为/attendance
public ResponseDTO edit(@RequestBody Attendance attendance) {
return this.attendanceService.edit(attendance);
}
/**
* 根据ID查询考勤记录详情接口
* @param id 考勤记录ID，通过路径参数传入
* @return 考勤记录信息响应
*/
@ApiOperation("查询")
@GetMapping("/{id}")
@GetMapping("/{id}") // 处理GET请求，路径为/attendance/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.attendanceService.query(id);
}
/**
* 条件分页查询考勤记录列表接口
* @param current 当前页码，默认为1
* @param size 每页大小，默认为10
* @param name 员工姓名（模糊查询条件）
* @param deptId 部门ID（筛选条件）
* @param month 月份（格式如：2024-01）
* @return 分页考勤记录列表响应
*/
@ApiOperation("条件查询")
@GetMapping
@PreAuthorize("hasAnyAuthority('performance:attendance:list','performance:attendance:search')")
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, String name, Integer deptId, String month) {
@GetMapping // 处理GET请求，路径为/attendance
@PreAuthorize("hasAnyAuthority('performance:attendance:list','performance:attendance:search')") // 需要具备考勤列表查看或搜索权限
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current,
@RequestParam(defaultValue = "10") Integer size,
String name,
Integer deptId,
String month) {
return this.attendanceService.list(current, size, name, deptId, month);
}
/**
* 考勤数据导出接口
* @param response HTTP响应对象，用于输出Excel文件
* @param month 导出数据的月份，通过路径参数传入
* @param filename 导出文件名，通过路径参数传入
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导出接口")
@GetMapping("/export/{month}/{filename}")
@PreAuthorize("hasAnyAuthority('performance:attendance:export')")
public void export(HttpServletResponse response, @PathVariable String month,@PathVariable String filename) throws IOException {
this.attendanceService.export(response, month,filename);
@GetMapping("/export/{month}/{filename}") // 处理GET请求，路径为/attendance/export/{month}/{filename}
@PreAuthorize("hasAnyAuthority('performance:attendance:export')") // 需要具备考勤数据导出权限
public void export(HttpServletResponse response,
@PathVariable String month,
@PathVariable String filename) throws IOException {
this.attendanceService.export(response, month, filename);
}
/**
* 考勤数据导入接口
* @param file Excel文件对象，包含考勤数据
* @return 导入结果响应
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导入接口")
@PostMapping("/import")
@PreAuthorize("hasAnyAuthority('performance:attendance:import')")
@PostMapping("/import") // 处理POST请求，路径为/attendance/import
@PreAuthorize("hasAnyAuthority('performance:attendance:import')") // 需要具备考勤数据导入权限
public ResponseDTO imp(MultipartFile file) throws IOException {
return this.attendanceService.imp(file);
}
/**
* 根据员工ID和日期查询考勤记录接口
* @param id 员工ID，通过路径参数传入
* @param date 日期字符串，格式如：2024-01-15
* @return 考勤记录信息响应
*/
@ApiOperation("查询")
@GetMapping("/{id}/{date}")
@GetMapping("/{id}/{date}") // 处理GET请求，路径为/attendance/{id}/{date}
public ResponseDTO queryByStaffIdAndDate(@PathVariable Integer id, @PathVariable String date) {
return this.attendanceService.queryByStaffIdAndDate(id, date);
}
/**
* 保存或更新考勤记录接口
* 如果考勤记录存在则更新，不存在则新增
* @param attendance 考勤实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("保存或更新")
@PutMapping("/set")
@PreAuthorize("hasAnyAuthority('performance:attendance:set')")
@PutMapping("/set") // 处理PUT请求，路径为/attendance/set
@PreAuthorize("hasAnyAuthority('performance:attendance:set')") // 需要具备设置考勤权限
public ResponseDTO setAttendance(@RequestBody Attendance attendance) {
return this.attendanceService.setAttendance(attendance);
}
/**
* 查询所有考勤记录接口
* @return 所有考勤记录列表响应
*/
@ApiOperation("获取所有")
@GetMapping("/all")
@GetMapping("/all") // 处理GET请求，路径为/attendance/all
public ResponseDTO queryAll() {
return this.attendanceService.queryAll();
}
}
}

106
hrm/src/main/java/com/qiujie/controller/CityController.java
Unescape View File

@ -14,83 +14,129 @@ import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
/**
* <p>
* 前端控制器
* </p>
*
* 城市管理前端控制器
* 处理城市相关的所有HTTP请求，包括城市信息的增删改查、导入导出等操作
* 通常用于管理员工所在城市信息，可能与薪资计算、补贴等相关
*
* @author qiujie
* @since 2022-03-23
*/
@RestController
@RequestMapping("/city")
@RestController // 标识为RESTful控制器，返回数据均为JSON格式
@RequestMapping("/city") // 定义基础请求路径为/city
public class CityController {
@Autowired
@Autowired // 自动注入城市服务类
private CityService cityService;
/**
* 新增城市信息接口
* @param city 城市实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("新增")
@PostMapping
@PreAuthorize("hasAnyAuthority('money:city:add')")
@PostMapping // 处理POST请求，路径为/city
@PreAuthorize("hasAnyAuthority('money:city:add')") // 需要具备新增城市权限（money权限域）
public ResponseDTO add(@RequestBody City city) {
return this.cityService.add(city);
}
/**
* 逻辑删除城市信息接口
* @param id 城市ID，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@PreAuthorize("hasAnyAuthority('money:city:delete')")
@DeleteMapping("/{id}") // 处理DELETE请求，路径为/city/{id}
@PreAuthorize("hasAnyAuthority('money:city:delete')") // 需要具备删除城市权限
public ResponseDTO delete(@PathVariable Integer id) {
return this.cityService.delete(id);
}
/**
* 批量逻辑删除城市信息接口
* @param ids 城市ID列表，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@PreAuthorize("hasAnyAuthority('money:city:delete')")
@DeleteMapping("/batch/{ids}") // 处理DELETE请求，路径为/city/batch/{ids}
@PreAuthorize("hasAnyAuthority('money:city:delete')") // 需要具备删除城市权限
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.cityService.deleteBatch(ids);
}
/**
* 编辑更新城市信息接口
* @param city 城市实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("编辑更新")
@PutMapping
@PreAuthorize("hasAnyAuthority('money:city:edit')")
@PutMapping // 处理PUT请求，路径为/city
@PreAuthorize("hasAnyAuthority('money:city:edit')") // 需要具备编辑城市权限
public ResponseDTO edit(@RequestBody City city) {
return this.cityService.edit(city);
}
/**
* 根据ID查询城市详情接口
* @param id 城市ID，通过路径参数传入
* @return 城市信息响应
*/
@ApiOperation("查询")
@GetMapping("/{id}")
@GetMapping("/{id}") // 处理GET请求，路径为/city/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.cityService.query(id);
}
/**
* 查询所有城市信息接口
* @return 所有城市列表响应
*/
@ApiOperation("查询所有")
@GetMapping("/all")
@GetMapping("/all") // 处理GET请求，路径为/city/all
public ResponseDTO queryAll() {
return this.cityService.queryAll();
}
/**
* 条件分页查询城市列表接口
* @param current 当前页码，默认为1
* @param size 每页大小，默认为10
* @param name 城市名称（模糊查询条件）
* @return 分页城市列表响应
*/
@ApiOperation("条件查询")
@GetMapping
@PreAuthorize("hasAnyAuthority('money:city:list','money:city:search')")
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, String name) {
@GetMapping // 处理GET请求，路径为/city
@PreAuthorize("hasAnyAuthority('money:city:list','money:city:search')") // 需要具备城市列表查看或搜索权限
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current,
@RequestParam(defaultValue = "10") Integer size,
String name) {
return this.cityService.list(current, size, name);
}
/**
* 城市数据导出接口
* @param response HTTP响应对象，用于输出Excel文件
* @param filename 导出文件名，通过路径参数传入
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导出接口")
@GetMapping("/export/{filename}")
@PreAuthorize("hasAnyAuthority('money:city:export')")
@GetMapping("/export/{filename}") // 处理GET请求，路径为/city/export/{filename}
@PreAuthorize("hasAnyAuthority('money:city:export')") // 需要具备城市数据导出权限
public void export(HttpServletResponse response, @PathVariable String filename) throws IOException {
this.cityService.export(response, filename);
}
/**
* 城市数据导入接口
* @param file Excel文件对象，包含城市数据
* @return 导入结果响应
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导入接口")
@PostMapping("/import")
@PreAuthorize("hasAnyAuthority('money:city:import')")
@PostMapping("/import") // 处理POST请求，路径为/city/import
@PreAuthorize("hasAnyAuthority('money:city:import')") // 需要具备城市数据导入权限
public ResponseDTO imp(MultipartFile file) throws IOException {
return this.cityService.imp(file);
}
}
}

115
hrm/src/main/java/com/qiujie/controller/InsuranceController.java
Unescape View File

@ -3,7 +3,6 @@ package com.qiujie.controller;
import com.qiujie.entity.Staff;
import com.qiujie.service.InsuranceService;
import com.qiujie.entity.Insurance;
import com.qiujie.dto.ResponseDTO;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
@ -16,83 +15,141 @@ import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
/**
* <p>
* 前端控制器
* </p>
*
* 社保管理前端控制器
* 处理员工社保信息的增删改查、导入导出以及社保设置等操作
* 社保信息通常包括养老保险、医疗保险、失业保险、工伤保险、生育保险等
*
* @author qiujie
* @since 2022-03-23
*/
@RestController
@RequestMapping("/insurance")
@RestController // 标识为RESTful控制器，返回数据均为JSON格式
@RequestMapping("/insurance") // 定义基础请求路径为/insurance
public class InsuranceController {
@Autowired
@Autowired // 自动注入社保服务类
private InsuranceService insuranceService;
/**
* 新增社保信息接口
* @param insurance 社保实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("新增")
@PostMapping
@PostMapping // 处理POST请求，路径为/insurance
public ResponseDTO add(@RequestBody Insurance insurance) {
return this.insuranceService.add(insurance);
}
/**
* 逻辑删除社保信息接口
* @param id 社保记录ID，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@DeleteMapping("/{id}") // 处理DELETE请求，路径为/insurance/{id}
public ResponseDTO delete(@PathVariable Integer id) {
return this.insuranceService.delete(id);
}
/**
* 批量逻辑删除社保信息接口
* @param ids 社保记录ID列表，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@DeleteMapping("/batch/{ids}") // 处理DELETE请求，路径为/insurance/batch/{ids}
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.insuranceService.deleteBatch(ids);
}
/**
* 编辑更新社保信息接口
* @param insurance 社保实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("编辑更新")
@PutMapping
@PutMapping // 处理PUT请求，路径为/insurance
public ResponseDTO edit(@RequestBody Insurance insurance) {
return this.insuranceService.edit(insurance);
}
/**
* 根据ID查询社保详情接口
* @param id 社保记录ID，通过路径参数传入
* @return 社保信息响应
*/
@ApiOperation("查询")
@GetMapping("/{id}")
@GetMapping("/{id}") // 处理GET请求，路径为/insurance/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.insuranceService.query(id);
}
/**
* 根据员工ID查询社保信息接口
* @param id 员工ID，通过路径参数传入
* @return 该员工的社保信息响应
*/
@ApiOperation("查询")
@GetMapping("/staff/{id}")
@GetMapping("/staff/{id}") // 处理GET请求，路径为/insurance/staff/{id}
public ResponseDTO queryByStaffId(@PathVariable Integer id) {
return this.insuranceService.queryByStaffId(id);
}
/**
* 多条件分页查询社保列表接口
* @param current 当前页码，默认为1
* @param size 每页大小，默认为10
* @param name 员工姓名（模糊查询条件）
* @param deptId 部门ID（筛选条件）
* @return 分页社保列表响应
*/
@ApiOperation("多条件分页查询")
@GetMapping
@PreAuthorize("hasAnyAuthority('money:insurance:list','money:insurance:search')")
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, String name, Integer deptId){
return this.insuranceService.list(current, size, name,deptId);
@GetMapping // 处理GET请求，路径为/insurance
@PreAuthorize("hasAnyAuthority('money:insurance:list','money:insurance:search')") // 需要具备社保列表查看或搜索权限
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current,
@RequestParam(defaultValue = "10") Integer size,
String name,
Integer deptId) {
return this.insuranceService.list(current, size, name, deptId);
}
/**
* 社保数据导出接口
* @param response HTTP响应对象，用于输出Excel文件
* @param filename 导出文件名，通过路径参数传入
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导出接口")
@GetMapping("/export/{filename}")
@PreAuthorize("hasAnyAuthority('money:insurance:export')")
public void export(HttpServletResponse response,@PathVariable String filename) throws IOException {
this.insuranceService.export(response,filename);
@GetMapping("/export/{filename}") // 处理GET请求，路径为/insurance/export/{filename}
@PreAuthorize("hasAnyAuthority('money:insurance:export')") // 需要具备社保数据导出权限
public void export(HttpServletResponse response, @PathVariable String filename) throws IOException {
this.insuranceService.export(response, filename);
}
/**
* 社保数据导入接口
* @param file Excel文件对象，包含社保数据
* @return 导入结果响应
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导入接口")
@PostMapping("/import")
@PreAuthorize("hasAnyAuthority('money:insurance:import')")
@PostMapping("/import") // 处理POST请求，路径为/insurance/import
@PreAuthorize("hasAnyAuthority('money:insurance:import')") // 需要具备社保数据导入权限
public ResponseDTO imp(MultipartFile file) throws IOException {
return this.insuranceService.imp(file);
}
/**
* 为员工设置社保信息接口
* 通常用于初始化或更新员工的社保缴纳信息
* @param insurance 社保实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("为员工设置社保")
@PostMapping("/set")
@PreAuthorize("hasAnyAuthority('money:insurance:set')")
@PostMapping("/set") // 处理POST请求，路径为/insurance/set
@PreAuthorize("hasAnyAuthority('money:insurance:set')") // 需要具备设置社保权限
public ResponseDTO setInsurance(@RequestBody Insurance insurance) {
return this.insuranceService.setInsurance(insurance);
}
}
}

88
hrm/src/main/java/com/qiujie/controller/LeaveController.java
Unescape View File

@ -11,77 +11,119 @@ import org.springframework.web.bind.annotation.*;
import javax.annotation.Resource;
import java.util.List;
/**
* <p>
* 请假表 前端控制器
* </p>
*
* 请假管理前端控制器
* 处理请假相关的所有HTTP请求，包括请假信息的增删改查、部门假期设置等操作
* 请假信息包括年假、病假、事假、婚假、产假等各种假期类型
*
* @author qiujie
* @since 2022-03-27
*/
@RestController
@RequestMapping("/leave")
@RestController // 标识为RESTful控制器，返回数据均为JSON格式
@RequestMapping("/leave") // 定义基础请求路径为/leave
public class LeaveController {
@Autowired
@Autowired // 自动注入请假服务类
private LeaveService leaveService;
/**
* 新增请假记录接口
* @param leave 请假实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("新增")
@PostMapping
@PostMapping // 处理POST请求，路径为/leave
public ResponseDTO add(@RequestBody Leave leave) {
return this.leaveService.add(leave);
}
/**
* 逻辑删除请假记录接口
* @param id 请假记录ID，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@DeleteMapping("/{id}") // 处理DELETE请求，路径为/leave/{id}
public ResponseDTO delete(@PathVariable Integer id) {
return this.leaveService.delete(id);
}
/**
* 批量逻辑删除请假记录接口
* @param ids 请假记录ID列表，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@DeleteMapping("/batch/{ids}") // 处理DELETE请求，路径为/leave/batch/{ids}
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.leaveService.deleteBatch(ids);
}
/**
* 编辑更新请假记录接口
* @param leave 请假实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("编辑更新")
@PutMapping
@PutMapping // 处理PUT请求，路径为/leave
public ResponseDTO edit(@RequestBody Leave leave) {
return this.leaveService.edit(leave);
}
/**
* 根据ID查询请假详情接口
* @param id 请假记录ID，通过路径参数传入
* @return 请假信息响应
*/
@ApiOperation("查询")
@GetMapping("/{id}")
@GetMapping("/{id}") // 处理GET请求，路径为/leave/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.leaveService.query(id);
}
/**
* 根据部门ID和请假类型编号查询请假信息接口
* @param deptId 部门ID，通过路径参数传入
* @param typeNum 请假类型编号，通过路径参数传入
* @return 请假信息响应
*/
@ApiOperation("获取")
@GetMapping("/{deptId}/{typeNum}")
@GetMapping("/{deptId}/{typeNum}") // 处理GET请求，路径为/leave/{deptId}/{typeNum}
public ResponseDTO queryByDeptIdAndTypeNum(@PathVariable Integer deptId, @PathVariable Integer typeNum) {
return this.leaveService.queryByDeptIdAndTypeNum(deptId, typeNum);
}
/**
* 设置部门假期政策接口
* 用于配置不同部门的假期规则和额度
* @param leave 请假实体对象，包含假期设置信息，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("设置假期")
@PostMapping("/set")
@PreAuthorize("hasAnyAuthority('system:department:setting')")
@PostMapping("/set") // 处理POST请求，路径为/leave/set
@PreAuthorize("hasAnyAuthority('system:department:setting')") // 需要具备部门设置权限
public ResponseDTO setLeave(@RequestBody Leave leave) {
return this.leaveService.setLeave(leave);
}
/**
* 根据部门ID查询请假信息接口
* @param id 部门ID，通过路径参数传入
* @return 该部门的请假信息响应
*/
@ApiOperation("查询")
@GetMapping("/dept/{id}")
@GetMapping("/dept/{id}") // 处理GET请求，路径为/leave/dept/{id}
public ResponseDTO queryByDeptId(@PathVariable Integer id) {
return this.leaveService.queryByDeptId(id);
}
/**
* 查询所有请假信息接口
* @return 所有请假记录列表响应
*/
@ApiOperation("获取所有")
@GetMapping("/all")
@GetMapping("/all") // 处理GET请求，路径为/leave/all
public ResponseDTO queryAll() {
return this.leaveService.queryAll();
}
}
}

28
hrm/src/main/java/com/qiujie/controller/LoginController.java
Unescape View File

@ -13,24 +13,40 @@ import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
/**
* 登录注册接口
* 登录注册控制器
* 处理用户登录、验证码获取等认证相关功能
*
* @Author : qiujie
* @Date : 2022/1/30
*/
@RestController
@RestController // 标识为RESTful控制器，返回数据均为JSON格式
public class LoginController {
@Autowired
@Autowired // 自动注入登录服务类
private LoginService loginService;
@PostMapping("/login/{validateCode}")
/**
* 用户登录接口
* 验证用户凭证（用户名/密码）和验证码，生成认证令牌
*
* @param staff 员工实体对象，通过请求体传入，包含登录凭证（如用户名、密码）
* @param validateCode 验证码，通过路径参数传入
* @return 登录结果响应，包含认证令牌和用户信息
*/
@PostMapping("/login/{validateCode}") // 处理POST请求，路径为/login/{validateCode}
public ResponseDTO login(@RequestBody Staff staff, @PathVariable String validateCode) {
return this.loginService.login(staff, validateCode);
}
@GetMapping("/validate/code")
/**
* 获取验证码接口
* 生成图形验证码并输出到HTTP响应流中，用于登录时的验证码验证
*
* @param response HTTP响应对象，用于输出验证码图片
* @throws IOException 可能抛出IO异常
*/
@GetMapping("/validate/code") // 处理GET请求，路径为/validate/code
public void getValidateCode(HttpServletResponse response) throws IOException {
this.loginService.getValidateCode(response);
}
}
}

111
hrm/src/main/java/com/qiujie/controller/SalaryController.java
Unescape View File

@ -14,80 +14,135 @@ import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
/**
* <p>
* 前端控制器
* </p>
*
* 薪资管理前端控制器
* 处理员工薪资信息的增删改查、导入导出以及薪资设置等操作
* 薪资信息包括基本工资、奖金、津贴、扣款等各项薪资组成
*
* @author qiujie
* @since 2022-04-06
*/
@RestController
@RequestMapping("/salary")
@RestController // 标识为RESTful控制器，返回数据均为JSON格式
@RequestMapping("/salary") // 定义基础请求路径为/salary
public class SalaryController {
@Autowired
@Autowired // 自动注入薪资服务类
private SalaryService salaryService;
/**
* 新增薪资记录接口
* @param salary 薪资实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("新增")
@PostMapping
@PostMapping // 处理POST请求，路径为/salary
public ResponseDTO add(@RequestBody Salary salary) {
return this.salaryService.add(salary);
}
/**
* 逻辑删除薪资记录接口
* @param id 薪资记录ID，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@DeleteMapping("/{id}") // 处理DELETE请求，路径为/salary/{id}
public ResponseDTO delete(@PathVariable Integer id) {
return this.salaryService.delete(id);
}
/**
* 批量逻辑删除薪资记录接口
* @param ids 薪资记录ID列表，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@DeleteMapping("/batch/{ids}") // 处理DELETE请求，路径为/salary/batch/{ids}
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.salaryService.deleteBatch(ids);
}
/**
* 编辑更新薪资记录接口
* @param salary 薪资实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("编辑更新")
@PutMapping
@PutMapping // 处理PUT请求，路径为/salary
public ResponseDTO edit(@RequestBody Salary salary) {
return this.salaryService.edit(salary);
}
/**
* 根据ID查询薪资详情接口
* @param id 薪资记录ID，通过路径参数传入
* @return 薪资信息响应
*/
@ApiOperation("查询")
@GetMapping("/{id}")
@GetMapping("/{id}") // 处理GET请求，路径为/salary/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.salaryService.query(id);
}
/**
* 分页条件查询薪资列表接口
* @param current 当前页码，默认为1
* @param size 每页大小，默认为10
* @param name 员工姓名（模糊查询条件）
* @param deptId 部门ID（筛选条件）
* @param month 薪资月份（格式如：2024-01）
* @return 分页薪资列表响应
*/
@ApiOperation("分页条件查询")
@GetMapping
@PreAuthorize("hasAnyAuthority('money:salary:list','money:salary:search')")
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, String name, Integer deptId, String month) {
@GetMapping // 处理GET请求，路径为/salary
@PreAuthorize("hasAnyAuthority('money:salary:list','money:salary:search')") // 需要具备薪资列表查看或搜索权限
public ResponseDTO list(@RequestParam(defaultValue = "1") Integer current,
@RequestParam(defaultValue = "10") Integer size,
String name,
Integer deptId,
String month) {
return this.salaryService.list(current, size, name, deptId, month);
}
/**
* 薪资数据导出接口
* @param response HTTP响应对象，用于输出Excel文件
* @param month 导出数据的月份，通过路径参数传入
* @param filename 导出文件名，通过路径参数传入
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导出接口")
@GetMapping("/export/{month}/{filename}")
@PreAuthorize("hasAnyAuthority('money:salary:export')")
public void export(HttpServletResponse response, @PathVariable String month,@PathVariable String filename) throws IOException {
this.salaryService.export(response, month,filename);
@GetMapping("/export/{month}/{filename}") // 处理GET请求，路径为/salary/export/{month}/{filename}
@PreAuthorize("hasAnyAuthority('money:salary:export')") // 需要具备薪资数据导出权限
public void export(HttpServletResponse response,
@PathVariable String month,
@PathVariable String filename) throws IOException {
this.salaryService.export(response, month, filename);
}
/**
* 薪资数据导入接口
* @param file Excel文件对象，包含薪资数据
* @return 导入结果响应
* @throws IOException 可能抛出IO异常
*/
@ApiOperation("数据导入接口")
@PostMapping("/import")
@PreAuthorize("hasAnyAuthority('money:salary:import')")
@PostMapping("/import") // 处理POST请求，路径为/salary/import
@PreAuthorize("hasAnyAuthority('money:salary:import')") // 需要具备薪资数据导入权限
public ResponseDTO imp(MultipartFile file) throws IOException {
return this.salaryService.imp(file);
}
/**
* 设置员工薪资接口
* 用于配置或调整员工的基本工资、岗位工资等固定薪资项
* @param salary 薪资实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("设置工资")
@PostMapping("/set")
@PreAuthorize("hasAnyAuthority('money:salary:set')")
@PostMapping("/set") // 处理POST请求，路径为/salary/set
@PreAuthorize("hasAnyAuthority('money:salary:set')") // 需要具备设置薪资权限
public ResponseDTO setSalary(@RequestBody Salary salary) {
return this.salaryService.setSalary(salary);
}
}
}

79
hrm/src/main/java/com/qiujie/controller/SalaryDeductController.java
Unescape View File

@ -11,69 +11,108 @@ import org.springframework.web.bind.annotation.*;
import javax.annotation.Resource;
import java.util.List;
/**
* <p>
* 工资扣除表 前端控制器
* </p>
*
* 工资扣款管理前端控制器
* 处理工资扣款规则的增删改查以及扣款规则设置等操作
* 工资扣款包括罚款、缺勤扣款、社保公积金个人部分、个税等扣款项
*
* @author qiujie
* @since 2022-03-27
*/
@RestController
@RequestMapping("/salary-deduct")
@RestController // 标识为RESTful控制器，返回数据均为JSON格式
@RequestMapping("/salary-deduct") // 定义基础请求路径为/salary-deduct
public class SalaryDeductController {
@Autowired
@Autowired // 自动注入工资扣款服务类
private SalaryDeductService salaryDeductService;
/**
* 新增工资扣款规则接口
* @param salaryDeduct 工资扣款实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("新增")
@PostMapping
@PostMapping // 处理POST请求，路径为/salary-deduct
public ResponseDTO add(@RequestBody SalaryDeduct salaryDeduct) {
return this.salaryDeductService.add(salaryDeduct);
}
/**
* 逻辑删除工资扣款规则接口
* @param id 工资扣款记录ID，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("逻辑删除")
@DeleteMapping("/{id}")
@DeleteMapping("/{id}") // 处理DELETE请求，路径为/salary-deduct/{id}
public ResponseDTO delete(@PathVariable Integer id) {
return this.salaryDeductService.delete(id);
}
/**
* 批量逻辑删除工资扣款规则接口
* @param ids 工资扣款记录ID列表，通过路径参数传入
* @return 操作结果响应
*/
@ApiOperation("批量逻辑删除")
@DeleteMapping("/batch/{ids}")
@DeleteMapping("/batch/{ids}") // 处理DELETE请求，路径为/salary-deduct/batch/{ids}
public ResponseDTO deleteBatch(@PathVariable List<Integer> ids) {
return this.salaryDeductService.deleteBatch(ids);
}
/**
* 编辑更新工资扣款规则接口
* @param salaryDeduct 工资扣款实体对象，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("编辑更新")
@PutMapping
@PutMapping // 处理PUT请求，路径为/salary-deduct
public ResponseDTO edit(@RequestBody SalaryDeduct salaryDeduct) {
return this.salaryDeductService.edit(salaryDeduct);
}
/**
* 根据ID查询工资扣款详情接口
* @param id 工资扣款记录ID，通过路径参数传入
* @return 工资扣款信息响应
*/
@ApiOperation("查询")
@GetMapping("/{id}")
@GetMapping("/{id}") // 处理GET请求，路径为/salary-deduct/{id}
public ResponseDTO query(@PathVariable Integer id) {
return this.salaryDeductService.query(id);
}
/**
* 根据部门ID和扣款类型编号查询工资扣款规则接口
* @param deptId 部门ID，通过路径参数传入
* @param typeNum 扣款类型编号，通过路径参数传入
* @return 工资扣款信息响应
*/
@ApiOperation("获取")
@GetMapping("/{deptId}/{typeNum}")
@GetMapping("/{deptId}/{typeNum}") // 处理GET请求，路径为/salary-deduct/{deptId}/{typeNum}
public ResponseDTO queryByDeptIdAndTypeNum(@PathVariable Integer deptId, @PathVariable Integer typeNum) {
return this.salaryDeductService.queryByDeptIdAndTypeNum(deptId, typeNum);
}
/**
* 设置部门罚款规则接口
* 用于配置不同部门的罚款规则和扣款标准
* @param salaryDeduct 工资扣款实体对象，包含罚款设置信息，通过请求体传入
* @return 操作结果响应
*/
@ApiOperation("设置罚款")
@PostMapping("/set")
@PreAuthorize("hasAnyAuthority('system:department:setting')")
@PostMapping("/set") // 处理POST请求，路径为/salary-deduct/set
@PreAuthorize("hasAnyAuthority('system:department:setting')") // 需要具备部门设置权限
public ResponseDTO setSalaryDeduct(@RequestBody SalaryDeduct salaryDeduct) {
return this.salaryDeductService.setSalaryDeduct(salaryDeduct);
}
/**
* 查询所有工资扣款规则接口
* @return 所有工资扣款规则列表响应
*/
@ApiOperation("获取所有")
@GetMapping("/all")
@GetMapping("/all") // 处理GET请求，路径为/salary-deduct/all
public ResponseDTO queryAll() {
return this.salaryDeductService.queryAll();
}
}
}
Write Preview
Loading…
Cancel
Save