项目介绍

近期参加了阿里云的AI训练营，按照要求完成了一个 “身份证识别” 的 Web应用，特此记录一下。

由于之前使用过百度AI的人脸识别SDK，而且对阿里云比较熟悉，所以这篇博客侧重于对官方文档阅读理解，以及对给出的视频和项目Demo的理解及运用。

项目用到文档地址

阿里云达摩院视觉开放平台：https://vision.aliyun.com/

阿里云视觉开放平台文档地址：https://help.aliyun.com/product/142958.html?spm=a2c4g.11186623.6.540.263e3c74d59JVh

Aliyun Java SDK COCR 仓库地址：https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core

新版文字识别 Ocr20191230 仓库地址：https://mvnrepository.com/artifact/com.aliyun/ocr20191230

阿里云的2个Demo的github项目地址：https://github.com/aliyun/alibabacloud-viapi-demo

文章中的代码都是参考的这2个Demo

说明

经过多次尝试并仔细的阅读，发现官方提供的Demo中的引入和依赖和官方文档中引入的依赖有点区别。而且Demo中的 Config 类的配置和文档中的配置也存在一定的区别。

我是2种依赖和配置都测试过了，觉得官方文档中的配置的确有问题，会导致报错，于是选择了 Demo 中的配置。（后面会有详细说明）

这里只展示本地图片上传识别，没用到阿里云OOS对象存储服务；关于前端的一些代码逻辑也没有给出，只给出身份证识别关键部分的代码。

开始项目（配置参照Demo中的配置）

开通服务

按照文档中的说明，开通服务，不出意外的话很容易就开通成功了，如下图所示：

使用 Maven 导入SDK相关依赖

文档中说了提供2个版本的SDK，旧版需用阿里云OSS存储我们的图片，由于我用的是七牛云的图像存储，没用用阿里云，于是选择新版本SDK，支持本地图片上传。

这里我们选择使用官方提供的Demo中的依赖，而不是用官方文档中提供的依赖

我的导入的依赖

<dependency><groupId>com.aliyun</groupId><artifactId>ocr</artifactId><version>1.0.3</version>
</dependency>

创建 Config 类和 Client 类

参考文档中的说明，我们需要先创建一个 Config 类，将我们的 accessKeyId 和 accessKeySecret 以及一些其他的配置保存在 Config 类中，再通过 Config 类为参数创建 Client 类。

注意：Config 类和 Client 类都是位于 com.aliyun.ocr 包下面的类，导包的时候注意一下。

遇到的坑，文档中的配置存在 Bug，具体如下：

改进之后，我们关于 Config 类的配置及初始化应该这样（和官方提供的Demo中一样）

private Client client;
private RuntimeOptions runtime;@Value("${accessKeyId}")
private String accessKeyId;@Value("${accessKeySecret}")
private String accessKeySecret;@PostConstruct
private void init() throws Exception {Config config = new Config();config.type = "access_key";config.regionId = "cn-shanghai";config.accessKeyId = accessKeyId;config.accessKeySecret = accessKeySecret;config.endpoint = "ocr.cn-shanghai.aliyuncs.com";ocrClient = new Client(config);// 需要注意的是，这里我们创建一个 RuntimeOptions 对象，之后会用到这个对象runtime = new RuntimeOptions();
}

之后继续看文档

调用 Client 类的方法

（1）调用流程概述

文档中举了一个银行卡识别的例子，说白了就是创建一个 xxxRequest 对象，然后获取本地图片的数量流并赋值给 xxxRequest 对象的 imageURLObject 属性，以及将一些其他的配置放入 xxxRequest 对象中。

之后通过调用 Client 对象的 xxxAdvance() 方法，获得一个 xxxResponse 对象；然后我们只需要从这个 xxxResponse 对象中获取 JSON 字符串即可。

---

这个 xxx 代表了不同的场景，即不同的场景使用的类和方法都有所不同，不过名字都类似。具体的场景的参数也会有略微的不同，可以参看文档中关于该场景的详细描述。

（2）具体的使用

下面以身份证识别为例，看下文档中是如何描述的：

实际上在这里还可以进行调试，快速体验一下身份证识别：

我们在IDEA中查看查找相关的类

实际上这些场景对应的类都可以在我们添加Maven依赖之后导入的jar包中看到：

好了，看完了文档之后，我就使用身份证识别场景的类和方法对文档中的代码进行替换，效果如下

public String MyRecognizeIdCard(String filePath, String side) throws Exception {// 注意我们的类的名称和方法的名称RecognizeIdentityCardAdvanceRequest req = new RecognizeIdentityCardAdvanceRequest();InputStream inputStream = new FileInputStream(new File(filePath));req.imageURLObject = Files.newInputStream(Paths.get(filePath));req.side = side;RecognizeIdentityCardResponse rep = client.recognizeIdentityCardAdvance(req, runtime);// 这个 face 不是凭空产生的，是我们看完文档中，文档中给出的值if ("face".equals(side)) {// 正面识别，通过阿里巴巴的 fastjson 将这个 fromResult 类转换为 JSON 格式的字符串并返回return JSON.toJSONString(rep.data.frontResult);} else {// 反面识别return JSON.toJSONString(rep.data.backResult);}
}

之后我们在测试类中进行测试

@Autowired
private OcrService ocrService;@Test
void contextLoads() {try {String face = ocrService.MyRecognizeIdCard("D:\\Temp\\images\\_2020053011373037SS.png", "face");System.out.println("face = " + face);String backface = ocrService.MyRecognizeIdCard("D:\\Temp\\images\\IMG20200530112702.jpg", "back");System.out.println("back = " + backface);} catch (TeaException e) {System.out.println(e.getData());} catch (Exception e) {e.printStackTrace();}
}

由于我的图片打了马赛克，所以只能识别出部分结果，结果如下所示

关于使用文档中的配置

我照着文档一步一步来，和文档一样的代码，依赖也是一样的，莫名其妙会报错。不知道是我自己的原因还是文档本来就有错，反正我的代码就是跑不起来，这里展示一下我的报错的代码，希望有小伙伴可以发现问题并解决。

初始化部分 ----> 关键就是没有将 config.endpointType=“internal”; 注释掉

我引入的Maven依赖

<!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core -->
<dependency><groupId>com.aliyun</groupId><artifactId>aliyun-java-sdk-core</artifactId><version>4.5.1</version>
</dependency><!-- https://mvnrepository.com/artifact/com.aliyun/ocr20191230 -->
<dependency><groupId>com.aliyun</groupId><artifactId>ocr20191230</artifactId><version>0.0.3</version>
</dependency>

报错