anon.util.captcha

Class ZipBinaryImageCaptchaClient

java.lang.Object

anon.util.captcha.ZipBinaryImageCaptchaClient

All Implemented Interfaces:

IImageEncodedCaptcha

public class ZipBinaryImageCaptchaClient
extends java.lang.Object
implements IImageEncodedCaptcha

This is the client implementation for all captchas of the "ZIP_BINARY_IMAGE" format.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CAPTCHA_DATA_FORMAT This is the captcha format identifier for the class of captchas, which can be handled by this class implementation.

Constructor Summary

Constructors

Constructor and Description
ZipBinaryImageCaptchaClient(org.w3c.dom.Element a_captchaEncodedNode) Creates a new instance of ZipBinaryImageClient, which handles all captchas of the "ZIP_BINARY_IMAGE" format.

Method Summary

Modifier and Type	Method and Description
int	getCharacterNumber() Returns the number of characters which are included in the captcha.
java.lang.String	getCharacterSet() Returns the character set which was used when the captcha was created.
MyImage	getImage() Returns the image with the captcha data.
byte[]	solveCaptcha(java.lang.String a_key, byte[] a_startsWith) Solves the captcha and returns the encoded information.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CAPTCHA_DATA_FORMAT

public static final java.lang.String CAPTCHA_DATA_FORMAT

This is the captcha format identifier for the class of captchas, which can be handled by this class implementation. We are handling the "ZIP_BINARY_IMAGE" format.

See Also:

Constant Field Values

Constructor Detail

ZipBinaryImageCaptchaClient

public ZipBinaryImageCaptchaClient(org.w3c.dom.Element a_captchaEncodedNode)
                            throws java.lang.Exception

Creates a new instance of ZipBinaryImageClient, which handles all captchas of the "ZIP_BINARY_IMAGE" format. If something is wrong with the specified XML captcha data (e.g. data with the wrong captcha format or invalid data), an Exception is thrown.

Parameters:

a_captchaEncodedNode - The CaptchaEncoded node with the data of a "ZIP_BINARY_IMAGE" captcha.

Throws:

java.lang.Exception

Method Detail

getImage

public MyImage getImage()

Returns the image with the captcha data.

Specified by:

getImage in interface IImageEncodedCaptcha

getCharacterSet

public java.lang.String getCharacterSet()

Returns the character set which was used when the captcha was created. Only characters from this set are in the captcha image.

Specified by:

getCharacterSet in interface IImageEncodedCaptcha

getCharacterNumber

public int getCharacterNumber()

Returns the number of characters which are included in the captcha.

Specified by:

getCharacterNumber in interface IImageEncodedCaptcha

solveCaptcha

public byte[] solveCaptcha(java.lang.String a_key,
                           byte[] a_startsWith)
                    throws java.lang.Exception

Solves the captcha and returns the encoded information. The key is the character string visible in the captcha image. If the wrong key is specified, an Exception is thrown.

Specified by:

solveCaptcha in interface IImageEncodedCaptcha

Parameters:

a_key - The key for solving the captcha (it's the string which is shown in the captcha image).

a_startsWith - byte[]

Returns:

The encoded data

Throws:

java.lang.Exception