Element Summary

ElementDescriptionClass
basicAuthCredentialsThis class contains parameters needed to send basic authentication credentialsorg.apache.servicemix.http.BasicAuthCredentials
componentan HTTP JBI component. The component is responsible for hosting HTTP endpoints.org.apache.servicemix.http.HttpComponent
configurationconfiguration for the Jetty instance used by an HTTP endpointorg.apache.servicemix.http.HttpConfiguration
consumerPlain HTTP consumer endpoint. This endpoint can be used to handle plain HTTP request (without SOAP) or to be able to process the request in a non standard way. For HTTP requests, a WSDL2 HTTP binding can be used.org.apache.servicemix.http.endpoints.HttpConsumerEndpoint
endpointthe base element for all HTTP endpointsorg.apache.servicemix.http.HttpEndpoint
providerA plain HTTP provider. This type of endpoint can be used to send non-SOAP requests to HTTP endpoints.org.apache.servicemix.http.endpoints.HttpProviderEndpoint
proxyParametersparameters needed to send HTTP requests through a proxyorg.apache.servicemix.http.ProxyParameters
serializedMarshalera consumer-side marshaler for handling Java serialized contentorg.apache.servicemix.http.endpoints.SerializedMarshaler
soap-consumeran HTTP consumer endpoint that is optimized to work with SOAP messagesorg.apache.servicemix.http.endpoints.HttpSoapConsumerEndpoint
soap-provideran HTTP provider endpoint that is optimaized to work with SOAP messages.org.apache.servicemix.http.endpoints.HttpSoapProviderEndpoint
sslParametersThis class contains all parameters needed to create an SSL server or client socket.org.apache.servicemix.http.SslParameters

Element Detail

Element: basicAuthCredentials

AttributeTypeDescription
domainxs:stringthe domain to use for NTLM authentication
hostxs:stringthe host to use for NTLM authentication
passwordxs:stringthe password to use for authentication
usernamexs:stringthe username to use for authentication

Element: component

AttributeTypeDescription
hostxs:stringthe host name
pathxs:string
portxs:integerthe port number. The default is 80.
protocolxs:stringthe protocol being used. Valid values are http: and https:
ElementTypeDescription
authenticationService<spring:bean/>the authentication service object used by a component
client<spring:bean/>the Apache Commons HTTP client used by a component
configurationconfigurationthe HTTP configuration information used to establish HTTP connections
connectionPool<spring:bean/>a Jetty HTTP client instance maintaining a thread pool for client-side connections
endpoints(consumer | endpoint | provider | soap-consumer | soap-provider)*the endpoints hosted by a component
executorFactory<spring:bean/>The executor factory to use to create the executor. If none is provided, one will be retrieved from the JBI container when the component is deployed into ServiceMix 3.x, or a default implementation will be used.
keystoreManager<spring:bean/>the keystore manager object used by a component
server<spring:bean/>

Element: configuration

AttributeTypeDescription
authenticationServiceNamexs:stringthe JNDI name of the authentication service object. The default is java:comp/env/smx/AuthenticationService.
connectorMaxIdleTimexs:integerthe number of miliseconds a connection will be idle before timing out. The default is 30000.
consumerProcessorSuspendTimexs:integerthe number of miliseconds Jetty will susspend the processing of a request. The default is 60000.
jettyClientPerProviderxs:booleanSpecifies if HTTP provider endpoints share a Jetty client or use per-endpoint Jetty clients. The default setting is
jettyClientThreadPoolSizexs:integerthe maximum number of threads in the client-side threadpool. The default setting is 16.
jettyConnectorClassNamexs:stringthe classname of the Jetty connector used by the endpoint
jettyManagementxs:boolean
jettyThreadPoolSizexs:integerthe maximum number of threads in the server-side threadpool. The default setting is 255.
keystoreManagerNamexs:stringthe JNDI name of the keystore manager object. The default is java:comp/env/smx/KeystoreManager.
managedxs:boolean
mappingxs:string
maxConnectionsPerHostxs:integerthe maximum number of concurent connections allowed from a host. The default is 65536.
maxTotalConnectionsxs:integerthe maximum number of total concurent connections allowed to an endpoint. The default is 65536.
preemptiveAuthenticationxs:booleanSpecifies of the httpclient uses preemptive authentication which can save performance. The default is false
providerExpirationTimexs:integerthe number of miliseconds Jetty will susspend the processing of a request. The default is 60000.
proxyHostxs:stringthe default proxy host name used to send requests. This can be overridden by each endpoint.
proxyPortxs:integerthe default proxy port used to send requests. This can be overridden by each endpoint.
retryCountxs:integerthe number of times a request will be attempted without succees before an error is created. The default is 3. If streaming is enabled, the value will always be 0.
soLingerTimexs:integerthe connector soLingerTime in milliseconds. The default is -1.
streamingEnabledxs:booleanSpecifies if client-side requests use HTTP streaming.
useHostPortForAuthScopexs:booleanIf true the AuthScope of the httpclient is bind to a special host and port from the url. The default is false
wantHeadersFromHttpIntoExchangexs:booleanSpecifies if the HTTP provider will copy the HTTP request headers into the JBI exchange. The default is
ElementTypeDescription
authenticationService<spring:bean/>the authentication service object. This property takes precedence over
keystoreManager<spring:bean/>the keystore object. This property takes precedence over

