使用 JCaptcha 开发图形和声音验证码

当前越来越多的网站系统采用 CAPTCHA 验证码，来阻止垃圾信息发布机器人的信息提交，但通常绝大多数网站，只提供图片验证码，而这将影响盲人用户的使用。JCaptcha 是一个 Java 开源项目，利用 JCaptcha，不但可以生成图形验证码，还可以利用与 FreeTTS 的集成，来生成声音验证码，而盲人则可以通过识别声音验证码，来正常登录和使用网站的服务。本文将基于四个示例，首先介绍如何使用 JCaptcha 生成图形验证码，最后还介绍了如何开发生成声音验证码。

JCaptcha 简介

CAPTCHA 全称 Completely Automated Public Turing Test to Tell Computers and Humans Apart，最早作为卡内基梅隆大学的一个科研项目，用于生成一个人类容易通过而计算机难以通过的测试，目前广泛应用于网络应用，用于阻止机器人发布垃圾 信息。JCaptcha 即为 Java 版本的 CAPTCHA 项目，其是一个开源项目，支持生成图形和声音版的验证码，在生成声音版的验证码时，需要使用到 FreeTTS。目前，JCaptcha 官方网站显示有 2.0 版本，但二进制版只有 1.0 版可供下载，本文亦是基于 1.0 版本展开。

回页首

一个简单的图形验证码

JCaptcha 提供了一定的可扩展能力，用于开发人员创建出复杂的图形验证码。下面，首先利用 JCaptcha 提供的 API 来快速开发一个简单示例。本文的示例为 Web 应用，可以运行在 Tomcat 和 WebSphere 上，除了准备 Web 服务器外，我们还需要准备好 JCaptcha 运行时所必须的 Jar 包。

准备所需的 Jar 包

JCaptcha 项目在实现中，还引用了 commons-collections 和 commons-logging 两个开源项目，再加上 JCaptcha 本身的实现，我们共需要三个包，具体信息如下：

• jcaptcha-1.0-all.jar
• commons-logging-1.1.1.jar
• commons-collections-3.2.jar

创建生成图形验证码的 Servlet

在 示例 1 中，我们采用 Servlet 生成验证码图片，并将这个图片写到 ServletOutputStream 中，同时将 Servlet 的 response 的类型设置为 image/jpeg。在前台页面中，我们使用 img 标签，并将 src 指向这个 Servlet，这样我们就可以在页面中显示这个生成的验证码图片。清单 1 是 Servlet 代码片段。

清单 1. 生成图形验证码代码片段

 // set content type as jpeg 
 httpServletResponse.setHeader("Cache-Control", "no-store"); 
 httpServletResponse.setHeader("Pragma", "no-cache"); 
 httpServletResponse.setDateHeader("Expires", 0); 
 httpServletResponse.setContentType("image/jpeg"); 

 // create the image using session ID 
 logger.fine("tring to get image captcha service"); 
 BufferedImage bufferedImage = service 
        .getImageChallengeForID(httpServletRequest.getSession(true) 
            .getId()); 

 ServletOutputStream servletOutputStream = httpServletResponse 
        .getOutputStream(); 

 // write the image to the servlet output stream 
 logger.fine("tring to output buffered image to servlet output stream"); 
 ImageIO.write(bufferedImage, "jpg", servletOutputStream); 
  
 try { 
  servletOutputStream.flush(); 
 } finally { 
  servletOutputStream.close(); 
 }

清单 1 中的 service 对象，我们采用了一个 JCaptcha 的默认实现类 DefaultManageableImageCaptchaService，在代码中，我们需要通过获取 service 对象，根据 Session ID 来生成验证码图片。除了使用该默认实现类外，我们也可以通过实现 ImageCaptchaService 接口来生成更为复杂的验证码图片（参见示例 2）。清单 2 为获取 service 对象的示例代码，JCaptcha 建议使用单例来生成 service 对象。

清单 2. 生成 ImageCaptchaService 对象

 public class SampleImageCaptchaService  { 

 private static ImageCaptchaService instance; 

 /** 
 * Get default manageable image captcha service 
 * @return ImageCaptchaService 
 */ 
 public static ImageCaptchaService getInstance() { 
 if (instance == null) { 
    instance = new DefaultManageableImageCaptchaService(); 
  } 
    return instance; 
  } 
 }

