package com.mes.service;

import com.alibaba.fastjson.JSONObject;
import com.github.xingshuangs.iot.common.enums.EDataType;
import com.github.xingshuangs.iot.protocol.s7.serializer.S7Parameter;
import com.mes.device.entity.DeviceConfig;
import com.mes.s7.enhanced.EnhancedS7Serializer;

import java.util.ArrayList;
import java.util.List;
import java.util.Map;

/**
 * PLC动态数据读写服务
 * 根据DeviceConfig配置动态构建参数，支持任意字段组合的PLC数据交互
 * 
 * @author huang
 * @date 2025/11/05
 */
public interface PlcDynamicDataService {
    
    /**
     * 根据DeviceConfig配置和字段名称读取PLC数据
     * 
     * @param device 设备配置
     * @param fieldNames 要读取的字段名称列表
     * @param s7Serializer S7序列化器
     * @return 字段名->值 的Map
     */
    Map<String, Object> readPlcData(DeviceConfig device, List<String> fieldNames, EnhancedS7Serializer s7Serializer);
    
    /**
     * 根据DeviceConfig配置和数据Map写入PLC
     * 
     * @param device 设备配置
     * @param dataMap 字段名->值 的Map
     * @param s7Serializer S7序列化器
     */
    void writePlcData(DeviceConfig device, Map<String, Object> dataMap, EnhancedS7Serializer s7Serializer);
    
    /**
     * 读取PLC所有字段（基于DeviceConfig）
     * 
     * @param device 设备配置
     * @param s7Serializer S7序列化器
     * @return 所有字段的值
     */
    Map<String, Object> readAllPlcData(DeviceConfig device, EnhancedS7Serializer s7Serializer);
    
    /**
     * 读取单个字段（基于DeviceConfig）
     * 
     * @param device 设备配置
     * @param fieldName 字段名
     * @param s7Serializer S7序列化器
     * @return 字段值
     */
    Object readPlcField(DeviceConfig device, String fieldName, EnhancedS7Serializer s7Serializer);
    
    /**
     * 写入单个字段（基于DeviceConfig）
     * 
     * @param device 设备配置
     * @param fieldName 字段名
     * @param value 字段值
     * @param s7Serializer S7序列化器
     */
    void writePlcField(DeviceConfig device, String fieldName, Object value, EnhancedS7Serializer s7Serializer);
    
    /**
     * 根据实体类和DeviceConfig配置写入PLC数据
     * 实体类字段使用@S7Variable注解，address字段为字段名（对应configJson中的paramKey）
     * 偏移量从configJson中的paramValue获取
     * 
     * @param <T> 实体类型
     * @param device 设备配置
     * @param entity 实体对象
     * @param s7Serializer S7序列化器
     */
    <T> void writePlcDataByEntity(DeviceConfig device, T entity, EnhancedS7Serializer s7Serializer);
}