# java-sdk

**Repository Path**: besehen/java-sdk

## Basic Information

- **Project Name**: java-sdk
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-08
- **Last Updated**: 2025-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

6666






# 点触验证码 Java SDK

##### [其他语言SDK以及JS API https://github.com/touclick/captcha-demo](https://github.com/touclick/captcha-demo)

## 开发环境

  
  - JDK 1.5及以上
  - Tomcat 6.0及以上

## 文件说明

* ActivateServlet.java/ 激活功能,为了确保您的公钥能正常使用,请务必使用配套的SDK进行激活
* captcha-demo/ web项目调用演示
* captcha-java-sdk/ SDK源码
* lib/ 项目中可能需要的jar包
  


## 使用指南
1. 在`TouclickController`中填写从点触官网注册获得的公钥和私钥
   ```java	
   private static final String PUBKEY = "";//公钥(从点触官网获取)
   private static final String PRIKEY = "";//私钥(从点触官网获取)
   ```
   
2. 在index.html中填写
   ```xml
      <script src="http://js.touclick.com/js.touclick?b=公钥(从点触官网获得)" ></script>
   ```

3. 公钥激活

	`为了公钥能正常使用，请务必进行激活，如更换SDK，则需要使用新SDK的激活程序重新进行激活`

	`激活过后，建议删除ActivateServlet.java`
	
	* 将ActivateServlet.java复制到自己的项目中或者新建web项目运行ActivateServlet.java

	* 在web.xml中添加如下配置
   ```xml
   <servlet>
      <servlet-name>activateServlet</servlet-name>
      <servlet-class>com.touclick.captcha.ActivateServlet</servlet-class>
   </servlet>
   <servlet-mapping>
      <servlet-name>activateServlet</servlet-name>
      <url-pattern>/activate.do</url-pattern>
   </servlet-mapping>
   ```

   * 启动项目访问`http://localhost:8080/项目名/activate.do`
    
   * 在打开的页面中填写配套公钥与私钥进行激活，激活成功后可在官网后台查看版本号
	

4. 运行demo
	* 导入java-sdk-1.0.0.jar以及其他相关jar包 (lib目录下)
	
	* 浏览器访问`http://localhost:8080/项目名/index.html`即可体验



#### 调用SDK

在pom.xml中添加对java-sdk的依赖，当您准备将点触添加到您的项目中去时，请先依赖该项目

```xml
<dependency>
	<groupId>com.touclick.captcha</groupId>
	<artifactId>java-sdk</artifactId>
	<version>1.1.0</version>
</denpendency>
```


   ```java
   String checkKey = request.getParameter("checkAddress");
   String token = request.getParameter("token");
   //一次验证传递的参数,同一次验证一样
   String checkCode = request.getParameter("checkCode");
   Status status = touclick.check(checkCode,checkKey,token,PUBKEY,PRIKEY);
   System.out.println("checkKey :"+checkKey + ",token:" + token+ ",checkCode:" + checkCode);
   System.out.println("code :"+status.getCode() + ",message:" + status.getMessage());
   if(status != null && status.getCode()==0){
       //执行自己的程序逻辑
   }
   ```

  `check`方法的返回值为status对象，对象属性code可能的取值如下所示：

  ```java
  (0, "验证正确")
  (1, "该验证已过期")
  (2, "公钥不可为空")
  (3, "一次验证返回的token为必需参数,不可为空")
  (4, "公钥不正确")
  (5, "CheckCode有误,请确认CheckCode是否和一次验证传递一致"),
  (6, "sign加密错误,请检查参数是否正确")
  (7, "一次验证错误")
  (8, "点触服务器异常")
  (9, "http请求异常")
  (10, "json转换异常,可能是请求地址有误,请检查请求地址(http://[checkAddress].touclick.com/sverify.touclick?参数)")
  (11, "二次验证地址不合法")
  (12, "签名校验失败,数据可能被篡改")
  ```


### 联系我们：

（客户服务）官Q1：<a href="https://touclick.com/?service=0" target="_blank">800161394</a> ，电话010-53608568

（技术支持）官Q1：<a target="_blank" href="http://shang.qq.com/wpa/qunwpa?idkey=eae024d881e951c69bb4bbb41d1af9be9f4b861eb86bf48e8f35cf27cc24d98e">205658675</a>