【开发】特种设备（一）：基本增删改查以及导入导出

需求说明

特种设备从属于设备，是设备的一个特殊分类。

现在公司要求把特种设备从设备中拎出来，单独做个页面，具备常规的增删改查，导入导出以及二维码的功能。

同时要求对特种设备的数据进行数据过滤和权限管控。

若依框架的数据过滤组件是成熟的，可以直接使用，而且配置也非常简单（通过主角@DataScope就可实现，主要是区分全部权限，本部门权限，本部门及其子部门，共三种过滤。）

若依框架的权限管控有两个维度，一是用户维度，这种方式要求对每一个用户都进行赋权。二是角色维度，将权限赋给角色，为用户分配角色，这样能够对权限进行集中管理，推荐。）

特种设备和设备一样，同样具有设备验收和延迟验收的功能，功能入口均在移动端，位于公司企业微信内。

该功能开发完成后，每一个特种设备都会有唯一的二维码，该二维码会打印成设备标签，贴在设备上。

巡检人员只需要扫面二维码就可以完成设备填报的录入，如果遇到节假日，设备更改，设备整改等情况，还可以在移动端进行延迟验收，从而推迟下次检验日期。

同时要开发智能推送的功能，当一台设备临近下次检验日期时，提前30天，23天，以及当天各推送一次（共推送三次！）

表数据

CREATE TABLE `spec_equipment` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `category_id` bigint(20) NOT NULL COMMENT '设备分类ID',
  `spec_name` varchar(255) NOT NULL COMMENT '特种设备名称',
  `asset_model` varchar(255) NOT NULL COMMENT '规格型号',
  `dept_id` varchar(255) NOT NULL COMMENT '所属部门',
  `install_location` varchar(255) NOT NULL COMMENT '安装使用地点',
  `factory_number` varchar(255) NOT NULL COMMENT '厂内使用编号',
  `manufacturer` varchar(255) DEFAULT '' COMMENT '生产厂家',
  `regist_code` varchar(255) DEFAULT '' COMMENT '设备注册登记代码',
  `inspection_no` varchar(255) DEFAULT '' COMMENT '监督检验报告编号',
  `last_inspection_date` datetime DEFAULT NULL COMMENT '上次检验日期',
  `valid_period` int(5) DEFAULT '0' COMMENT '有效期（天）',
  `next_inspection_date` datetime DEFAULT NULL COMMENT '下次检验日期',
  `create_by` varchar(100) DEFAULT NULL COMMENT '创建人',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(100) DEFAULT NULL COMMENT '更新人',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `status` varchar(1) DEFAULT NULL COMMENT '状态（0正常 1停用）',
  `attachment` varchar(500) DEFAULT NULL COMMENT '附件',
  `reserve2` varchar(255) DEFAULT NULL COMMENT '预留字段2',
  `reserve3` varchar(255) DEFAULT NULL COMMENT '预留字段3',
  `reserve4` varchar(255) DEFAULT NULL COMMENT '预留字段4',
  `reserve5` varchar(255) DEFAULT NULL COMMENT '预留字段5',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=23 DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC COMMENT='特种设备';

增删改查，导入导出，这都是基础的功能，不用多说。

但是客户提了个改动，上次检验日期是必填的，有限期和下次检验日期是选填的。

如果有效期已填写，则判断下次检验日期是否填写，填写了，直接新增即可，未填写，则根据上次检验日期+有效期对应的天数，自行计算下次检验日期。

如果有效期未填写，则判断下次检验日期是否填写，填写了，直接新增即可，未填写，返回前台数据格式不正确。

另外再提一句，公司使用的框架版本是3.4.0，这种框架比较老，生成的代码中只有导出，没有导入的功能。

导入按钮

<el-col :span="1.5">
    <el-button
      type="info"
      plain
      icon="el-icon-upload2"
      size="mini"
      @click="handleImport"
      v-hasPermi="['hxems:attach:import']"
    >导入</el-button>
</el-col>

