net.shibboleth.utilities.java.support.httpclient

Class HttpClientSupport

java.lang.Object

net.shibboleth.utilities.java.support.httpclient.HttpClientSupport

public final class HttpClientSupport
extends Object

Support class for using HttpClient and related components.

Field Summary

Fields

Modifier and Type	Field and Description
private static String	CONTEXT_KEY_DYNAMIC_CONTEXT_HANDLERS Context key for instances of dynamic context handlers to be invoked before and after the HTTP request.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	HttpClientSupport() Constructor to prevent instantiation.

Method Summary

Methods

Modifier and Type	Method and Description
static void	addDynamicContextHandlerFirst(HttpClientContext context, HttpClientContextHandler handler) Add the specified instance of HttpClientContextHandler to the HttpClientContext in the first handler list position.
static void	addDynamicContextHandlerLast(HttpClientContext context, HttpClientContextHandler handler) Add the specified instance of HttpClientContextHandler to the HttpClientContext in the last handler list position.
static SSLConnectionSocketFactory	buildNoTrustSSLConnectionSocketFactory() Deprecated. use instead buildNoTrustTLSSocketFactory()
static LayeredConnectionSocketFactory	buildNoTrustTLSSocketFactory() Build a TLS-capable instance of LayeredConnectionSocketFactory which accepts all peer certificates and performs no hostname verification.
static X509TrustManager	buildNoTrustX509TrustManager() Build an instance of X509TrustManager which trusts all certificates.
static SSLConnectionSocketFactory	buildStrictSSLConnectionSocketFactory() Deprecated. use instead buildStrictTLSSocketFactory()
static LayeredConnectionSocketFactory	buildStrictTLSSocketFactory() Build an instance of TLS-capable LayeredConnectionSocketFactory which uses the standard JSSE default SSLContext and which performs strict hostname verification.
static List<HttpClientContextHandler>	getDynamicContextHandlerList(HttpClientContext context) Get the list of HttpClientContextHandler for the HttpClientContext.
static String	toString(org.apache.http.HttpEntity entity, Charset defaultCharset, int maxLength) Get the entity content as a String, using the provided default character set if none is found in the entity.
static String	toString(org.apache.http.HttpEntity entity, int maxLength) Read the contents of an entity and return it as a String.
static String	toString(org.apache.http.HttpEntity entity, String defaultCharset, int maxLength) Get the entity content as a String, using the provided default character set if none is found in the entity.

Methods inherited from class java.lang.Object

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

Field Detail

CONTEXT_KEY_DYNAMIC_CONTEXT_HANDLERS

private static final String CONTEXT_KEY_DYNAMIC_CONTEXT_HANDLERS

Context key for instances of dynamic context handlers to be invoked before and after the HTTP request. Must be an instance of List<HttpClientContextHandler>.

See Also:

Constant Field Values

Constructor Detail

HttpClientSupport

private HttpClientSupport()

Constructor to prevent instantiation.

Method Detail

buildStrictTLSSocketFactory

@Nonnull
public static LayeredConnectionSocketFactory buildStrictTLSSocketFactory()

Build an instance of TLS-capable LayeredConnectionSocketFactory which uses the standard JSSE default SSLContext and which performs strict hostname verification.

Returns:

a new instance of HttpClient SSL connection socket factory

buildNoTrustTLSSocketFactory

@Nonnull
public static LayeredConnectionSocketFactory buildNoTrustTLSSocketFactory()

Build a TLS-capable instance of LayeredConnectionSocketFactory which accepts all peer certificates and performs no hostname verification.

Returns:

a new instance of HttpClient SSL connection socket factory

buildStrictSSLConnectionSocketFactory

@Deprecated
@Nonnull
public static SSLConnectionSocketFactory buildStrictSSLConnectionSocketFactory()

Deprecated. use instead buildStrictTLSSocketFactory()

Build an instance of SSLConnectionSocketFactory which uses the standard HttpClient default SSLContext and which uses a strict hostname verifier SSLConnectionSocketFactory.STRICT_HOSTNAME_VERIFIER.

