Go语言中C结构体联合体绑定的实践指南

struct mifare_desfire_file_settings {
    uint8_t file_type;
    uint8_t communication_settings;
    uint16_t access_rights;
    union {
    struct {
        uint32_t file_size;
    } standard_file;
    struct {
        int32_t lower_limit;
        int32_t upper_limit;
        int32_t limited_credit_value;
        uint8_t limited_credit_enabled;
    } value_file;
    struct {
        uint32_t record_size;
        uint32_t max_number_of_records;
        uint32_t current_number_of_records;
    } linear_record_file;
    } settings;
};

int mifare_desfire_get_file_settings (MifareTag tag, uint8_t file_no, struct mifare_desfire_file_settings *settings);

package mifare

const (
    MDFTStandarDataFile            uint8 = 0x00 // 标准数据文件
    MDFTBackupDataFile             uint8 = 0x01 // 备份数据文件
    MDFTValueFileWithBackup        uint8 = 0x02 // 带备份的值文件
    MDFTLinearRecordFileWithBackup uint8 = 0x03 // 带备份的线性记录文件
    MDFTCyclicRecordFileWithBackup uint8 = 0x04 // 带备份的循环记录文件
)

// StandardFile 对应 C 联合体中的 standard_file 结构
type StandardFile struct {
    FileSize uint32
}

// ValueFile 对应 C 联合体中的 value_file 结构
type ValueFile struct {
    LowerLimit           int32
    UpperLimit           int32
    LimitedCreditValue   int32
    LimitedCreditEnabled uint8
}

// LinearRecordFile 对应 C 联合体中的 linear_record_file 结构
type LinearRecordFile struct {
    RecordSize            uint32
    MaxNumberOfRecords     uint32
    CurrentNumberOfRecords uint32
}

// DESFireFileSettings 对应 C 语言的 mifare_desfire_file_settings 结构
type DESFireFileSettings struct {
    FileType              uint8
    CommunicationSettings uint8
    AccessRights          uint16
    // settings 字段是一个匿名结构体，嵌入了所有联合体可能的数据结构
    // 它们在内存中是独立的，但通过方法进行逻辑上的“联合”
    settings struct {
        StandardFile
        ValueFile
        LinearRecordFile
    }
}

// StandardFile 方法返回标准文件设置。
// 如果当前 FileType 与标准文件不符，则返回错误。
func (fs *DESFireFileSettings) StandardFile() (StandardFile, error) {
    if fs.FileType != MDFTStandarDataFile && fs.FileType != MDFTBackupDataFile {
        return StandardFile{}, fmt.Errorf("file type %d is not a standard data file", fs.FileType)
    }
    return fs.settings.StandardFile, nil
}

// SetStandardFile 方法设置标准文件设置。
// 它会更新 FileType 并设置 StandardFile 字段。
func (fs *DESFireFileSettings) SetStandardFile(standardFile StandardFile) error {
    // 可以在此处添加更严格的验证，例如检查传入的 standardFile 是否有效
    fs.FileType = MDFTStandarDataFile // 或 MDFTBackupDataFile，根据实际业务逻辑决定
    fs.settings.StandardFile = standardFile
    return nil
}

// ValueFile 方法返回值文件设置。
// 如果当前 FileType 与值文件不符，则返回错误。
func (fs *DESFireFileSettings) ValueFile() (ValueFile, error) {
    if fs.FileType != MDFTValueFileWithBackup {
        return ValueFile{}, fmt.Errorf("file type %d is not a value file", fs.FileType)
    }
    return fs.settings.ValueFile, nil
}

// SetValueFile 方法设置值文件设置。
// 它会更新 FileType 并设置 ValueFile 字段。
func (fs *DESFireFileSettings) SetValueFile(valueFile ValueFile) error {
    fs.FileType = MDFTValueFileWithBackup
    fs.settings.ValueFile = valueFile
    return nil
}

// LinearRecordFile 方法返回线性记录文件设置。
// 如果当前 FileType 与线性记录文件不符，则返回错误。
func (fs *DESFireFileSettings) LinearRecordFile() (LinearRecordFile, error) {
    if fs.FileType != MDFTLinearRecordFileWithBackup && fs.FileType != MDFTCyclicRecordFileWithBackup {
        return LinearRecordFile{}, fmt.Errorf("file type %d is not a linear/cyclic record file", fs.FileType)
    }
    return fs.settings.LinearRecordFile, nil
}

// SetLinearRecordFile 方法设置线性记录文件设置。
// 它会更新 FileType 并设置 LinearRecordFile 字段。
func (fs *DESFireFileSettings) SetLinearRecordFile(linearRecordFile LinearRecordFile) error {
    fs.FileType = MDFTLinearRecordFileWithBackup // 或 MDFTCyclicRecordFileWithBackup
    fs.settings.LinearRecordFile = linearRecordFile
    return nil
}