HttpConversationManager

java.lang.Object
- com.sap.smp.client.httpc.HttpConversationManager

```
public final class HttpConversationManager
extends java.lang.Object
```
Main entry point class of the library through which arbitrary HTTP-based conversations can be started. An instance of this type can be created for each endpoint that has to be driven using the same configuration. Optionally, one such instance can be made VM-wide by setting it as default using setDefault(HttpConversationManager).

Basic idea
An HTTP conversation is considered to be a single HTTP request/response which might be interrupted by a series of additional requests to prepare the original one. A typical example would be an OAuth2-based scenario where a request to a given resource must be preceded by a series of authorization requests before the original one can be sent. Ultimately, a conversation is essentially a single HTTP (or HTTPS) request/response exchange during which additional communication might happen to allow the original one to complete.

The flow
The general conversation flow, after having created a new IHttpConversation object using create(URL), is as follows:
1. Request filters get executed which take care of pre-sending actions, such as authentication, authorization, preliminary request header and parameter processing, etc.. These filters have the power to cancel the request in case they decide that can't be fulfilled given the current circumstances. The filters might actually execute a whole bunch of additional HTTP request/response cycles to prepare the original request (typical in case authentication is required beforehand).
2. The request can be finalized by the IRequestListener supplied to the IHttpConversation object. This produces the final set of request headers and the request body.
3. Response filters get executed which take care of post-processing of the response before handing it to the response listener supplied to the IHttpConversation object. These filters have the power to cancel the processing and to actually restart the entire flow in case it's required.
4. The response is processed using the IResponseListener supplied to the IHttpConversation object.
The above flow is submitted as a single continuous processing unit to the executor defined by setExecutor(Executor).

Configuration
To configure a manager, use the fluent API established by the various setters. A series of configurations are obtained by the manager via the IConnectionConfigurationListener interface. The implementations are to be provided by the client of this library. These get executed just before the actual HTTP/HTTPS connection is built.

For simplicity, instances of IManagerConfigurator might be used to configure a conversation manager to a typical, high-level use case. Instances of the configurer are usually supplied by additional libraries which are intended to support special use cases (for example: SAML2, OAuth2, etc..).

The configuration of the manager is considered closed the first time the create(URL) method is invoked. After that all configuration methods throw IllegalStateException.

Contexts
During the execution, all filters and listeners have access to two important context objects (instances of IContext) using which state information can be preserved and exchanged:
- Manager context
  The scope of this context is bounded by the lifetime of a single conversation manager instance. The main purpose is to allow for the storage and retrieval of parameters which might be required by subsequent requests. These parameters typically include audit-, tracing- and authentication/authorization-related information.
- Conversation context
  The scope of this context is limited to a single IHttpConversation. This allows filters and listeners to communicate with each other within the boundaries of a single request/response exchange.
Both contexts have a name which are taken from getName() and IHttpConversation.getName(), respectively. These names need not be unique and serves nothing else just identification purposes. Clients of this library can name managers and conversations to be able to categorize certain network interactions in an easy way. For example, an application can give similar names to conversations executed from a particular screen to easily identify them when reading the responses. This can make it easier to find out where on the User Interface the results need to be shown.

Cookie handling
The library uses SAPCookieManager for cookie handling. That means the library sets it as default cookie handler. Clients should pay attention to this in case a custom cookie handler is used via the same mechanism. If there is already a default CookieHandler set the library will copy every cookie from it to SAPCookieManager. This is done when a new instance is created. In order to turn off this behaviour, invoke the SAPCookieManager.setForceOverride(boolean) method with a false argument. Refer to the documentation of SAPCookieManager for the details.

X.509 & SSL/TLS support
Support for SSL/TLS is achieved through the setSSLSocketFactoryListener, the addTrustManager and the addKeyManager methods. The latter ones can be used to add independent trust and key managers which will then be exchanged for an SSLSocketFactory via the configured ISSLSocketFactoryListener. The main purpose of this pattern is that specifying trust and key managers is independent from the process of making a factory out of these. The default SSL socket factory listener initializes a single SSLContext using the 'SSL' protocol.

Redirect handling

