若依分离版实现设备与传感器关联管理实践-代码聚汇网

若依分离版实现设备与传感器关联管理实践

长发在船头舞蹈·2026-08-13·阅读 23 GEO检测（免费）

若依框架MyBatis-Plus工业物联网

|难度：普通|阅读约 31 分钟

1. 项目背景与需求分析

在工业物联网和智能设备管理系统中，设备与传感器的关联关系是最基础也最核心的数据模型之一。一个设备往往挂载多个传感器，而每个传感器又可能在不同时间段被分配到不同设备上。这种典型的一对多关系，在若依分离版框架中如何优雅地实现，正是本文要解决的核心问题。

我最近接手了一个工业设备监控平台的二次开发项目，客户要求能够对生产车间的200多台设备及其附带的2000多个传感器进行全生命周期管理。在技术选型阶段，我们最终选择了若依分离版作为基础框架，主要看中其完善的权限体系和前后端分离的架构优势。但在实际开发中，设备与传感器的关联关系处理却遇到了几个关键痛点：

如何在前端实现设备选择后动态加载对应的传感器列表？
后端如何设计API才能同时支持设备基础信息和传感器列表的高效查询？
表单提交时如何确保设备与传感器关联关系的原子性操作？

经过两周的摸索和实践，我总结出了一套完整的解决方案，下面将详细分享从数据库设计到前端交互的全流程实现。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 数据库设计与模型层实现

2.1 主从表结构设计

设备表(device)作为主表，传感器表(sensor)作为从表，通过device_id建立外键关联：

sql复制CREATE TABLE `device` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '设备ID',
  `device_name` varchar(100) NOT NULL COMMENT '设备名称',
  `device_code` varchar(50) NOT NULL COMMENT '设备编号',
  `device_type` varchar(2) DEFAULT NULL COMMENT '设备类型',
  `status` char(1) DEFAULT '0' COMMENT '状态（0正常 1停用）',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_device_code` (`device_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='设备信息表';

CREATE TABLE `sensor` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '传感器ID',
  `sensor_name` varchar(100) NOT NULL COMMENT '传感器名称',
  `sensor_code` varchar(50) NOT NULL COMMENT '传感器编号',
  `device_id` bigint(20) DEFAULT NULL COMMENT '所属设备ID',
  `sensor_type` varchar(2) DEFAULT NULL COMMENT '传感器类型',
  `install_time` datetime DEFAULT NULL COMMENT '安装时间',
  PRIMARY KEY (`id`),
  KEY `idx_device_id` (`device_id`),
  CONSTRAINT `fk_sensor_device` FOREIGN KEY (`device_id`) REFERENCES `device` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='传感器信息表';

这里有几个设计要点需要注意：

设备编号(device_code)和传感器编号(sensor_code)都设置了唯一索引，确保业务唯一性
外键约束虽然会影响部分性能，但在数据一致性要求高的场景下建议保留
install_time记录传感器挂载到设备的时间，这对后续设备维护记录很重要

2.2 MyBatis-Plus实体类配置

设备实体类(Device.java)中需要定义传感器列表字段：

java复制@Data
@TableName("device")
public class Device {
    @TableId(type = IdType.AUTO)
    private Long id;
    
    private String deviceName;
    private String deviceCode;
    private String deviceType;
    private String status;
    
    @TableField(exist = false)
    private List<Sensor> sensorList;
}

传感器实体类(Sensor.java)中需要定义设备ID字段：

java复制@Data
@TableName("sensor")
public class Sensor {
    @TableId(type = IdType.AUTO)
    private Long id;
    
    private String sensorName;
    private String sensorCode;
    private Long deviceId;
    private String sensorType;
    private Date installTime;
}

注意：@TableField(exist = false)注解表示sensorList不是数据库字段，而是用于业务逻辑的关联字段

3. 后端API设计与实现

3.1 设备查询接口优化

常规的若依代码生成器生成的接口只能查询设备基础信息，我们需要改造为同时返回关联的传感器列表：

java复制@GetMapping("/getInfo/{deviceId}")
public AjaxResult getInfo(@PathVariable("deviceId") Long deviceId) {
    // 查询设备基础信息
    Device device = deviceService.getById(deviceId);
    if (device == null) {
        return AjaxResult.error("设备不存在");
    }
    
    // 查询关联的传感器列表
    LambdaQueryWrapper<Sensor> queryWrapper = new LambdaQueryWrapper<>();
    queryWrapper.eq(Sensor::getDeviceId, deviceId);
    List<Sensor> sensorList = sensorService.list(queryWrapper);
    
    device.setSensorList(sensorList);
    return AjaxResult.success(device);
}

