CAPTCHA

查看 Github 倉(cāng)庫(kù) | 查看 Gitee 倉(cāng)庫(kù)

簡(jiǎn)介

人機(jī)識(shí)別與驗(yàn)證碼是后端開(kāi)發(fā)中保護(hù)接口最常見(jiàn)的方式之一，而此類(lèi)代碼往往會(huì)與業(yè)務(wù)代碼耦合帶來(lái)項(xiàng)目可維護(hù)性變差。

CAPTCHA 是一個(gè)基于 Spring Boot 的驗(yàn)證碼框架，它通過(guò) AOP 的方式完成包含驗(yàn)證碼生成、發(fā)送、存儲(chǔ)等驗(yàn)證碼相關(guān)業(yè)務(wù)，以避免與業(yè)務(wù)代碼耦合。
開(kāi)發(fā)者可以輕松地通過(guò)不同組件的組合來(lái)完成驗(yàn)證業(yè)務(wù)，同時(shí)可以進(jìn)行自定義實(shí)現(xiàn)以應(yīng)對(duì)自身的業(yè)務(wù)需求（例如郵箱驗(yàn)證碼、短信驗(yàn)證碼）。

代碼示例

導(dǎo)入 Maven 依賴(lài)

<dependency>
 <groupId>cn.dustlight.captcha</groupId>
 <artifactId>captcha-core</artifactId>
 <version>0.0.6</version>
</dependency>

添加注解啟用 CAPTCHA

@SpringBootApplication
@EnableCaptcha // 啟用 CAPTCHA
public class DemoApplication {
 public static void main(String[] args) {
  SpringApplication.run(DemoApplication.class, args);
 }
}

使用注解生產(chǎn)驗(yàn)證碼

 @RequestMapping("/captcha")
 @SendCode // 生成隨機(jī)字符圖像驗(yàn)證碼并發(fā)送
 public void captcha(@CodeValue String code) {
  // 在此處進(jìn)行自定義的業(yè)務(wù)，驗(yàn)證碼的生成、發(fā)送與儲(chǔ)存已由注解 '@SendCode' 完成。
  log.info(code);
 }

使用注解消費(fèi)驗(yàn)證碼（保護(hù)接口）

 @RequestMapping("/")
 @VerifyCode
 public String index(@CodeValue String code) {
  // 在此處進(jìn)行自定義的業(yè)務(wù)，驗(yàn)證碼的驗(yàn)證以及銷(xiāo)毀已由注解 '@VerifyCode' 完成。
  return String.format("Hello World! (%s)", code);
 }

實(shí)現(xiàn)原理

CAPTCHA 基于面向切面編程（AOP）思想，將驗(yàn)證碼業(yè)務(wù)劃分為兩個(gè)切面：

@SendCode

1. 生成驗(yàn)證碼
2. 儲(chǔ)存驗(yàn)證碼
3. 發(fā)送驗(yàn)證碼

@VerifyCode

• 讀取驗(yàn)證碼
• 進(jìn)行驗(yàn)證

同時(shí)將驗(yàn)證碼業(yè)務(wù)抽象為下面幾個(gè)接口：

• Code—— 驗(yàn)證碼
• CodeGenerator—— 生成器
• CodeSender—— 發(fā)送器
• CodeStore—— 儲(chǔ)存器
• CodeVerifier—— 驗(yàn)證器

例子

隨機(jī)字符圖像驗(yàn)證碼的 AOP 實(shí)現(xiàn)

業(yè)務(wù)分析

•  客戶端訪問(wèn)驗(yàn)證碼接口獲取到圖像，同時(shí)后端服務(wù)將生成的驗(yàn)證碼儲(chǔ)存在 Session 或者 Redis。
• 客戶端訪問(wèn)接口（登錄、注冊(cè)等），傳入?yún)?shù)以及驗(yàn)證碼，后端服務(wù)取出驗(yàn)證碼進(jìn)行校驗(yàn)。

模塊劃分

業(yè)務(wù)邏輯

@SendCode

1. 通過(guò) CodeGenerator生成 Code。
2. 通過(guò) CodeStore儲(chǔ)存 Code。
3. 通過(guò) CodeSender輸出 Code。
4. 執(zhí)行業(yè)務(wù)代碼。

@VerifyCode

1. 從請(qǐng)求參數(shù)獲取待驗(yàn)證的驗(yàn)證碼。
2. 通過(guò) CodeStore取出 Code。
3. 通過(guò) CodeVerify進(jìn)行驗(yàn)證。
4. 驗(yàn)證完成則執(zhí)行業(yè)務(wù)代碼，否則拋出異常。

拓展與組合

除了圖像驗(yàn)證碼（人機(jī)識(shí)別）以外，常見(jiàn)的驗(yàn)證碼業(yè)務(wù)或者人機(jī)識(shí)別業(yè)務(wù)例如：短信驗(yàn)證碼、郵箱驗(yàn)證碼、谷歌 reCAPTCHA 人機(jī)識(shí)別等都可以通過(guò)實(shí)現(xiàn)上述接口來(lái)完成業(yè)務(wù)。

例如，想要使用 Redis 儲(chǔ)存驗(yàn)證碼只需要通過(guò) RedisTemplate實(shí)現(xiàn) CodeStore即可，再通過(guò)模塊的組合使用可以輕易地完成自定義的驗(yàn)證碼業(yè)務(wù)，同時(shí)又不影響業(yè)務(wù)代碼。

到此這篇關(guān)于Spring Boot 驗(yàn)證碼框架 - CAPTCHA的文章就介紹到這了,更多相關(guān)Spring Boot 驗(yàn)證碼框架內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論