com.DeathByCaptcha

Class SocketClient

java.lang.Object

com.DeathByCaptcha.Client

com.DeathByCaptcha.SocketClient

public class SocketClient
extends Client

Death by Captcha socket API client.

Field Summary

Fields

Modifier and Type	Field and Description
static int	FIRST_PORT
static java.lang.String	HOST
static int	LAST_PORT
static java.lang.String	TERMINATOR

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
SocketClient(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.
void	finalize()
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

HOST

public static final java.lang.String HOST

See Also:

Constant Field Values

FIRST_PORT

public static final int FIRST_PORT

See Also:

Constant Field Values

LAST_PORT

public static final int LAST_PORT

See Also:

Constant Field Values

TERMINATOR

public static final java.lang.String TERMINATOR

See Also:

Constant Field Values

Constructor Detail

SocketClient

public SocketClient(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()

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object

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

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)