Apache Axis2 and JAX-WS Tools

Content

Apache Axis2 Artifact

To create a Apache Axis2 Service Artifact, right click on the CApp project and select Axis2 Service from the menu.



New Server Runtime



There are three ways to create an Apache Axis2 Service Artifact.



New Server Runtime



Create an Apache Axis2 Service Artifact pointing a class file in the workspace

This option will be selected by default. If you already have a service class in your workspace, select Browse button and type the class name you want to specify.



New Server Runtime



You can create a new class from the scratch as well. To point a new service class, select New button. Now you will see, general java class creation page of Eclipse appears.





New Server Runtime



In the class creation wizard page give necessary information and click Finish.





New Server Runtime



Now you will see that the given information has been filled in to Apache Axis2 Service artifact creation wizard page. Then click Next.





New Server Runtime



Give a name to the Apache Axis2 Service artifact. This field will be filled automatically. If not, give a name you preferred. Then click Finish.





New Server Runtime



Now you will see axis2 artifact is created under artifacts folder. You can see HelloWorld.service and services.xml files also have been created.





New Server Runtime



Now we will add a method to HelloWorld java class.





New Server Runtime



There are several things you can do with the service file that has been created.

  1. Create a WSDL
  2. Create a service client
  3. Create an Axis2 Archive (aar) file
Those options are available when you right click on the .service file which has been created.



Create a WSDL

New Server Runtime



Create a service client



New Server Runtime



Create Apache Axis2 Archive(aar) file



New Server Runtime



Apache Axis2 Service in the workspace

This is the second option to create an Axis2 Service artifact. If you already have a Web Services project in your workspace, you can create a service from that as well.





New Server Runtime



Apache Axis2 archive(aar) in the file system

This is the third option to create an Axis2 Service artifact. With this option, you have to give the location of Apache Axis2 archive(aar) file in your file system.





New Server Runtime



Now you have successfully created an Apache Axis2 Service artifact from WSO2 Carbon Studio. You can deploy the created service to WSO2 Application Server and test. Detailed description of how to deploy any type of artifact to a Carbon Server can be found here.

Apache Axis2 Service with Contract First Approach

You can create an Apache Axis2 Service pointing a WSDL file, using WSO2 Carbon Studio. To create Apache Axis2 Service, first add the WSDL file in to your workspace.





New Server Runtime



Before creating the service, add a Carbon Server. You can find information regardig how to add a Carbon Server from here.

After adding the carbon server, right click on the WSDL file and select Generate Java Bean Skeleton from Web Services category.





New Server Runtime



Now you will see the Web Service wizard has been pop up.





New Server Runtime



Under Configuration, you will see added Carbon Server has been listed. Click on that.

Select Server runtime as the added Carbon Server and Web service runtime as WSO2 Carbon Server Runtime and click Next.





New Server Runtime



In the next page, you can specify other options like Port Name, Databinding Name etc.





New Server Runtime



In the next page, you will ask to start the server. Unless you start the server, it will allow to proceed.





New Server Runtime



After some time, you will see that the server has been started.





New Server Runtime



Now you will see, new Web Services Project has been created which contains the generated stubs for the WSDL you have pointed.





New Server Runtime



Now you can export this Web Services Project to Apache Axis2 Archive (aar) file with the Export option.





New Server Runtime



In the Export wizard, select Axis2 Service Archive [AAR] from WSO2 Exporter and click Next.





New Server Runtime



In the next page, you will see that the Axis2 Service Project has been filled up. Now click Finish.





New Server Runtime



Give a location where you want to save the Axis2 Archive. Now you have successfully created a Apache Axis2 Archive in contract first approach.

JAX-WS Artifact

To create a JAX-WS Artifact, right click on the CApp project and select JAX-WS from the menu.





New Server Runtime



There are two ways to create a JAX-WS Artifact.

  1. Create a JAX-WS Pointing to a jar in the file system
  2. Create a JAX-WS Pointing to a jar in the registry




New Server Runtime



With the first option, you can point to a jar file in the file system.





New Server Runtime



With the Create a JAX-WS Pointing to a jar in the registry, you can browse resources of the registry instance that you have already created or you can create a new registry instance as well. After selecting the registry instance, click on Browse to browse resources in registry.





New Server Runtime



Select the CApp project you want to create JAX-WS and click Finish.





New Server Runtime



Now you will see new JAX-WS artifact is created under the selected CApp project.





New Server Runtime