3.2 设备新增/修改接口改造

为了保证设备信息和传感器关联的原子性，需要使用@Transactional注解：

java复制@PostMapping
@Transactional(rollbackFor = Exception.class)
public AjaxResult add(@RequestBody Device device) {
    // 1. 保存设备基本信息
    if (!deviceService.save(device)) {
        throw new RuntimeException("保存设备信息失败");
    }
    
    // 2. 处理传感器关联关系
    if (CollectionUtils.isNotEmpty(device.getSensorList())) {
        for (Sensor sensor : device.getSensorList()) {
            sensor.setDeviceId(device.getId());
            if (!sensorService.updateById(sensor)) {
                throw new RuntimeException("更新传感器关联关系失败");
            }
        }
    }
    
    return AjaxResult.success();
}

关键点：这里采用先保存设备获取ID，再更新传感器关联关系的策略，避免了复杂的SQL拼接

3.3 自定义分页查询

对于设备列表页，我们需要支持带传感器条件的分页查询：

java复制@GetMapping("/list")
public TableDataInfo list(Device device) {
    startPage();
    
    // 构建设备查询条件
    LambdaQueryWrapper<Device> queryWrapper = new LambdaQueryWrapper<>();
    queryWrapper.like(StringUtils.isNotBlank(device.getDeviceName()), 
                     Device::getDeviceName, device.getDeviceName());
    queryWrapper.eq(StringUtils.isNotBlank(device.getDeviceType()), 
                   Device::getDeviceType, device.getDeviceType());
    
    // 如果有传感器条件，构建子查询
    if (StringUtils.isNotBlank(device.getParams().get("sensorType"))) {
        String sensorType = device.getParams().get("sensorType").toString();
        queryWrapper.inSql(Device::getId, 
                         "SELECT device_id FROM sensor WHERE sensor_type = '" + sensorType + "'");
    }
    
    List<Device> list = deviceService.list(queryWrapper);
    return getDataTable(list);
}

4. 前端Vue实现

4.1 设备表单改造

在deviceForm.vue中，需要增加传感器表格的编辑功能：

vue复制<template>
  <el-form ref="form" :model="form" :rules="rules" label-width="120px">
    <!-- 设备基础信息字段 -->
    <el-form-item label="设备名称" prop="deviceName">
      <el-input v-model="form.deviceName" />
    </el-form-item>
    
    <!-- 传感器表格 -->
    <el-divider content-position="left">传感器列表</el-divider>
    <el-table :data="form.sensorList" border>
      <el-table-column prop="sensorName" label="传感器名称">
        <template #default="scope">
          <el-input v-model="scope.row.sensorName" />
        </template>
      </el-table-column>
      <el-table-column prop="sensorType" label="类型" width="120">
        <template #default="scope">
          <el-select v-model="scope.row.sensorType">
            <el-option label="温度" value="01" />
            <el-option label="湿度" value="02" />
            <el-option label="压力" value="03" />
          </el-select>
        </template>
      </el-table-column>
      <el-table-column label="操作" width="80">
        <template #default="scope">
          <el-button size="mini" type="danger" 
                     @click="handleRemoveSensor(scope.$index)">删除</el-button>
        </template>
      </el-table-column>
    </el-table>
    
    <div style="margin-top: 10px">
      <el-button type="primary" @click="handleAddSensor">添加传感器</el-button>
    </div>
  </el-form>
</template>

<script>
export default {
  data() {
    return {
      form: {
        sensorList: []
      },
      rules: {
        deviceName: [{ required: true, message: "设备名称不能为空", trigger: "blur" }]
      }
    }
  },
  methods: {
    handleAddSensor() {
      this.form.sensorList.push({
        sensorName: '',
        sensorType: '01',
        deviceId: this.form.id
      });
    },
    handleRemoveSensor(index) {
      this.form.sensorList.splice(index, 1);
    }
  }
}
</script>

4.2 设备详情页实现

在设备详情页展示传感器列表：

