org.biojava.nbio.structure.align.util

Class HTTPConnectionTools

java.lang.Object

org.biojava.nbio.structure.align.util.HTTPConnectionTools

public class HTTPConnectionTools
extends Object

a class that takes care about opening HttpURLConnections and sets the proper timeouts

Since:

9:58:25 AM

Version:

%I% %G%

Author:

Andreas Prlic

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_CONNECTION_TIMEOUT
static String	USERAGENT

Constructor Summary

Constructors

Constructor and Description
HTTPConnectionTools()

Method Summary

Modifier and Type	Method and Description
static InputStream	doPOST(URL url, String data) do a POST to a URL and return the response stream for further processing elsewhere.
static InputStream	doPOST(URL url, String data, int timeout) do a POST to a URL and return the response stream for further processing elsewhere.
static InputStream	getInputStream(URL url) connect to DAS server and return result as an InputStream.
static InputStream	getInputStream(URL url, boolean acceptGzipEncoding, int timeout) open a URL and return an InputStream to it if acceptGzipEncoding == true, use GZIPEncoding to compress communication
static InputStream	getInputStream(URL url, int timeout) connect to DAS server and return result as an InputStream.
static HttpURLConnection	openHttpURLConnection(URL url) open HttpURLConnection.
static HttpURLConnection	openHttpURLConnection(URL url, int timeout) open HttpURLConnection.

Methods inherited from class java.lang.Object

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

Field Detail

USERAGENT

public static final String USERAGENT

See Also:

Constant Field Values

DEFAULT_CONNECTION_TIMEOUT

public static final int DEFAULT_CONNECTION_TIMEOUT

See Also:

Constant Field Values

Constructor Detail

HTTPConnectionTools

public HTTPConnectionTools()

Method Detail

openHttpURLConnection

public static HttpURLConnection openHttpURLConnection(URL url,
                                                      int timeout)
                                               throws IOException,
                                                      ConnectException

open HttpURLConnection. Recommended way to open HttpURLConnections, since this take care of setting timeouts properly for java 1.4 and 1.5

Parameters:

url - URL to oopen

timeout - timeout in milli seconds

Returns:

a HttpURLConnection

Throws:

IOException

ConnectException

openHttpURLConnection

public static HttpURLConnection openHttpURLConnection(URL url)
                                               throws IOException,
                                                      ConnectException

open HttpURLConnection. Recommended way to open HttpURLConnections, since this take care of setting timeouts properly for java 1.4 and 1.5 uses the DEFAULT_CONNECTION_TIMEOUT (= 15 seconds)

Parameters:

url - a URL to open a http connection to

Returns:

HttpURLConnect the opened connection

Throws:

IOException

ConnectException

getInputStream

public static InputStream getInputStream(URL url,
                                         int timeout)
                                  throws IOException

connect to DAS server and return result as an InputStream. always asks for response to be in GZIP encoded

Parameters:

url - the URL to connect to

timeout - the timeout for the connection

Returns:

an InputStream

Throws:

IOException

DASException - if DAS server returns error response code

getInputStream

public static InputStream getInputStream(URL url)
                                  throws IOException

connect to DAS server and return result as an InputStream. always asks for response to be in GZIP encoded

Parameters:

url - the URL to connect to

Returns:

an InputStream

Throws:

IOException

DASException - if DAS server returns error response code

getInputStream

public static InputStream getInputStream(URL url,
                                         boolean acceptGzipEncoding,
                                         int timeout)
                                  throws IOException

open a URL and return an InputStream to it if acceptGzipEncoding == true, use GZIPEncoding to compress communication

Parameters:

url -

acceptGzipEncoding -

Returns:

an InputStream to the URL

Throws:

IOException

DASException - if DAS server returns error response code

doPOST

public static InputStream doPOST(URL url,
                                 String data)
                          throws IOException

do a POST to a URL and return the response stream for further processing elsewhere.

Parameters:

url -

Returns:

InputStream of response

Throws:

IOException

doPOST

public static InputStream doPOST(URL url,
                                 String data,
                                 int timeout)
                          throws IOException

do a POST to a URL and return the response stream for further processing elsewhere.

Parameters:

url -

Returns:

InputStream of response

Throws:

IOException