示例 1 提供了 2 个简单的页面，一个用于显示图形验证码，另一个则在验证成功后显示成功信息。清单 3 为用于显示图形验证码的页面代码片段。

清单 3. 显示图形验证码页面代码片段

 <form action="CaptchaValidationServlet" method="post"> 
 <table> 
  <tr> 
    <td colspan="2"><img src="ImageCaptchaServlet" /></td> 
  </tr> 
  <tr> 
    <td> 请输入您所看到的字符 :</td> 
    <td><input type="text" name="captcha_input" value="" /> 
                <%=request.getAttribute("ERROR") == null ? "" :       
                request.getAttribute("ERROR")%></td> 
  </tr> 
  <tr> 
      
    <td><input type="submit" value="提交" /></td> 
  </tr> 
 </table> 
 </form>

除了实现图形验证码的生成和展示，我们还需要一个 Servlet 来验证用户的输入。用户输入验证的代码的核心，是使用在生成图片时所使用的 service 对象，调用 JCaptcha 的输入验证方法（本示例为 validateResponseForID 方法），来判断用户输入是否正确，清单 4 为输入验证代码片段。

清单 4. 验证用户输入

 validated = service.validateResponseForID( 
    request.getSession(true).getId(), userCaptchaResponse).booleanValue();

完成上述代码工作后，我们还需要在 Web.xml 中设置好上面创建的两个 Servlet，然后再部署到 Web 服务器上，图 1 是部署成功后的示例 1 首页。

图 1. 示例 1 的首页

Sample1Index.jpg

至此，我们完成了第一个示例，该示例采用了 JCaptcha 提供的默认实现，下面我们将通过扩展使用 JCaptcha，来生成一个更为复杂的图形验证码。

回页首

使用 JCaptcha 生成复杂图形验证码

在实际项目中，我们可能需要使用更为复杂的图形验证码，比如，加入带干扰的图形背景、更多的干扰点、自定义随机字库及图形字体等等，下面将基于示例 2 介绍如何使用 JCaptcha 生成更为复杂的图形验证码。

自定义 ImageCaptchaService 的实现

正 如介绍示例 1 时所提到的，我们可以通过实现 ImageCaptchaService 接口来创建我们自己所需要的 service 对象，清单 5 为示例 2 对接口 ImageCaptchaService 的实现，我们可以在该实现中，使用自己开发的图形验证码生成引擎（SampleListImageCaptchaEngine）来生成更为复杂的图形验证 码。

清单 5. 示例 2 中 ImageCaptchaService 的实现

 public class SampleImageCaptchaService extends 
    AbstractManageableImageCaptchaService implements ImageCaptchaService { 

  private static SampleImageCaptchaService instance; 

  public static SampleImageCaptchaService getInstance() { 
    if (instance == null) { 
      //use customized engine 
      ListImageCaptchaEngine engine = new SampleListImageCaptchaEngine(); 
      instance = new SampleImageCaptchaService( 
        new FastHashMapCaptchaStore(), engine, 180, 100000, 75000); 
    } 
    return instance; 
  } 
  
  public SampleImageCaptchaService(CaptchaStore captchaStore, 
      CaptchaEngine captchaEngine, int minGuarantedStorageDelayInSeconds, 
      int maxCaptchaStoreSize, int captchaStoreLoadBeforeGarbageCollection) { 
    super(captchaStore, captchaEngine, minGuarantedStorageDelayInSeconds, 
        maxCaptchaStoreSize, captchaStoreLoadBeforeGarbageCollection); 
  } 
 }

构建生成图形验证码的 ImageCaptchaEngine

清单 5 中的 FastHashMapCaptchaStore 用于存放生成的验证码字符，FastHashMapCaptchaStore 基本可以满足绝大多数项目需求，我们通常不需要创建自己的类来实现它的功能；SampleListImageCaptchaEngine 则是扩展的核心，该类是 ImageCaptchaEngine 的一个实现，在该类中，我们可以设置随机字库、生成的字体和大小、字符数、背景图片以及干扰点等等。清单 6 为 SampleListImageCaptchaEngine 代码片段。

