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.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
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 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

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

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