ucar.nc2.util.net

Class HttpClientManager

java.lang.Object

ucar.nc2.util.net.HttpClientManager

public class HttpClientManager
extends java.lang.Object

Convenience routines that wrap HTTPSession.

Author:

caron

Constructor Summary

Constructors

Constructor and Description
HttpClientManager()

Method Summary

Methods

Modifier and Type	Method and Description
static long	appendUrlContentsToFile(HTTPSession session, java.lang.String urlString, java.io.File file, long start, long end)
static void	clearState()
static void	copyUrlContentsToFile(HTTPSession session, java.lang.String urlString, java.io.File file)
static java.lang.String	getContentAsString(HTTPSession session, java.lang.String urlString) Get the content from a url.
static java.lang.String	getUrlContentsAsString(HTTPSession session, java.lang.String urlString, int maxKbytes)
static void	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 void 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

clearState

public static void clearState()

getContentAsString

public static java.lang.String getContentAsString(HTTPSession session,
                                  java.lang.String urlString)
                                           throws java.io.IOException

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

Parameters:

session - use this session, if null, create a new one

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

getUrlContentsAsString

public static java.lang.String getUrlContentsAsString(HTTPSession session,
                                      java.lang.String urlString,
                                      int maxKbytes)

copyUrlContentsToFile

public static void copyUrlContentsToFile(HTTPSession session,
                         java.lang.String urlString,
                         java.io.File file)
                                  throws HTTPException

Throws:

HTTPException

appendUrlContentsToFile

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

Throws:

HTTPException

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)