vue复制<template>
  <div class="app-container">
    <el-descriptions title="设备基础信息" border>
      <el-descriptions-item label="设备名称">{{ device.deviceName }}</el-descriptions-item>
      <el-descriptions-item label="设备编号">{{ device.deviceCode }}</el-descriptions-item>
    </el-descriptions>
    
    <el-divider content-position="left">关联传感器</el-divider>
    <el-table :data="device.sensorList" border>
      <el-table-column prop="sensorName" label="传感器名称" />
      <el-table-column prop="sensorType" label="类型" width="120">
        <template #default="scope">
          {{ formatSensorType(scope.row.sensorType) }}
        </template>
      </el-table-column>
      <el-table-column prop="installTime" label="安装时间" width="180">
        <template #default="scope">
          {{ parseTime(scope.row.installTime) }}
        </template>
      </el-table-column>
    </el-table>
  </div>
</template>

<script>
export default {
  data() {
    return {
      device: {
        sensorList: []
      }
    }
  },
  created() {
    const deviceId = this.$route.params.id;
    this.getDevice(deviceId);
  },
  methods: {
    getDevice(deviceId) {
      getDevice(deviceId).then(response => {
        this.device = response.data;
      });
    },
    formatSensorType(type) {
      const typeMap = { '01': '温度', '02': '湿度', '03': '压力' };
      return typeMap[type] || '未知';
    }
  }
}
</script>

5. 性能优化与扩展思考

5.1 N+1查询问题解决方案

当需要查询大量设备及其传感器时，简单的实现会导致N+1查询问题。以下是两种优化方案：

方案一：批量查询+内存关联

java复制public List<Device> listDeviceWithSensors(List<Long> deviceIds) {
    // 1. 批量查询设备
    List<Device> devices = deviceService.listByIds(deviceIds);
    
    // 2. 批量查询这些设备的传感器
    LambdaQueryWrapper<Sensor> sensorQuery = new LambdaQueryWrapper<>();
    sensorQuery.in(Sensor::getDeviceId, deviceIds);
    List<Sensor> allSensors = sensorService.list(sensorQuery);
    
    // 3. 内存中建立关联关系
    Map<Long, List<Sensor>> sensorMap = allSensors.stream()
        .collect(Collectors.groupingBy(Sensor::getDeviceId));
    
    devices.forEach(device -> 
        device.setSensorList(sensorMap.getOrDefault(device.getId(), Collections.emptyList())));
    
    return devices;
}

方案二：使用MyBatis的@ResultMap

在DeviceMapper.xml中定义resultMap：

xml复制<resultMap id="DeviceWithSensorsResult" type="Device">
    <id property="id" column="id"/>
    <result property="deviceName" column="device_name"/>
    <!-- 其他设备字段 -->
    
    <collection property="sensorList" ofType="Sensor" 
                select="selectSensorsByDeviceId" column="id"/>
</resultMap>

<select id="selectSensorsByDeviceId" resultType="Sensor">
    SELECT * FROM sensor WHERE device_id = #{deviceId}
</select>

<select id="selectDeviceWithSensors" resultMap="DeviceWithSensorsResult">
    SELECT * FROM device WHERE id = #{deviceId}
</select>

5.2 历史关联关系追踪

在实际业务中，传感器可能会在不同设备间转移，需要记录这种变更历史。可以设计传感器设备关联历史表：

sql复制CREATE TABLE `sensor_device_history` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `sensor_id` bigint(20) NOT NULL,
  `device_id` bigint(20) NOT NULL,
  `start_time` datetime NOT NULL,
  `end_time` datetime DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_sensor_id` (`sensor_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='传感器设备关联历史表';

每次传感器设备关联变更时，先更新历史表中前一条记录的end_time，再插入新记录。

5.3 前端性能优化

当传感器数量很大时（如超过1000条），前端表格渲染会变慢。可以采用虚拟滚动优化：

vue复制<template>
  <el-table 
    :data="form.sensorList"
    style="width: 100%"
    height="500"
    row-key="id"
    :row-height="50"
    :virtual-scroll="form.sensorList.length > 100">
    <!-- 列定义 -->
  </el-table>
</template>

6. 常见问题与解决方案

6.1 表单提交时传感器校验问题

当需要校验传感器列表中的必填字段时，可以使用自定义校验规则：

javascript复制data() {
  const validateSensors = (rule, value, callback) => {
    if (this.form.sensorList.some(s => !s.sensorName)) {
      callback(new Error('所有传感器名称必须填写'));
    } else {
      callback();
    }
  };
  
  return {
    rules: {
      sensorList: [{ validator: validateSensors, trigger: 'blur' }]
    }
  }
}

6.2 设备删除时的级联处理

在删除设备时，通常有三种处理关联传感器的方式：

级联删除（不推荐，会丢失历史数据）