清单 6. SampleListImageCaptchaEngine 代码片段

 //create text parser 
 TextPaster randomPaster = new DecoratedRandomTextPaster(new Integer(8), 
        new Integer(10), new SingleColorGenerator(Color.BLACK), 
 new TextDecorator[] { new BaffleTextDecorator(new Integer(1), Color.WHITE) }); 
 //create image captcha factory 
 ImageCaptchaFactory factory = new GimpyFactory( 
        new RandomWordGenerator("abcdefghijklmnopqrstuvwxyz"), 


    new ComposedWordToImage(new TwistedRandomFontGenerator(new Integer(34), 
            new Integer(40)), new FunkyBackgroundGenerator(new Integer( 
            260), new Integer(70)), randomPaster)); 
    
 ImageCaptchaFactory characterFactory[] = { factory}; 
 this.addFactories(characterFactory);

在清单 6 中，DecoratedRandomTextPaster 的第一个参数用于设置验证码最少字符数，第二个参数为最多的字符数，第三个参数 SingleColorGenerator 为字体颜色，这里为黑色，TextDecorator 为干扰设置，这里是一个字符一个干扰点，并且干扰点为白色。

在 ImageCaptchaFactory 中，第一个参数设置了随机字库，这里为英文字母，在第二个参数中，TwistedRandomFontGenerator 设置了生成的字符字体，最小 34，最大为 40，FunkyBackgroundGenerator 则用于生成干扰背景，除了设置字体大小外，还需要设置生成的图片大小，示例 2 为 260*70 像素。图 2 为示例 2 的首页截图。

图 2. 示例 2 的首页

Sample2Index.jpg

可 以说 ImageCaptchaEngine 的不同实现，决定了图形验证码的不同样式，JCaptcha 目前提供了多种 ImageCaptchaEngine 的实现，这些实现提供了多种不同的图形验证码样式，当然，我们也可以自己实现 TextPaster 及 TextDecorator 等，进而再继承实现 ImageCaptchaEngine，从而实现自己所期望的效果。图 3 为 JCaptcha 官方网站提供的部分 ImageCaptchaEngine 的实现截图，更多样式，请参见 官方网站。

图 3. JCaptcha 官方图形验证码示例

JCaptchaSample.jpg

回页首

开发声音验证码

由 于某些项目需要支持盲人使用，而盲人无法看到图形验证码，这时，我们就需要同时提供声音版的验证码。JCaptcha 同时支持声音版验证码，但默认实现并不支持生成的声音和图形验证码中的字符一致，这里就需要通过一定的扩展定制，才能保证声音和图形验证码的内容一致，下 面首先介绍如何生成声音验证码，然后介绍如何扩展定制，才能保证声音和图形验证码的内容的一致。

FreeTTS

JCaptcha 使用了 FreeTTS 来开发声音验证码，FreeTTS 是一个采用 Java 编写的语音合成项目，它基于 Flite 项目编写，Flite 项目是一个由卡内基梅隆大学开发的小型语音合成引擎，其又源于爱丁堡大学的 Festival 语音合成系统和卡内基梅隆大学的 FestVox 项目。本文的示例使用了 FreeTTS 1.2.2，该版本的有如下几个方面的功能：

• 一个语音合成引擎
• 支持多种声音
  • 1 个 8khz，多音位，男性美国英语发音
  • 1 个 16khz，多音位，男性美国英语发音
  • 1 个 16khz 有限声音域的男性美国英语发音
• 支持从 FestVox 导入声音（仅支持美国英语）
• 一定程度上支持从 FestVox 中导入 CMU ARCTIC 声音
• 支持 MBROLA 声音（需另外下载该功能包）
  • 1 个 16khz 女性美国英语发音
  • 2 个 16khz 男性美国英语发音
• 部分支持 JSAPI 1.0

为了使用 FreeTTS，JCaptcha 还另外提供了一个 Jar 包用于和 FreeTTS 的集成，所以在运行过程中，除了需要引入 FreeTTS 自带的 Jar 包，还需要包括 JCaptcha 提供的和 FreeTTS 集成的包，在示例 3 和 4 中，使用了如下的包：

• jcaptcha-extension-sound-freetts-1.0.jar：用于和 FreeTTS 的集成
• jcaptcha-1.0-all.jar： JCaptcha 核心包
• freetts.jar：FreeTTS 核心包
• en_us.jar：用于 FreeTTS
• commons-logging-1.1.1.jar：用于 JCaptcha
• commons-collections-3.2.jar：用于 JCaptcha
• cmutimelex.jar：用于 FreeTTS
• cmulex.jar：用于 FreeTTS
• cmudict04.jar：用于 FreeTTS
• cmu_us_kal.jar：用于 FreeTTS
• cmu_time_awb.jar：用于 FreeTTS

