com.screenscraper.util.images.deathbycaptcha_api

Class HttpClient

java.lang.Object

com.screenscraper.util.images.deathbycaptcha_api.Client

com.screenscraper.util.images.deathbycaptcha_api.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.screenscraper.util.images.deathbycaptcha_api.Client

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

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

call

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

Throws:

java.io.IOException

Exception

call

@NotNull
protected org.json.JSONObject call(java.lang.String cmd,
                                             @NotNull
                                             byte[] data)
                                      throws java.io.IOException,
                                             Exception

Throws:

java.io.IOException

Exception

call

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

Throws:

java.io.IOException

Exception

call

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

Throws:

java.io.IOException

Exception

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

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(@NotNull
                                 byte[] img,
                                 @NotNull
                                 java.lang.String challenge,
                                 int type,
                                 @Nullable
                                 byte[] banner,
                                 @NotNull
                                 java.lang.String banner_text,
                                 @NotNull
                                 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(@NotNull
                                 byte[] img,
                                 @NotNull
                                 java.lang.String challenge,
                                 int type,
                                 byte[] banner,
                                 @NotNull
                                 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(@NotNull
                                 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