com.screenscraper.util.images.deathbycaptcha_api

Class SocketClient

java.lang.Object

com.screenscraper.util.images.deathbycaptcha_api.Client

com.screenscraper.util.images.deathbycaptcha_api.SocketClient

public class SocketClient
extends Client

Death by Captcha socket API client.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Object	callLock
protected java.nio.channels.SocketChannel	channel
static int	FIRST_PORT
static java.lang.String	HOST
static int	LAST_PORT
static java.lang.String	TERMINATOR

Fields inherited from class com.screenscraper.util.images.deathbycaptcha_api.Client

_password, _username, API_VERSION, DEFAULT_TIMEOUT, isVerbose, 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
protected org.json.JSONObject	call(java.lang.String cmd)
protected org.json.JSONObject	call(java.lang.String cmd, org.json.JSONObject args)
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
protected java.lang.String	sendAndReceive(byte[] payload)
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.

Methods inherited from class com.screenscraper.util.images.deathbycaptcha_api.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, getBalance, getCaptcha, getCredentials, getText, getText, load, load, load, log, log, report, upload, upload, upload

Methods inherited from class java.lang.Object

clone, 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

channel

@Nullable
protected java.nio.channels.SocketChannel channel

callLock

@NotNull
protected java.lang.Object callLock

Constructor Detail

SocketClient

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

See Also:

Client.Client(String, String)

Method Detail

sendAndReceive

@NotNull
protected java.lang.String sendAndReceive(@NotNull
                                                    byte[] payload)
                                             throws java.io.IOException

Throws:

java.io.IOException

close

public void close()

Description copied from class: Client

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

Specified by:

close in class Client

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

call

@Nullable
protected org.json.JSONObject call(@NotNull
                                              java.lang.String cmd,
                                              @NotNull
                                              org.json.JSONObject args)
                                       throws java.io.IOException,
                                              Exception

Throws:

java.io.IOException

Exception

call

@Nullable
protected org.json.JSONObject call(@NotNull
                                              java.lang.String cmd)
                                       throws java.io.IOException,
                                              Exception

Throws:

java.io.IOException

Exception

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object

getUser

@NotNull
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

upload

@Nullable
public Captcha upload(byte[] img,
                                 java.lang.String challenge,
                                 int type,
                                 @Nullable
                                 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

upload

@Nullable
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

@NotNull
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

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

Specified by:

upload in class Client

Throws:

java.io.IOException

Exception

getCaptcha

@NotNull
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

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