JBI Support deprecated in Apache ServiceMix 4

JBI 1.0 support is available in Apache ServiceMix 4 to allow existing users to migrate more easily to this latest version - if you're a new user, you should consider JBI deprecated and not use it for your project. Take a look at our technology selection guidelines for more information.

servicemix-cxf-bc

Overview

A JBI compliant HTTP/SOAP or JMS/SOAP binding component named servicemix-cxf-bc which use apache cxf internally.

The main features are:

  • JBI compliant Binding Component

  • Usable in a lightweight mode in servicemix.xml configuration files

  • SOAP 1.1 and 1.2 support

  • MIME attachments

  • Support for all MEPs as consumers or providers

  • SSL support

  • WS-Security support

  • WS-Policy support

  • WS-RM support

  • WS-Addressing support

Namespace and xbean.xml

The namespace URI for the servicemix-bean JBI component is http://servicemix.apache.org/cxfbc/1.0. This is an example of an xbean.xml file with a namespace definition with prefix bean.

<beans xmlns:cxfbc="http://servicemix.apache.org/cxfbc/1.0">

  <!-- add cxfbc:consumer or cxfbc:provider definitions here -->

</beans>

Endpoint types

The servicemix-cxf-bc component defines two endpoints:

  • cxfbc:consumer :: a server-side cxf endpoint that will consume plain HTTP+SOAP requests and send them into the NMR to a given JBI endpoint

  • cxfbc:provider :: a client-side jbi endpoint which can receive requests from the NMR and send them to a given url where the service is provided

cxfbc:consumer

Endpoint properties

Property Name Type Description
busCfg java.lang.String the location of the CXF configuration file used to configure the CXF bus. This allows you to configure features like WS-RM and JMS runtime behavior.
delegateToJaas boolean Specifies if the endpoint delegate to JAASAuthenticationService to do the authentication.
endpoint java.lang.String The name of the endpoint.
features (java.lang.Object)\* Specifies the cxf features set for this endpoint
inFaultInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process incoming faults
inInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process incoming responses
interfaceName javax.xml.namespace.QName The qualified name of the interface exposed by the endpoint.
locationURI java.lang.String the HTTP address to which requests are sent. This value will overide any value specified in the WSDL.
mtomEnabled boolean Specifies if MTOM / attachment support is enabled. Default is <code>false</code>.
outFaultInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process fault messages being returned to the consumer
outInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process requests
properties java.util.Map Sets arbitrary properties that are added to the CXF context at the Endpoint level
providedBus org.apache.cxf.Bus a preconfigured CXF Bus object to use; overrides busCfg
schemaValidationEnabled boolean Specifies if the endpoint use schemavalidation for the incoming/outgoing message.
service javax.xml.namespace.QName The qualified name of the service the endpoint exposes.
synchronous boolean Specifies if the endpoint expects send messageExchange by sendSync .
targetEndpoint java.lang.String the name of the endpoint to which requests are sent
targetInterface javax.xml.namespace.QName the QName of the interface to which requests are sent
targetOperation javax.xml.namespace.QName the QName of the operation to which requests are sent
targetService javax.xml.namespace.QName the QName of the service to which requests are sent
targetUri java.lang.String Set the target service/endpoint/interface using a URI.
timeout long the number of second the endpoint will wait for a response. The default is unlimited.
useJBIWrapper boolean Specifies if the JBI wrapper is sent in the body of the message. Default is <code>true</code>.
useSOAPEnvelope boolean Specifies if the endpoint expects soap messages when useJBIWrapper is false,
wsdl org.springframework.core.io.Resource the location of the WSDL document defining the endpoint's interface
x509 boolean Specifies if the endpoint use X.509 Certificate to do the authentication.

cxfbc:provider

Endpoint properties

