Creating the service assembly (SA)

On this page, we are going to create a service assembly .

Using a Maven archetype to create the service assembly

ServiceMix provides Maven archetype to help you create your service assembly.(SA)

From SMX_HOME/bin directory, we run this command to create a service unit project named :

in MS Windows:

 
smx-arch sa

in GNU\Linux:

 
./smx-arch sa

Maven executes the archetype and reports BUILD SUCCESSFUL when it's done. (For more information run smx-arch help)

c:\java\apache-servicemix-3.2.1\bin>smx-arch sa
[INFO] Scanning for projects...
...
[INFO] OldArchetype created in dir: c:\java\apache-servicemix-3.2.1\bin\my-sa
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 8 seconds
[INFO] Finished at: Wed Jul 30 11:08:06 CEST 2008
[INFO] Final Memory: 8M/14M
[INFO] ------------------------------------------------------------------------

A new service assembly project is generated in the my-sa directory.

Add this SA to directory of our project

We copy directory my-sa to directory of our project.(where is parent's pom.xml)
Then we add this to parent's pom.xml to element project.

 
  <modules>
     <module>my-sa</module>
  </modules>

Finally, parent's pom.xml looks like this:

 
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>org.apache.servicemix.tutorial</groupId>
  <artifactId>parent</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>pom</packaging>
  <name>ServiceMix  :: CXF WSDL Tutorial</name>
  <url>http://servicemix.org</url>
  <modules>
      <module>my-cxf-se-su</module>
      <module>my-cxf-bc-su</module>
     <module>my-sa</module>
  </modules>
</project>

Configuring pom.xml

Changing the project name

In order to make the build output a little bit more comprehensible, we first change the project name in the generated pom.xml file.

 
<project>
  ...
  <name>CXF WSDL Tutorial :: CXF SA</name>
  ...
</project>

Adding parent's element to generated pom.xml

We must specify parent of this project. So, we add this to generated pom.xml.

 
 <parent>
    <artifactId>parent</artifactId>
    <groupId>org.apache.servicemix.tutorial</groupId>
    <version>1.0-SNAPSHOT</version>
  </parent>

Adding the SU to the SA

We want to add the service unit we created before to the service assembly. The Maven tooling will do this automatically if we add the correct dependency to our SA's pom.xml. We just use the groupId, artifactId and version we find in our service unit's pom.xml here:

 
<project>
  ...
  <dependencies>
  <dependency>
      <groupId>com.mycompany</groupId>
      <artifactId>my-cxf-se-su</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>
    <dependency>
      <groupId>com.mycompany</groupId>
      <artifactId>my-cxf-bc-su</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>
 </dependencies>
  ...
</project>

Running Maven to build everything

Now, run mvn install from the parent directory to get this output:

Now, we are ready to deploy our service assembly.

Things to remember

Add SU to your SA by adding dependencies to your pom.xml

Child pages