The redirects occuring during an HTTP conversation are handled manually. This means that the following of redirects is turned off on the underlying HttpURLConnection using HttpURLConnection.setInstanceFollowRedirects(boolean). Furthermore, this manager is capable of consulting a whitelist whether the given redirect should be allowed or not. In case a non-null instance of RedirectWhitelist is set using setRedirectWhitelist(RedirectWhitelist) and the redirect URL is found to be invalid then the conversation fails with an InvalidRedirectUrlException (which is a subclass of IOException). To detect this, look for this type of exception in the ICommunicationErrorListener.onCommunicationError(IOException) method.
By default, no redirect whitelist is set which means that the conversation manager allows all redirects unconditionally.

Thread management and thread safety
This class itself is not thread-safe as it should be initialized before performing any conversations. However, creating a new conversation using create(URL) can be safely done by multiple threads. The actual conversations are executed using the configured executor set via setExecutor(Executor) which is the one that actually decides where and how to execute the entire conversation flow.

Observers
The conversation manager supports the definition of observers via the addObserver method. Subinterfaces of IObserver defined within the com.sap.smp.client.httpc.observers package have built-in support in the conversation manager. Further, user-defined observers can also be added but they must be invoked by corresponding request and response filters/listeners. For this purpose, the collection of registered observers can be queried using the IBaseEvent.getObserversByType(Class) method, making the collection available for all filters and listeners via their event parameters.

Copying of a manager
A conversation manager basically acts like a pre-configured connection factory that can create new conversations instrumented using the various filters and listeners. One might need to create a new manager based on an existing one and copy all it's configuration. The copy() method can be used for this purpose.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class HttpConversationManager.Setting
Enumeration of the possible settings of a HttpConversationManager.

Nested Classes
Modifier and Type	Class and Description
`static class`	`HttpConversationManager.Setting` Enumeration of the possible settings of a `HttpConversationManager`.

Field Summary

Fields
Modifier and Type Field and Description