Property Name Type Description
busCfg java.lang.String the location of the CXF configuration file used to configure the CXF bus. This allows you to configure features like WS-RM and JMS runtime behavior.
endpoint java.lang.String The name of the endpoint.
features (java.lang.Object)\* Specifies the cxf features set for this endpoint
inFaultInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process incoming faults
inInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process incoming requests
interfaceName javax.xml.namespace.QName The qualified name of the interface exposed by the endpoint.
locationURI java.net.URI the HTTP address of the exposed service. This value will overide any value specified in the WSDL.
mtomEnabled boolean Specifies if MTOM / attachment support is enabled. Default is <code>false</code>.
outFaultInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process fault messages being returned to the consumer
outInterceptors (java.lang.Object)\* a list of beans configuring interceptors that process responses
properties java.util.Map Sets arbitrary properties that are added to the CXF context at the Endpoint level
providedBus org.apache.cxf.Bus a preconfigured CXF Bus object to use; overrides busCfg
schemaValidationEnabled boolean Specifies if the endpoint use schemavalidation for the incoming/outgoing message.
service javax.xml.namespace.QName The qualified name of the service the endpoint exposes.
synchronous boolean Specifies if the endpoints send message synchronously to external server using underlying
useJBIWrapper boolean Specifies if the JBI wrapper is sent in the body of the message. Default is <code>true</code>.
useSOAPEnvelope boolean Specifies if the endpoint expects soap messages when useJBIWrapper is false,
wsdl org.springframework.core.io.Resource the location of the WSDL document defining the endpoint's interface

Examples

Configuring the CXF JMS Transport

The ServiceMix CXF binding component also allows using the CXF JMS Transport to send and receive messages. You can use the <cxf:features/> element to add and configure the org.apache.cxf.transport.jms.JMSConfigFeature on the endpoint, as in the example below.

<cxfbc:provider wsdl="org/apache/servicemix/cxfbc/ws/security/hello_world.wsdl"
              service="greeter:HelloWorldService"
              endpoint="HelloWorldPortProxy"
              interfaceName="greeter:Greeter"
              busCfg="jms_conduit_config.xml">

  <!-- add interceptors here -->

  <cxfbc:features>
     <bean class="org.apache.cxf.transport.jms.JMSConfigFeature">
        <property name="jmsConfig">
            <bean class="org.apache.cxf.transport.jms.JMSConfiguration">
                <property name="concurrentConsumers">
                    <value>5</value>
                </property>
                <property name="connectionFactory">
                    <ref bean="myConnectionFactory" /> 
                </property>
                <property name="targetDestination">
                    <value>test.jmstransport.text.provider</value>
                </property>
                <property name="useJms11">
                    <value>false</value>
                </property>
            </bean>
         </property>
     </bean>
  </cxfbc:features>

</cxfbc:provider>

<amq:connectionFactory id="myConnectionFactory" brokerURL="vm://localhost"/>

The jms_conduit_config.xml file specified in the busCfg parameter, is optional and can be used to specify additional JMS transport parameters:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:jms="http://cxf.apache.org/transports/jms"
       xsi:schemaLocation="
       http://cxf.apache.org/transports/jms http://cxf.apache.org/schemas/configuration/jms.xsd
       http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <jms:conduit name="{http://apache.org/hello_world_soap_http}HelloWorldPort.jms-conduit" abstract="true"> 
        <jms:clientConfig clientReceiveTimeout="200000"/>
    </jms:conduit>

</beans>

Configuring the CXF HTTP Transport

In order to configure the underlying HTTP transport used by a CXF BC endpoint, you can specify an additional busCfg file as in the example below. 

<cxfbc:provider wsdl="org/apache/servicemix/cxfbc/ws/security/hello_world.wsdl"
              service="greeter:HelloWorldService"
              endpoint="HelloWorldPortProxy"
              interfaceName="greeter:Greeter"
              busCfg="http_conduit_config.xml">

  <!-- add interceptors and additional CXF features here -->

</cxfbc:provider>

The http_conduit_config.xml file can then specify the additional CXF configuration. Have a look at this page for an overview of all the options supported by CXF.

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:http-conf="http://cxf.apache.org/transports/http/configuration"
       xsi:schemaLocation="http://cxf.apache.org/transports/http/configuration
                           http://cxf.apache.org/schemas/configuration/http-conf.xsd
                           http://www.springframework.org/schema/beans
                           http://www.springframework.org/schema/beans/spring-beans.xsd">

  <http-conf:conduit name="{http://apache.org/hello_world_soap_http}HelloWorldPort.http-conduit">
    <http-conf:client Connection="Keep-Alive"
                      MaxRetransmits="1"
                      AllowChunking="false" />
  </http-conf:conduit>
</beans>