Util

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS (src) NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.jboss.invocation.http.interfaces
Class Util

java.lang.Object
  org.jboss.invocation.http.interfaces.Util

public class Util
extends java.lang.Object

Common client utility methods

Field Summary
`static java.lang.String`	`IGNORE_HTTPS_HOST` A property to override the default https url host verification
`static java.lang.String`	`SSL_FACTORY_BUILDER` A property to install the https connection ssl socket factory

Constructor Summary
`Util()`

Method Summary
`static void`	`configureHttpsHostVerifier(java.net.HttpURLConnection conn)` Given an Https URL connection check the org.jboss.security.ignoreHttpsHost system property and if true, install the AnyhostVerifier as the com.sun.net.ssl.HostnameVerifier or javax.net.ssl.HostnameVerifier depending on the version of JSSE seen.
`static void`	`configureSSLSocketFactory(java.net.HttpURLConnection conn)` Override the SSLSocketFactory used by the HttpsURLConnection.
`static void`	`init()` Install the SecurityAssociationAuthenticator as the default java.net.Authenticator
`static java.lang.Object`	`invoke(java.net.URL externalURL, Invocation (src) mi)` Post the Invocation as a serialized MarshalledInvocation object.
`static java.net.URL`	`resolveURL(java.lang.String urlValue)` First try to use the externalURLValue as a URL string and if this fails to produce a valid URL treat the externalURLValue as a system property name from which to obtain the URL string.

Methods inherited from class java.lang.Object

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

Field Detail

IGNORE_HTTPS_HOST

public static final java.lang.String IGNORE_HTTPS_HOST

A property to override the default https url host verification

See Also:: Constant Field Values (src)

SSL_FACTORY_BUILDER

public static final java.lang.String SSL_FACTORY_BUILDER

A property to install the https connection ssl socket factory

See Also:: Constant Field Values (src)

Constructor Detail

Util

public Util()

Method Detail

init

public static void init()

Install the SecurityAssociationAuthenticator as the default java.net.Authenticator

invoke

public static java.lang.Object invoke(java.net.URL externalURL,
                                      Invocation (src)  mi)
                               throws java.lang.Exception

Post the Invocation as a serialized MarshalledInvocation object. This is using the URL class for now but this should be improved to a cluster aware layer with full usage of HTTP 1.1 features, pooling, etc.

Throws:: java.lang.Exception

configureHttpsHostVerifier

public static void configureHttpsHostVerifier(java.net.HttpURLConnection conn)

Given an Https URL connection check the org.jboss.security.ignoreHttpsHost system property and if true, install the AnyhostVerifier as the com.sun.net.ssl.HostnameVerifier or javax.net.ssl.HostnameVerifier depending on the version of JSSE seen. If HttpURLConnection is not a HttpsURLConnection then nothing is done.

Parameters:: conn - a HttpsURLConnection

configureSSLSocketFactory

public static void configureSSLSocketFactory(java.net.HttpURLConnection conn)
                                      throws java.lang.reflect.InvocationTargetException

Override the SSLSocketFactory used by the HttpsURLConnection. This method will invoke setSSLSocketFactory on any HttpsURLConnection if there was a SSLSocketFactoryBuilder implementation specified via the org.jboss.security.httpInvoker.sslSocketFactoryBuilder system property.

Parameters:: conn - possibly a HttpsURLConnection
Throws:: java.lang.reflect.InvocationTargetException - thrown on failure to invoke setSSLSocketFactory

resolveURL

public static java.net.URL resolveURL(java.lang.String urlValue)
                               throws java.net.MalformedURLException

First try to use the externalURLValue as a URL string and if this fails to produce a valid URL treat the externalURLValue as a system property name from which to obtain the URL string. This allows the proxy url to not be set until the proxy is unmarshalled in the client vm, and is necessary when the server is sitting behind a firewall or proxy and does not know what its public http interface is named.