org.apache.camel.component.http4

Class HttpComponent

java.lang.Object

org.apache.camel.support.ServiceSupport

org.apache.camel.impl.DefaultComponent

org.apache.camel.impl.UriEndpointComponent

org.apache.camel.impl.HeaderFilterStrategyComponent

org.apache.camel.http.common.HttpCommonComponent

org.apache.camel.component.http4.HttpComponent

All Implemented Interfaces:

org.apache.camel.CamelContextAware, org.apache.camel.Component, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.spi.HeaderFilterStrategyAware, org.apache.camel.spi.RestProducerFactory, org.apache.camel.StatefulService, org.apache.camel.SuspendableService

public class HttpComponent
extends org.apache.camel.http.common.HttpCommonComponent
implements org.apache.camel.spi.RestProducerFactory

Defines the HTTP4 Component

Version:

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.http.conn.HttpClientConnectionManager	clientConnectionManager
protected int	connectionsPerRoute
protected long	connectionTimeToLive
protected org.apache.http.client.CookieStore	cookieStore
protected HttpClientConfigurer	httpClientConfigurer
protected org.apache.http.protocol.HttpContext	httpContext
protected int	maxTotalConnections
protected org.apache.camel.util.jsse.SSLContextParameters	sslContextParameters
protected org.apache.http.conn.ssl.X509HostnameVerifier	x509HostnameVerifier

Fields inherited from class org.apache.camel.http.common.HttpCommonComponent

allowJavaSerializedObject, httpBinding, httpConfiguration

Fields inherited from class org.apache.camel.support.ServiceSupport

shutdown, shuttingdown, started, starting, stopped, stopping, suspended, suspending

Constructor Summary

Constructors

Constructor and Description
HttpComponent()
HttpComponent(Class<? extends HttpEndpoint> endpointClass)

Method Summary

Modifier and Type	Method and Description
protected org.apache.http.conn.HttpClientConnectionManager	createConnectionManager(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry)
protected org.apache.http.conn.HttpClientConnectionManager	createConnectionManager(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry, int maxTotalConnections, int connectionsPerRoute)
protected org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory>	createConnectionRegistry(org.apache.http.conn.ssl.X509HostnameVerifier x509HostnameVerifier, org.apache.camel.util.jsse.SSLContextParameters sslContextParams)
protected org.apache.camel.Endpoint	createEndpoint(String uri, String remaining, Map<String,Object> parameters)
protected HttpClientConfigurer	createHttpClientConfigurer(Map<String,Object> parameters, boolean secure) Creates the HttpClientConfigurer based on the given parameters
org.apache.camel.Producer	createProducer(org.apache.camel.CamelContext camelContext, String host, String verb, String basePath, String uriTemplate, String queryParameters, String consumes, String produces, Map<String,Object> parameters)
void	doStart()
void	doStop()
org.apache.http.conn.HttpClientConnectionManager	getClientConnectionManager()
int	getConnectionsPerRoute()
long	getConnectionTimeToLive()
org.apache.http.client.CookieStore	getCookieStore()
HttpClientConfigurer	getHttpClientConfigurer()
org.apache.http.protocol.HttpContext	getHttpContext()
int	getMaxTotalConnections()
org.apache.camel.util.jsse.SSLContextParameters	getSslContextParameters()
org.apache.http.conn.ssl.X509HostnameVerifier	getX509HostnameVerifier()
void	setAllowJavaSerializedObject(boolean allowJavaSerializedObject) Whether to allow java serialization when a request uses context-type=application/x-java-serialized-object This is by default turned off.
void	setClientConnectionManager(org.apache.http.conn.HttpClientConnectionManager clientConnectionManager) To use a custom HttpClientConnectionManager to manage connections
void	setConnectionsPerRoute(int connectionsPerRoute) The maximum number of connections per route.
void	setConnectionTimeToLive(long connectionTimeToLive) The time for connection to live, the time unit is millisecond, the default value is always keep alive.
void	setCookieStore(org.apache.http.client.CookieStore cookieStore) To use a custom org.apache.http.client.CookieStore.
void	setHttpBinding(org.apache.camel.http.common.HttpBinding httpBinding) To use a custom HttpBinding to control the mapping between Camel message and HttpClient.
void	setHttpClientConfigurer(HttpClientConfigurer httpClientConfigurer) To use the custom HttpClientConfigurer to perform configuration of the HttpClient that will be used.
void	setHttpConfiguration(org.apache.camel.http.common.HttpConfiguration httpConfiguration) To use the shared HttpConfiguration as base configuration.
void	setHttpContext(org.apache.http.protocol.HttpContext httpContext) To use a custom org.apache.http.protocol.HttpContext when executing requests.
void	setMaxTotalConnections(int maxTotalConnections) The maximum number of connections.
void	setSslContextParameters(org.apache.camel.util.jsse.SSLContextParameters sslContextParameters) To configure security using SSLContextParameters.
void	setX509HostnameVerifier(org.apache.http.conn.ssl.X509HostnameVerifier x509HostnameVerifier) To use a custom X509HostnameVerifier such as org.apache.http.conn.ssl.StrictHostnameVerifier or org.apache.http.conn.ssl.AllowAllHostnameVerifier.
protected boolean	useIntrospectionOnEndpoint()

