DeXun/fad_oa
9
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(oa): 新增OA文件操作记录功能

Browse Source 
- 新增文件操作记录实体类及对应Mapper、Service、Controller
- 实现文件操作记录的增删改查接口
- 支持分页查询与导出Excel功能
- 添加操作类型字段（上传/删除）及相关校验逻辑
- 配置MyBatis Plus逻辑删除标识字段
- 提供VO、BO对象用于前后端数据传输与业务处理
This commit is contained in:
Joshi
2025-12-03 17:11:25 +08:00
parent 6d84da23c3
commit 432e75d641
8 changed files with 475 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

101
ruoyi-oa/src/main/java/com/ruoyi/oa/controller/OaFileOperationRecordController.java Normal file
View File

@@ -0,0 +1,101 @@
package com.ruoyi.oa.controller;
import java.util.List;
import java.util.Arrays;
import java.util.concurrent.TimeUnit;
import lombok.RequiredArgsConstructor;
import javax.servlet.http.HttpServletResponse;
import javax.validation.constraints.*;
import org.springframework.web.bind.annotation.*;
import org.springframework.validation.annotation.Validated;
import com.ruoyi.common.annotation.RepeatSubmit;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.PageQuery;
import com.ruoyi.common.core.domain.R;
import com.ruoyi.common.core.validate.AddGroup;
import com.ruoyi.common.core.validate.EditGroup;
import com.ruoyi.common.core.validate.QueryGroup;
import com.ruoyi.common.enums.BusinessType;
import com.ruoyi.common.utils.poi.ExcelUtil;
import com.ruoyi.oa.domain.vo.OaFileOperationRecordVo;
import com.ruoyi.oa.domain.bo.OaFileOperationRecordBo;
import com.ruoyi.oa.service.IOaFileOperationRecordService;
import com.ruoyi.common.core.page.TableDataInfo;
/**
* OA文件操作记录
*
* @author Joshi
* @date 2025-12-03
*/
@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/oa/fileOperationRecord")
public class OaFileOperationRecordController extends BaseController {
private final IOaFileOperationRecordService iOaFileOperationRecordService;
/**
* 查询OA文件操作记录列表
*/
@GetMapping("/list")
public TableDataInfo<OaFileOperationRecordVo> list(OaFileOperationRecordBo bo, PageQuery pageQuery) {
return iOaFileOperationRecordService.queryPageList(bo, pageQuery);
}
/**
* 导出OA文件操作记录列表
*/
@Log(title = "OA文件操作记录", businessType = BusinessType.EXPORT)
@PostMapping("/export")
public void export(OaFileOperationRecordBo bo, HttpServletResponse response) {
List<OaFileOperationRecordVo> list = iOaFileOperationRecordService.queryList(bo);
ExcelUtil.exportExcel(list, "OA文件操作记录", OaFileOperationRecordVo.class, response);
}
/**
* 获取OA文件操作记录详细信息
*
* @param recordId 主键
*/
@GetMapping("/{recordId}")
public R<OaFileOperationRecordVo> getInfo(@NotNull(message = "主键不能为空")
@PathVariable Long recordId) {
return R.ok(iOaFileOperationRecordService.queryById(recordId));
}
/**
* 新增OA文件操作记录
*/
@Log(title = "OA文件操作记录", businessType = BusinessType.INSERT)
@RepeatSubmit()
@PostMapping()
public R<Void> add(@Validated(AddGroup.class) @RequestBody OaFileOperationRecordBo bo) {
return toAjax(iOaFileOperationRecordService.insertByBo(bo));
}
/**
* 修改OA文件操作记录
*/
@Log(title = "OA文件操作记录", businessType = BusinessType.UPDATE)
@RepeatSubmit()
@PutMapping()
public R<Void> edit(@Validated(EditGroup.class) @RequestBody OaFileOperationRecordBo bo) {
return toAjax(iOaFileOperationRecordService.updateByBo(bo));
}
/**
* 删除OA文件操作记录
*
* @param recordIds 主键串
*/
@Log(title = "OA文件操作记录", businessType = BusinessType.DELETE)
@DeleteMapping("/{recordIds}")
public R<Void> remove(@NotEmpty(message = "主键不能为空")
@PathVariable Long[] recordIds) {
return toAjax(iOaFileOperationRecordService.deleteWithValidByIds(Arrays.asList(recordIds), true));
}
}

56
ruoyi-oa/src/main/java/com/ruoyi/oa/domain/OaFileOperationRecord.java Normal file
View File

@@ -0,0 +1,56 @@
package com.ruoyi.oa.domain;
import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import lombok.EqualsAndHashCode;
import java.io.Serializable;
import java.util.Date;
import java.math.BigDecimal;
import com.ruoyi.common.core.domain.BaseEntity;
/**
* OA文件操作记录对象 oa_file_operation_record
*
* @author Joshi
* @date 2025-12-03
*/
@Data
@EqualsAndHashCode(callSuper = true)
@TableName("oa_file_operation_record")
public class OaFileOperationRecord extends BaseEntity {
private static final long serialVersionUID=1L;
/**
* 主键ID
*/
@TableId(value = "record_id")
private Long recordId;
/**
* 文件ID（关联文件表主键）
*/
private String fileId;
/**
* 文件名
*/
private String fileName;
/**
* 操作人姓名
*/
private String operatorName;
/**
* 操作类型：1-上传 2-删除
*/
private Long type;
/**
* 备注
*/
private String remark;
/**
* 是否删除（0-未删除 1-已删除）
*/
@TableLogic
private Long delFlag;
}

