This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

  Apache ServiceMix NMR #usernavbar() #printableicon() #pdficon() #feedicon()  
When you contribute content to this Wiki, you grant a license to the ASF for inclusion in ASF works (as per the Apache Software License).
  3. Deploying JBI components without the JBI packaging

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Wiki Markup


3. Deploying JBI components without the JBI packaging

In ServiceMix Kernel, run the following commands:

Code Block
features/addUrl mvn:org.apache.servicemix.nmr/apache-servicemix-nmr/1.0.0/xml/features
features/install jbi
osgi/install -s mvn:org.apache.servicemix.bundles/org.apache.servicemix.bundles.wsdl4j/1.6.1_1
osgi/install -s mvn:org.apache.xbean/xbean-spring/3.5
osgi/install -s mvn:org.apache.servicemix/servicemix-utils/1.1.0
osgi/install -s mvn:org.apache.servicemix/servicemix-common/2009.01
osgi/install -s mvn:org.apache.servicemix/servicemix-eip/2009.01

Then, create the following file:

Code Block
<beans xmlns=""

  <bean class="org.apache.servicemix.common.osgi.EndpointExporter" />

  <eip:wire-tap id="eip-endpoint" service="test:wireTap" endpoint="endpoint">
      <eip:exchange-target service="test:listener" />
      <eip:exchange-target service="test:target" />


3.1 Under the hood

How does it work under the hood ?

For each endpoint defined in the application context, the EndpointExporter will create and register in the OSGi registry an object implementing org.apache.servicemix.common.osgi.EndpointWrapper. Those objects are tracked by each individual ServiceMix JBI component. When a given component knows how to handle a given endpoint, it will internally create a service unit, deploy it, and inform the endpoint wrapper that it has been successfully deployed. The EndpointExporter waits for all endpoint to be deployed and once this is done, will register a org.apache.servicemix.jbi.deployer.DeployedAssembly object representing a JBI Service Assembly composed of all the deployed service units. Those DeployedAssembly objects are tracked by the NMR JBI layer which can then handle those as standard JBI service assemblies.

At this point, the service units have been deployed, but not initialized and started, so that no JBI / NMR endpoint has been created yet. This will be done when the Service Assembly is actually initialized and started.

This quite complicated flow is necessary to be able to handle the JBI lifecycle of the Service Assembly in a nice way (starting, stopping, shutting down), because all service units lifecycle have to be managed through a service assembly in an atomic way.


Wiki Markup