目录

• 文件描述
  • 核心SDK库
  • 极验行为验证Demo
  • 短信和极验行为验证Demo
• 搭建开发环境
• 一分钟运行Demo
• failback效果展示
  • 正常效果
  • failback效果
• 联系作者
• 发布日志（由新到旧）
  • 2.15.10.9.1
  • 2.15.8.24.1
  • 2.15.7.3.1
  • 2.15.7.2.3
  • 2.15.7.2.1
  • 3.15.6.18.2
  • 3.15.6.17.1
  • 3.15.6.16.1
  • 3.15.6.15.1
  • 3.15.6.12.1（舍弃）
  • 2.15.5.22.1
  • 2.15.4.1.4
  • 15.3.31.1
  • 15.2.2.2
  • 15.2.2.1
  • 15.1.29.3
  • 15.1.28.1
  • Vc8Vn14.12.01
  • Vc7Vn2.1

文件描述

注意：本项目提供的Demo的前端实现方法均是面向PC端的。 如果需要移动端的canvas功能，请参考canvas的前端文档。

核心SDK库

1. GeetestLib.java

   提供只带拼图行为验证的功能

2. GeetestMsgLib.java

   提供带短信功能打包的完整功能,继承于GeetestLib.java所定义的类

极验行为验证Demo

包名：com.geetest.sdk.java.web.demo

1. GeetestConfig.java

   Web用户配置文件。此处填写用户自己申请的验证模块ID/KEY

2. StartCaptchaServlet.java

   用户判断极验服务器是否Down机的示例Servlet,页面生成前置处理

3. VerifyLoginServlet.java

   提交验证调用Sdk的示例Servlet

4. login.jsp

   行为验证的前端示范页面

目前这个demo页面比以前复杂的原因如下：

1. 实现failback的前端逻辑，在正常和非正常之间形成无缝自动化切换。
2. 在极验服务器down机的情况下，避免同步请求长达20s的阻塞页面
3. 在极验服务down机头部下，仍然先优先使用异步加载，把加载时间减少一半。

短信和极验行为验证Demo

包名：com.geetest.sdk.java.msg.demo

1. GeetestMsgConfig.java

   Web用户配置文件。此处填写用户自己申请的验证模块ID/KEY

2. StartMsgCaptchaServlet.java

   用户判断极验服务器是否Down机的示例Servlet,页面生成前置处理

3. VerifyGeetestServlet.java

   获取短信前的一次验证逻辑控制

4. VerifyMsgServlet.java

   提交短信验证示例Servlet

5. msg_login.jsp

   短信+行为验证的前端示范页面

6. ./lib/java-json.jar

   Java的json解码包。用户如果有其它包可以在此替换。

搭建开发环境

搭建Eclipse+Tomcat的开发环境

一分钟运行Demo

1. 从GitHub中clone一份到本地
2. 使用Eclipse直接import一个项目
3. 打开tomcat
4. 在浏览器中访问http://localhost:8080/gt-java-sdk/login.jsp即可看到Demo界面

failback效果展示

如果极验服务器出现故障，会全自动切换到备选验证，以确保网站主的正常功能能够进行。请有开发能力的网站请务必完成failback后的本地化代码功能，以减少不必要的损失。

正常效果

failback效果

联系作者

QQ:1295351490

发布日志（由新到旧）

2.15.10.9.1

• 加入了同一会话的我实例的SDK函数实现部分

2.15.8.24.1

• 规范和修改函数的命名的名称

2.15.7.3.1

1. 修复failback的重放漏洞

2.15.7.2.3

1. 优化了前端逻辑，在down机状态下采用动态异步请求的方式，响应速度更快

2.15.7.2.1

1. 增加了在极验服务器down机情况下的failback方案的具体实现

3.15.6.18.2

1. 一些代码重新命名
2. 更新文档
3. 修复web.xml里面的命名问题

3.15.6.17.1

1. 增加了gt-message的demo
2. 采用面向对象的方式，重构了代码
3. 后续会继续重构此代码，但是此项目已经是可用版本

3.15.6.16.1

1. 将接口封装更彻底，让用户的使用更便捷。
2. 改变包的相对路径，用户代码和库文件逻辑更清晰
3. 服务端使用session传值，安全性更高

3.15.6.15.1

1. 根据极验服务升级写的全新的SDK使用方法Demo
2. 实现前后端代码完全分离的调用模式
3. 将用户要配置的参数以文件方式独立出来
4. 更丰富的前端api调用示例
5. 优化一个session的传值问题
6. 以submit为主，ajax提交为辅助（注释掉），形成完整的流程

3.15.6.12.1（舍弃）

1. 一个session的传值代码写得太丑，不要这个版本了。

2.15.5.22.1

1. 修改了检查down机的时间超时为2s

2.15.4.1.4

1. 加入了前端中https的设置函数
2. 使用新的版本编号。加入了一个前缀的大版本号。
3. 在二次验证的时候，加入了SDK版本号和SDK语言类型。
4. 修改了sdk版本的表示字段为sdk，内容一致

15.3.31.1

1. 统一命名方式

15.2.2.2

1. chanllege的生成函数转移到服务器端
2. 服务器端重复的failback去掉

15.2.2.1

1. chanllege的生成函数转移到服务器端

15.1.29.3

1. 修复了一些小bug
2. 和服务端联调成功

15.1.28.1

1. SDK加入了自主生成id的接口
2. 前端src引用有了加强版
3. SDK的版本编号规则发生变化

Vc8Vn14.12.01

让forbidden的情况在仍然提示通过，但客户服务器仍然能够知晓原因。

1. GeetestLib.java 中加入了增强型的验证结果判定的API
2. VerifyLoginServlet.java 中重新对新接口进行了引用。

Vc7Vn2.1

1. 规范sdk的发布流程，形成持续集成
2. 调整结构，简化开发人员使用步骤。做到1分钟入门的Demo
3. 加入failback“备胎”验证码的功能
4. 检验服务器数据读取时长限定为1s后就算超时，就报超时