55
ruoyi-oa/src/main/java/com/ruoyi/oa/domain/bo/OaFileOperationRecordBo.java Normal file
View File

@@ -0,0 +1,55 @@
package com.ruoyi.oa.domain.bo;
import com.ruoyi.common.core.validate.AddGroup;
import com.ruoyi.common.core.validate.EditGroup;
import lombok.Data;
import lombok.EqualsAndHashCode;
import javax.validation.constraints.*;
import java.util.Date;
import com.ruoyi.common.core.domain.BaseEntity;
/**
* OA文件操作记录业务对象 oa_file_operation_record
*
* @author Joshi
* @date 2025-12-03
*/
@Data
@EqualsAndHashCode(callSuper = true)
public class OaFileOperationRecordBo extends BaseEntity {
/**
* 主键ID
*/
private Long recordId;
/**
* 文件ID（关联文件表主键）
*/
private String fileId;
/**
* 文件名
*/
private String fileName;
/**
* 操作人姓名
*/
private String operatorName;
/**
* 操作类型：1-上传 2-删除
*/
private Long type;
/**
* 备注
*/
private String remark;
}

62
ruoyi-oa/src/main/java/com/ruoyi/oa/domain/vo/OaFileOperationRecordVo.java Normal file
View File

@@ -0,0 +1,62 @@
package com.ruoyi.oa.domain.vo;
import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
import com.alibaba.excel.annotation.ExcelProperty;
import com.ruoyi.common.annotation.ExcelDictFormat;
import com.ruoyi.common.convert.ExcelDictConvert;
import lombok.Data;
import java.util.Date;
/**
* OA文件操作记录视图对象 oa_file_operation_record
*
* @author Joshi
* @date 2025-12-03
*/
@Data
@ExcelIgnoreUnannotated
public class OaFileOperationRecordVo {
private static final long serialVersionUID = 1L;
/**
* 主键ID
*/
@ExcelProperty(value = "主键ID")
private Long recordId;
/**
* 文件ID（关联文件表主键）
*/
@ExcelProperty(value = "文件ID", converter = ExcelDictConvert.class)
@ExcelDictFormat(readConverterExp = "关=联文件表主键")
private String fileId;
/**
* 文件名
*/
@ExcelProperty(value = "文件名")
private String fileName;
/**
* 操作人姓名
*/
@ExcelProperty(value = "操作人姓名")
private String operatorName;
/**
* 操作类型：1-上传 2-删除
*/
@ExcelProperty(value = "操作类型：1-上传 2-删除")
private Long type;
/**
* 备注
*/
@ExcelProperty(value = "备注")
private String remark;
}

15
ruoyi-oa/src/main/java/com/ruoyi/oa/mapper/OaFileOperationRecordMapper.java Normal file
View File

@@ -0,0 +1,15 @@
package com.ruoyi.oa.mapper;
import com.ruoyi.oa.domain.OaFileOperationRecord;
import com.ruoyi.oa.domain.vo.OaFileOperationRecordVo;
import com.ruoyi.common.core.mapper.BaseMapperPlus;
/**
* OA文件操作记录Mapper接口
*
* @author Joshi
* @date 2025-12-03
*/
public interface OaFileOperationRecordMapper extends BaseMapperPlus<OaFileOperationRecordMapper, OaFileOperationRecord, OaFileOperationRecordVo> {
}

49
ruoyi-oa/src/main/java/com/ruoyi/oa/service/IOaFileOperationRecordService.java Normal file
View File

@@ -0,0 +1,49 @@
package com.ruoyi.oa.service;
import com.ruoyi.oa.domain.OaFileOperationRecord;
import com.ruoyi.oa.domain.vo.OaFileOperationRecordVo;
import com.ruoyi.oa.domain.bo.OaFileOperationRecordBo;
import com.ruoyi.common.core.page.TableDataInfo;
import com.ruoyi.common.core.domain.PageQuery;
import java.util.Collection;
import java.util.List;
/**
* OA文件操作记录Service接口
*
* @author Joshi
* @date 2025-12-03
*/
public interface IOaFileOperationRecordService {
/**
* 查询OA文件操作记录
*/
OaFileOperationRecordVo queryById(Long recordId);
/**
* 查询OA文件操作记录列表
*/
TableDataInfo<OaFileOperationRecordVo> queryPageList(OaFileOperationRecordBo bo, PageQuery pageQuery);
/**
* 查询OA文件操作记录列表
*/
List<OaFileOperationRecordVo> queryList(OaFileOperationRecordBo bo);
/**
* 新增OA文件操作记录
*/
Boolean insertByBo(OaFileOperationRecordBo bo);
/**
* 修改OA文件操作记录
*/
Boolean updateByBo(OaFileOperationRecordBo bo);
/**
* 校验并批量删除OA文件操作记录信息
*/
Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
}

