ucar.nc2.util.net
Class HttpClientManager

java.lang.Object
  ucar.nc2.util.net.HttpClientManager

public class HttpClientManager
extends java.lang.Object

Manage Http Client protocol settings.

 Example:
   org.apache.commons.httpclient.auth.CredentialsProvider provider = new thredds.ui.UrlAuthenticatorDialog(frame);
 ucar.nc2.util.net.HttpClientManager.init(provider, "ToolsUI");
 

Author:

caron

Constructor Summary

HttpClientManager()

Method Summary

static long	appendUrlContentsToFile(java.lang.String urlString, java.io.File file, long start, long end)
static void	clearState()
static void	copyUrlContentsToFile(java.lang.String urlString, java.io.File file)
static java.lang.String	getContent(java.lang.String urlString) Get the content from a url.
static org.apache.commons.httpclient.HttpClient	getHttpClient() Get the HttpClient object - a single instance is used.
static java.lang.String	getUrlContents(java.lang.String urlString, int maxKbytes)
static org.apache.commons.httpclient.HttpClient	init(org.apache.commons.httpclient.auth.CredentialsProvider provider, java.lang.String userAgent) initialize the HttpClient layer.
static int	putContent(java.lang.String urlString, java.lang.String content) Put content to a url, using HTTP PUT.
static void	showHttpRequestInfo(java.util.Formatter f, org.apache.commons.httpclient.HttpMethodBase m)
static void	showHttpResponseInfo(java.util.Formatter f, org.apache.commons.httpclient.HttpMethodBase m)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpClientManager

public HttpClientManager()

Method Detail

init

public static org.apache.commons.httpclient.HttpClient init(org.apache.commons.httpclient.auth.CredentialsProvider provider,
                                                            java.lang.String userAgent)

initialize the HttpClient layer.

Parameters:

provider - CredentialsProvider.

userAgent - Content of User-Agent header, may be null

getHttpClient

public static org.apache.commons.httpclient.HttpClient getHttpClient()

Get the HttpClient object - a single instance is used.

Returns:

the HttpClient object

clearState

public static void clearState()

getContent

public static java.lang.String getContent(java.lang.String urlString)
                                   throws java.io.IOException

Get the content from a url. For large returns, its better to use getResponseAsStream.

Parameters:

urlString - url as a String

Returns:

contents of url as a String

Throws:

java.io.IOException - on error

putContent

public static int putContent(java.lang.String urlString,
                             java.lang.String content)
                      throws java.io.IOException

Put content to a url, using HTTP PUT. Handles one level of 302 redirection.

Parameters:

urlString - url as a String

content - PUT this content at the given url.

Returns:

the HTTP status return code

Throws:

java.io.IOException - on error

getUrlContents

public static java.lang.String getUrlContents(java.lang.String urlString,
                                              int maxKbytes)

copyUrlContentsToFile

public static void copyUrlContentsToFile(java.lang.String urlString,
                                         java.io.File file)

appendUrlContentsToFile

public static long appendUrlContentsToFile(java.lang.String urlString,
                                           java.io.File file,
                                           long start,
                                           long end)

showHttpRequestInfo

public static void showHttpRequestInfo(java.util.Formatter f,
                                       org.apache.commons.httpclient.HttpMethodBase m)

showHttpResponseInfo

public static void showHttpResponseInfo(java.util.Formatter f,
                                        org.apache.commons.httpclient.HttpMethodBase m)