导入模态框

	<!-- 特种设备导入对话框 -->
    <el-dialog :title="upload.title" :visible.sync="upload.open" width="400px" append-to-body>
      <el-upload
        ref="upload"
        :limit="1"
        accept=".xlsx, .xls"
        :headers="upload.headers"
        :action="upload.url"
        :disabled="upload.isUploading"
        :on-progress="handleFileUploadProgress"
        :on-success="handleFileSuccess"
        :auto-upload="false"
        drag
      >
        <i class="el-icon-upload"></i>
        <div class="el-upload__text">将文件拖到此处，或<em>点击上传</em></div>
        <div class="el-upload__tip text-center" slot="tip">
          <span style="color:#ff0000">仅允许导入xls、xlsx格式文件。</span>
          <el-link type="primary" :underline="false" style="font-size:12px;vertical-align: baseline;" @click="importTemplate">下载模板</el-link>
        </div>
      </el-upload>
      <div slot="footer" class="dialog-footer">
        <el-button type="primary" @click="submitFileForm">确 定</el-button>
        <el-button @click="upload.open = false">取 消</el-button>
      </div>
    </el-dialog>

js方法

必须导入getToken和importTemplate。

getToken方法是全局方法，引用即可，而importTemplate是在equipment.js中单独定义的。

// 下载设备导入模板
export function importTemplate() {
  return request({
    url: '/equipment/importTemplate',
    method: 'get'
  })
}

这个方法importTemplate需要在后台控制类中添加处理逻辑：

	/**
     * 导出特种设备模板
     */
    @GetMapping("/importTemplate")
    @Permission(level = ResourceLevel.SITE, permissionLogin = true)
    public AjaxResult importTemplate(){
        ExcelUtil<SpecEquipment> util = new ExcelUtil<>(SpecEquipment.class);
        return util.importTemplateExcel("特种设备模板");
    }
    /**
     * 导入特种设备列表
     */
    @Log(title = "特种设备", businessType = BusinessType.IMPORT)
    @PreAuthorize("@ss.hasPermi('hxems:archives:import')")
    @PostMapping("/importData")
    @Permission(level = ResourceLevel.SITE, permissionLogin = true)
    public AjaxResult importData(MultipartFile file) throws Exception{
        ExcelUtil<SpecEquipment> util = new ExcelUtil<>(SpecEquipment.class);
        List<SpecEquipment> equipmentList = util.importExcel(file.getInputStream());
        String message = specEquipmentService.importAssetArchives(equipmentList);
        return AjaxResult.success(message);
    }

前端vue页面：

import { getToken } from '@/utils/auth'
import { importTemplate } from "@/api/hxems/attach";
data(){
    return {
      // 下次检验日期时间范围
      daterangeNextInspectionDate: [],
      // 安全附件导入参数
      upload: {
        // 是否显示弹出层（组件导入）
        open: false,
        // 弹出层标题（组件导入）
        title: "",
        // 是否禁用上传
        isUploading: false,
        // 设置上传的请求头部
        headers: { Authorization: "Bearer " + getToken() },
        // 上传的地址
        url: process.env.VUE_APP_BASE_API + "/3/attach/importData"
      },         
    };
  }

	/** 导入按钮操作 */
    handleImport() {
      this.upload.title = "特种设备导入";
      this.upload.open = true;
    },
	/** 下载模板操作 */
    importTemplate() {
      importTemplate().then(response => {
        this.download(response.msg);
      });
    },
    // 文件上传中处理
    handleFileUploadProgress(event, file, fileList) {
      this.upload.isUploading = true;
    },
    // 文件上传成功处理
    handleFileSuccess(response, file, fileList) {
      this.upload.open = false;
      this.upload.isUploading = false;
      this.$refs.upload.clearFiles();
      this.$alert("<div style='overflow: auto;overflow-x: hidden;max-height: 70vh;padding: 10px 20px 0;'>" + response.msg + "</div>", "导入结果", { dangerouslyUseHTMLString: true });
      this.getList();
    },
    // 提交上传文件
    submitFileForm() {
      this.$refs.upload.submit();
    }

搞定。