115
ruoyi-oa/src/main/java/com/ruoyi/oa/service/impl/OaFileOperationRecordServiceImpl.java Normal file
View File

@@ -0,0 +1,115 @@
package com.ruoyi.oa.service.impl;
import cn.hutool.core.bean.BeanUtil;
import com.ruoyi.common.helper.LoginHelper;
import com.ruoyi.common.utils.StringUtils;
import com.ruoyi.common.core.page.TableDataInfo;
import com.ruoyi.common.core.domain.PageQuery;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Service;
import com.ruoyi.oa.domain.bo.OaFileOperationRecordBo;
import com.ruoyi.oa.domain.vo.OaFileOperationRecordVo;
import com.ruoyi.oa.domain.OaFileOperationRecord;
import com.ruoyi.oa.mapper.OaFileOperationRecordMapper;
import com.ruoyi.oa.service.IOaFileOperationRecordService;
import java.util.List;
import java.util.Map;
import java.util.Collection;
/**
* OA文件操作记录Service业务层处理
*
* @author Joshi
* @date 2025-12-03
*/
@RequiredArgsConstructor
@Service
public class OaFileOperationRecordServiceImpl implements IOaFileOperationRecordService {
private final OaFileOperationRecordMapper baseMapper;
/**
* 查询OA文件操作记录
*/
@Override
public OaFileOperationRecordVo queryById(Long recordId){
return baseMapper.selectVoById(recordId);
}
/**
* 查询OA文件操作记录列表
*/
@Override
public TableDataInfo<OaFileOperationRecordVo> queryPageList(OaFileOperationRecordBo bo, PageQuery pageQuery) {
LambdaQueryWrapper<OaFileOperationRecord> lqw = buildQueryWrapper(bo);
Page<OaFileOperationRecordVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
return TableDataInfo.build(result);
}
/**
* 查询OA文件操作记录列表
*/
@Override
public List<OaFileOperationRecordVo> queryList(OaFileOperationRecordBo bo) {
LambdaQueryWrapper<OaFileOperationRecord> lqw = buildQueryWrapper(bo);
return baseMapper.selectVoList(lqw);
}
private LambdaQueryWrapper<OaFileOperationRecord> buildQueryWrapper(OaFileOperationRecordBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<OaFileOperationRecord> lqw = Wrappers.lambdaQuery();
lqw.eq(StringUtils.isNotBlank(bo.getFileId()), OaFileOperationRecord::getFileId, bo.getFileId());
lqw.like(StringUtils.isNotBlank(bo.getFileName()), OaFileOperationRecord::getFileName, bo.getFileName());
lqw.like(StringUtils.isNotBlank(bo.getOperatorName()), OaFileOperationRecord::getOperatorName, bo.getOperatorName());
lqw.eq(bo.getType() != null, OaFileOperationRecord::getType, bo.getType());
lqw.orderByDesc(OaFileOperationRecord::getCreateTime);
return lqw;
}
/**
* 新增OA文件操作记录
*/
@Override
public Boolean insertByBo(OaFileOperationRecordBo bo) {
OaFileOperationRecord add = BeanUtil.toBean(bo, OaFileOperationRecord.class);
validEntityBeforeSave(add);
add.setOperatorName(LoginHelper.getNickName());
boolean flag = baseMapper.insert(add) > 0;
if (flag) {
bo.setRecordId(add.getRecordId());
}
return flag;
}
/**
* 修改OA文件操作记录
*/
@Override
public Boolean updateByBo(OaFileOperationRecordBo bo) {
OaFileOperationRecord update = BeanUtil.toBean(bo, OaFileOperationRecord.class);
validEntityBeforeSave(update);
return baseMapper.updateById(update) > 0;
}
/**
* 保存前的数据校验
*/
private void validEntityBeforeSave(OaFileOperationRecord entity){
//TODO 做一些数据校验,如唯一约束
}
/**
* 批量删除OA文件操作记录
*/
@Override
public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
if(isValid){
//TODO 做一些业务上的校验,判断是否需要校验
}
return baseMapper.deleteBatchIds(ids) > 0;
}
}

22
ruoyi-oa/src/main/resources/mapper/oa/OaFileOperationRecordMapper.xml Normal file
View File

@@ -0,0 +1,22 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ruoyi.oa.mapper.OaFileOperationRecordMapper">
<resultMap type="com.ruoyi.oa.domain.OaFileOperationRecord" id="OaFileOperationRecordResult">
<result property="recordId" column="record_id"/>
<result property="fileId" column="file_id"/>
<result property="fileName" column="file_name"/>
<result property="operatorName" column="operator_name"/>
<result property="type" column="type"/>
<result property="remark" column="remark"/>
<result property="createBy" column="create_by"/>
<result property="createTime" column="create_time"/>
<result property="updateBy" column="update_by"/>
<result property="updateTime" column="update_time"/>
<result property="delFlag" column="del_flag"/>
</resultMap>
</mapper>