IRestfulClientFactory (HAPI FHIR - Core Library 1.4 API)

All Known Implementing Classes:

RestfulClientFactory
```
public interface IRestfulClientFactory
```

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_CONNECT_TIMEOUT` Default value for `getConnectTimeout()`
`static int`	`DEFAULT_CONNECTION_REQUEST_TIMEOUT` Default value for `getConnectionRequestTimeout()`
`static int`	`DEFAULT_POOL_MAX` Default value for `()`
`static int`	`DEFAULT_POOL_MAX_PER_ROUTE` Default value for `getPoolMaxPerRoute()`
`static ServerValidationModeEnum`	`DEFAULT_SERVER_VALIDATION_MODE` Default value for `getServerValidationModeEnum()`
`static int`	`DEFAULT_SOCKET_TIMEOUT` Default value for `getSocketTimeout()`

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
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()` Deprecated. Use `getServerValidationMode()` instead
`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`	`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)` Deprecated. Use `setServerValidationMode(ServerValidationModeEnum)` instead. This method was incorrectly named.
`void`	`setSocketTimeout(int theSocketTimeout)` Sets the socket timeout, in milliseconds.

- Field Detail
  - DEFAULT_CONNECT_TIMEOUT
```
static final int DEFAULT_CONNECT_TIMEOUT
```
    Default value for getConnectTimeout()
    
    See Also:
    
    Constant Field Values
  - DEFAULT_CONNECTION_REQUEST_TIMEOUT
```
static final int DEFAULT_CONNECTION_REQUEST_TIMEOUT
```
    Default value for getConnectionRequestTimeout()
    
    See Also:
    
    Constant Field Values
  - DEFAULT_SERVER_VALIDATION_MODE
```
static final ServerValidationModeEnum DEFAULT_SERVER_VALIDATION_MODE
```
    Default value for getServerValidationModeEnum()
  - DEFAULT_SOCKET_TIMEOUT
```
static final int DEFAULT_SOCKET_TIMEOUT
```
    Default value for getSocketTimeout()
    
    See Also:
    
    Constant Field Values
  - DEFAULT_POOL_MAX
```
static final int DEFAULT_POOL_MAX
```
    Default value for ()
    
    See Also:
    
    Constant Field Values
  - DEFAULT_POOL_MAX_PER_ROUTE
```
static final int DEFAULT_POOL_MAX_PER_ROUTE
```
    Default value for getPoolMaxPerRoute()
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getConnectionRequestTimeout
```
int getConnectionRequestTimeout()
```
    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 DEFAULT_CONNECTION_REQUEST_TIMEOUT
  - getConnectTimeout
```
int getConnectTimeout()
```
    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 DEFAULT_CONNECT_TIMEOUT
  - getHttpClient
```
org.apache.http.client.HttpClient getHttpClient()
```
    Returns the Apache HTTP client instance. This method will not return null.
    
    See Also:
    
    setHttpClient(HttpClient)
  - getServerValidationModeEnum
```
@Deprecated
ServerValidationModeEnum getServerValidationModeEnum()
```
    Deprecated. Use getServerValidationMode() instead
  - getServerValidationMode
```
ServerValidationModeEnum getServerValidationMode()
```
    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 DEFAULT_SERVER_VALIDATION_MODE
    
    Since:
    
    1.0
  - getSocketTimeout
```
int getSocketTimeout()
```
    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 DEFAULT_SOCKET_TIMEOUT
  - getPoolMaxTotal
```
int getPoolMaxTotal()
```
    Gets the maximum number of connections allowed in the pool.
    The default value for this setting is defined by DEFAULT_POOL_MAX
  - getPoolMaxPerRoute
```
int getPoolMaxPerRoute()
```
    Gets the maximum number of connections per route allowed in the pool.
    The default value for this setting is defined by DEFAULT_POOL_MAX_PER_ROUTE
  - newClient
```
<T extends IRestfulClient> T newClient(Class<T> theClientType,
                                       String theServerBase)
```
    Instantiates a new client instance
    
    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
```
IGenericClient newGenericClient(String theServerBase)
```
    Instantiates a new generic client instance
    
    Parameters:
    
    theServerBase - The URL of the base for the restful FHIR server to connect to
    
    Returns:
    
    A newly created client
  - setConnectionRequestTimeout
```
void setConnectionRequestTimeout(int theConnectionRequestTimeout)
```
    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 DEFAULT_CONNECTION_REQUEST_TIMEOUT
  - setConnectTimeout
```
void setConnectTimeout(int theConnectTimeout)
```
    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 DEFAULT_CONNECT_TIMEOUT
  - setHttpClient
```
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, a new HTTP client with default settings will be created.
    
    Parameters:
    
    theHttpClient - An HTTP client instance to use, or null
  - setProxy
```
void setProxy(String theHost,
              Integer thePort)
```
    Sets the HTTP proxy to use for outgoing connections
    
    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)
  - setProxyCredentials
```
void setProxyCredentials(String theUsername,
                         String thePassword)
```
    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.
    
    Parameters:
    
    theUsername - The username
    
    thePassword - The password
  - setServerValidationModeEnum
```
@Deprecated
void setServerValidationModeEnum(ServerValidationModeEnum theServerValidationMode)
```
    Deprecated. Use setServerValidationMode(ServerValidationModeEnum) instead. This method was incorrectly named.
  - setServerValidationMode
```
void setServerValidationMode(ServerValidationModeEnum theServerValidationMode)
```
    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 DEFAULT_SERVER_VALIDATION_MODE
    
    Since:
    
    1.0
  - setSocketTimeout
```
void setSocketTimeout(int theSocketTimeout)
```
    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 DEFAULT_SOCKET_TIMEOUT
  - setPoolMaxTotal
```
void setPoolMaxTotal(int thePoolMaxTotal)
```
    Sets the maximum number of connections allowed in the pool.
    The default value for this setting is defined by DEFAULT_POOL_MAX
  - setPoolMaxPerRoute
```
void setPoolMaxPerRoute(int thePoolMaxPerRoute)
```
    Sets the maximum number of connections per route allowed in the pool.
    The default value for this setting is defined by DEFAULT_POOL_MAX_PER_ROUTE

Interface IRestfulClientFactory

Field Summary

Method Summary

Field Detail

DEFAULT_CONNECT_TIMEOUT

DEFAULT_CONNECTION_REQUEST_TIMEOUT

DEFAULT_SERVER_VALIDATION_MODE

DEFAULT_SOCKET_TIMEOUT

DEFAULT_POOL_MAX

DEFAULT_POOL_MAX_PER_ROUTE

Method Detail

getConnectionRequestTimeout

getConnectTimeout

getHttpClient

getServerValidationModeEnum

getServerValidationMode

getSocketTimeout

getPoolMaxTotal

getPoolMaxPerRoute

newClient

newGenericClient

setConnectionRequestTimeout

setConnectTimeout

setHttpClient

setProxy

setProxyCredentials

setServerValidationModeEnum

setServerValidationMode

setSocketTimeout

setPoolMaxTotal

setPoolMaxPerRoute