调用阿里云身份证识别服务识别本舆图片，很具体，附工具类 ...

一、先购买阿里云的身份证识别服务，拿到对应的AccessKey ID 和 AccessKey Secret

二、在项目中添加阿里云的相关依赖，找到对应的工具类，这里用的是新版依赖

1、引入阿里云图片识别的依赖

1. <dependency>
2.     <groupId>com.aliyun</groupId>
3.     <artifactId>ocr20191230</artifactId>
4.     <version>${aliyun.ocr.version}</version>
5. </dependency>

复制代码

这是对应的依赖版本号查询地点，新版和旧版的依赖都可以在这里查
   https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-ocr
  接入步调中的依赖我只添加了这个，json处置惩罚的依赖包项目本身就有，看本身环境，没有缺少对应的依赖就不需要添加了。
这是阿里云的示例地点
   https://help.aliyun.com/document_detail/153132.htm?spm=a2c4g.11186623.0.0.65296d04gaIiFP#task-2406409
  2、查询引入依赖，看是否导入成功

但是在调用过程发现引入依赖后与示例有点不一样！！！
我并没有看到com.aliyuncr:0.0.3这个依赖，以为是版本的题目，但看了一下也没有0.0.3这个版本
这是阿里云示例地点中的截图

这是我引入的阿里云依赖后，找到最像示例中的依赖包

   RecognizeBankCardAdvanceRequest和RecognizeBankCardRequest这两个类倒是有，但是我的models包下面没有Config这个类，当时就想，示例代码中是需要这个类的，就算是高版本的jar包也不应该删了啊，保留疑问继续往下走。
  既然和示例中的jar包有些出入，就先看看识别身份证的相关类吧，阿里云示例中提到
   对于同一个接口，如果 SDK 中包含雷同 xxxAdvanceRequest 的结构，那么这个接口支持本地文件上传，否则不支持。
  示例截图中框的是识别银行卡的，我需要的是识别身份证的，那就找相关的工具类吧。
3、这是我找工具类的过程，可以跳过

（1）、识别身份证的类

识别身份证的是RecognizeIdentityCardAdvanceRequest和RecognizeIdentityCardRequest，其中RecognizeIdentityCardAdvanceRequest支持本地上传，那么就用这个。

识别本舆图片的话，就将本舆图片的输入流赋值给RecognizeIdentityCardAdvanceRequest实例的imageURLObject属性，示例代码中也有提到。
（2）、调用服务的类

调用身份证识别的服务需要Client这个类，通过在Client实例的recognizeIdentityCardAdvance方法中传入RecognizeIdentityCardAdvanceRequest实例进行图片识别，阿里云示例中没有明说Client这个是谁人包中，引入的依赖和示例截图中（不同依赖）都有这个类，当时就想着先使用已经引入的依赖中的Client类，不行再换。

（3）、调用服务的类需要的Config实例，也是前面提到的没有看到的Config类

在实例化Client这个类中需要传入Config类的示例，由于modules中没有Config，进入Client源码，发现使用的是com.aliyun.teaopenapi.models这个包下的Config，行，那就用这个吧。

（4）、Config实例传参

一开始还不知道Config实例如何传参，后面看到阿里云身份证识别产品体验的示例代码（示例代码是旧版依赖的调用方式）中传了regionId、AccessKey ID 和 AccessKey Secret，加上Config确实有对应的变量，那就传这三个参数试试吧。
这是阿里云产品体验中央的代码：

三、示例代码

   Config实例中的regionId相沿示例代码中的cn-shanghai。
  运行测试一下

识别成功！
完整代码如下：

