imagecaptchaconfirmationstrategy.java

### File Source: imagecaptchaconfirmationstrategy.java

             /*
        P/P   *  Method: net.sourceforge.pebble.confirmation.ImageCaptchaConfirmationStrategy__static_init
              *
              *  Postconditions:
              *    init'ed(log)
              */
         1  /*
         2   * Copyright (c) 2003-2006, Simon Brown
         3   * All rights reserved.
         4   *
         5   * Redistribution and use in source and binary forms, with or without
         6   * modification, are permitted provided that the following conditions are met:
         7   *
         8   *   - Redistributions of source code must retain the above copyright
         9   *     notice, this list of conditions and the following disclaimer.
        10   *
        11   *   - Redistributions in binary form must reproduce the above copyright
        12   *     notice, this list of conditions and the following disclaimer in
        13   *     the documentation and/or other materials provided with the
        14   *     distribution.
        15   *
        16   *   - Neither the name of Pebble nor the names of its contributors may
        17   *     be used to endorse or promote products derived from this software
        18   *     without specific prior written permission.
        19   *
        20   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
        21   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        22   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        23   * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
        24   * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
        25   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
        26   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
        27   * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
        28   * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
        29   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
        30   * POSSIBILITY OF SUCH DAMAGE.
        31   */
        32  package net.sourceforge.pebble.confirmation;
        33
             /*
        P/P   *  Method: void net.sourceforge.pebble.confirmation.ImageCaptchaConfirmationStrategy()
              */
        34  import com.octo.captcha.service.CaptchaServiceException;
        35  import org.apache.commons.logging.Log;
        36  import org.apache.commons.logging.LogFactory;
        37
        38  import javax.servlet.http.HttpServletRequest;
        39
        40  /**
        41   * Image captcha comment confirmation strategy.
        42   *
        43   * @author    Simon Brown
        44   */
        45  public class ImageCaptchaConfirmationStrategy extends AbstractConfirmationStrategy {
        46
        47    /** the log used by this class */
        48    private static final Log log = LogFactory.getLog(ImageCaptchaConfirmationStrategy.class);
        49
        50    /**
        51     * Called before showing the confirmation page.
        52     *
        53     * @param request the HttpServletRequest used in the confirmation
        54     */
        55    public void setupConfirmation(HttpServletRequest request) {
               /*
        P/P     *  Method: void setupConfirmation(HttpServletRequest)
                */
        56    }
        57
        58    /**
        59     * Gets the URI of the confirmation page.
        60     *
        61     * @return a URI, relative to the web application root.
        62     */
               /*
        P/P     *  Method: String getUri()
                *
                *  Postconditions:
                *    return_value == &".WEB-INF.jsp.confirmation.imageCaptcha.jsp"
                */
        63    public String getUri() {
        64      return "/WEB-INF/jsp/confirmation/imageCaptcha.jsp";
        65    }
        66
        67    /**
        68     * Called to determine whether confirmation was successful.
        69     *
        70     * @param request   the HttpServletRequest used in the confirmation
        71     * @return  true if the confirmation was successful, false otherwise
        72     */
        73    public boolean isConfirmed(HttpServletRequest request) {
                 /*
        P/P       *  Method: bool isConfirmed(HttpServletRequest)
                  *
                  *  Preconditions:
                  *    request != null
                  *
                  *  Presumptions:
                  *    com.octo.captcha.service.image.ImageCaptchaService:validateResponseForID(...)@77 != null
                  *    javax.servlet.http.HttpServletRequest:getSession(...)@74 != null
                  *    org.apache.commons.logging.LogFactory:getLog(...)@48 != null
                  *
                  *  Postconditions:
                  *    init'ed(return_value)
                  */
        74      String captchaId = request.getSession().getId();
        75      String response = request.getParameter("j_captcha_response");
        76      try {
        77        return CaptchaService.getInstance().validateResponseForID(captchaId, response);
        78      } catch (CaptchaServiceException e) {
        79        ImageCaptchaConfirmationStrategy.log.error("Exception encountered", e);
        80      }
        81
        82      return false;
        83    }
        84
        85  }

SofCheck Inspector Build Version : 2.22510

imagecaptchaconfirmationstrategy.java | 2010-Jun-25 19:40:32
imagecaptchaconfirmationstrategy.class | 2010-Jul-19 20:23:40