ca.uhn.fhir.rest.client

Class RestfulClientFactory

java.lang.Object

ca.uhn.fhir.rest.client.RestfulClientFactory

All Implemented Interfaces:

IRestfulClientFactory

public class RestfulClientFactory
extends Object
implements IRestfulClientFactory

Field Summary

Fields inherited from interface ca.uhn.fhir.rest.client.IRestfulClientFactory

DEFAULT_CONNECT_TIMEOUT, DEFAULT_CONNECTION_REQUEST_TIMEOUT, DEFAULT_POOL_MAX, DEFAULT_POOL_MAX_PER_ROUTE, DEFAULT_SERVER_VALIDATION_MODE, DEFAULT_SOCKET_TIMEOUT

Constructor Summary

Constructors

Constructor and Description
RestfulClientFactory() Constructor
RestfulClientFactory(FhirContext theFhirContext) Constructor

Method Summary

Modifier and Type	Method and Description
int	getConnectionRequestTimeout() Gets the connection request timeout, in milliseconds.
int	getConnectTimeout() Gets the connect timeout, in milliseconds.
org.apache.http.client.HttpClient	getHttpClient() Returns the Apache HTTP client instance.
int	getPoolMaxPerRoute() Gets the maximum number of connections per route allowed in the pool.
int	getPoolMaxTotal() Gets the maximum number of connections allowed in the pool.
ServerValidationModeEnum	getServerValidationMode() Gets the server validation mode for any clients created from this factory.
ServerValidationModeEnum	getServerValidationModeEnum()
int	getSocketTimeout() Gets the socket timeout, in milliseconds.
<T extends IRestfulClient> T	newClient(Class<T> theClientType, String theServerBase) Instantiates a new client instance
IGenericClient	newGenericClient(String theServerBase) Instantiates a new generic client instance
void	setConnectionRequestTimeout(int theConnectionRequestTimeout) Sets the connection request timeout, in milliseconds.
void	setConnectTimeout(int theConnectTimeout) Sets the connect timeout, in milliseconds.
void	setFhirContext(FhirContext theContext) Sets the context associated with this client factory.
void	setHttpClient(org.apache.http.client.HttpClient theHttpClient) Sets the Apache HTTP client instance to be used by any new restful clients created by this factory.
void	setPoolMaxPerRoute(int thePoolMaxPerRoute) Sets the maximum number of connections per route allowed in the pool.
void	setPoolMaxTotal(int thePoolMaxTotal) Sets the maximum number of connections allowed in the pool.
void	setProxy(String theHost, Integer thePort) Sets the HTTP proxy to use for outgoing connections
void	setProxyCredentials(String theUsername, String thePassword) Sets the credentials to use to authenticate with the HTTP proxy, if one is defined.
void	setServerValidationMode(ServerValidationModeEnum theServerValidationMode) Sets the server validation mode for any clients created from this factory.
void	setServerValidationModeEnum(ServerValidationModeEnum theServerValidationMode)
void	setSocketTimeout(int theSocketTimeout) Sets the socket timeout, in milliseconds.
void	validateServerBaseIfConfiguredToDoSo(String theServerBase, org.apache.http.client.HttpClient theHttpClient, BaseClient theClient) This method is internal to HAPI - It may change in future versions, use with caution.

Methods inherited from class java.lang.Object

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

Constructor Detail

RestfulClientFactory

public RestfulClientFactory()

Constructor

RestfulClientFactory

public RestfulClientFactory(FhirContext theFhirContext)

Constructor

Parameters:

theFhirContext - The context

Method Detail

getConnectionRequestTimeout

public int getConnectionRequestTimeout()

Description copied from interface: IRestfulClientFactory

Gets the connection request timeout, in milliseconds. This is the amount of time that the HTTPClient connection pool may wait for an available connection before failing. This setting typically does not need to be adjusted.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_CONNECTION_REQUEST_TIMEOUT

Specified by:

getConnectionRequestTimeout in interface IRestfulClientFactory

getConnectTimeout

public int getConnectTimeout()

Description copied from interface: IRestfulClientFactory

Gets the connect timeout, in milliseconds. This is the amount of time that the initial connection attempt network operation may block without failing.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_CONNECT_TIMEOUT

Specified by:

getConnectTimeout in interface IRestfulClientFactory

getHttpClient

public org.apache.http.client.HttpClient getHttpClient()

Description copied from interface: IRestfulClientFactory

Returns the Apache HTTP client instance. This method will not return null.

Specified by:

getHttpClient in interface IRestfulClientFactory

See Also:

IRestfulClientFactory.setHttpClient(HttpClient)

setProxyCredentials

public void setProxyCredentials(String theUsername,
                                String thePassword)

Description copied from interface: IRestfulClientFactory

Sets the credentials to use to authenticate with the HTTP proxy, if one is defined. Set to null to use no authentication with the proxy.

Specified by:

setProxyCredentials in interface IRestfulClientFactory

Parameters:

theUsername - The username

thePassword - The password

getServerValidationMode

public ServerValidationModeEnum getServerValidationMode()

Description copied from interface: IRestfulClientFactory

Gets the server validation mode for any clients created from this factory. Server validation involves the client requesting the server's conformance statement to determine whether the server is appropriate for the given client.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_SERVER_VALIDATION_MODE

Specified by:

getServerValidationMode in interface IRestfulClientFactory

getSocketTimeout