1. import com.aliyun.ocr20191230.Client;
2. import com.aliyun.ocr20191230.models.RecognizeIdentityCardAdvanceRequest;
3. import com.aliyun.ocr20191230.models.RecognizeIdentityCardResponse;
4. import com.aliyun.teaopenapi.models.Config;
5. import com.aliyun.teautil.models.RuntimeOptions;
6. import com.aliyuncs.exceptions.ClientException;
7. import com.aliyuncs.exceptions.ServerException;
8. import com.google.gson.Gson;
10. import java.io.File;
11. import java.io.FileInputStream;
12. import java.io.InputStream;
14. /**
15. * TODO
16. *
17. * @author：user
18. * @date: 2022-08-08 14:21
19. */
20. public class IdCardIdentifyUtil {
22.     public static void main(String[] args) throws Exception {
23.         Config config = new Config();
24.         config.setAccessKeyId("你的accessKeyId");
25.         config.setAccessKeySecret("你的accessKeySecret");
26.         config.setRegionId("cn-shanghai");
28.         Client client = new Client(config);
30.         InputStream inputStream = new FileInputStream(new File("D:\\opt\\jeecg-boot\\upload\\temp\\upload_1644998658029.jpg"));
32.         //这是上传本地图片的
33.         RecognizeIdentityCardAdvanceRequest request = new RecognizeIdentityCardAdvanceRequest();
34.         request.setSide("face");
35.         request.imageURLObject = inputStream;
37.         //识别本地图片才要上传，但只是new一个实例进行传参，也没做什么
38.         RuntimeOptions runtimeOptions = new RuntimeOptions();
40.         RecognizeIdentityCardResponse response = null;
41.         try {
42.             response = client.recognizeIdentityCardAdvance(request, runtimeOptions);
43.         } catch (ServerException e) {
44.             e.printStackTrace();
46.             throw new RuntimeException(e.getMessage());
47.         } catch (ClientException e) {
48.             System.out.println("ErrCode:" + e.getErrCode());
49.             System.out.println("ErrMsg:" + e.getErrMsg());
50.             System.out.println("RequestId:" + e.getRequestId());
52.             throw new RuntimeException("ErrCode:" + e.getErrCode() + "，ErrMsg:" + e.getErrMsg());
53.         }
55.         System.out.println("response:：" + new Gson().toJson(response));
56.     }
58. }

复制代码

四、工具类

这是我改造后的工具类，个人以为比较适合在项目中使用。
1、身份证识别服务的请求参数

1. import lombok.Data;
3. /**
4. * 身份证识别接口的参数
5. *
6. * @author：user
7. * @date: 2022-08-08 15:28
8. */
9. @Data
10. public class IdCardRequestParam {
12.     //阿里云accessKeyId
13.     private String accessKeyId;
15.     //阿里云accessSecret
16.     private String accessSecret;
18.     //阿里云识别身份证的regionId，设置请求参数的方法有横线，似乎废弃了
19.     private String regionId;
21.     //身份证正反面
22.     private String side;
24.     //上传图片路径
25.     private String imageURL;
26. }

复制代码

2、身份证正面识别的吸收dto

1. import lombok.Data;
3. /**
4. * 身份证正面dto
5. *
6. * @author：user
7. * @date: 2022-08-08 14:59
8. */
9. @Data
10. public class IdCardFrontDto {
12.     //地址
13.     private String Address;
15.     //出生日期
16.     private String BirthDate;
18.     //性别
19.     private String Gender;
21.     //身份证号码
22.     private String IDNumber;
24.     //姓名
25.     private String Name;
27.     //民族
28.     private String Nationality;
30.     //身份证位置，目前没有用到
31.     private String CardAreas;
32. }

复制代码

3、身份证反面识别的吸收dto

1. import lombok.Data;
3. /**
4. * 身份证反面dto
5. *
6. * @author：user
7. * @date: 2022-08-08 15:09
8. */
9. @Data
10. public class IdCardBackDto {
12.     //开始日期
13.     private String StartDate;
15.     //结束日期
16.     private String EndDate;
18.     //发证机关
19.     private String Issue;
20. }

复制代码

4、身份证正反面枚举类

1. /**
2. * 身份证正反面枚举类
3. *
4. * @author：user
5. * @date: 2022-08-08 16:09
6. */
7. public enum IdCardSideEnum {
8.     FACE("face", "人像面"),
9.     BACK("back", "国徽面");
11.     private String code;
12.     private String desc;
14.     IdCardSideEnum(String code, String desc) {
15.         this.code = code;
16.         this.desc = desc;
17.     }
19.     public String getCode() {
20.         return code;
21.     }
23.     public void setCode(String code) {
24.         this.code = code;
25.     }
27.     public static String getDesc(String code) {
28.         for (IdCardSideEnum value : IdCardSideEnum.values()) {
29.             if (value.code.equals(code))
30.                 return value.desc;
31.         }
32.         throw new RuntimeException("未知状态：" + code);
33.     }
35.     public String getDesc() {
36.         return desc;
37.     }
39.     public void setDesc(String desc) {
40.         this.desc = desc;
41.     }
42. }

复制代码

5、身份证识别工具类