Returns:

a new instance of HttpClient SSL connection socket factory

buildNoTrustSSLConnectionSocketFactory

@Deprecated
@Nonnull
public static SSLConnectionSocketFactory buildNoTrustSSLConnectionSocketFactory()

Deprecated. use instead buildNoTrustTLSSocketFactory()

Build an instance of SSLConnectionSocketFactory which accepts all peer certificates and performs no hostname verification.

Returns:

a new instance of HttpClient SSL connection socket factory

buildNoTrustX509TrustManager

@Nonnull
public static X509TrustManager buildNoTrustX509TrustManager()

Build an instance of X509TrustManager which trusts all certificates.

Returns:

a new trust manager instance

getDynamicContextHandlerList

@Nonnull
public static List<HttpClientContextHandler> getDynamicContextHandlerList(@Nonnull
                                                                  HttpClientContext context)

Get the list of HttpClientContextHandler for the HttpClientContext.

Parameters:

context - the client context

Returns:

the handler list

addDynamicContextHandlerFirst

public static void addDynamicContextHandlerFirst(@Nonnull
                                 HttpClientContext context,
                                 @Nonnull
                                 HttpClientContextHandler handler)

Add the specified instance of HttpClientContextHandler to the HttpClientContext in the first handler list position.

Parameters:

context - the client context

handler - the handler to add

addDynamicContextHandlerLast

public static void addDynamicContextHandlerLast(@Nonnull
                                HttpClientContext context,
                                @Nonnull
                                HttpClientContextHandler handler)

Add the specified instance of HttpClientContextHandler to the HttpClientContext in the last handler list position.

Parameters:

context - the client context

handler - the handler to add

toString

@Nullable
public static String toString(@Nonnull
                       org.apache.http.HttpEntity entity,
                       @Nullable
                       Charset defaultCharset,
                       int maxLength)
                       throws IOException,
                              org.apache.http.ParseException

Get the entity content as a String, using the provided default character set if none is found in the entity.

If defaultCharset is null, the default "ISO-8859-1" is used.

Parameters:

entity - must not be null

defaultCharset - character set to be applied if none found in the entity

maxLength - limit on size of content

Returns:

the entity content as a String. May be null if HttpEntity.getContent() is null.

Throws:

org.apache.http.ParseException - if header elements cannot be parsed

IOException - if an error occurs reading the input stream, or the size exceeds limits

UnsupportedCharsetException - when the content's charset is not available

toString

@Nullable
public static String toString(@Nonnull
                       org.apache.http.HttpEntity entity,
                       @Nullable
                       String defaultCharset,
                       int maxLength)
                       throws IOException,
                              org.apache.http.ParseException

Get the entity content as a String, using the provided default character set if none is found in the entity. If defaultCharset is null, the default "ISO-8859-1" is used.

Parameters:

entity - must not be null

defaultCharset - character set to be applied if none found in the entity

maxLength - limit on size of content

Returns:

the entity content as a String. May be null if HttpEntity.getContent() is null.

Throws:

org.apache.http.ParseException - if header elements cannot be parsed

IOException - if an error occurs reading the input stream, or the size exceeds limits

UnsupportedCharsetException - when the content's charset is not available

toString

@Nullable
public static String toString(@Nonnull
                       org.apache.http.HttpEntity entity,
                       int maxLength)
                       throws IOException,
                              org.apache.http.ParseException

Read the contents of an entity and return it as a String. The content is converted using the character set from the entity (if any), failing that, "ISO-8859-1" is used.

Parameters:

entity - the entity to convert to a string; must not be null

maxLength - limit on size of content

Returns:

the entity content as a String. May be null if HttpEntity.getContent() is null.

Throws:

org.apache.http.ParseException - if header elements cannot be parsed

IOException - if an error occurs reading the input stream, or the size exceeds limits

UnsupportedCharsetException - when the content's charset is not available