Element: consumer

AttributeTypeDescription
authMethodxs:stringa string naming the scheme used for authenticating users
defaultMepxs:stringa URI representing the endpoint's default MEP. The default is JbiConstants.IN_OUT.
endpointxs:string

Get the endpoint implementation.

interfaceNamexs:QName

Get the qualified name of the endpoint interface.

lateResponseStrategyxs:stringSet the strategy to be used for handling a late response from the ESB (i.e. a response that arrives after the HTTP request has timed out). Defaults to error
  • error will terminate the exchange with an ERROR status and log an exception for the late response
  • warning will end the exchange with a DONE status and log a warning for the late response instead
locationURIxs:stringthe URI at which the endpoint listens for requests
servicexs:QName

Get the service qualified name of the endpoint.

targetEndpointxs:stringthe name of the endpoint to which requests are sent
targetInterfacexs:QNamethe QName of the interface to which requests are sent
targetOperationxs:QNamethe QName of the operation to which requests are sent
targetServicexs:QNamethe QName of the service to which requests are sent
targetUrixs:string

Gets the target URI of the consumer endpoint.

timeoutxs:longthe timeout is specified in milliseconds. The default value is 0 which means that the endpoint will never timeout.
ElementTypeDescription
componentcomponent
marshalerserializedMarshalerthe bean used to marshal HTTP messages. The default is a DefaultHttpConsumerMarshaler.
serviceUnit<spring:bean/>
sslsslParametersa bean containing the SSL configuration properties

Element: endpoint

AttributeTypeDescription
authMethodxs:stringa string naming the scheme used for authenticating users
defaultMepxs:string
defaultOperationxs:QName
dynamicxs:boolean
endpointxs:string

Get the endpoint implementation.

interfaceNamexs:QName

Get the qualified name of the endpoint interface.

locationURIxs:stringthe URI to which a provider endpoint sends requests
responseContentTypeCheckxs:booleanSpecifies if the http provider checks the response content type for the
rolexs:stringHTTP endpoints can be either consumers or providers. Specifying
roleAsStringxs:string
servicexs:QName

Get the service qualified name of the endpoint.

soapxs:boolean
soapActionxs:string
soapVersionxs:string
synchronousxs:boolean
targetEndpointxs:string
targetInterfaceNamexs:QName
targetServicexs:QName
timeoutxs:integerthe number of milliseconds before the endpoint times out. The default value is 0 which means that the endpoint will never timeout.
wantContentTypeHeaderFromExchangeIntoHttpRequestxs:booleanSpecifies if the HTTP provider will copy the HTTP request headers into the JBI
ElementTypeDescription
basicAuthenticationbasicAuthCredentialsauthentication data for using basic HTTP authentication.
binding<spring:bean/>
description<spring:bean/>
policies(<spring:bean/>)*
proxyproxyParametersconfiguration used to establish a proxy for sending HTTP requests. This configuration overrides that which is set at the component level.
sslsslParametersa bean containing the SSL configuration properties
wsdlResource<spring:bean/>

Element: provider

AttributeTypeDescription
clientSoTimeoutxs:integerthe number of milliseconds the endpoint will block while attempting to read a request. The default value is 60000. Setting this to 0 specifies that the endpoint will never timeout.
credentialsxs:stringThe authentication credentials
endpointxs:string

Get the endpoint implementation.

expectGzippedResponsexs:booleanIf true, the accept-encoding http header will be set to gzip and the response will be un-gzipped.
gzipRequestxs:booleanIf true, the request content will be gzipped and sent over the wire. The content-encoding http header will also be set to gzip.
interfaceNamexs:QName

Get the qualified name of the endpoint interface.

locationURIxs:stringthe URI to which the endpoint sends requests
principalxs:stringThe authentication principal
providerExpirationTimexs:integerthe number of milliseconds to wait for a response before expiring.
proxyHostxs:stringthe host name of the HTTP proxy
proxyPasswordxs:stringthe password for the HTTP proxy authentication
proxyPortxs:integerthe host port of the HTTP proxy (defaults to 80)
proxyUsernamexs:stringthe user name for the HTTP proxy authentication
servicexs:QName

