# fasc-openapi-java-sdk

**Repository Path**: gtiger666/fasc-openapi-java-sdk

## Basic Information

- **Project Name**: fasc-openapi-java-sdk
- **Description**: 法大大FASC OpenAPI  Java语言版SDK
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2022-03-29
- **Last Updated**: 2022-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FASC OpenApi Java SDK 说明

# 简介

欢迎使用法大大开发者工具套件（SDK），Java SDK 是法大大电子合同和电子签云服务开放平台（FASC OPEN API）的配套工具。

# 模块说明

- SDK 目前支持以下模块，对应 client 可支持具体的业务方法：

| 模块               | 模块中文名       | 模块说明                                                     |
| ------------------ | ---------------- | ------------------------------------------------------------ |
| ServiceClient      | 服务访问凭证     | 获取服务访问凭证                                             |
| UserClient         | 个人用户管理     | 包含个人用户信息增删改查、认证、授权                         |
| CorpClient         | 企业用户账号管理 | 包含企业用户信息增删改查、认证、授权                         |
| FileClient          | 文件管理         | 包含文件和附件上传                                           |
| DocTemplateClient  | 文档模板管理     | 包含文档模板列表、详情查询                                   |
| SignTemplateClient | 签署模板管理     | 包含签署模板列表、详情查询                                   |
| SignTaskClient     | 签署任务管理     | 包含签署任务的创建、维护、各个流程节点的流转操作，以及签署任务文件下载 |
| BillingClient      | 计费             | 获取计费页面链接，用于账户信息查询或套餐订购                 |
| CorpManageClient   | 企业管理         | 对指定模块进行管理操作，如印章管理、模块管理PUI等               |

# 依赖环境

JAVA JDK 版本: JDK 1.7-1.8

# 安装说明

## 引用jar包
[jar包下载](https://gitee.com/fadada-cloud/fasc-openapi-java-sdk/releases)
​ 引入sdk 所依赖的jar包，提供全流程的方法，提供的方法调用云端法大大api服务。

```text
    <dependency>
        <groupId>org.apache.httpcomponents</groupId>
        <artifactId>httpclient</artifactId>
        <version>4.5.12</version>
    </dependency>
    <dependency>
        <groupId>org.apache.httpcomponents</groupId>
        <artifactId>httpmime</artifactId>
        <version>4.5.8</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.10.1</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.7.25</version>
    </dependency>
    <dependency>
        <groupId>commons-logging</groupId>
        <artifactId>commons-logging</artifactId>
        <version>1.2</version>
    </dependency>

```

## 始化客户端

项目启动后必须先进行初始化，才能调用jar包方法。初始化仅需一次，之后可重复使用。

法大大分配的appId，appSecret，API请求地址在初始化时作为入参传入，请求超时配置、序列化策率可以初始化后设置。

```java
        //法大大分配的appId
        String appId="xxxxx";
                //法大大分配的appId对应的秘钥
                String appSecret="xxxxx";
                //API请求地址
                String serverUrl="";

                // 初始化客户端
                OpenApiClient openApiClient=new OpenApiClient(appId,appSecret,serverUrl);

                // http超时配置设置， 默认不设置超时时间
                // 如果不设置超时时间 该设置可忽略
                HttpConfig httpConfig=new HttpConfig();
                httpConfig.setConnectTimeout(1000000);
                httpConfig.setReadTimeout(1000000);
                openApiClient.setHttpConfig(httpConfig);

                // Json序列化策率，默认使用Jackson，如果要使用其他如FastJson,Gson等实现JsonStrategy接口即可
                // 如果使用默认该设置可以忽略
                openApiClient.setJsonStrategy(new DefaultJsonStrategy());
```

## 业务方法调用

下面添加个人用户的方法调用为例展示调用过程：

```java
        // 初始化业务客户端
        ServiceClient serviceClient=new ServiceClient(openApiClient);
                // 获取accessToken
                BaseRes<AccessTokenRes> res=serviceClient.getAccessToken();
        String accessToken=res.getData().getAccessToken();

        // 添加个人用户
        UserClient userClient=new UserClient(openApiClient);
        AddUserReq addUserReq=new AddUserReq();
        addUserReq.setAccessToken(accessToken);
        addUserReq.setClientUserId("clientUserId值客户自定义");
        addUserReq.setClientUserName("用户名称");
        BaseRes<AddOpenUserRes> addUserRes=userClient.add(addUserReq);
```

更多示例详见demo代码。



# 参考

FASC OpenAPI (服务端) 接口文档

https://dev.fadada.com/api-doc/W6MIOHNFNT/90M5Y9AS1ZWEWHLE