Java

GitHub 仓库 或 Coding 仓库

项目说明

项目通过 maven 引入了腾讯云 sdk，补充了调用电子签第三方应用集成 API 所需要的内容，并提供了调用的样例。使用前请先在项目中导入腾讯云 sdk。

<dependency>
    <!-- go to https://search.maven.org/search?q=tencentcloud-sdk-java and get the latest version. -->
    <!-- 请到https://search.maven.org/search?q=tencentcloud-sdk-java查询所有版本 -->
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-java-essbasic</artifactId>
    <version>3.1.557</version>
</dependency>

通过 maven 安装腾讯云 sdk

通过 maven 获取腾讯云 sdk 是使用 Java SDK 的推荐方法，maven 是 Java 的依赖管理工具，支持您项目所需的依赖项，并将其安装到项目中。关于 maven 详细可参考 maven 官网。

1. 安装 maven

   1.1 windows 环境请访问maven 官网下载安装包安装。

   设置 Maven 环境变量

添加环境变量 MAVEN_HOME： 右键 "计算机"，选择 "属性"，之后点击 "高级系统设置"，点击"环境变量"，来设置环境变量，有以下系统变量需要配置：

新建系统变量 MAVEN_HOME，变量值为安装目录如：E:\Maven\apache-maven-3.3.9

编辑系统变量 Path，添加变量值：;%MAVEN_HOME%\bin

注意：注意多个值之间需要有分号隔开，然后点击确定。

1.2 Linux 环境在命令行中执行以下命令安装。

# wget http://mirrors.hust.edu.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz
# tar -xvf  apache-maven-3.3.9-bin.tar.gz
# sudo mv -f apache-maven-3.3.9 /usr/local/

编辑 /etc/profile 文件 sudo vim /etc/profile，在文件末尾添加如下代码：

export MAVEN_HOME=/usr/local/apache-maven-3.3.9
export PATH=${PATH}:${MAVEN_HOME}/bin

保存文件，并运行如下命令使环境变量生效：

# source /etc/profile

在控制台输入如下命令，如果能看到 Maven 相关版本信息，则说明 Maven 已经安装成功：

# mvn -v

2. 在 pom.xml 中引入以下依赖

<dependency>
    <!-- go to https://search.maven.org/search?q=tencentcloud-sdk-java and get the latest version. -->
    <!-- 请到https://search.maven.org/search?q=tencentcloud-sdk-java查询所有版本 -->
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-java-essbasic</artifactId>
    <version>3.1.557</version>
</dependency>

目录文件说明

com.tencent.essbasic.api

api 目录是对电子签第三方应用集成所有 API 的简单封装，以及调用的 Example（可以直接运行 main 函数进行测试）。 如果需要 API 更加高级的功能，需要结合业务修改 api 的封装。

注意部分参数需要用户结合实际业务进行调整

com.tencent.essbasic.byfile

byfile 目录是电子签第三方应用集成的核心场景之一：通过文件发起的快速上手样例。 ByFileQuickStart 一键使用文件发起流程：

• 上传文件获取 fileId
• 创建签署流程
• 获取签署链接

业务方可以结合自己的业务调整，用于正式对接。

com.tencent.essbasic.bytemplate

bytemplate 目录是电子签第三方应用集成的核心场景之一 ：通过模板发起的快速上手样例。 ByTemplateQuickStart 一键使用模板 id 发起流程:

• 创建流程
• 创建电子文档
• 等待文档异步合成
• 开启流程
• 获取签署链接

业务方可以结合自己的业务调整，用于正式对接。

com.tencent.essbasic.common

用于构造默认电子签客户端调用实例， 以及一些公共参数的组装

com.tencent.essbasic.config

里面定义调用电子签第三方应用集成 API 需要的一些核心参数。

resources

blank.pdf 是一个空白的 pdf 用于快速发起合同的测试。