Java调用UK动态库SKF接口（dll/so）——JNA的实现

Java调用UK动态库SKF接口（dll/so）——JNA的实现

   个人对Java语音了解有限，由于工作上的原因，写了一个的demo，仅供参考
  
  
   情况：
  

  

• IntelliJ IDEA Community Edition 2024.1  
  
• wiindows10
  

  1-项目搭建

1.1-创建项目

1. 1- 新建项目：选择Maven Archetype
2.         a- Archetype:任意添加一个，默认第一个（org.apache.maven.archetypes:maven-archetype-archetype）

复制代码

1.2-JNA依靠

在项目根目录下的pom.xml添加JNA依靠

1. <dependencies>
2.     <!-- 添加JNA依赖 -->
3.     <dependency>
4.         <groupId>net.java.dev.jna</groupId>
5.         <artifactId>jna</artifactId>
6.         <version>5.10.0</version> <!-- 请检查并使用最新版本 -->
7.     </dependency>
8. </dependencies>

复制代码

1.3-目录创建

在src\mian下创建java目录，后续的代码文件将在这个目录下创建完成
2-Java SKFApi接口类的创建

   涉及的内容：
  

  

• 相关数据类型（各结构体）：  
  
• SKF接口  
  
• 算法ID
  

  2.1-数据结构的定义

示例：
C的结构体定义：

1. typedef struct Struct_Version{
2.    
3.         BYTE major;
4.         BYTE minor;
5. }VERSION;

复制代码

Java-JNA的对应的定义：
   

  

• getFieldOrder：必须存在的方法，里面的字符串跟结构体变量的顺序保持一致，没有会报错
    
  
• ByReference和ByValue：非必须的，在结构体类内部再定义两个静态类ByReference和ByValue 用于表示值传递还是引用传递，发起加上。
    
  
• 可增加其他方法：如果有需要对结构体完成某些操纵，可在后面增加方法，后面的部分结构体的部分中我会增加get和set方法，因为SKF接口中有涉及到将结构体转为byte*类型，或将byte*转为结构体的，以是增加get方法将结构体转为byte数组，set方法将byte数组转为结构体。
  
  

1. public static class VERSION extends Structure {
2.    
3.         public int major;
4.         public int minor;
6.             // 定义值传递和指针传递类
7.         public static class ByReference extends VERSION implements Structure.ByReference {
8.    
9.             //指针和引用的传递使用ByReference
10.         }
12.         public static class ByValue extends VERSION implements Structure.ByValue {
13.    
14.             //拷贝参数传递使用ByValue
15.         }
17.         @Override
18.         protected List<String> getFieldOrder() {
19.    
20.             return Arrays.asList(new String[]{
21.    "major", "minor"});
22.         }
23.     }

复制代码

2.2-SKF句柄相关

   SKF涉及到的句柄有：设备句柄、应用句柄、容器句柄、会话密钥句柄、哈希句柄
  C中的SKF相关的句柄：

1. DEVHANDLE *phDev = NULL;                                 // 设备句柄
2. HAPPLICATION *phApplicatio = NULL;                  // 应用句柄
3. HCONTAINER *phContaine = NULL;                        // 容器句柄
4. HANDLE *phKeyHandle = NULL;                                // 会话密钥句柄
5. HANDLE *phHash = NULL;                                        // 哈希句柄

复制代码

Java-JNA的SKF相关的句柄：

1. // 句柄的定义
2. PointerByReference phDev = new PointerByReference();// 设备句柄
3. PointerByReference phApp = new PointerByReference();// 应用句柄
4. PointerByReference phContainer = new PointerByReference();// 容器句柄
5. PointerByReference sessionKey = new PointerByReference();// 会话密钥句柄
6. PointerByReference pHash = new PointerByReference(); // 哈希句柄
8. // 在获取句柄的时候传PointerByReference引用，在后续使用句柄的时候用getValue的值，以获取设备句柄，和使用设备句柄接口定义为例：连接设备、断开连接
9. long SKF_ConnectDev(String szName, PointerByReference phDev); // 连接设备
10. long SKF_DisConnectDev(Pointer hDev);//断开连接
12. // 示例
13. PointerByReference phDev = new PointerByReference();
14. SKF_ConnectDev(deviceName, phDev)
15. // 调用SKF_ConnectDev接口后，用getValue方法获取指针
16. Pointer hDev = phDev.getValue();
17. SKF_DisConnectDev(hDev)

复制代码

2.3-注意事项

   

  

