Package org.apache.camel.component.http

Class HttpComponent

java.lang.Object
org.apache.camel.support.service.BaseService
org.apache.camel.support.service.ServiceSupport
org.apache.camel.support.DefaultComponent
org.apache.camel.support.HeaderFilterStrategyComponent
org.apache.camel.http.common.HttpCommonComponent
org.apache.camel.component.http.HttpComponent
All Implemented Interfaces:
AutoCloseable, org.apache.camel.CamelContextAware, org.apache.camel.Component, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.spi.HasCamelContext, org.apache.camel.spi.HeaderFilterStrategyAware, org.apache.camel.spi.RestProducerFactory, org.apache.camel.SSLContextParametersAware, org.apache.camel.StatefulService, org.apache.camel.SuspendableService
@Metadata(label="verifiers", enums="parameters,connectivity") @Component("http,https") public class HttpComponent extends org.apache.camel.http.common.HttpCommonComponent implements org.apache.camel.spi.RestProducerFactory, org.apache.camel.SSLContextParametersAware
Defines the HTTP Component

  • Field Details

    • httpClientConfigurer

      @Metadata(label="advanced", description="To use the custom HttpClientConfigurer to perform configuration of the HttpClient that will be used.") protected HttpClientConfigurer httpClientConfigurer

    • clientConnectionManager

      @Metadata(label="advanced", description="To use a custom and shared HttpClientConnectionManager to manage connections. If this has been configured then this is always used for all endpoints created by this component.") protected org.apache.hc.client5.http.io.HttpClientConnectionManager clientConnectionManager

    • httpContext

      @Metadata(label="advanced", description="To use a custom org.apache.hc.core5.http.protocol.HttpContext when executing requests.") protected org.apache.hc.core5.http.protocol.HttpContext httpContext

    • sslContextParameters

      @Metadata(label="security", description="To configure security using SSLContextParameters. Important: Only one instance of org.apache.camel.support.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.") protected org.apache.camel.support.jsse.SSLContextParameters sslContextParameters

    • x509HostnameVerifier

      @Metadata(label="security", description="To use a custom X509HostnameVerifier such as DefaultHostnameVerifier or NoopHostnameVerifier.") protected HostnameVerifier x509HostnameVerifier

    • cookieStore

      @Metadata(label="producer,advanced", description="To use a custom org.apache.hc.client5.http.cookie.CookieStore. By default the org.apache.hc.client5.http.cookie.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).") protected org.apache.hc.client5.http.cookie.CookieStore cookieStore

    • connectionRequestTimeout

      @Metadata(label="timeout", defaultValue="180000", description="Returns the connection lease request timeout (in millis) used when requesting a connection from the connection manager. A timeout value of zero is interpreted as a disabled timeout.") protected long connectionRequestTimeout

    • connectTimeout

      @Metadata(label="timeout", defaultValue="180000", description="Determines the timeout (in millis) until a new connection is fully established. A timeout value of zero is interpreted as an infinite timeout.") protected long connectTimeout

    • soTimeout

      @Metadata(label="timeout", defaultValue="180000", description="Determines the default socket timeout (in millis) value for blocking I/O operations.") protected long soTimeout

    • responseTimeout

      @Metadata(label="timeout", description="Determines the timeout (in millis) until arrival of a response from the opposite endpoint. A timeout value of zero is interpreted as an infinite timeout. Please note that response timeout may be unsupported by HTTP transports with message multiplexing.") protected long responseTimeout

    • proxyHost

      @Metadata(label="producer,proxy", description="Proxy server host") protected String proxyHost

    • proxyPort

      @Metadata(label="producer,proxy", description="Proxy server port") protected Integer proxyPort

    • proxyAuthScheme

      @Metadata(label="producer,proxy", enums="http,https", description="Proxy server authentication protocol scheme to use") protected String proxyAuthScheme

    • proxyAuthMethod

      @Metadata(label="producer,proxy", enums="Basic,Digest,NTLM", description="Proxy authentication method to use (NTLM is deprecated)") protected String proxyAuthMethod

    • proxyAuthUsername

      @Metadata(label="producer,proxy", secret=true, description="Proxy server username") protected String proxyAuthUsername

    • proxyAuthPassword

      @Metadata(label="producer,proxy", secret=true, description="Proxy server password") protected String proxyAuthPassword

    • proxyAuthHost

      @Deprecated @Metadata(label="producer,proxy", description="Proxy server host") protected String proxyAuthHost
      Deprecated.

    • proxyAuthPort

      @Deprecated @Metadata(label="producer,proxy", description="Proxy server port") protected Integer proxyAuthPort
      Deprecated.

    • proxyAuthDomain

      @Deprecated @Metadata(label="producer,proxy", description="Proxy authentication domain to use with NTLM") protected String proxyAuthDomain
      Deprecated.

    • proxyAuthNtHost

      @Deprecated @Metadata(label="producer,proxy", description="Proxy authentication domain (workstation name) to use with NTLM (NTLM is deprecated)") protected String proxyAuthNtHost
      Deprecated.

    • maxTotalConnections

      @Metadata(label="advanced", defaultValue="200", description="The maximum number of connections.") protected int maxTotalConnections

    • connectionsPerRoute

      @Metadata(label="advanced", defaultValue="20", description="The maximum number of connections per route.") protected int connectionsPerRoute

    • connectionTimeToLive

      @Metadata(label="advanced", description="The time for connection to live, the time unit is millisecond, the default value is always keepAlive.") protected long connectionTimeToLive

    • useGlobalSslContextParameters

      @Metadata(label="security", defaultValue="false", description="Enable usage of global SSL context parameters.") protected boolean useGlobalSslContextParameters

    • responsePayloadStreamingThreshold

      @Metadata(label="producer,advanced", defaultValue="8192", description="This threshold in bytes controls whether the response payload should be stored in memory as a byte array or be streaming based. Set this to -1 to always use streaming mode.") protected int responsePayloadStreamingThreshold

    • redirectHandlingDisabled

      @Metadata(label="advanced", description="Disables automatic redirect handling") protected boolean redirectHandlingDisabled

    • automaticRetriesDisabled

      @Metadata(label="advanced", description="Disables automatic request recovery and re-execution") protected boolean automaticRetriesDisabled

    • contentCompressionDisabled

      @Metadata(label="advanced", description="Disables automatic content decompression") protected boolean contentCompressionDisabled

    • cookieManagementDisabled

      @Metadata(label="advanced", description="Disables state (cookie) management") protected boolean cookieManagementDisabled

    • authCachingDisabled

      @Metadata(label="advanced", description="Disables authentication scheme caching") protected boolean authCachingDisabled

    • connectionStateDisabled

      @Metadata(label="advanced", description="Disables connection state tracking") protected boolean connectionStateDisabled

    • defaultUserAgentDisabled

      @Metadata(label="advanced", description="Disables the default user agent set by this builder if none has been provided by the user") protected boolean defaultUserAgentDisabled

    • skipRequestHeaders

      @Metadata(label="producer", description="Whether to skip mapping all the Camel headers as HTTP request headers. This is useful when you know that calling the HTTP service should not include any custom headers.") protected boolean skipRequestHeaders

    • skipResponseHeaders

      @Metadata(label="producer", description="Whether to skip mapping all the HTTP response headers to Camel headers.") protected boolean skipResponseHeaders

    • copyHeaders

      @Metadata(label="producer,advanced", defaultValue="true", description="If this option is true then IN exchange headers will be copied to OUT exchange headers according to copy strategy. Setting this to false, allows to only include the headers from the HTTP response (not propagating IN headers).") protected boolean copyHeaders

    • followRedirects

      @Metadata(label="producer,advanced", defaultValue="false", description="Whether to the HTTP request should follow redirects. By default the HTTP request does not follow redirects ") protected boolean followRedirects

    • userAgent

      @Metadata(label="producer,advanced", description="To set a custom HTTP User-Agent request header") protected String userAgent

    • httpActivityListener

      @Metadata(label="producer,advanced", autowired=true, description="To use a custom activity listener") protected HttpActivityListener httpActivityListener

    • logHttpActivity

      @Metadata(label="producer", description="To enable logging HTTP request and response. You can use a custom LoggingHttpActivityListener as httpActivityListener to control logging options.") protected boolean logHttpActivity

    • contentTypeCharsetEnabled

      @Metadata(label="producer,advanced", defaultValue="true", description="Whether the Content-Type header should automatic include charset for string based content.") protected boolean contentTypeCharsetEnabled

  • Constructor Details

    • HttpComponent

      public HttpComponent()

  • Method Details

    • 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 (e.g., https)
      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.support.DefaultComponent
      Throws:
      Exception

    • createConnectionManager

      protected org.apache.hc.client5.http.io.HttpClientConnectionManager createConnectionManager(Map<String,Object> parameters, org.apache.camel.support.jsse.SSLContextParameters sslContextParameters, Map<String,Object> httpConnectionOptions) throws GeneralSecurityException, IOException
      Throws:
      GeneralSecurityException
      IOException

    • createHttpClientBuilder

      protected org.apache.hc.client5.http.impl.classic.HttpClientBuilder createHttpClientBuilder(String uri, Map<String,Object> parameters, Map<String,Object> httpClientOptions)

    • createConnectionRegistry

      protected org.apache.hc.core5.http.config.Registry<org.apache.hc.client5.http.socket.ConnectionSocketFactory> createConnectionRegistry(HostnameVerifier x509HostnameVerifier, org.apache.camel.support.jsse.SSLContextParameters sslContextParams, boolean useSystemProperties) throws GeneralSecurityException, IOException
      Throws:
      GeneralSecurityException
      IOException

    • createConnectionManager

      protected org.apache.hc.client5.http.io.HttpClientConnectionManager createConnectionManager(org.apache.hc.core5.http.config.Registry<org.apache.hc.client5.http.socket.ConnectionSocketFactory> registry, int maxTotalConnections, int connectionsPerRoute, org.apache.hc.core5.http.io.SocketConfig defaultSocketConfig)

    • 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, org.apache.camel.spi.RestConfiguration configuration, 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.hc.client5.http.io.HttpClientConnectionManager getClientConnectionManager()

    • setClientConnectionManager

      public void setClientConnectionManager(org.apache.hc.client5.http.io.HttpClientConnectionManager clientConnectionManager)
      To use a custom and shared HttpClientConnectionManager to manage connections. If this has been configured, then this is always used for all endpoints created by this component.

    • getHttpContext

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

    • setHttpContext

      public void setHttpContext(org.apache.hc.core5.http.protocol.HttpContext httpContext)
      To use a custom org.apache.http.protocol.HttpContext when executing requests.

    • getSslContextParameters

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

    • setSslContextParameters

      public void setSslContextParameters(org.apache.camel.support.jsse.SSLContextParameters sslContextParameters)
      To configure security using SSLContextParameters. Important: Only one instance of org.apache.camel.support.jsse.SSLContextParameters is supported per HttpComponent. If you need to use two or more different instances, you need to define a new HttpComponent per instance.

    • isUseGlobalSslContextParameters

      public boolean isUseGlobalSslContextParameters()
      Specified by:
      isUseGlobalSslContextParameters in interface org.apache.camel.SSLContextParametersAware

    • setUseGlobalSslContextParameters

      public void setUseGlobalSslContextParameters(boolean useGlobalSslContextParameters)
      Enable usage of global SSL context parameters.
      Specified by:
      setUseGlobalSslContextParameters in interface org.apache.camel.SSLContextParametersAware

    • getX509HostnameVerifier

      public HostnameVerifier getX509HostnameVerifier()

    • setX509HostnameVerifier

      public void setX509HostnameVerifier(HostnameVerifier x509HostnameVerifier)
      To use a custom X509HostnameVerifier such as DefaultHostnameVerifier or NoopHostnameVerifier.

    • isUseSystemProperties

      public boolean isUseSystemProperties()

    • setUseSystemProperties

      public void setUseSystemProperties(boolean useSystemProperties)

    • 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 keepAlive.

    • getCookieStore

      public org.apache.hc.client5.http.cookie.CookieStore getCookieStore()

    • setCookieStore

      public void setCookieStore(org.apache.hc.client5.http.cookie.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 (e.g., acting as a proxy).

    • getConnectionRequestTimeout

      public long getConnectionRequestTimeout()

    • setConnectionRequestTimeout

      public void setConnectionRequestTimeout(long connectionRequestTimeout)
      Returns the connection lease request timeout used when requesting a connection from the connection manager.

      A timeout value of zero is interpreted as a disabled timeout.

      Default: 3 minutes

    • getConnectTimeout

      public long getConnectTimeout()

    • setConnectTimeout

      public void setConnectTimeout(long connectTimeout)
      Determines the timeout until a new connection is fully established. This may also include transport security negotiation exchanges such as SSL or TLS protocol negotiation.

      A timeout value of zero is interpreted as an infinite timeout.

      Default: 3 minutes

    • getSoTimeout

      public long getSoTimeout()

    • setSoTimeout

      public void setSoTimeout(long soTimeout)
      Determines the default socket timeout value for blocking I/O operations.

      Default: 3 minutes

    • getResponseTimeout

      public long getResponseTimeout()

    • setResponseTimeout

      public void setResponseTimeout(long responseTimeout)
      Determines the timeout until arrival of a response from the opposite endpoint.

      A timeout value of zero is interpreted as an infinite timeout.

      Please note that response timeout may be unsupported by HTTP transports with message multiplexing.

      Default: 0

    • getProxyHost

      public String getProxyHost()

    • setProxyHost

      public void setProxyHost(String proxyHost)

    • getProxyPort

      public Integer getProxyPort()

    • setProxyPort

      public void setProxyPort(Integer proxyPort)

    • getProxyAuthScheme

      public String getProxyAuthScheme()

    • setProxyAuthScheme

      public void setProxyAuthScheme(String proxyAuthScheme)

    • getProxyAuthMethod

      public String getProxyAuthMethod()

    • setProxyAuthMethod

      public void setProxyAuthMethod(String proxyAuthMethod)

    • getProxyAuthUsername

      public String getProxyAuthUsername()

    • setProxyAuthUsername

      public void setProxyAuthUsername(String proxyAuthUsername)

    • getProxyAuthPassword

      public String getProxyAuthPassword()

    • setProxyAuthPassword

      public void setProxyAuthPassword(String proxyAuthPassword)

    • getProxyAuthHost

      @Deprecated public String getProxyAuthHost()
      Deprecated.

    • setProxyAuthHost

      @Deprecated public void setProxyAuthHost(String proxyAuthHost)
      Deprecated.

    • getProxyAuthPort

      @Deprecated public Integer getProxyAuthPort()
      Deprecated.

    • setProxyAuthPort

      @Deprecated public void setProxyAuthPort(Integer proxyAuthPort)
      Deprecated.

    • getProxyAuthDomain

      public String getProxyAuthDomain()

    • setProxyAuthDomain

      public void setProxyAuthDomain(String proxyAuthDomain)

    • getProxyAuthNtHost

      public String getProxyAuthNtHost()

    • setProxyAuthNtHost

      public void setProxyAuthNtHost(String proxyAuthNtHost)

    • getResponsePayloadStreamingThreshold

      public int getResponsePayloadStreamingThreshold()

    • setResponsePayloadStreamingThreshold

      public void setResponsePayloadStreamingThreshold(int responsePayloadStreamingThreshold)

    • isRedirectHandlingDisabled

      public boolean isRedirectHandlingDisabled()

    • setRedirectHandlingDisabled

      public void setRedirectHandlingDisabled(boolean redirectHandlingDisabled)

    • isAutomaticRetriesDisabled

      public boolean isAutomaticRetriesDisabled()

    • setAutomaticRetriesDisabled

      public void setAutomaticRetriesDisabled(boolean automaticRetriesDisabled)

    • isContentCompressionDisabled

      public boolean isContentCompressionDisabled()

    • setContentCompressionDisabled

      public void setContentCompressionDisabled(boolean contentCompressionDisabled)

    • isCookieManagementDisabled

      public boolean isCookieManagementDisabled()

    • setCookieManagementDisabled

      public void setCookieManagementDisabled(boolean cookieManagementDisabled)

    • isAuthCachingDisabled

      public boolean isAuthCachingDisabled()

    • setAuthCachingDisabled

      public void setAuthCachingDisabled(boolean authCachingDisabled)

    • isConnectionStateDisabled

      public boolean isConnectionStateDisabled()

    • setConnectionStateDisabled

      public void setConnectionStateDisabled(boolean connectionStateDisabled)

    • isDefaultUserAgentDisabled

      public boolean isDefaultUserAgentDisabled()

    • setDefaultUserAgentDisabled

      public void setDefaultUserAgentDisabled(boolean defaultUserAgentDisabled)

    • isCopyHeaders

      public boolean isCopyHeaders()

    • setCopyHeaders

      public void setCopyHeaders(boolean copyHeaders)

    • isSkipControlHeaders

      public boolean isSkipControlHeaders()

    • setSkipControlHeaders

      public void setSkipControlHeaders(boolean skipControlHeaders)

    • isSkipRequestHeaders

      public boolean isSkipRequestHeaders()

    • setSkipRequestHeaders

      public void setSkipRequestHeaders(boolean skipRequestHeaders)

    • isSkipResponseHeaders

      public boolean isSkipResponseHeaders()

    • setSkipResponseHeaders

      public void setSkipResponseHeaders(boolean skipResponseHeaders)

    • isFollowRedirects

      public boolean isFollowRedirects()

    • setFollowRedirects

      public void setFollowRedirects(boolean followRedirects)

    • getUserAgent

      public String getUserAgent()

    • setUserAgent

      public void setUserAgent(String userAgent)

    • getHttpActivityListener

      public HttpActivityListener getHttpActivityListener()

    • setHttpActivityListener

      public void setHttpActivityListener(HttpActivityListener httpActivityListener)

    • isLogHttpActivity

      public boolean isLogHttpActivity()

    • setLogHttpActivity

      public void setLogHttpActivity(boolean logHttpActivity)

    • isContentTypeCharsetEnabled

      public boolean isContentTypeCharsetEnabled()

    • setContentTypeCharsetEnabled

      public void setContentTypeCharsetEnabled(boolean contentTypeCharsetEnabled)

    • doStart

      public void doStart() throws Exception
      Overrides:
      doStart in class org.apache.camel.support.service.BaseService
      Throws:
      Exception

    • doStop

      public void doStop() throws Exception
      Overrides:
      doStop in class org.apache.camel.support.service.BaseService
      Throws:
      Exception