构建生成声音的 SoundCaptchaEngine

同 ImageCaptchaEngine 一样，JCaptcha 同时提供了 SoundCaptchaEngine，所以整个声音验证码的核心是创建 SoundCaptchaEngine 的实现，当然 JCaptcha 也提供了一些默认的实现，比如 DefaultSoundCaptchaEngine 以及 SpellerSoundCaptchaEngine 等等，为了考虑能够支持生成和图形验证码相同的字符，示例 3 采用继承抽象类 ListSoundCaptchaEngine 的方式，来创建自己的实现 SampleListSoundCaptchaEngine。清单 7 为 SampleListSoundCaptchaEngine 代码片段。

清单 7. SampleListSoundCaptchaEngine 代码片段

 public class SampleListSoundCaptchaEngine extends ListSoundCaptchaEngine {  

  private static String voiceName = "kevin16"; 

   private static String voicePackage = 
   "com.sun.speech.freetts.en.us.cmu_us_kal.KevinVoiceDirectory"; 

  protected void buildInitialFactories() { 
    //create word generator 
  WordGenerator wordGenerator = new RandomWordGenerator("ABCDEFGHIJKLMNOPQRSTUVWXYZ"); 
  //create decorator 
 SpellerWordDecorator decorator = new SpellerWordDecorator(", "); 
 //create sound factory 
  SoundCaptchaFactory soundFactory[] = { new SpellerSoundFactory( 
        wordGenerator, 
      new FreeTTSWordToSound(new FreeTTSSoundConfigurator(voiceName, 
          voicePackage, 1.0f, 100, 100), 4, 10), decorator) }; 
    this.setFactories(soundFactory); 
  } 
 }

创建生成声音验证码的 Servlet

同开发图形验证码一样，这里也 需要创建 SoundCaptchaService 的实现，实现方式与 ImageCaptchaService 的实现类似，示例 3 的实现类为 SampleSoundCaptchaService，这里不做叙述，读者可以参见附带的示例源代码。

和 ImageCaptchaService 的实现不同的是，这里不能采用单例的方式来获取 SoundCaptchaService 的实现，否则不能多次为同一 Session ID 生成多个声音验证码文件。另外，在用户不刷新页面，而重复点击声音验证码图标时，我们需要提供同一段声音，因此，我们可以将 SoundCaptchaService 的实现对象以及所生成的字节码流放入到 session 中，清单 7 为 SoundCaptchaServlet 代码片段。

清单 8. SoundCaptchaServlet 代码片段

 httpServletResponse.setContentType("audio/x-wav"); 
 SoundCaptchaService service = null; 
 if ( httpServletRequest.getSession().getAttribute("soundService") != null) { 
   service = (SoundCaptchaService) httpServletRequest 
      .getSession().getAttribute("soundService"); 
 } else { 
  service = new SampleSoundCaptchaService(); 
 } 
 // get AudioInputStream using session 
 ByteArrayOutputStream byteOutputStream = new ByteArrayOutputStream();  
 //get from the session if already existed, otherwise, create new one 
 if (httpServletRequest.getSession().getAttribute("stream") == null) { 
      AudioInputStream audioInputStream = service.getSoundChallengeForID( 
  httpServletRequest.getSession().getId(), httpServletRequest.getLocale()); 

      AudioSystem.write(audioInputStream, javax.sound.sampled.AudioFileFormat.Type.WAVE, 
              byteOutputStream); 
 } else { 
    byteOutputStream = 
    (ByteArrayOutputStream)httpServletRequest.getSession().getAttribute("stream"); 
 }    

 // output to servlet 
 ServletOutputStream servletOutputStream = httpServletResponse.getOutputStream(); 
 servletOutputStream.write(byteOutputStream.toByteArray()); 
 // save the service object to session, will use it for validation 
 // purpose 
 httpServletRequest.getSession().setAttribute("soundService", service); 
 httpServletRequest.getSession().setAttribute("stream", byteOutputStream); 
 // output to servlet response stream 
 try { 
  servletOutputStream.flush(); 
 } finally { 
  servletOutputStream.close(); 
 }

