SourceCode/Bond/Servo/SECSRuntimeManager.h
@@ -1,4 +1,4 @@
#ifndef SECS_RUNTIME_MANAGER_H
#ifndef SECS_RUNTIME_MANAGER_H
#define SECS_RUNTIME_MANAGER_H
#include <string>
@@ -9,80 +9,191 @@
class SECSRuntimeManager {
public:
    /**
     * 获取单例实例
     * @return SECSRuntimeManager实例的引用
     * 获取单例实例
     * @return SECSRuntimeManager实例的引用
     */
    static SECSRuntimeManager& getInstance();
    /**
     * 设置数据库连接
     * @param db 数据库连接的指针
     * 设置数据库连接
     * @param db 数据库连接的指针
     */
    void setDatabase(BL::Database* db);
   /**
    * 初始化SECS运行设置管理库
    * @return 成功返回true,失败返回false
    * 初始化SECS运行设置管理库
    * @return 成功返回true,失败返回false
    */
    bool initRuntimeSetting();
   /**
   * 销毁SECS运行设置管理库
   * 销毁SECS运行设置管理库
   */
    void termRuntimeSetting();
   /**
    * 初始化SystemSV表
    * 初始化SystemSV表
    */
    void initSystemSVTable();
    /**
     * 添加 SystemSV 数据
     * @param nID: 需要添加的 SystemSV 的 ID,必须是唯一的。
     * @param sName: 需要添加的 SystemSV 的名称,必须是唯一的。
     * @param sDataType: 数据类型,表示该系统值的类型,例如 "ASCII"、"UINT_1" 等。
     * @param nLength: 系统值的数据长度,通常为一个正整数,用于表示该数据的长度。
     * @param sUnit: 系统值的单位。如果为空或者为 "NULL",则插入数据库中的 NULL 值。
     * @param sRemark: 备注信息,描述该系统值的其他信息,可用于说明该字段的用途或特性。
     * @param nSystemID: 该数据所属的系统 ID,用于与其他表进行关联。
     * @return 1: 数据库未连接。
     * @return 2: ID 重复,无法插入数据。
     * @return 3: Name 重复,无法插入数据。
    * @return 4: 插入数据失败。
     * @return 0: 插入成功,数据已添加到 SystemSV 表中。
     *
     * 此函数用于将一条新的数据插入到 SystemSV 表中。它首先会检查传入的 `ID` 和 `Name` 是否已存在于表中,
     * 如果存在则返回相应的错误代码。如果 `Unit` 参数为 "NULL" 或者为空,函数会将其转换为数据库中的 NULL 值。
     * 然后,构造一个 SQL 插入语句并执行插入操作。如果插入失败,则抛出异常。
     * 如果一切顺利,返回 0 表示数据成功插入。
     */
    int addSystemSV(int nID, const std::string& sName, const std::string& sDataType, int nLength, const std::string& sUnit, const std::string& sRemark, int nSystemID);
    /**
     * 更新指定 ID 的 SystemSV 数据
     * @param nID: 需要更新的 SystemSV 的当前 ID。
     * @param sNewID: 要更新为的新 ID。
     * @return 1: 数据库未连接。
     * @return 2: 未找到指定的 ID。
     * @return 3: 新的 ID 已经存在,无法更新。
     * @return 4: 更新操作失败。
     * @return 0: 更新成功。
     *
     * 此函数用于更新 `SystemSV` 表中指定 `nID` 的记录,将其 `ID` 字段更新为 `sNewID`。
     * 在执行更新前,函数会检查:
     * 1. 当前的 `nID` 是否存在于表中。
     * 2. 新的 `sNewID` 是否已经存在于表中,如果存在,则无法进行更新。
     *
     * 如果 `nID` 不存在,则返回错误代码 2。如果 `sNewID` 已经存在,则返回错误代码 3。
     * 如果数据库更新失败,则返回错误代码 4。成功时,返回 0 表示操作成功。
     */
    int updateIDSystemSV(int nID, int sNewID);
   /**
    * 初始化Eqp表
     * 更新所有 SystemSV 数据
     * @param nID: 需要更新的 SystemSV 的当前 ID。
     * @param sNewID: 要更新为的新 ID,如果为空或为 -1,则不更新 ID。
     * @param sName: 新的名称,如果为空,则不更新。
     * @param sDataType: 新的数据类型,如果为空,则不更新。
     * @param nLength: 新的数据长度,如果为负值或零,则不更新。
     * @param sUnit: 新的单位,如果为空或 "NULL",则不更新。
     * @param sRemark: 新的备注,如果为空,则不更新。
     * @param nSystemID: 新的系统 ID,如果为负值,则不更新。
     * @return 1: 数据库未连接。
     * @return 2: 没有找到该 ID 对应的记录。
     * @return 3: 新的 ID 已经存在,无法更新。
    * @return 4: 更新操作失败。
     * @return 0: 更新成功。
     *
     * 此函数用于更新指定 `ID` 的 `SystemSV` 数据。如果某个字段为空,则跳过该字段的更新。
     * 如果给定的 `ID` 不存在,则返回错误代码 2。如果新的 `ID` 已经存在,则返回错误代码 3。
     *
     * 如果字段为空,跳过该字段的更新。
    */
    int updateAllSystemSV(int nID, int sNewID, const std::string& sName, const std::string& sDataType, int nLength, const std::string& sUnit, const std::string& sRemark, int nSystemID);
    /**
     * 删除指定 ID 的 SystemSV 数据
     * @param nID: 需要删除的 SystemSV 的 ID。
     * @return 1: 数据库未连接。
     * @return 2: 未找到指定的 ID 对应的记录。
    * @return 3: 删除操作失败。
     * @return 0: 删除成功。
     *
     * 此函数用于删除 `SystemSV` 表中指定 `nID` 的记录。如果给定的 `nID` 不存在,则返回错误代码 2。
     * 删除操作成功后,返回 0 表示删除成功。
     */
    int deleteSystemSVByID(int nID);
   /**
    * 删除所有 SystemSV 数据
    * @return 1: 数据库未连接。
    * @return 2: 删除操作失败。
    * @return 0: 删除成功。
    *
    * 此函数用于删除 `SystemSV` 表中的所有记录。如果数据库未连接,则返回错误代码 1。
    * 如果删除操作失败,则返回错误代码 2。删除成功后,返回 0 表示删除成功。
    */
    int deleteAllSystemSV();
   /**
    * 初始化Eqp表
    */
    void initEqpSVTable();
   /**
   * 初始化SystemDV表
    * 添加 EqpSV 数据
    * @param nID: 需要添加的 EqpSV 的 ID,必须是唯一的。
    * @param sName: 需要添加的 EqpSV 的名称,必须是唯一的。
    * @param sDataType: 数据类型,表示该设备值的类型,例如 "ASCII"、"UINT_1" 等。
    * @param nLength: 设备值的数据长度,通常为一个正整数,用于表示该数据的长度。
    * @param sUnit: 设备值的单位。如果为空或者为 "NULL",则插入数据库中的 NULL 值。
    * @param sRemark: 备注信息,描述该设备值的其他信息,可用于说明该字段的用途或特性。
    * @param nSeqNo: 该数据的序号,用于排序。
    * @return 1: 数据库未连接。
    * @return 2: ID 重复,无法插入数据。
    * @return 3: Name 重复,无法插入数据。
     * @return 4: 插入数据失败。
    * @return 0: 插入成功,数据已添加到 EqpSV 表中。
    *
    * 此函数用于将一条新的数据插入到 EqpSV 表中。它首先会检查传入的 `ID` 和 `Name` 是否已存在于表中,
    * 如果存在则返回相应的错误代码。如果 `Unit` 参数为 "NULL" 或者为空,函数会将其转换为数据库中的 NULL 值。
    * 然后,构造一个 SQL 插入语句并执行插入操作。如果插入失败,则抛出异常。
    * 如果一切顺利,返回 0 表示数据成功插入。
    */
    int addEqpSV(int nID, const std::string& sName, const std::string& sDataType, int nLength, const std::string& sUnit, const std::string& sRemark, int nSeqNo);
   /**
   * 初始化SystemDV表
    */ 
    void initSystemDVTable();
   /**
   * 初始化EqpDV表
   * 初始化EqpDV表
    */ 
    void initEqpDVTable();
   /**
   * 初始化SystemEC表
   * 初始化SystemEC表
    */ 
    void initSystemECTable();
    /**
    * 初始化EqpEC表
    * 初始化EqpEC表
    */
    void initEqpECTable();
    /**
    * 初始化SystemEvent表
    * 初始化SystemEvent表
    */
    void initSystemEventTable();
    /**
    * 初始化EqpEvent表
    * 初始化EqpEvent表
    */
    void initEqpEventTable();
    /**
    * 初始化EventLink表
    * 初始化EventLink表
    */
    void initEventLinkTable();
   /**
    * 初始化PPID表
    * 初始化PPID表
    */
    void initPPIDTable();
   /**
   * 初始化RPTID表
   * 初始化RPTID表
    */ 
    void initRPTIDTable();
@@ -90,13 +201,19 @@
    SECSRuntimeManager();
    ~SECSRuntimeManager();
    // 禁止拷贝和赋值
    // 禁止拷贝和赋值
    SECSRuntimeManager(const SECSRuntimeManager&) = delete;
    SECSRuntimeManager& operator=(const SECSRuntimeManager&) = delete;
   // 从数据库中获取整数
   // 从数据库中获取整数
    int getIntFromDB(const std::string& query);
   // 判断VID是否重复
    bool isIDDuplicate(int nID);
   // 判断名称是否重复
    bool isNameDuplicate(const std::string& sName);
    BL::Database* m_pDB;
    static std::mutex m_mutex;
};