java复制@Transactional
public boolean removeDevice(Long deviceId) {
    // 1. 删除关联的传感器
    LambdaQueryWrapper<Sensor> wrapper = new LambdaQueryWrapper<>();
    wrapper.eq(Sensor::getDeviceId, deviceId);
    sensorService.remove(wrapper);
    
    // 2. 删除设备
    return deviceService.removeById(deviceId);
}

解除关联（推荐）

java复制@Transactional
public boolean removeDevice(Long deviceId) {
    // 1. 解除传感器关联
    LambdaUpdateWrapper<Sensor> updateWrapper = new LambdaUpdateWrapper<>();
    updateWrapper.eq(Sensor::getDeviceId, deviceId)
                .set(Sensor::getDeviceId, null);
    sensorService.update(updateWrapper);
    
    // 2. 删除设备
    return deviceService.removeById(deviceId);
}

校验后删除（业务最严谨）

java复制@Transactional
public boolean removeDevice(Long deviceId) {
    // 1. 检查是否有关联传感器
    LambdaQueryWrapper<Sensor> queryWrapper = new LambdaQueryWrapper<>();
    queryWrapper.eq(Sensor::getDeviceId, deviceId);
    long count = sensorService.count(queryWrapper);
    
    if (count > 0) {
        throw new BusinessException("请先解除所有传感器关联后再删除设备");
    }
    
    // 2. 删除设备
    return deviceService.removeById(deviceId);
}

6.3 大数据量下的分页优化

当设备表和传感器表数据量都很大时，分页查询需要特殊优化：

java复制public TableDataInfo listDeviceWithSensors(DeviceQuery query) {
    // 1. 先分页查询设备ID
    Page<Device> page = new Page<>(query.getPageNum(), query.getPageSize());
    LambdaQueryWrapper<Device> deviceQuery = buildDeviceQueryWrapper(query);
    deviceService.page(page, deviceQuery);
    
    // 2. 批量查询这些设备的传感器
    List<Long> deviceIds = page.getRecords().stream()
                              .map(Device::getId)
                              .collect(Collectors.toList());
    
    if (!deviceIds.isEmpty()) {
        Map<Long, List<Sensor>> sensorMap = sensorService.listByDeviceIds(deviceIds);
        page.getRecords().forEach(d -> d.setSensorList(sensorMap.get(d.getId())));
    }
    
    return getDataTable(page);
}

对应的SQL优化：

xml复制<select id="listByDeviceIds" resultType="Sensor">
    SELECT * FROM sensor 
    WHERE device_id IN 
    <foreach collection="deviceIds" item="id" open="(" separator="," close=")">
        #{id}
    </foreach>
    ORDER BY device_id, id
</select>

7. 项目实战经验分享

在实际项目中实现设备-传感器主从表关联时，我总结了以下几点经验：

前端表格编辑的坑：直接使用v-model绑定表格行数据时，如果行数据缺少响应式属性，可能会导致数据绑定失效。解决方案是：

javascript复制handleAddSensor() {
  this.form.sensorList.push({
    ...this.$options.data().sensorTemplate, // 包含所有响应式属性的模板对象
    deviceId: this.form.id
  });
}

后端事务处理的陷阱：在大型系统中，@Transactional注解在自调用时会失效。比如：

java复制public void updateDevice(Device device) {
    // 这个方法的事务会失效
    this.handleSensors(device.getSensorList());
}

@Transactional
public void handleSensors(List<Sensor> sensors) {
    // ...
}

解决方案是使用AopContext.currentProxy()或将该方法移到另一个Service中。

MyBatis-Plus的批量操作：默认的saveBatch方法其实是循环单条插入，要实现真正的批量插入需要：

java复制@Autowired
private SqlSessionTemplate sqlSessionTemplate;

public void batchInsertSensors(List<Sensor> sensors) {
    SqlSession session = sqlSessionTemplate.getSqlSessionFactory()
                         .openSession(ExecutorType.BATCH, false);
    try {
        SensorMapper mapper = session.getMapper(SensorMapper.class);
        for (Sensor sensor : sensors) {
            mapper.insert(sensor);
        }
        session.commit();
    } finally {
        session.close();
    }
}

前端性能监控：当传感器表格行数超过500时，建议添加渲染性能监控：

javascript复制mounted() {
  this.$nextTick(() => {
    const start = performance.now();
    // 强制重新渲染
    this.$forceUpdate();
    setTimeout(() => {
      const duration = performance.now() - start;
      if (duration > 100) {
        console.warn(`传感器表格渲染耗时 ${duration.toFixed(2)}ms，建议启用虚拟滚动`);
      }
    }, 0);
  });
}