创建 Web 页面和验证代码

为了方便用户使用，我们需要在页面上放 置一个图标，当焦点落在图标上（考虑到盲人可能使用键盘 Tab 键来切换焦点），触发 onFocus 事件来调用 JavaScript 方法显示 embed 标签，从而调用上面生成声音验证码的 Servlet。图 4 为示例 3 首页截图。

图 4. 示例 3 运行页面截图

Sample3Index.jpg

当 声音验证码图标在已经获取焦点，并朗读后，用户可能多次重复让该图标获取焦点以便多次收听，这时，JavaScript 方法会被多次触发，如果不做处理，其将多次请求 Servlet，以致生成不同的声音文件，本示例采用了前一个小节所介绍的缓存 SoundCaptchaService 对象和字节码流的方法来解决这个问题，以保证多次能收听到同一段声音。当然，也可以采用在 URL 后面加一个随机 token 的方式，来判断是否重复提交。清单 8 为示例 3 首页代码片段。

清单 9. 示例 3 index.jsp 代码片段

 <% 
      
    request.getSession().removeAttribute("soundService"); 
      request.getSession().removeAttribute("stream"); 
 %> 
 <html> 
 <head> 
 <script type="text/javascript"> 
 
 function playSoundCaptcha() { 
   var wavURL = '<%= request.getContextPath() %>'+'/SoundCaptchaServlet'; 
     var embedAudioPlayer = "<EMBED SRC='" + wavURL + "' HIDDEN='true' AUTOSTART='true'  />";  
   var wavArea = document.getElementById("wavArea"); 
   wavArea.innerHTML = embedAudioPlayer; 
 
   
 } 
 </script> 
 </head> 

 <form action="CaptchaValidationServlet" method="post"> 
 <table> 
  <tr> 
    <td colspan="2"><img src="ImageCaptchaServlet" /></td> 
  </tr> 
  <tr> 
    <td> 请输入您所看到的字符 :</td> 
    <td><input type="text" name="captcha_input" value="" /> 
    <a href="#"  onFocus="playSoundCaptcha()"> 
  <img src="image/wheelchair.jpg" height="18px" width="18px" 
  alt=""></a><%=request.getAttribute("ERROR") == null ? "" : 
    request  .getAttribute("ERROR")%></td> 
  </tr> 
  <tr> 
    <td><input type="submit" value="提交" /></td> 
  </tr> 
 <div id="wavArea" style="display:none"> 
 </div> 
 </table> 
 </form>

可以看到，我们采用了不在页面显示的 embed 标签来调用 Servlet 以获取声音流，然后自动播放。在每次页面刷新的时候，还需要将 Session 中的 SoundCaptchaService 的实现对象以及音频流删除，以便页面刷新时，重新生成新的声音验证码。

后台用来验证用户输入的逻辑和图形版的验证方式相似，这里不做介绍， 具体参见示例源代码。需要注意的是，由于示例 3 生成的声音验证码中的字符和图形版的字符并不一致，在后台验证的逻辑中，只需要用户输入等于声音验证码或图形验证码的字符，即可认为用户输入正确。下面将 介绍如何才能使声音版和图形版中的字符保持一致。

回页首

使声音验证码和图形验证码字符一致

JCaptcha 并没有提供很直观的方式，来保证声音验证码和图形验证码中的字符一致，这就需要我们了解 JCaptcha 的实现，并能够通过继承的方式来扩展定制 JCaptcha，从而实现声音和图形验证码字符的一致。

由于图形验证码会先于声音验证码生成，所以，我们第一步就是需要获取图形验证码所生成的字符串，然后是利用所获取的字符串来生成声音验证码。

获取图形验证码随机数

在 以上示例中，虽然我们在实现 ImageCaptchaEngine 和 SoundCaptchaEngine 的时候，可以设置随机数生成类，比如 RandomWordGenerator 等，但是即使声音版和图形版采用同一个随机数生成对象，也不能保证会生成同一个字符，因为它们仅仅是设定一个随机字库，而字符则是每次随机生成。因而，我 们并不能通过使用同样的随机数生成对象来生成同样的随机数，只能通过考虑使用图形版生成的字符来生成声音验证码，才能保持两者的一致。

