JNA集成原生库：处理复杂结构体与联合体的最佳实践

// C语言中的Install_CD97_GTML结构体
typedef struct
{
  UCHAR   ucProtocolType;
  UCHAR   ucAddReader;
} Install_CD97_GTML_Params; // 假设这是嵌套结构体的名称

// C语言中的InstallCardParam联合体
typedef union
{
  Install_CD97_GTML_Params   xCd97Param;
  // Install_CD98_GTML     xCd98Param; // 示例：其他可能的联合体成员
  // Install_CD99_GTML      xCd99Param;
} InstallCardParam;

// C语言中的InstallCard结构体
typedef struct
{
  eTypCardType        xCardType;
  InstallCardParam    iCardParam; // 包含一个联合体
} InstallCard;

// 原生函数声明
short sSmartInstCardEx(const InstallCard *pxInstallCard);

// InstallCard 继承自 Structure
public class InstallCard extends Structure {
    public int xCardType;

    @Override
    protected List<String> getFieldOrder() {
        // 注意：这里定义了所有字段，包括子类中的字段，这在JNA中是可行的
        // 但通常推荐子类自己定义其特有字段，并由父类通过其继承链管理
        return Arrays.asList("xCardType", "ucProtocolType", "ucAddReader");
    }
}

// Install_CD97_GTML 继承 InstallCard，直接包含参数字段
public class Install_CD97_GTML extends InstallCard {
    public byte ucProtocolType;
    public byte ucAddReader;
    // 构造函数等...
}

// 调用示例
Install_CD97_GTML pxInstallCardCD97 = new Install_CD97_GTML();
pxInstallCardCD97.xCardType = 1;
pxInstallCardCD97.ucAddReader = 0;
pxInstallCardCD97.ucProtocolType = 1;

// res = ReaderThalesApi.INSTANCE.sSmartInstCardEx(pxInstallCardCD97); // 正常工作

// InstallCard 保持不变
public class InstallCard extends Structure {
    public int xCardType;

    @Override
    protected List<String> getFieldOrder() {
        // 注意：这里的getFieldOrder()可能需要调整以反映实际的结构
        // 如果Install_CD97_GTML是InstallCard的子类，并且iCardParam是Install_CD97_GTML特有的字段
        // 那么InstallCard的getFieldOrder()可能只包含它自己的字段
        return Arrays.asList("xCardType");
    }
}

// 引入一个普通的Java类，不继承Structure
public class CD97_GTML_Parameter {
    public byte ucProtocolType;
    public byte ucAddReader;
    // 构造函数等...
}

// Install_CD97_GTML 继承 InstallCard，并包含非Structure类型的字段
public class Install_CD97_GTML extends InstallCard {
    public CD97_GTML_Parameter iCardParam; // 问题所在：CD97_GTML_Parameter不是Structure

    @Override
    protected List<String> getFieldOrder() {
        return Arrays.asList("xCardType", "iCardParam"); // 尝试将非Structure类型加入字段顺序
    }
}

// 调用示例
Install_CD97_GTML pxInstallCardCD97 = new Install_CD97_GTML();
CD97_GTML_Parameter pxCD97_GTML_Parameter = new CD97_GTML_Parameter();
pxInstallCardCD99.xCardType = 1;
pxCD97_GTML_Parameter.ucAddReader = 0;
pxCD97_GTML_Parameter.ucProtocolType = 1;
pxInstallCardCD97.iCardParam = pxCD97_GTML_Parameter;

// res = ReaderThalesApi.INSTANCE.sSmartInstCardEx(pxInstallCardCD97); // 抛出异常

import com.sun.jna.Structure;
import com.sun.jna.Union;
import java.util.Arrays;
import java.util.List;

// 对应 C 语言的 Install_CD97_GTML_Params 结构体
public class Install_CD97_GTML_Params_Native extends Structure {
    public byte ucProtocolType;
    public byte ucAddReader;

    public Install_CD97_GTML_Params_Native() {
        // 默认构造函数
    }

    public Install_CD97_GTML_Params_Native(byte ucProtocolType, byte ucAddReader) {
        this.ucProtocolType = ucProtocolType;
        this.ucAddReader = ucAddReader;
    }

    @Override
    protected List<String> getFieldOrder() {
        return Arrays.asList("ucProtocolType", "ucAddReader");
    }
}

// 对应 C 语言的 InstallCardParam 联合体
public class InstallCardParam_Native extends Union {
    // 联合体的成员，JNA会为其中最大的成员分配内存
    public Install_CD97_GTML_Params_Native xCd97Param;
    // 其他联合体成员，例如：
    // public Install_CD98_GTML_Params_Native xCd98Param;

    public InstallCardParam_Native() {
        // 默认构造函数
    }

    @Override
    protected List<String> getFieldOrder() {
        // 联合体字段顺序，通常只列出所有成员
        return Arrays.asList("xCd97Param"); // 如果有其他成员，也需要在此列出
    }
}

// 对应 C 语言的 InstallCard 结构体
public class InstallCard_Native extends Structure {
    public int xCardType; // 假设 eTypCardType 映射为 int
    public InstallCardParam_Native iCardParam; // 嵌套的联合体字段

    public InstallCard_Native() {
        // 默认构造函数
    }

    @Override
    protected List<String> getFieldOrder() {
        return Arrays.asList("xCardType", "iCardParam");
    }
}

// 假设 ReaderThalesApi 是 JNA 接口，定义了 sSmartInstCardEx 方法
// public interface ReaderThalesApi extends Library {
//     ReaderThalesApi INSTANCE = Native.load("your_native_lib", ReaderThalesApi.class);
//     short sSmartInstCardEx(InstallCard_Native pxInstallCard);
// }

InstallCard_Native pxInstallCard = new InstallCard_Native();
pxInstallCard.xCardType = 1;

// 为联合体成员赋值
Install_CD97_GTML_Params_Native cd97Params = new Install_CD97_GTML_Params_Native((byte)1, (byte)0);
pxInstallCard.iCardParam.xCd97Param = cd97Params;
// 对于联合体，通常需要显式地设置当前活跃的类型，以便JNA正确处理
pxInstallCard.iCardParam.setType(Install_CD97_GTML_Params_Native.class);

// 将数据写入原生内存（如果需要）
pxInstallCard.write();

// 调用原生方法
// short res = ReaderThalesApi.INSTANCE.sSmartInstCardEx(pxInstallCard);

// 从原生内存读取数据（如果方法会修改结构体内容）
// pxInstallCard.read();

// 友好的参数类，不继承Structure
public class Friendly_CD97_GTML_Parameter {
    public final byte ucProtocolType;
    public final byte ucAddReader;

    public Friendly_CD97_GTML_Parameter(byte ucProtocolType, byte ucAddReader) {