Methods inherited from class org.apache.camel.http.common.HttpCommonComponent

connect, disconnect, getHttpBinding, getHttpConfiguration, isAllowJavaSerializedObject

Methods inherited from class org.apache.camel.impl.HeaderFilterStrategyComponent

getHeaderFilterStrategy, setEndpointHeaderFilterStrategy, setHeaderFilterStrategy

Methods inherited from class org.apache.camel.impl.UriEndpointComponent

createComponentConfiguration, createParameterConfigurationMap, getEndpointClass, getParameterConfigurationMap, populateParameterConfigurationMap, setEndpointClass

Methods inherited from class org.apache.camel.impl.DefaultComponent

afterConfiguration, createConfiguration, createEndpoint, getAndRemoveOrResolveReferenceParameter, getAndRemoveOrResolveReferenceParameter, getAndRemoveParameter, getAndRemoveParameter, getCamelContext, ifStartsWithReturnRemainder, preProcessUri, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceParameter, resolveAndRemoveReferenceParameter, setCamelContext, setProperties, setProperties, useRawUri, validateParameters, validateURI

Methods inherited from class org.apache.camel.support.ServiceSupport

doResume, doShutdown, doSuspend, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

Methods inherited from class java.lang.Object

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

Field Detail

httpClientConfigurer

protected HttpClientConfigurer httpClientConfigurer

clientConnectionManager

protected org.apache.http.conn.HttpClientConnectionManager clientConnectionManager

httpContext

protected org.apache.http.protocol.HttpContext httpContext

sslContextParameters

protected org.apache.camel.util.jsse.SSLContextParameters sslContextParameters

x509HostnameVerifier

protected org.apache.http.conn.ssl.X509HostnameVerifier x509HostnameVerifier

cookieStore

protected org.apache.http.client.CookieStore cookieStore

maxTotalConnections

protected int maxTotalConnections

connectionsPerRoute

protected int connectionsPerRoute

connectionTimeToLive

protected long connectionTimeToLive

Constructor Detail

HttpComponent

public HttpComponent()

HttpComponent

public HttpComponent(Class<? extends HttpEndpoint> endpointClass)

Method Detail

createHttpClientConfigurer

protected HttpClientConfigurer createHttpClientConfigurer(Map<String,Object> parameters,
                                                          boolean secure)
                                                   throws Exception

Creates the HttpClientConfigurer based on the given parameters

Parameters:

parameters - the map of parameters

secure - whether the endpoint is secure (eg https4)

Returns:

the configurer

Throws:

Exception - is thrown if error creating configurer

createEndpoint

protected org.apache.camel.Endpoint createEndpoint(String uri,
                                                   String remaining,
                                                   Map<String,Object> parameters)
                                            throws Exception

Specified by:

createEndpoint in class org.apache.camel.impl.DefaultComponent

Throws:

Exception

createConnectionRegistry

protected org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> createConnectionRegistry(org.apache.http.conn.ssl.X509HostnameVerifier x509HostnameVerifier,
                                                                                                                        org.apache.camel.util.jsse.SSLContextParameters sslContextParams)
                                                                                                                 throws GeneralSecurityException,
                                                                                                                        IOException

Throws:

GeneralSecurityException

IOException

createConnectionManager

protected org.apache.http.conn.HttpClientConnectionManager createConnectionManager(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry)

createConnectionManager

protected org.apache.http.conn.HttpClientConnectionManager createConnectionManager(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry,
                                                                                   int maxTotalConnections,
                                                                                   int connectionsPerRoute)

useIntrospectionOnEndpoint

protected boolean useIntrospectionOnEndpoint()

Overrides:

useIntrospectionOnEndpoint in class org.apache.camel.http.common.HttpCommonComponent

createProducer