static int DEFAULT_MAX_RESTARTS
The default number of allowed flow restarts.

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_MAX_RESTARTS` The default number of allowed flow restarts.

Constructor Summary

Constructors
Constructor and Description

HttpConversationManager(android.content.Context context)
Creates a new conversation manager.

Constructors
Constructor and Description
`HttpConversationManager(android.content.Context context)` Creates a new conversation manager.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`HttpConversationManager`	`addFilter(IRequestFilter filter)` Appends the specified request filter to the end of the chain.
`HttpConversationManager`	`addFilter(IResponseFilter filter)` Appends the specified response filter to the end of the chain.
`HttpConversationManager`	`addFilterIfMissing(IRequestFilter filter)` Convenience method to add a request filter only if it has not been added yet, as of it's descriptor.
`HttpConversationManager`	`addFilterIfMissing(IResponseFilter filter)` Convenience method to add a response filter only if it has not been added yet, as of it's descriptor.
`HttpConversationManager`	`addKeyManager(javax.net.ssl.X509KeyManager keyManager)` Adds a new key manager to be used during SSL handshake.
`HttpConversationManager`	`addObserver(IObserver observer)` Adds a new observer to this manager which will be active only for conversations that are started after this method is called.
`HttpConversationManager`	`addTrustManager(javax.net.ssl.X509TrustManager trustManager)` Adds a new trust manager to be used during SSL handshake.
`void`	`closeSettings(HttpConversationManager.Setting... settings)` Closes the specified settings.
`HttpConversationManager`	`configuredBy(IManagerConfigurator configurator)` Marks this manager using the specified configurator object.
`HttpConversationManager`	`copy()` Creates a copy of this manager.
`IHttpConversation`	`create(android.net.Uri uri)` Convenience overload of `create(URL)` that uses the `Uri` class instead.
`IHttpConversation`	`create(java.net.URL url)` Creates a new HTTP conversation using the configuration set in this manager.
`static HttpConversationManager`	`getDefault()` Returns the default conversation manager.
`ITextBasedResponseDetector`	`getDefaultTextBasedResponseDetector()` Returns the configured text-based response detector.
`static ITextBasedResponseDetector`	`getInitialDetector()` Returns the initial detector to be set for a conversation manager in case one wishes to reset the default.
`java.lang.String`	`getName()` Returns the name of this manager.
`RedirectWhitelist`	`getRedirectWhitelist()` Returns the configured redirect whitelist.
`java.util.List<IRequestFilter>`	`getRequestFilterChain()` Returns a list of `IRequestFilter`.
`java.util.List<IResponseFilter>`	`getResponseFilterChain()` Returns a list of `IResponseFilter`.
`ISSLSocketFactoryListener`	`getSSLSocketFactoryListener()` Returns the socket factory listener currently in use.
`boolean`	`hasRequestFilter(java.lang.Object descriptor)` Tests whether this manager has a request filter added which has a descriptor that `equals` to the specified one.
`boolean`	`hasResponseFilter(java.lang.Object descriptor)` Tests whether this manager has a response filter added which has a descriptor that `equals` to the specified one.
`boolean`	`isConfiguredBy(IManagerConfigurator configurator)` Checks whether this manager has been marked by the specified configurator, as of the `Object.equals(Object)` method.
`static void`	`setDefault(HttpConversationManager manager)` Sets the default conversation manager.
`HttpConversationManager`	`setDefaultFlowListener(IConversationFlowListener listener)` Sets the default flow listener newly created `IHttpConversation` will use.
`HttpConversationManager`	`setDefaultMaximumRestarts(int maximumRestarts)` Sets the default value for the maximum number of flow restarts allowed.
`HttpConversationManager`	`setDefaultTextBasedResponseDetector(ITextBasedResponseDetector detector)` Sets the default detector that can be used to detect text-based responses to allow response filters and response listeners to read the response using a `Reader` instead of just an `InputStream`.
`HttpConversationManager`	`setExecutor(java.util.concurrent.Executor executor)` Sets the executor to use when executing the flow.
`HttpConversationManager`	`setHostnameVerifierListener(IConnectionConfigurationListener<javax.net.ssl.HostnameVerifier> listener)` Sets the hostname verifier listener.
`HttpConversationManager`	`setName(java.lang.String name)` Sets the name of this manager.
`HttpConversationManager`	`setProxyProviderListener(IConnectionConfigurationListener<java.net.Proxy> listener)` Sets the proxy provider listener.
`HttpConversationManager`	`setRedirectWhitelist(RedirectWhitelist redirectWhitelist)` Sets the redirect whitelist.
`HttpConversationManager`	`setSSLSocketFactoryListener(ISSLSocketFactoryListener listener)` Sets the SSL socket factory listener.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_MAX_RESTARTS
```
public static final int DEFAULT_MAX_RESTARTS
```
    The default number of allowed flow restarts.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - HttpConversationManager
```
public HttpConversationManager(android.content.Context context)
```
    Creates a new conversation manager. The specified context is used only to access the application context.
    
    Parameters:
    
    context - a context object, must be non-null
- Method Detail
  - getDefault
```
public static HttpConversationManager getDefault()
```
    Returns the default conversation manager.
    
    Returns:
    
    the default manager or null if it's unset
  - setDefault
```
public static void setDefault(HttpConversationManager manager)
```
    Sets the default conversation manager.
    
    Parameters:
    
    manager - the manager, can be null
  - getInitialDetector
```
public static ITextBasedResponseDetector getInitialDetector()
```
    Returns the initial detector to be set for a conversation manager in case one wishes to reset the default. This detector is capable of recognizing the 'application/xml' and 'application/json' content types. The encoding is determined using the 'encoding' attribute in case of XML and it defaults to UTF-8 in case of JSON.
    
    Returns:
    
    the initial detector, always non-null
  - getName
```
public java.lang.String getName()
```
    Returns the name of this manager.
    
    Returns:
    
    the name, may be null
  - setName
```
public HttpConversationManager setName(java.lang.String name)
```
    Sets the name of this manager. The name is exposed to pluggable components such as request/response listeners and filters using IContext objects accessible from IBaseEvents.
    
    Parameters:
    
    name - the name, can be null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed
  - setDefaultMaximumRestarts
```
public HttpConversationManager setDefaultMaximumRestarts(int maximumRestarts)
```
    Sets the default value for the maximum number of flow restarts allowed. By default, this value is set to DEFAULT_MAX_RESTARTS. For further details, see the IHttpConversation.setMaximumRestarts(int) method. Newly created conversations will use this value by default.
    
    Parameters:
    
    maximumRestarts - the maximum number of restarts
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed
  - getRedirectWhitelist
```
public RedirectWhitelist getRedirectWhitelist()
```
    Returns the configured redirect whitelist. This is null by default. Callers can use this to decorate an already configured whitelist implementation with a new one and set it back.
    
    Returns:
    
    the redirect whitelist, may be null
  - setRedirectWhitelist
```
public HttpConversationManager setRedirectWhitelist(RedirectWhitelist redirectWhitelist)
```
    Sets the redirect whitelist.
    
    Parameters:
    
    redirectWhitelist - the redirect whitelist, can be null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed
  - setExecutor
```
public HttpConversationManager setExecutor(java.util.concurrent.Executor executor)
```
    Sets the executor to use when executing the flow. By default, this class uses an executor that creates a new thread for each flow and then closes it after completion. Setting the executor to null resets this default.
    Note that care must be taken when setting a synchronous executor as this way the flow might be executed on the UI thread. Considering that request/response filters might perform UI interaction this can lead to a deadlock! It's strongly advised that any custom executor set offloads all processing to worker threads (obtained from a thread pool, for example). However, if the manager itself is guaranteed to be used from background threads then utilizing a synchronous executor is the way to go. In this case the SynchronousExecutor utility singleton can be used.
    
    Parameters:
    
    executor - the executor, can be null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed or in case the HttpConversationManager.Setting.EXECUTOR setting has been closed using closeSettings()
  - addFilter
```
public HttpConversationManager addFilter(IRequestFilter filter)
```
    Appends the specified request filter to the end of the chain.
    
    Parameters:
    
    filter - the filter, must be non-null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed
  - addFilterIfMissing
```
public HttpConversationManager addFilterIfMissing(IRequestFilter filter)
```
    Convenience method to add a request filter only if it has not been added yet, as of it's descriptor. This is essentially the same as:
```
 if (!hasRequestFilter(filter.getDescriptor()))
        addFilter(filter);
 