Get the service qualified name of the endpoint.

ElementTypeDescription
componentcomponent
marshaler<spring:bean/>the bean used to marshal HTTP messages. The default is a
serviceUnit<spring:bean/>
sslsslParametersthe SSL parameters

Element: proxyParameters

AttributeTypeDescription
proxyHostxs:stringthe proxy's host name
proxyPortxs:integerthe proxy's port number
ElementTypeDescription
proxyCredentialsbasicAuthCredentialsauthentication data for using basic HTTP authentication.

Element: serializedMarshaler

AttributeTypeDescription
defaultMepxs:string

Element: soap-consumer

AttributeTypeDescription
authMethodxs:stringa string naming the scheme used for authenticating users
defaultMepxs:stringa URI representing the endpoint's default MEP. The default is JbiConstants.IN_OUT.
endpointxs:string

Get the endpoint implementation.

interfaceNamexs:QName

Get the qualified name of the endpoint interface.

lateResponseStrategyxs:stringSet the strategy to be used for handling a late response from the ESB (i.e. a response that arrives after the HTTP request has timed out). Defaults to error
  • error will terminate the exchange with an ERROR status and log an exception for the late response
  • warning will end the exchange with a DONE status and log a warning for the late response instead
locationURIxs:stringthe URI at which the endpoint listens for requests
servicexs:QName

Get the service qualified name of the endpoint.

soapVersionxs:stringSpecifies the SOAP version to use when generating a wsdl binding for
targetEndpointxs:stringthe name of the endpoint to which requests are sent
targetInterfacexs:QNamethe QName of the interface to which requests are sent
targetOperationxs:QNamethe QName of the operation to which requests are sent
targetServicexs:QNamethe QName of the service to which requests are sent
targetUrixs:string

Gets the target URI of the consumer endpoint.

timeoutxs:longthe timeout is specified in milliseconds. The default value is 0 which means that the endpoint will never timeout.
useJbiWrapperxs:booleanSpecifies if the JBI wrapper is sent in the body of the message. Default is
validateWsdlxs:booleanSpecifies if the WSDL is checked for WSI-BP compliance. Default is true.
ElementTypeDescription
componentcomponent
marshalerserializedMarshalerthe bean used to marshal HTTP messages. The default is a DefaultHttpConsumerMarshaler.
policies(<spring:bean/>)*a list of interceptors that will process messages
serviceUnit<spring:bean/>
sslsslParametersa bean containing the SSL configuration properties
wsdl<spring:bean/>the URL of the WSDL document defining the endpoint's messages

Element: soap-provider

AttributeTypeDescription
clientSoTimeoutxs:integerthe number of milliseconds the endpoint will block while attempting to read a request. The default value is 60000. Setting this to 0 specifies that the endpoint will never timeout.
credentialsxs:stringThe authentication credentials
endpointxs:string

Get the endpoint implementation.

expectGzippedResponsexs:booleanIf true, the accept-encoding http header will be set to gzip and the response will be un-gzipped.
gzipRequestxs:booleanIf true, the request content will be gzipped and sent over the wire. The content-encoding http header will also be set to gzip.
interfaceNamexs:QName

Get the qualified name of the endpoint interface.

locationURIxs:stringthe URI to which the endpoint sends requests
principalxs:stringThe authentication principal
providerExpirationTimexs:integerthe number of milliseconds to wait for a response before expiring.
proxyHostxs:stringthe host name of the HTTP proxy
proxyPasswordxs:stringthe password for the HTTP proxy authentication
proxyPortxs:integerthe host port of the HTTP proxy (defaults to 80)
proxyUsernamexs:stringthe user name for the HTTP proxy authentication
servicexs:QName

Get the service qualified name of the endpoint.

useJbiWrapperxs:booleanSpecifies if the JBI wrapper is sent in the body of the message. Default is
validateWsdlxs:booleanSpecifies if the WSDL is checked for WSI-BP compliance. Default is true
ElementTypeDescription
componentcomponent
marshaler<spring:bean/>the bean used to marshal HTTP messages. The default is a
policies(<spring:bean/>)*a list of interceptors that will process messages
serviceUnit<spring:bean/>
sslsslParametersthe SSL parameters
wsdl<spring:bean/>the URL of the WSDL document defining the endpoint's messages

Element: sslParameters

AttributeTypeDescription
keyAliasxs:string
keyManagerFactoryAlgorithmxs:string
keyPasswordxs:string
keyStorexs:string
keyStorePasswordxs:string
keyStoreTypexs:string
managedxs:boolean
needClientAuthxs:boolean
protocolxs:string
providerxs:string
trustManagerFactoryAlgorithmxs:string
trustStorexs:string
trustStorePasswordxs:string
trustStoreTypexs:string
wantClientAuthxs:boolean