在创 建 ImageCaptchaEngine 的实现时，我们需要提供一个 ImageCaptchaFactory，实际上，我们可以通过使用继承实现 JCaptcha 已有 ImageCaptchaFactory 的实现，来获取生成的随机数。清单 9 是示例 4 中继承了 GimpyFactory 的代码片段。

清单 9. SampleGimpyFactory 代码片段

 public class SampleGimpyFactory extends GimpyFactory { 
  
  ……

  public ImageCaptcha getImageCaptcha(Locale locale) { 
        //length 
        Integer wordLength = getRandomLength(); 

        String word = getWordGenerator().getWord(wordLength, locale); 
        if (this.wordBridge != null) { 
          this.wordBridge.setGeneratedWord(word); 
    } 
        BufferedImage image = null; 
        try { 
            image = getWordToImage().getImage(word); 
        } catch (Throwable e) { 
            throw new CaptchaException(e); 
        } 

        ImageCaptcha captcha = 
        new SampleGimpy(CaptchaQuestionHelper.getQuestion(locale, BUNDLE_QUESTION_KEY), 
                image, word); 
        return captcha; 
  } 

 }

可以发现，通过使用上面的 SampleGimpyFactory 即可获取图形验证码的随机数，所以我们可以将清单 6 中的 GimpyFactory 替换为 SampleGimpyFactory。

在 获取了生成的随机数后，还需考虑如何将该随机数传递给生成声音验证码的代码。考虑到我们在生成验证码时，都是基于同一个 Session ID 生成，那么我们就可以将生成的随机数放到 map 中，而 key 是 Session ID，那么，在生成验证码字符后，我们就可以用 Session ID 取出该字符串，并放到 Session 中，然后，在生成声音验证码的代码中，就可以从 Session 中获取随机数。但是，并不是所有代码都可以很方便的获取到 ID，所以，我们还需要对示例 2 的代码进行改造，以便能够根据 ID 保存随机数。清单 10 为改造后的清单 5 中的类 SampleImageCaptchaService 的代码片段。

清单 10. SampleImageCaptchaService 代码片段

 public class SampleImageCaptchaService extends 
    AbstractManageableImageCaptchaService implements ImageCaptchaService { 

  … .. 

  @Override 
  public BufferedImage getImageChallengeForID(String ID) 
      throws CaptchaServiceException { 
    BufferedImage image=  super.getImageChallengeForID(ID); 
    String generatedWord = ((SampleListImageCaptchaEngine) engine).getWordBridge() 
    .getGeneratedWord(); 
    WordMap.getWordsMap().put(ID, generatedWord); 
    return image; 
  } 

 }

如清单 10 所示，我们将生成的随机数放到了一个 map 中，而 key 则是 ID，这里也就是 SessionID，然后我们就可以在 ImageCaptchaServlet 获取并将该随机数放到 Session 中，如清单 11 所示。接下来便是如何利用该字符生成声音验证码。

清单 11. ImageCaptchaServlet 代码片段

 httpServletRequest.getSession().setAttribute( 
        "generatedWord", 
        WordMap.getWordsMap().get(httpServletRequest.getSession(true) 
            .getId()));

利用指定字符生成声音验证码

为了能够使用指定的字符串生成验证码，我们需要对示例 3 中的代码做一定的修改。这里，示例 4 通过继承 SpellerSoundFactory 实现了一个扩展的 SoundCaptchaFactory，清单 12 为代码片段。

清单 12. SampleSpellerSoundFactory 代码片段

 public class SampleSpellerSoundFactory extends SpellerSoundFactory { 

  private String word; 
  ……

  @Override 
  public SoundCaptcha getSoundCaptcha() { 
    return getSoundCaptcha(Locale.getDefault()); 
  } 

  @Override 
  public SoundCaptcha getSoundCaptcha(Locale locale) { 
    String soundWord = ""; 
    if (this.word != null && !this.word.equals("")) { 
      soundWord = this.word; 
    } else { 
      soundWord = this.wordGenerator.getWord(getRandomLength(), locale); 
    } 

    AudioInputStream sound = this.word2Sound.getSound(wordDecorator 
        .decorateWord(soundWord), locale); 
    SoundCaptcha soundCaptcha = new SpellerSound(getQuestion(locale), 
        sound, word); 
    return soundCaptcha; 
  } 

 }