```
    Parameters:
    
    filter - the filter, must be non-null
    
    Returns:
    
    this, for method chaining
  - hasRequestFilter
```
public boolean hasRequestFilter(java.lang.Object descriptor)
```
    Tests whether this manager has a request filter added which has a descriptor that equals to the specified one.
    
    Parameters:
    
    descriptor - the descriptor, must be non-null
    
    Returns:
    
    true if a request filter having an equivalent descriptor has already been added to this manager, false otherwise
  - addFilter
```
public HttpConversationManager addFilter(IResponseFilter filter)
```
    Appends the specified response filter to the end of the chain.
    
    Parameters:
    
    filter - the filter, must be non-null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed
  - addFilterIfMissing
```
public HttpConversationManager addFilterIfMissing(IResponseFilter filter)
```
    Convenience method to add a response filter only if it has not been added yet, as of it's descriptor. This is essentially the same as:
```
 if (!hasResponseFilter(filter.getDescriptor()))
        addFilter(filter);
 
```
    Parameters:
    
    filter - the filter, must be non-null
    
    Returns:
    
    this, for method chaining
  - hasResponseFilter
```
public boolean hasResponseFilter(java.lang.Object descriptor)
```
    Tests whether this manager has a response filter added which has a descriptor that equals to the specified one.
    
    Parameters:
    
    descriptor - the descriptor, must be non-null
    
    Returns:
    
    true if a response filter having an equivalent descriptor has already been added to this manager, false otherwise
  - setDefaultFlowListener
```
public HttpConversationManager setDefaultFlowListener(IConversationFlowListener listener)
```
    Sets the default flow listener newly created IHttpConversation will use.
    
    Parameters:
    
    listener - the listener, can be null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed
  - setHostnameVerifierListener
```
public HttpConversationManager setHostnameVerifierListener(IConnectionConfigurationListener<javax.net.ssl.HostnameVerifier> listener)
```
    Sets the hostname verifier listener. The specified listener will get invoked only in case the started conversation targets a HTTPS URL. Not setting any listener or returning null from the specified listener causes the default verifier to be used, which accepts all hosts.
    
    Parameters:
    
    listener - the listener, can be null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed or in case the HttpConversationManager.Setting.HOSTNAME_VERIFIER setting has been closed using closeSettings()
  - getSSLSocketFactoryListener
```
public ISSLSocketFactoryListener getSSLSocketFactoryListener()
```
    Returns the socket factory listener currently in use. Callers usually decorate the returned listener with their own implementation and set the decorator back to the manager using the setter.
    
    Returns:
    
    the listener currently in use, always non-null
  - setSSLSocketFactoryListener
```
public HttpConversationManager setSSLSocketFactoryListener(ISSLSocketFactoryListener listener)
```
    Sets the SSL socket factory listener. The specified listener will get invoked only in case the started conversation targets a HTTPS URL. Not setting any listener or returning null from the specified listener causes the default one to be used.
    Note that the default listener is actually an instance of DefaultSSLSocketFactoryListener.
    
    Application-specific trust and key managers can be added using the addTrustManager(X509TrustManager) and addKeyManager(X509KeyManager) APIs.
    
    Parameters:
    
    listener - the listener, can be null (which resets the default)
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed or in case the HttpConversationManager.Setting.SSL_SOCKET_FACTORY setting has been closed using closeSettings()
  - addTrustManager
```
public HttpConversationManager addTrustManager(javax.net.ssl.X509TrustManager trustManager)
```
    Adds a new trust manager to be used during SSL handshake.
    
    Parameters:
    
    trustManager - a trust manager, must be non-null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed or in case the HttpConversationManager.Setting.TRUST_MANAGER setting has been closed using closeSettings()
  - addKeyManager
```
public HttpConversationManager addKeyManager(javax.net.ssl.X509KeyManager keyManager)
```
    Adds a new key manager to be used during SSL handshake.
    
    Parameters:
    
    keyManager - a key manager, must be non-null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the create(URL) method has been called beforehand and the configuration of this manager is closed or in case the HttpConversationManager.Setting.KEY_MANAGER setting has been closed using closeSettings()
  - setProxyProviderListener
```
public HttpConversationManager setProxyProviderListener(IConnectionConfigurationListener<java.net.Proxy> listener)
```
    Sets the proxy provider listener. The specified listener will get invoked only in case the started conversation targets a HTTPS URL. Not setting any listener or returning null from the specified listener causes the default proxy to e used, in which case the connection goes directly to the URL.
    
    Parameters:
    
    listener - the listener, can be null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the (@link create(URL) method has been called beforehand and the configuration of this manager is closed or in case the HttpConversationManager.Setting.PROXY_PROVIDER setting has been closed using closeSettings()
  - getDefaultTextBasedResponseDetector
```
public ITextBasedResponseDetector getDefaultTextBasedResponseDetector()
```
    Returns the configured text-based response detector. The return value can be used for creating a new detector which adds extra detection capabilities on top of the default one via decoration.
    
    Returns:
    
    the detector, may be null
  - setDefaultTextBasedResponseDetector
```
public HttpConversationManager setDefaultTextBasedResponseDetector(ITextBasedResponseDetector detector)
```
    Sets the default detector that can be used to detect text-based responses to allow response filters and response listeners to read the response using a Reader instead of just an InputStream. The value set using this method is going to be inherited by IHttpConversation objects created using this manager.
    Initially, the detector set for this conversation manager is the one obtained using getInitialDetector().
    
    Parameters:
    
    detector - the detector to set, can be null
    
    Returns:
    
    this, for method chaining
    
    Throws:
    
    java.lang.IllegalStateException - in case the (@link create(URL) method has been called beforehand and the configuration of this manager is closed or in case the HttpConversationManager.Setting.RESPONSE_DETECTOR setting has been closed using closeSettings()
  - addObserver
```
public HttpConversationManager addObserver(IObserver observer)
```
    Adds a new observer to this manager which will be active only for conversations that are started after this method is called. As such, this method is thread-safe.
    
    Parameters:
    
    observer - the observer, must be non-null
    
    Returns:
    
    this, for method chaining
  - configuredBy
```
public HttpConversationManager configuredBy(IManagerConfigurator configurator)
```
    Marks this manager using the specified configurator object. This method is useful for IManagerConfigurator implementations whose configure method is not idempotent. Such configurators usually invoke isConfiguredBy(IManagerConfigurator) on the manager to check whether configuration is to be done or not.
    Internally, this class stores weak references to configurators (thereby representing a mark).
    
    Parameters:
    
    configurator - the configurator to mark this manager with, must be non-null
    
    Returns:
    
    this, for method chaining
  - isConfiguredBy
```
public boolean isConfiguredBy(IManagerConfigurator configurator)
```
    Checks whether this manager has been marked by the specified configurator, as of the Object.equals(Object) method.
    
    Parameters:
    
    configurator - the configurator, must be non-null
    
    Returns:
    
    true if the specified (or an equivalent) configurator has already marked this manager, false otherwise
  - create
```
public IHttpConversation create(java.net.URL url)
```
    Creates a new HTTP conversation using the configuration set in this manager. The specified URL must point to either an HTTP or an HTTPS endpoint.
    There's no need to include request parameters in the URL as it can be done afterwards using the IHttpConversation.addParameter(String, String) method.
    
    Parameters:
    
    url - the endpoint URL, must be non-null
    
    Returns:
    
    the created conversation, always non-null
    
    Throws:
    
    java.lang.IllegalArgumentException - in case the URL scheme is not supported
  - create
```
public IHttpConversation create(android.net.Uri uri)
```
    Convenience overload of create(URL) that uses the Uri class instead.
    
    Parameters:
    
    uri - the endpoint URL, represented as a Uri, must be non-null
    
    Returns:
    
    the created conversation, always non-null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the URL is malformed or the scheme is unsupported
  - copy
```
public HttpConversationManager copy()
```
    Creates a copy of this manager. This copies the following settings:
    - Request filters
    - Response filters
    - Default flow listener
    - Hostname verifier, SSL socket factory and proxy provider listeners
    - Trust and key managers
    - Observers
    - Default text-based response detector
    - Default maximmum restart count
    The name of the manager, the executor and the manager context is not copied. The rest of the fields are shallow copied. Only the internal collections storing them are reallocated.
    The main purpose of this method is to allow for the creation of a new manager based on the settings of an existing one, thereby replicating it's configuration in another one. The returned manager is configurable as it was not yet used to create conversations.
    Returns:
    
    the copied manager, must be non-null
  - getRequestFilterChain
```
public java.util.List<IRequestFilter> getRequestFilterChain()
```
    Returns a list of IRequestFilter. The returned list of filters are modifiable by the caller.
    
    Returns:
    
    list of filter, can be null
  - getResponseFilterChain
```
public java.util.List<IResponseFilter> getResponseFilterChain()
```
    Returns a list of IResponseFilter. The returned list of filters are modifiable by the caller.
    
    Returns:
    
    list of filter, can be null
  - closeSettings
```
public void closeSettings(HttpConversationManager.Setting... settings)
```
    Closes the specified settings. In case the corresponding setters are invoked after a call to this method then an exception is going to be thrown.
    Closing an already closed setting has no effect.
    
    The main purpose of this method is to support IManagerConfigurator implementations to close of certain settings from external modifications. A good example is a configurator which adds a custom SSL socket factory listener that's collaborating with a series of filters added by the same configurator. Allowing one to set a new SSL socket factory listener would break the functionality. By closing off a series of settings it becomes possible to detect conflicting configurations and an improperly configured conversation manager.
    
    Parameters:
    
    settings - the array of settings, can be null

Class HttpConversationManager

Basic idea

The flow

Configuration

Contexts

Cookie handling

X.509 & SSL/TLS support

Redirect handling

Thread management and thread safety

Observers

Copying of a manager

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_MAX_RESTARTS

Constructor Detail

HttpConversationManager

Method Detail

getDefault

setDefault

getInitialDetector

getName

setName

setDefaultMaximumRestarts

getRedirectWhitelist

setRedirectWhitelist

setExecutor

addFilter

addFilterIfMissing

hasRequestFilter

addFilter

addFilterIfMissing

hasResponseFilter

setDefaultFlowListener

setHostnameVerifierListener

getSSLSocketFactoryListener

setSSLSocketFactoryListener

addTrustManager

addKeyManager

setProxyProviderListener

getDefaultTextBasedResponseDetector

setDefaultTextBasedResponseDetector

addObserver

configuredBy

isConfiguredBy

create

create

copy

getRequestFilterChain

getResponseFilterChain

closeSettings