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.
clientSoTimeoutxs:integerthe number of miliseconds representign shared JettyClient soTimeout. The default is 10000.
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
maxConnectionsPerAddressxs:integerthe number of the maximum connections per address that JettyClient creates for each destination. The default is 32.
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 the provider will wait for a response (read timeout). The default is 300000.
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
rewriteSoapAddressxs:booleanToggles the rewriting of the soap address based on the request info.

When active, the soap address in the wsdl will be updated according to the protocol, host and port of the request. This is useful when listening on 0.0.0.0 or when behind a NAT (or reverse-proxy in some cases).
This function only works on the main wsdl, not in imported wsdl-parts. This means the service with its port must be declared in the main wsdl.

By default it is activated.

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
maxConnectionsPerAddressxs:integerthe number of the maximum connections per address that JettyClient creates for each destination. The default is 32.
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
rewriteSoapAddressxs:booleanToggles the rewriting of the soap address based on the request info.

When active, the soap address in the wsdl will be updated according to the protocol, host and port of the request. This is useful when listening on 0.0.0.0 or when behind a NAT (or reverse-proxy in some cases).
This function only works on the main wsdl, not in imported wsdl-parts. This means the service with its port must be declared in the main wsdl.

By default it is activated.

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
maxConnectionsPerAddressxs:integerthe number of the maximum connections per address that JettyClient creates for each destination. The default is 32.
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