根据清单 11 中的代码，如果字符串能够正确的传进来，这个 SampleSpellerSoundFactory 将可以根据该字符串生成声音验证码。

相应的，清单 7 中的 SampleListSoundCaptchaEngine 需要做如清单 13 所示的修改。

清单 13. SampleListSoundCaptchaEngine 代码

 public class SampleListSoundCaptchaEngine extends ListSoundCaptchaEngine { 
  
  private String word;  

  private static String voiceName = "kevin16"; 

  private static String voicePackage = 
  "com.sun.speech.freetts.en.us.cmu_us_kal.KevinVoiceDirectory";

  protected void buildInitialFactories() { 
    WordGenerator wordGenerator = new RandomWordGenerator("ABCDEFGHIJKLMNOPQRSTUVWXYZ"); 
     SpellerWordDecorator decorator = new SpellerWordDecorator(", "); 
    SoundCaptchaFactory soundFactory[] = { new SampleSpellerSoundFactory( 
        wordGenerator, 
        new FreeTTSWordToSound(new FreeTTSSoundConfigurator(voiceName,
          voicePackage, 1.0f, 100, 100), 4, 10), decorator, word) }; 
    this.setFactories(soundFactory); 
  } 

  public SampleListSoundCaptchaEngine(String word) { 
      this.word = word; 
      buildInitialFactories(); 
  
  } 

 }

需要注意的是，我们一定要有如清单 13 所示的带参数的够找函数，否则初始化时，该类会首先调用父类的构造函数，其父类会直接调用 buildInitialFactories 函数，而此时字符串还没有传递给父类。

接下来需要修改 SampleSoundCaptchaService，在该类中使用 SampleListSoundCaptchaEngine 并传入随机数参数。

清单 14. SampleSoundCaptchaService 代码片段

 public class SampleSoundCaptchaService extends 
    AbstractManageableSoundCaptchaService implements SoundCaptchaService { 
  
  public SampleSoundCaptchaService(String word) { 
    super(new FastHashMapCaptchaStore(), 
        new SampleListSoundCaptchaEngine(word), 180, 100000, 75000); 
  } 
  ……

  
 }

最后，我们只需要修改 SoundCaptchaServlet，先依据 Session ID 获取生成的随机数，然后调用清单 14 的 SampleSoundCaptchaService 生成声音验证码，如清单 15 所示。

清单 15. SoundCaptchaServlet 代码片段

 String word = ""; 
 if (httpServletRequest  .getSession().getAttribute("generatedWord") != null) { 
  word = (String)httpServletRequest.getSession().getAttribute("generatedWord"); 
  logger.info("Get generated word from the session, word=" + word); 
 } 
 service = new SampleSoundCaptchaService(word);

至于后台验证逻辑，可以不做修改，也可以删除原先用于验证声音验证码的代码。至此，声音验证码的字符将与图形验证码的字符保持一致。

回页首

总结

本 文先从一个简单的示例入手，介绍了如何采用 JCaptcha 开发一个简单的图形验证码，然后介绍了如何通过扩展定制，实现更为复杂的图形验证码，接下来介绍了如何采用 JCaptcha 开发声音验证码，并在最后，介绍了如何扩展 JCaptcha 来保证图形验证码和声音验证码的内容一致。

回页首

下载

描述 名字 大小 样例代码

SourceCode.zip	105KB

参考资料

学习

• 参考 JCaptcha 官方网站，获取更多关于 JCaptcha 的信息。
• JCaptcha样例网页提供了更多的图形验证码实现引擎。
• 通过 SourceForge下载 JCaptcha 1.0 或其他版本。
• 参考 FreeTTS 官方网站，获取更多关于 FreeTTS 的信息。
• 通过 SourceForge下载 FreeTTS 1.2.2 或其他版本。
• 随时关注 developerWorks 技术活动和网络广播。
• 访问 developerWorks Open source 专区获得丰富的 how-to 信息、工具和项目更新以及最受欢迎的文章和教程，帮助您用开放源码技术进行开发，并将它们与 IBM 产品结合使用。

讨论

• 加入 developerWorks 中文社区，developerWorks 社区是一个面向全球 IT 专业人员，可以提供博客、书签、wiki、群组、联系、共享和协作等社区功能的专业社交网络社区。
• 加入 IBM 软件下载与技术交流群组，参与在线交流。