com.restfb

Class DefaultWebRequestor

java.lang.Object

com.restfb.DefaultWebRequestor

All Implemented Interfaces:

WebRequestor

public class DefaultWebRequestor
extends Object
implements WebRequestor

Default implementation of a service that sends HTTP requests to the Facebook API endpoint.

Author:

Mark Allen

Nested Class Summary

Nested classes/interfaces inherited from interface com.restfb.WebRequestor

WebRequestor.Response

Constructor Summary

Constructors

Constructor and Description
DefaultWebRequestor()

Method Summary

Modifier and Type	Method and Description
protected void	closeQuietly(Closeable closeable) Attempts to cleanly close a resource, swallowing any exceptions that might occur since there's no way to recover anyway.
protected void	closeQuietly(HttpURLConnection httpUrlConnection) Attempts to cleanly close an HttpURLConnection, swallowing any exceptions that might occur since there's no way to recover anyway.
protected void	customizeConnection(HttpURLConnection connection) Hook method which allows subclasses to easily customize the connections created by executeGet(String) and executePost(String, String) - for example, setting a custom read timeout or request header.
WebRequestor.Response	executeGet(String url) Given a Facebook API endpoint URL, execute a GET against it.
WebRequestor.Response	executePost(String url, String parameters) Given a Facebook API endpoint URL and parameter string, execute a POST to the endpoint URL.
WebRequestor.Response	executePost(String url, String parameters, InputStream binaryAttachment) Given a Facebook API endpoint URL and parameter string, execute a POST to the endpoint URL.
protected void	write(InputStream source, OutputStream destination, int bufferSize) Writes the contents of the source stream to the destination stream using the given bufferSize.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultWebRequestor

public DefaultWebRequestor()

Method Detail

executeGet

public WebRequestor.Response executeGet(String url)
                                 throws IOException

Description copied from interface: WebRequestor

Given a Facebook API endpoint URL, execute a GET against it.

Specified by:

executeGet in interface WebRequestor

Parameters:

url - The URL to make a GET request for, including URL parameters.

Returns:

HTTP response data.

Throws:

IOException - If an error occurs while performing the GET operation.

See Also:

WebRequestor.executeGet(String)

executePost

public WebRequestor.Response executePost(String url,
                                         String parameters)
                                  throws IOException

Description copied from interface: WebRequestor

Given a Facebook API endpoint URL and parameter string, execute a POST to the endpoint URL.

Specified by:

executePost in interface WebRequestor

Parameters:

url - The URL to POST to.

parameters - The parameters to be POSTed.

Returns:

HTTP response data.

Throws:

IOException - If an error occurs while performing the POST.

See Also:

WebRequestor.executePost(String, String)

executePost

public WebRequestor.Response executePost(String url,
                                         String parameters,
                                         InputStream binaryAttachment)
                                  throws IOException

Description copied from interface: WebRequestor

Given a Facebook API endpoint URL and parameter string, execute a POST to the endpoint URL.

Specified by:

executePost in interface WebRequestor

Parameters:

url - The URL to POST to.

parameters - The parameters to be POSTed.

binaryAttachment - A binary attachment to be included in the POST body (e.g. a photo).

Returns:

HTTP response data.

Throws:

IOException - If an error occurs while performing the POST.

See Also:

WebRequestor.executePost(String, String, java.io.InputStream)

customizeConnection

protected void customizeConnection(HttpURLConnection connection)

Hook method which allows subclasses to easily customize the connections created by executeGet(String) and executePost(String, String) - for example, setting a custom read timeout or request header.

This implementation is a no-op.

Parameters:

connection - The connection to customize.

closeQuietly

protected void closeQuietly(Closeable closeable)

Attempts to cleanly close a resource, swallowing any exceptions that might occur since there's no way to recover anyway.

It's OK to pass null in, this method will no-op in that case.

Parameters:

closeable - The resource to close.

closeQuietly

protected void closeQuietly(HttpURLConnection httpUrlConnection)

Attempts to cleanly close an HttpURLConnection, swallowing any exceptions that might occur since there's no way to recover anyway.

It's OK to pass null in, this method will no-op in that case.

Parameters:

httpUrlConnection - The connection to close.

write

protected void write(InputStream source,
                     OutputStream destination,
                     int bufferSize)
              throws IOException

Writes the contents of the source stream to the destination stream using the given bufferSize.

Parameters:

source - The source stream to copy from.

destination - The destination stream to copy to.

bufferSize - The size of the buffer to use during the copy operation.

Throws:

IOException - If an error occurs when reading from source or writing to destination.

NullPointerException - If either source or @{code destination} is null.