Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. First create the service unit. The service unit is a ZIP file that will contain your application's Java class files and the servicemix.xml configuration file. For example:
    1. Wiki Markup
      Use a ZIP compression tool, such as Winzip or gzip to create a zip file containing the classes in \[servicemix_dir\]\examples\loan-broker\build\loanbroker\components and the {{servicemix.xml}} file which can be found in {{\[servicemix_dir\]\src\su}}. The zip file name is arbitrary, but it is used in the Service Assembly's {{jbi.xml}} file, so to match the example call it {{loanbroker-su.zip}}.
      \\
    2. Wiki Markup
      Put the {{loanbroker-su.zip}} file in the {{\[servicemix_dir\]\examples\loan-broker\build}} directory for later use. Note: you may store the zip file anywhere.
      \\
      \\
      The above two steps can be done automatically using the ant script: "ant build-su". If you look in the {{build.xml}} file you will see the {{build-su}} target does exactly what we just did manually.
      \\
  2. Create the Service Assembly. A service assembly is a zip file containing one or more service units and a jbi.xml file. The jbi.xml file must be in the META-INF directory. you may also include other files in the META-INF directory. The ZIP file directory structure for our example looks like this:
    Code Block
    loanbroker-su.zip
    META-INF\
         jbi.xml
         LICENSE.txt
         DISCLAIMER.txt
    


    The jbi.xml looks like this:
    Code Block
    <?xml version="1.0" encoding="UTF-8"?>
    <jbi xmlns="http://java.sun.com/xml/ns/jbi" version="1.0">
         
       <service-assembly>
         <identification>
           <name>loanbroker</name>
           <description>LoanBroker Service Assembly</description>
         </identification>
         <service-unit>
           <identification>
             <name>loanbroker</name>
             <description>LoanBroker Service Unit</description>
           </identification>
           <target>
             <artifacts-zip>loanbroker-su.zip</artifacts-zip>
             <component-name>servicemix-lwcontainer</component-name>
           </target>
         </service-unit>
        </service-assembly>
        
    </jbi>
    


    The interesting thing to note is that the jbi.xml file tells the JBI container what service units are in the service assembly and where to deploy them. There is only one service unit in our example, which is "loanbroker" (see the artifacts-name tag) and the component to which it will be deployed is servicemix-lwcontainer (see the <component-name> tag). There could be multiple service units in a service assembly and they would each be included in the jbi.xml file with the same type of information for each.
    Create the service assembly ZIP file and include the loanbroker-su.zip file and the META-INF\jbi.xml directory and file in it. To remain consistent with our example, call the zip file loanbroker-sa.zip.
    1. Wiki Markup
      Put the {{loanbroker-sa.zip}} file in the {{\[servicemix_dir\]\examples\loan-broker\build}} directory for later use. Note: you may store the zip file anywhere.

--------------------------------------------------------------------------------------

  1. Two jar files must be created. These jar files will be copied into the ServiceMix deploy directory. The first jar file will contain the service component jbi.xml file. When this is copied to the deploy directory it deploys the ServiceMixComponent component. The second jar file will contain the service assembly and the jbi.xml descriptor file. When it is copied to the deploy directory of ServiceMix it deploys the service unit (Quartz) to the previously deployed component, ServiceMixComponent.
    1. The file service component jbi.xml file should contain:
      Code Block
      
      <jbi xmlns="http://java.sun.com/xml/ns/jbi" 
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xsi:schemaLocation="http://java.sun.com/xml/ns/jbi" 
           version="1.0">
      
        <component type="service-engine">
          <identification>
            <name>servicemix-component</name>
            <description>A ServiceMix Component that can be used to deploy servicemix.xml artifacts.</description>
          </identification>
          <component-class-name>org.servicemix.components.servicemix.ServiceMixComponent</component-class-name>
          <component-class-path/>
        </component>
      
      </jbi>
      
    2. Put jbi.xml in an empty META-INF directory and put that into a jar file:
      Code Block
      
      mkdir META-INF
      copy jbi.xml META-INF
      jar cvf service-component.jar *
      
    3. Create a zip file of the servicemix.xml file you modified above. The zip file should contain the servicemix.xml file and it should be called su1.zip to match the name it is called in the jbi.xml file. See the artifacts-name tag in the jbi.xml file for the name of the zip file.
    4. Create the second jar file--this is the service assembly jar file. It will contain another jbi.xml file that is used for the service assembly and it will also contain the zip file, su1.zip in the following structure:
      The service assembly jbi.xml should be match the following:
      Code Block
      
      <jbi xmlns="http://java.sun.com/xml/ns/jbi" 
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xsi:schemaLocation="http://java.sun.com/xml/ns/jbi" 
           version="1.0">
           
         <service-assembly>
           <identification>
             <name>AU_1</name>
             <description>Sample AU</description>
           </identification>
           <service-unit>
             <identification>
               <name>SU_1</name>
               <description>Sample</description>
             </identification>
             <target>
               <artifacts-zip>su1.zip</artifacts-zip>
               <component-name>servicemix-component</component-name>
             </target>
           </service-unit>
          </service-assembly>
          
      </jbi>
      
      Copy the jbi.xml file to an empty META-INF directory, then create the jar file:
      Code Block
      
      In a directory which contains these files, create the jar file:
        META-INF/jbi.xml
        su1.zip
      
      jar cvf sa_quartz.jar *
      
    Wiki MarkupDeploy the two jar files. Copy {{service_component.jar}} and {{sa_quartz.jar}} to {{\[servicemix_src_install_dir\]\assembly\target\servicemix-2.0.\bin\servicemix-2.0.2\deploy}}. This can be done while ServiceMix is running or while ServiceMix is not running. In the second case, run ServiceMix to see the deployment. Output will be similar to:

The JBI spec describes in detail how to create a valid JBI deployment unit. In essence, it is a jar file with a META-INF/jbi.xml with other resource jars inside it. Please see Deployment Units for more information.

...