winterwell.jtwitter
Interface Twitter.IHttpClient

All Known Implementing Classes:

OAuthScribeClient, OAuthSignpostClient, URLConnectionHttpClient

Enclosing class:

Twitter

public static interface Twitter.IHttpClient

Interface for an http client - e.g. allows for OAuth to be used instead. The standard version is OAuthSignpostClient.

If creating your own version, please provide support for throwing the right subclass of TwitterException - see URLConnectionHttpClient.processError(java.net.HttpURLConnection) for example code.

Method Summary

boolean	canAuthenticate() Whether this client is setup to do authentication when contacting the Twitter server.
java.lang.String	getPage(java.lang.String uri, java.util.Map<java.lang.String,java.lang.String> vars, boolean authenticate) Send an HTTP GET request and return the response body.
java.lang.String	post(java.lang.String uri, java.util.Map<java.lang.String,java.lang.String> vars, boolean authenticate) Send an HTTP POST request and return the response body.
void	setTimeout(int millisecs) Set the timeout for a single get/post request.

Method Detail

canAuthenticate

boolean canAuthenticate()

Whether this client is setup to do authentication when contacting the Twitter server. Note: This is a fast method that does not call the server, so it does not check whether the access token or password is valid. See {Twitter#isValidLogin()} or TwitterAccount.verifyCredentials() if you need to check a login.

getPage

java.lang.String getPage(java.lang.String uri,
                         java.util.Map<java.lang.String,java.lang.String> vars,
                         boolean authenticate)
                         throws TwitterException

Send an HTTP GET request and return the response body. Note that this will change all line breaks into system line breaks!

Parameters:

uri - The uri to fetch

vars - get arguments to add to the uri

authenticate - If true, use authentication. The authentication method used depends on the implementation (basic-auth, OAuth). It is an error to use true if no authentication details have been set.

Throws:

TwitterException - for a variety of reasons

TwitterException.E404 - for resource-does-not-exist errors

post

java.lang.String post(java.lang.String uri,
                      java.util.Map<java.lang.String,java.lang.String> vars,
                      boolean authenticate)
                      throws TwitterException

Send an HTTP POST request and return the response body.

Parameters:

uri - The uri to post to.

vars - The form variables to send. These are URL encoded before sending.

authenticate - If true, send user authentication

Returns:

The response from the server.

Throws:

TwitterException - for a variety of reasons

TwitterException.E404 - for resource-does-not-exist errors

setTimeout

void setTimeout(int millisecs)

Set the timeout for a single get/post request. This is an optional method - implementation can ignore it!

Parameters:

millisecs -