com.DeathByCaptcha

Class HttpClient

java.lang.Object

com.DeathByCaptcha.Client

com.DeathByCaptcha.HttpClient

public class HttpClient
extends Client

Death by Captcha HTTP API client.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CRLF
java.net.Proxy	proxy Proxy to use, defaults to none.
static java.lang.String	SERVER_URL

Fields inherited from class com.DeathByCaptcha.Client

API_VERSION, DEFAULT_TIMEOUT, DEFAULT_TOKEN_TIMEOUT, DFLT_POLL_INTERVAL, isVerbose, LEN_POLLS_INTERVAL, POLLS_INTERVAL, SOFTWARE_VENDOR_ID

Constructor Summary

Constructors

Constructor and Description
HttpClient(java.lang.String username, java.lang.String password)

Method Summary

Modifier and Type	Method and Description
void	close() Closes opened connections (if any), cleans up resources.
boolean	connect() Opens API-specific connection if not opened yet.
Captcha	getCaptcha(int id) Fetches an uploaded CAPTCHA details.
User	getUser() Fetches user details.
boolean	report(int id) Reports an incorrectly solved CAPTCHA
Captcha	upload(byte[] img)
Captcha	upload(byte[] img, int type, byte[] banner, java.lang.String banner_text)
Captcha	upload(byte[] img, java.lang.String challenge, int type, byte[] banner, java.lang.String banner_text)
Captcha	upload(byte[] img, java.lang.String challenge, int type, byte[] banner, java.lang.String banner_text, java.lang.String grid) Uploads a CAPTCHA to the service.
Captcha	upload(int type, org.json.JSONObject json)

Methods inherited from class com.DeathByCaptcha.Client

decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, getBalance, getCaptcha, getPollInterval, getText, getText, load, report, upload, upload, upload, upload

Methods inherited from class java.lang.Object

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

Field Detail

CRLF

public static final java.lang.String CRLF

See Also:

Constant Field Values

SERVER_URL

public static final java.lang.String SERVER_URL

See Also:

Constant Field Values

proxy

public java.net.Proxy proxy

Proxy to use, defaults to none.

Constructor Detail

HttpClient

public HttpClient(java.lang.String username,
                  java.lang.String password)

See Also:

Client.Client(String, String)

Method Detail

close

public void close()

Description copied from class: Client

Closes opened connections (if any), cleans up resources.

Specified by:

close in class Client

See Also:

Client.close()

connect

public boolean connect()
                throws java.io.IOException

Description copied from class: Client

Opens API-specific connection if not opened yet.

Specified by:

connect in class Client

Returns:

true on success

Throws:

java.io.IOException

See Also:

Client.connect()

getUser

public User getUser()
             throws java.io.IOException,
                    Exception

Description copied from class: Client

Fetches user details.

Specified by:

getUser in class Client

Returns:

user details object

Throws:

java.io.IOException

Exception

See Also:

Client.getUser()

upload

public Captcha upload(byte[] img,
                      java.lang.String challenge,
                      int type,
                      byte[] banner,
                      java.lang.String banner_text,
                      java.lang.String grid)
               throws java.io.IOException,
                      Exception

Description copied from class: Client

Uploads a CAPTCHA to the service.

Specified by:

upload in class Client

Parameters:

img - CAPTCHA image byte vector

Returns:

CAPTCHA object on success, null otherwise

Throws:

java.io.IOException

Exception

See Also:

Client.upload(byte[], java.lang.String, int, byte[], java.lang.String, java.lang.String)

upload

public Captcha upload(byte[] img,
                      java.lang.String challenge,
                      int type,
                      byte[] banner,
                      java.lang.String banner_text)
               throws java.io.IOException,
                      Exception

Specified by:

upload in class Client

Throws:

java.io.IOException

Exception

upload

public Captcha upload(byte[] img,
                      int type,
                      byte[] banner,
                      java.lang.String banner_text)
               throws java.io.IOException,
                      Exception

Specified by:

upload in class Client

Throws:

java.io.IOException

Exception

upload

public Captcha upload(byte[] img)
               throws java.io.IOException,
                      Exception

Specified by:

upload in class Client

Throws:

java.io.IOException

Exception

upload

public Captcha upload(int type,
                      org.json.JSONObject json)
               throws java.io.IOException,
                      Exception

Specified by:

upload in class Client

Throws:

java.io.IOException

Exception

See Also:

for noCaptchas by Token

getCaptcha

public Captcha getCaptcha(int id)
                   throws java.io.IOException,
                          Exception

Description copied from class: Client

Fetches an uploaded CAPTCHA details.

Specified by:

getCaptcha in class Client

Parameters:

id - CAPTCHA ID

Returns:

CAPTCHA object if found, null otherwise

Throws:

java.io.IOException

Exception

See Also:

Client.getCaptcha(int)

report

public boolean report(int id)
               throws java.io.IOException,
                      Exception

Description copied from class: Client

Reports an incorrectly solved CAPTCHA

Specified by:

report in class Client

Parameters:

id - CAPTCHA ID

Returns:

true on success

Throws:

java.io.IOException

Exception

See Also:

Client.report(int)