public org.apache.camel.Producer createProducer(org.apache.camel.CamelContext camelContext,
                                                String host,
                                                String verb,
                                                String basePath,
                                                String uriTemplate,
                                                String queryParameters,
                                                String consumes,
                                                String produces,
                                                Map<String,Object> parameters)
                                         throws Exception

Specified by:

createProducer in interface org.apache.camel.spi.RestProducerFactory

Throws:

Exception

getHttpClientConfigurer

public HttpClientConfigurer getHttpClientConfigurer()

setHttpClientConfigurer

public void setHttpClientConfigurer(HttpClientConfigurer httpClientConfigurer)

To use the custom HttpClientConfigurer to perform configuration of the HttpClient that will be used.

getClientConnectionManager

public org.apache.http.conn.HttpClientConnectionManager getClientConnectionManager()

setClientConnectionManager

public void setClientConnectionManager(org.apache.http.conn.HttpClientConnectionManager clientConnectionManager)

To use a custom HttpClientConnectionManager to manage connections

setHttpBinding

public void setHttpBinding(org.apache.camel.http.common.HttpBinding httpBinding)

To use a custom HttpBinding to control the mapping between Camel message and HttpClient.

Overrides:

setHttpBinding in class org.apache.camel.http.common.HttpCommonComponent

setHttpConfiguration

public void setHttpConfiguration(org.apache.camel.http.common.HttpConfiguration httpConfiguration)

To use the shared HttpConfiguration as base configuration.

Overrides:

setHttpConfiguration in class org.apache.camel.http.common.HttpCommonComponent

setAllowJavaSerializedObject

public void setAllowJavaSerializedObject(boolean allowJavaSerializedObject)

Whether to allow java serialization when a request uses context-type=application/x-java-serialized-object

This is by default turned off. If you enable this then be aware that Java will deserialize the incoming data from the request to Java and that can be a potential security risk.

Overrides:

setAllowJavaSerializedObject in class org.apache.camel.http.common.HttpCommonComponent

getHttpContext

public org.apache.http.protocol.HttpContext getHttpContext()

setHttpContext

public void setHttpContext(org.apache.http.protocol.HttpContext httpContext)

To use a custom org.apache.http.protocol.HttpContext when executing requests.

getSslContextParameters

public org.apache.camel.util.jsse.SSLContextParameters getSslContextParameters()

setSslContextParameters

public void setSslContextParameters(org.apache.camel.util.jsse.SSLContextParameters sslContextParameters)

To configure security using SSLContextParameters. Important: Only one instance of org.apache.camel.util.jsse.SSLContextParameters is supported per HttpComponent. If you need to use 2 or more different instances, you need to define a new HttpComponent per instance you need.

getX509HostnameVerifier

public org.apache.http.conn.ssl.X509HostnameVerifier getX509HostnameVerifier()

setX509HostnameVerifier

public void setX509HostnameVerifier(org.apache.http.conn.ssl.X509HostnameVerifier x509HostnameVerifier)

To use a custom X509HostnameVerifier such as org.apache.http.conn.ssl.StrictHostnameVerifier or org.apache.http.conn.ssl.AllowAllHostnameVerifier.

getMaxTotalConnections

public int getMaxTotalConnections()

setMaxTotalConnections

public void setMaxTotalConnections(int maxTotalConnections)

The maximum number of connections.

getConnectionsPerRoute

public int getConnectionsPerRoute()

setConnectionsPerRoute

public void setConnectionsPerRoute(int connectionsPerRoute)

The maximum number of connections per route.

getConnectionTimeToLive

public long getConnectionTimeToLive()

setConnectionTimeToLive

public void setConnectionTimeToLive(long connectionTimeToLive)

The time for connection to live, the time unit is millisecond, the default value is always keep alive.

getCookieStore

public org.apache.http.client.CookieStore getCookieStore()

setCookieStore

public void setCookieStore(org.apache.http.client.CookieStore cookieStore)

To use a custom org.apache.http.client.CookieStore. By default the org.apache.http.impl.client.BasicCookieStore is used which is an in-memory only cookie store. Notice if bridgeEndpoint=true then the cookie store is forced to be a noop cookie store as cookie shouldn't be stored as we are just bridging (eg acting as a proxy).

doStart

public void doStart()
             throws Exception

Overrides:

doStart in class org.apache.camel.impl.DefaultComponent

Throws:

Exception

doStop

public void doStop()
            throws Exception

Overrides:

doStop in class org.apache.camel.impl.DefaultComponent

Throws:

Exception