# face-java-sdk-config-spring-boot-starter

**Repository Path**: dbin0123/face-java-sdk-config-spring-boot-starter

## Basic Information

- **Project Name**: face-java-sdk-config-spring-boot-starter
- **Description**: face-java-sdk spring boot使用
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-10-04
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 旷视人工智能开放平台API SDK

## 介绍

Face++ and FaceID Java SDK

## API文档 

- [Face++](https://console.faceplusplus.com.cn/documents/4887579)
- [FaceID](https://faceid.com/pages/documents)

## 安装使用
### Maven
在项目的pom.xml的dependencies中加入以下内容:

```
<dependency>
  <groupId>com.aiwiown.face</groupId>
  <artifactId>face-java-sdk-config-spring-boot-starter</artifactId>
  <version>${latest.version}</version>
</dependency>
```

### Gradle
```
compile 'com.aiwiown.face:face-java-sdk-config-spring-boot-starter:${latest.version}'
```
### 非Maven项目

点击以下任一链接，下载最新版本`face-java-sdk-config-spring-boot-starter-X.X.X.jar`即可：

- [Maven中央库1](https://repo1.maven.org/maven2/com/aiwiown/face/face-java-sdk-config-spring-boot-starter/)
- [Maven中央库2](https://search.maven.org/artifact/com.aiwiown.face/face-java-sdk-config-spring-boot-starter/)

### 编译安装

访问face-java-sdk-config-spring-boot-starter的码云主页：[https://gitee.com/dbin0123/face-java-sdk-config-spring-boot-starter](https://gitee.com/dbin0123/face-java-sdk-config-spring-boot-starter) 下载整个项目源码然后进入face-java-sdk-config-spring-boot-starter项目目录执行：
- master:已发布版本到中央仓库
- develop: 最新功能和fixbug分支

```
mvn clean install -DskipTests
```

然后就可以使用Maven引入了。

## 项目中使用

#### 以其中一个接口为例,其他类似(参数相关根据自有项目业务自定义即可)
```properties
        
    # 配置文件录入
    face.api.server-url=faceId或face++的服务端请求地址
    face.api.app-id=faceId或face++的应用id
    face.api.app-secret=faceId或face++的应用秘钥
    # 以下四个配置根据需求自定义即可,已有默认设置
    face.api.charset=字符集,默认 UTF-8 
    face.api.format=返回响应格式,默认 json 
    face.api.read-out-time=HTTP请求读取数据时间,单位(毫秒:ms)
    face.api.connect-time-out=HTTP请求读取数据时间,单位(毫秒:ms)

```
```java
    /**
    * spring boot方式
    */
    public String faceSearchTest() throws Exception {
        ApiClient apiClient = new BootDefaultApiClient();
        FaceSearchRequest request = new FaceSearchRequest();
        FaceSearchModel model = new FaceSearchModel();
        model.setOuterId("outerId");
        model.setImageFile(new File("ImageFilePath"));
        request.setBizModel(model);
        FaceSearchResponse response = apiClient.execute(request);
        System.out.println(response.isSuccess());
        System.out.println(response.toString());
        System.out.println(response.getBody());
        return new ObjectMapper().writeValueAsString(response);
    }
    
```