1. import com.alibaba.fastjson.JSONObject;
2. import com.aliyun.ocr20191230.Client;
3. import com.aliyun.ocr20191230.models.RecognizeIdentityCardAdvanceRequest;
4. import com.aliyun.ocr20191230.models.RecognizeIdentityCardResponse;
5. import com.aliyun.teaopenapi.models.Config;
6. import com.aliyun.teautil.models.RuntimeOptions;
7. import com.aliyuncs.exceptions.ClientException;
8. import com.aliyuncs.exceptions.ServerException;
9. import com.google.gson.Gson;
11. import org.jeecg.common.util.VerifyUtil;
12. import org.jeecg.modules.aliyun.enums.IdCardSideEnum;
13. import org.jeecg.modules.aliyun.dto.IdCardBackDto;
14. import org.jeecg.modules.aliyun.dto.IdCardFrontDto;
15. import org.jeecg.modules.aliyun.dto.IdCardRequestParam;
17. import java.io.File;
18. import java.io.FileInputStream;
19. import java.io.InputStream;
21. /**
22. * TODO
23. *
24. * @author：user
25. * @date: 2022-08-08 14:21
26. */
27. public class IdCardIdentifyUtil {
29.     /**
30.      * 识别身份证，泛型方法
31.      * @param param 识别身份证需要的参数
32.      * @param c 识别身份证正面传IdCardFrontDto.class；识别身份证反面传IdCardBackDto.class
33.      * @param <T>
34.      * @return
35.      */
36.     public static <T> T getIdCardInfo(IdCardRequestParam param, Class<T> c) throws Exception {
37.         VerifyUtil.checkBean(param); //这是之前写的一个校验方法，可以用自己的方式校验空值，之前的博客中也有该方法的代码
39.         //校验传入身份证正反面码是否合法
40.         String side = param.getSide();
41.         IdCardSideEnum.getDesc(side);
43.         if (IdCardSideEnum.FACE.getCode().equals(side) && !IdCardFrontDto.class.equals(c))
44.             throw new RuntimeException("识别身份证正面，应传入【IdCardFrontDto.class】");
46.         if (IdCardSideEnum.BACK.getCode().equals(side) && !IdCardBackDto.class.equals(c))
47.             throw new RuntimeException("识别身份证反面，应传入【IdCardBackDto.class】");
49.         String regionId = param.getRegionId();
51.         //这是阿里云身份证识别案例代码中拿过来的
52.         Config config = new Config();
53.         config.setAccessKeyId(param.getAccessKeyId());
54.         config.setAccessKeySecret(param.getAccessSecret());
55.         config.setRegionId(regionId);
57.         Client client = new Client(config);
59.         //这是识别网络路径的，需要开通oss服务
60. //        RecognizeIdentityCardRequest request = new RecognizeIdentityCardRequest();
61.         request.setRegionId(param.getRegionId());
62. //        request.setSide(side);
63. //        request.setImageURL(param.getImageURL());
65.         InputStream inputStream = new FileInputStream(new File(param.getImageURL()));
67.         //这是上传本地图片的
68.         RecognizeIdentityCardAdvanceRequest request = new RecognizeIdentityCardAdvanceRequest();
69.         request.setSide(side);
70.         request.imageURLObject = inputStream;
72.         //识别本地图片才要上传，但只是new一个实例进行传参，也没做什么
73.         RuntimeOptions runtimeOptions = new RuntimeOptions();
75.         RecognizeIdentityCardResponse response = null;
76.         try {
77.             response = client.recognizeIdentityCardAdvance(request, runtimeOptions);
78.         } catch (ServerException e) {
79.             e.printStackTrace();
81.             throw new RuntimeException(e.getMessage());
82.         } catch (ClientException e) {
83.             System.out.println("ErrCode:" + e.getErrCode());
84.             System.out.println("ErrMsg:" + e.getErrMsg());
85.             System.out.println("RequestId:" + e.getRequestId());
87.             throw new RuntimeException("ErrCode:" + e.getErrCode() + "，ErrMsg:" + e.getErrMsg());
88.         }
90.         System.out.println("response:：" + response);
92.         //将返回的json转化成JSONObject
93.         JSONObject responseJsonObject = JSONObject.parseObject(new Gson().toJson(response));
95.         //返回结果中嵌套了data，不能写错，data就是身份证的信息，
96.         //身份证正反面的返回键不一样，需要单独处理
97.         JSONObject idCardJsonObject = responseJsonObject.getJSONObject("body").getJSONObject("data");
99.         String idCardDataStr = null;
100.         if (IdCardSideEnum.FACE.getCode().equals(side)) {
101.             idCardDataStr = idCardJsonObject.getString("frontResult");
102.         } else if (IdCardSideEnum.BACK.getCode().equals(side)) {
103.             idCardDataStr = idCardJsonObject.getString("backResult");
104.         }
106.         return JSONObject.parseObject(idCardDataStr, c);
107.     }
109. }

复制代码

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