public int getSocketTimeout()

Description copied from interface: IRestfulClientFactory

Gets the socket timeout, in milliseconds. This is the SO_TIMEOUT time, which is the amount of time that a read/write network operation may block without failing.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_SOCKET_TIMEOUT

Specified by:

getSocketTimeout in interface IRestfulClientFactory

getPoolMaxTotal

public int getPoolMaxTotal()

Description copied from interface: IRestfulClientFactory

Gets the maximum number of connections allowed in the pool.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_POOL_MAX

Specified by:

getPoolMaxTotal in interface IRestfulClientFactory

getPoolMaxPerRoute

public int getPoolMaxPerRoute()

Description copied from interface: IRestfulClientFactory

Gets the maximum number of connections per route allowed in the pool.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_POOL_MAX_PER_ROUTE

Specified by:

getPoolMaxPerRoute in interface IRestfulClientFactory

newClient

public <T extends IRestfulClient> T newClient(Class<T> theClientType,
                                              String theServerBase)

Instantiates a new client instance

Specified by:

newClient in interface IRestfulClientFactory

Parameters:

theClientType - The client type, which is an interface type to be instantiated

theServerBase - The URL of the base for the restful FHIR server to connect to

Returns:

A newly created client

Throws:

ConfigurationException - If the interface type is not an interface

newGenericClient

public IGenericClient newGenericClient(String theServerBase)

Description copied from interface: IRestfulClientFactory

Instantiates a new generic client instance

Specified by:

newGenericClient in interface IRestfulClientFactory

Parameters:

theServerBase - The URL of the base for the restful FHIR server to connect to

Returns:

A newly created client

validateServerBaseIfConfiguredToDoSo

public void validateServerBaseIfConfiguredToDoSo(String theServerBase,
                                                 org.apache.http.client.HttpClient theHttpClient,
                                                 BaseClient theClient)

This method is internal to HAPI - It may change in future versions, use with caution.

setConnectionRequestTimeout

public void setConnectionRequestTimeout(int theConnectionRequestTimeout)

Description copied from interface: IRestfulClientFactory

Sets the connection request timeout, in milliseconds. This is the amount of time that the HTTPClient connection pool may wait for an available connection before failing. This setting typically does not need to be adjusted.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_CONNECTION_REQUEST_TIMEOUT

Specified by:

setConnectionRequestTimeout in interface IRestfulClientFactory

setConnectTimeout

public void setConnectTimeout(int theConnectTimeout)

Description copied from interface: IRestfulClientFactory

Sets the connect timeout, in milliseconds. This is the amount of time that the initial connection attempt network operation may block without failing.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_CONNECT_TIMEOUT

Specified by:

setConnectTimeout in interface IRestfulClientFactory

setFhirContext

public void setFhirContext(FhirContext theContext)

Sets the context associated with this client factory. Must not be called more than once.

setHttpClient

public void setHttpClient(org.apache.http.client.HttpClient theHttpClient)

Sets the Apache HTTP client instance to be used by any new restful clients created by this factory. If set to null, which is the default, a new HTTP client with default settings will be created.

Specified by:

setHttpClient in interface IRestfulClientFactory

Parameters:

theHttpClient - An HTTP client instance to use, or null

setProxy

public void setProxy(String theHost,
                     Integer thePort)

Description copied from interface: IRestfulClientFactory

Sets the HTTP proxy to use for outgoing connections

Specified by:

setProxy in interface IRestfulClientFactory

Parameters:

theHost - The host (or null to disable proxying, as is the default)

thePort - The port (or null to disable proxying, as is the default)

setServerValidationMode

public void setServerValidationMode(ServerValidationModeEnum theServerValidationMode)

Description copied from interface: IRestfulClientFactory

Sets the server validation mode for any clients created from this factory. Server validation involves the client requesting the server's conformance statement to determine whether the server is appropriate for the given client.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_SERVER_VALIDATION_MODE

Specified by:

setServerValidationMode in interface IRestfulClientFactory

setSocketTimeout

public void setSocketTimeout(int theSocketTimeout)

Description copied from interface: IRestfulClientFactory

Sets the socket timeout, in milliseconds. This is the SO_TIMEOUT time, which is the amount of time that a read/write network operation may block without failing.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_SOCKET_TIMEOUT

Specified by:

setSocketTimeout in interface IRestfulClientFactory

setPoolMaxTotal

public void setPoolMaxTotal(int thePoolMaxTotal)

Description copied from interface: IRestfulClientFactory

Sets the maximum number of connections allowed in the pool.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_POOL_MAX

Specified by:

setPoolMaxTotal in interface IRestfulClientFactory

setPoolMaxPerRoute

public void setPoolMaxPerRoute(int thePoolMaxPerRoute)

Description copied from interface: IRestfulClientFactory

Sets the maximum number of connections per route allowed in the pool.

The default value for this setting is defined by IRestfulClientFactory.DEFAULT_POOL_MAX_PER_ROUTE

Specified by:

setPoolMaxPerRoute in interface IRestfulClientFactory

getServerValidationModeEnum

public ServerValidationModeEnum getServerValidationModeEnum()

Specified by:

getServerValidationModeEnum in interface IRestfulClientFactory

setServerValidationModeEnum

public void setServerValidationModeEnum(ServerValidationModeEnum theServerValidationMode)

Specified by:

setServerValidationModeEnum in interface IRestfulClientFactory