• SKF接口中定义为BOOL类型的参数，在Java-JNA中用int类型表示：1表示true，0表示false
  
     
  
  • 原因：如果用Java的Boolean类型传，可能会出现传true和false的效果一样   
    
     
  
• 大小端序问题：
  
     
  
  • 将数据以byte数组输出大概将byte数据输入（或转为结构体）时要注意此问题，SKF接口是小端序输出的。   
    
    
  

  2.4-SKFApi内容

   请根据实际情况加载的动态库：

1. import com.sun.jna.*;
2. import com.sun.jna.ptr.ByteByReference;
3. import com.sun.jna.ptr.IntByReference;
4. import com.sun.jna.ptr.LongByReference;
5. import com.sun.jna.ptr.PointerByReference;
7. import java.nio.ByteBuffer;
8. import java.nio.ByteOrder;
9. import java.util.Arrays;
10. import java.util.List;
13. public interface SkfApi extends Library {
14.    
15.     SkfApi INSTANCE = Native.load("your_dll_name", SkfApi.class);
17.     //设备操作
18.     long SKF_EnumDev(int bPresent, ByteByReference szNameList, IntByReference pulSize);
20.     long SKF_ConnectDev(String szName, PointerByReference phDev);
22.     long SKF_DisConnectDev(Pointer hDev);
24.     long SKF_GetDevInfo(Pointer hDev, DEVINFO pDevInfo);
26.     //应用操作
27.     int SKF_EnumApplication(Pointer hDev, ByteByReference szAppName, IntByReference pulSize);
29.     int SKF_CreateApplication(Pointer hDev, String szAppName, String szAdminPin, int dwAdminPinRetryCount, String szUserPin, int dwUserPinRetryCount, int dwCreateFileRights, PointerByReference hApp);
31.     int SKF_OpenApplication(Pointer hDev, String appName, PointerByReference hApp);
33.     int SKF_CloseApplication(Pointer hApp);
35.     //访问控制
36.     int SKF_ChangeDevAuthKey(Pointer hDev, byte[] pbKeyValue, int ulKeyLen);
38.     int SKF_DevAuth(Pointer hDev, byte[] pbAuthData, int ulLen);
40.     int SKF_ChangePIN(Pointer hApplication, int ulPINType, String oldPIN, String newPIN, IntByReference pulRetryCount);
42.     int SKF_GetPINInfo(Pointer hApplication, int ulPINType, IntByReference pulMaxRetryCount, IntByReference pulRemainRetryCount, IntByReference pbDefaultPin);
44.     int SKF_VerifyPIN(Pointer hApplication, int ulPINType, String szPIN, IntByReference pulRetryCount);
46.     int SKF_UnblockPIN(Pointer hApplication, String szAdminPIN, String szNewUserPIN, IntByReference pulRetryCount);
48.     int SKF_ClearSecueState(Pointer hApplication);
50.     //容器管理
51.     int SKF_CreateContainer(Pointer hApplication, String szContainerName, PointerByReference phContainer);
53.     int SKF_DeleteContainer(Pointer hApplication, String szContainerName);
55.     int SKF_EnumContainer(Pointer hApplication, byte[] szContainerName, IntByReference pulSize);
57.     int SKF_OpenContainer(Pointer hApplication, String szContainerName, PointerByReference phContainer);
59.     int SKF_CloseContainer(Pointer hContainer);
61.     int SKF_GetContainerType(Pointer hContainer, IntByReference pulContainerType);
63.     // 密码服务
64.     // int SKF_ExportCertificate(Pointer hContainer, boolean bSignFlag, byte[] pbCert, IntByReference pulCertLen);
65.     // 接口中的boolean 都要改为int类型，1表示true，0表示false，如果是传boolean类型，不管是传true还是false，实际结果否是false的结果
66.     int SKF_ExportCertificate(Pointer hContainer, int bSignFlag, byte[] pbCert, IntByReference pulCertLen);
68.     //int SKF_ImportCertificate(Pointer hContainer, boolean bSignFlag, byte[] pbCert, IntByReference pulCertLen);
69.     // 接口中的boolean 都要改为int类型，1表示true，0表示false，如果是传boolean类型，不管是传true还是false，实际结果否是false的结果
70.     int SKF_ImportCertificate(Pointer hContainer, int bSignFlag, byte[] pbCert, IntByReference pulCertLen);
72.     int SKF_EncryptInit(Pointer hKey, BLOCKCIPHERPARAM EncryptParam);
74.     int SKF_Encrypt(Pointer hKey, byte[] pbData, int ulDataLen, byte[] pbEncryptedData, IntByReference pulEncryptedLen);
76.     int SKF_EncryptUpdate(Pointer hKey, byte[] pbData, int ulDataLen, byte[] pbEncryptedData, IntByReference pulEncryptedLen);
78.     int SKF_EncryptFinal(Pointer hKey, byte[] pbEncryptedData, IntByReference ulEncryptedDataLen);
80.     int SKF_DecryptInit(Pointer hKey, BLOCKCIPHERPARAM DecryptParam);
82.     int SKF_Decrypt(Pointer hKey, byte[] pbEncryptedData, int ulEncryptedLen, byte[] pbData, IntByReference pulDataLen);
84.     int SKF_DecryptFinal(Pointer hKey, byte[] pbDecryptedData, IntByReference pulDecryptedDataLen);
86.     //int SKF_ExportPublicKey(Pointer hContainer, boolean bSignFlag, byte[] pbBlob, IntByReference pulBlobLen);
87.     // 接口中的boolean 都要改为int类型，1表示true，0表示false，如果是传boolean类型，不管是传true还是false，实际结果否是false的结果
88.     int SKF_ExportPublicKey(Pointer hContainer, int bSignFlag, byte[] pbBlob, IntByReference pulBlobLen);
90.     int SKF_GenECCKeyPair(Pointer hContainer, NativeLong ulAlgId, ECCPUBLICKEYBLOB pBlob);
92.     int SKF_DigestInit(Pointer hDev, int ulAlgID, ECCPUBLICKEYBLOB pPubKey, byte[] pucID, int ulIDLen, PointerByReference phHash);
94.     int SKF_Digest(Pointer hHash, byte[] pbData, int ulDataLen, byte[] pbHashData, IntByReference pulHashLen);
96.     int SKF_DigestUpdate(Pointer hHash, byte[] pbData, int ulDataLen);
98.     int SKF_DigestFinal(Pointer hHash, byte[] pHashData, IntByReference pulHashLen);
100.     int SKF_RSASignData(Pointer hContainer,byte[] pbData, int ulDataLen,byte[]pbSignature,IntByReference pulSignLen);
102.     int SKF_RSAVerify(Pointer hContainer,RSAPUBLICKEYBLOB pPubKey,byte[] pbData, int ulDataLen,byte[]pbSignature,int ulSignLen);
104.     int SKF_ECCSignData(Pointer hContainer, byte[] pbData, int ulDataLen, ECCSIGNATUREBLOB pSignature);
106.     int SKF_ECCVerify(Pointer hDev, ECCPUBLICKEYBLOB pECCPubKeyBlob, byte[] pbData, int ulDataLen, ECCSIGNATUREBLOB pSignature);
108.     int SKF_RSAExportSessionKey(Pointer hContainer, int ulAlgId, RSAPUBLICKEYBLOB pPubKey, byte[] pData, IntByReference pulDataLen, PointerByReference phSessionKey);
110.     int SKF_ECCExportSessionKey(Pointer hContainer, int ulAlgId, ECCPUBLICKEYBLOB pPubKey, ECCCIPHERBLOB pData, PointerByReference phSessionKey);
112.     int SKF_ImportECCKeyPair(Pointer hContainer, ENVELOPEDKEYBLOB pEnvelopedKeyBlob);
114.     int SKF_ExtECCSign(Pointer hDev, ECCPRIVATEKEYBLOB pECCPriKeyBlob, byte[] pbData, int ulDataLen, ECCSIGNATUREBLOB pSignature);
116.     int SKF_ExtECCVerify(Pointer hDev, ECCPUBLICKEYBLOB pECCPubKeyBlob, byte[] pbData, int ulDataLen, ECCSIGNATUREBLOB pSignature);
118.     int SKF_ExtECCEncrypt(Pointer hDev, ECCPUBLICKEYBLOB pECCPubKeyBlob, byte[] pbPlainText, int ulPlainTextLen, ECCCIPHERBLOB pCipherText);
120.     int SKF_ExtECCDecrypt(Pointer hDev, ECCPRIVATEKEYBLOB pECCPriKeyBlob, ECCCIPHERBLOB pCipherText, byte[] pbPlainText, IntByReference pulPlainTextLen);
122.     int SKF_ImportSessionKey(Pointer hCnt, int ulAlgId, byte[] pbWrapedData, int ulWrapedLen, PointerByReference hkey);
124.     int SKF_SetSymmKey(Pointer hDev, byte[] pbKey, int ulAlgID, PointerByReference phKey);
126.     int SKF_CloseHandle(Pointer hHandle);
128.     public static class VERSION extends Structure {
129.    
130.         public int major;
131.         public int minor;
133.         public static class ByReference extends VERSION implements Structure.ByReference {
134.    
135.         }
137.         public static class ByValue extends VERSION implements Structure.ByValue {
138.    
139.         }
141.         @Override
142.         protected List<String> getFieldOrder() {
143.    
144.             return Arrays.asList(new String[]{
145.    "major", "minor"});
146.         }
147.     }
149.     public static class DEVINFO extends Structure {
150.    
151.         public VERSION Version;
152.         public byte[] Manufacturer = new byte[64];
153.         public byte[] Issuer = new byte[64];
154.         public byte[] Label = new byte[32];
155.         public byte[] SerialNumber = new byte[32];
156.         public VERSION HWVersion;
157.         public VERSION FirmwareVersion;
158.         public int AlgSymCap;
159.         public int AlgAsymCap;
160.         public int AlgHashCap;
161.         public int DevAuthAlgId;
162.         public int TotalSpace;
163.         public int FreeSpace;
164.         public byte[] Reserved = new byte[64];
166.         public static class ByReference extends DEVINFO implements Structure.ByReference {
167.    
168.         }
170.         public static class ByValue extends DEVINFO implements Structure.ByValue {
171.    
172.         }
174.         @Override
175.         protected List<String> getFieldOrder() {
176.    
177.             return Arrays.asList(new String[]{
178.    "Version", "Manufacturer", "Issuer", "Label", "SerialNumber", "HWVersion", "FirmwareVersion", "AlgSymCap", "AlgAsymCap", "AlgHashCap", "DevAuthAlgId" , "TotalSpace", "FreeSpace", "Reserved"});
179.         }
180.     }
182.     public static class BLOCKCIPHERPARAM extends Structure {
183.    
184.         public byte[] IVS = new byte[32];
185.         public int IVLen = 0;
186.         public int PaddingType = 0;
187.         public int FeedBitLen = 0;
189.         @Override
190.         protected List<String> getFieldOrder() {
191.    
192.             return Arrays.asList(new String[]{
193.    "IVS", "IVLen", "PaddingType", "FeedBitLen"});
194.         }
195.         public static class ByReference extends BLOCKCIPHERPARAM implements Structure.ByReference {
196.    
197.         }
198.         public static class ByValue extends BLOCKCIPHERPARAM implements Structure.ByValue {
199.    
200.         }
201.         public void setBlobCipherParam(byte[] IV, int ivLen, int PaddingType, int FeedBitLen){
202.    
203.             this.IVS = IV;
204.             this.IVLen = ivLen;
205.             this.PaddingType = PaddingType;//填充方式，0表示不填充，1表示按照PKCS5方式进行填充。
206.             this.FeedBitLen = FeedBitLen;
207.         }
208.     }
210.     public static class ECCPUBLICKEYBLOB extends Structure {
211.    
212.         public static final int ECC_MAX_XCOORDINATE_BITS_LEN = 512;
213.         public static final int ECC_MAX_YCOORDINATE_BITS_LEN = 512;
214.         public int BitLen;
215.         public byte[] XCoordinate = new byte[ECC_MAX_XCOORDINATE_BITS_LEN / 8];
216.         public byte[] YCoordinate = new byte[ECC_MAX_YCOORDINATE_BITS_LEN / 8];
218.         @Override
219.         protected List<String> getFieldOrder() {
220.    
221.             return Arrays.asList(new String[]{
222.    "BitLen", "XCoordinate", "YCoordinate"});
223.         }
224.         public static class ByReference extends ECCPUBLICKEYBLOB implements Structure.ByReference {
225.    
226.         }
227.         public static class ByValue extends ECCPUBLICKEYBLOB implements Structure.ByValue {
228.    
229.         }
231.         public byte[] getEccPublicBlob() {
232.    
233.             byte[] eccPublicBlob = new byte[132];
234.             int bitLenInt = this.BitLen;
235.             byte[] bitLenBytes = new byte[3];
236.             bitLenBytes[2] = (byte) (bitLenInt & 0xFF); // 最低有效字节
237.             bitLenBytes[1] = (byte) ((bitLenInt >> 8) & 0xFF);
238.             bitLenBytes[0] = (byte) ((bitLenInt >> 16)

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。