On this page, we are going to configure the cxf-se-su service unit to provide our service .
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 SE SU</name> ... </project>
Adding version of cxf to pom.xml
We must specify version of CXF.
<project> ... <properties> ... <cxf-version> 2.0.7</cxf-version> ... </properties> ... </project>
Adding org.apache.cxf plugin
We add this plugin to the generated pom.xml file to element plugins.
<plugin> <groupId>org.apache.cxf</groupId> <artifactId>cxf-codegen-plugin</artifactId> <version>${cxf-version}</version> <executions> <execution> <phase>generate-sources</phase> <configuration> <sourceRoot>${basedir}/target/jaxws</sourceRoot> <wsdlOptions> <wsdlOption> <wsdl>${basedir}/src/main/resources/service.wsdl</wsdl> <extraargs> <extraarg>-verbose</extraarg> </extraargs> </wsdlOption> </wsdlOptions> </configuration> <goals> <goal>wsdl2java</goal> </goals> </execution> </executions> </plugin>
This plugin is use for generating java classes from WSDL file. We use wsdl2java tool from JAX-WS (CXF framework).
Where service.wsdl is WSDL file, which we made in my-cxf-bc-su. We must copy this WSDL file from my-cxf-bc-su/src/main/resources to
my-cxf-se-su/src/main/resources.
Implementing generated ExampleService.java
We must implement our service in java. In our example, it's HelloImpl.java
package org.apache.servicemix.examples; import javax.jws.WebService; import javax.xml.ws.Holder; import org.apache.servicemix.examples.types.SayHello; import org.apache.servicemix.examples.types.SayHelloResponse; @WebService(serviceName = "HelloService", targetNamespace = "http://servicemix.apache.org/examples", endpointInterface = "org.apache.servicemix.examples.Hello") public class HelloImpl implements Hello { public void sayHello(Holder<String> name) throws UnknownWordFault { if (name.value == null || name.value.length() == 0) { org.apache.servicemix.examples.types.UnknownWordFault fault = new org.apache.servicemix.examples.types.UnknownWordFault(); throw new UnknownWordFault(null, fault); } name.value = "Hi " + name.value; } }
Configuring xbean.xml
Next, we will have to configure our new SU to really provide some services. We do this by modifying the file named xbean.xml in the src/main/resources directory of our my-cxf-se-su module.
<cxfse:endpoint> <cxfse:pojo> <bean class="org.apache.servicemix.examples.HelloImpl" /> </cxfse:pojo> </cxfse:endpoint>
Next, we are going to create service assembly.
Things to remember
- You specify the plugin for a SU in Maven's pom.xml file
- In ServiceMix, most service units will be configured by a file named xbean.xml