Carbon StudioDownloadsDocumentation
SamplesGet InvolvedProject Information![]() |
Apache Axis2 and JAX-WS ToolsContentApache Axis2 ArtifactTo create a Apache Axis2 Service Artifact, right click on the CApp project and select Axis2 Service from the menu.![]() There are three ways to create an Apache Axis2 Service Artifact. ![]() Create an Apache Axis2 Service Artifact pointing a class file in the workspaceThis 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.![]() 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. ![]() In the class creation wizard page give necessary information and click Finish. ![]() Now you will see that the given information has been filled in to Apache Axis2 Service artifact creation wizard page. Then click Next.
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.
Now you will see axis2 artifact is created under artifacts folder. You can see HelloWorld.service and services.xml files also have been created.
Now we will add a method to HelloWorld java class.
Generate WSDLThis option is available under Generate category, if you right click on a .aar file or a .service file.
WSDL file will be created in the workspace.
Generate Apache Axis2 ClientThis option is available under Generate category, if you right click on a .aar file, WSDL file or a .service file.
After selecting the option, in the next wizard page, it will automatically fill the source folder of the project, where your WSDL file or .service file or .aar file included. If you want to change the source folder, you can do it using Browse button. After selecting the Source folder, click Next.
Select the necessary Client Generation Options available in the next page and click Finish.
Now you will see, client classes has been created in the selected Source folder that you have given previously.
Generate Apache Axis2 Archive (AAR)You can generate an Axis2 Service Archive(.aar) by pointing to an existing service(.service) file. Right click on your .service file. Select Generate menu. Then Select Apache Axis2 Archive (AAR). This will pop up a file system browser dialog. Then browse to the place where you want generate your Axis2 Archive file and select OK.
Generate Apache Axis2 Java SkeletonThis option is available under Generate category, if you right click on a .aar file or a WSDL file.
After selecting the option, in the next wizard page, it will automatically fill the source folder of the project, where your WSDL file or .aar file included. If you want to change the source folder, you can do it using Browse button. After selecting the Source folder, click Next.
Select the necessary Client Generation Options available in the next page and click Finish.
You can also create an Axis2 artifact using the skeleton classes that were generated. When Finish is pressed the following dialog will be displayed.
If you selected to create an Axis2 artifact you will have to select a Carbon Application Project to create the Axis2 artifact .
Now you will see, client classes have been created in the selected Source folder that you have given previously. Also the created Axis2 artifact have been created in the selected project as shown below.
Apache Axis2 Service in the workspaceThis 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. Note: This option will not be supported in our future releases.
Apache Axis2 archive(aar) in the file systemThis 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.
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 ApproachYou 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.
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.
Now you will see the Web Service wizard has been pop up.
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.
In the next page, you can specify other options like Port Name, Databinding Name etc.
In the next page, you will ask to start the server. Unless you start the server, it will allow to proceed.
After some time, you will see that the server has been started.
Now you will see, new Web Services Project has been created which contains the generated stubs for the WSDL you have pointed.
Now you can export this Web Services Project to Apache Axis2 Archive (aar) file with the Export option.
In the Export wizard, select Axis2 Service Archive [AAR] from WSO2 Exporter and click Next.
In the next page, you will see that the Axis2 Service Project has been filled up. Now click Finish.
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 ArtifactTo create a JAX-WS Artifact, right click on the CApp project and select JAX-WS from the menu.
There are two ways to create a JAX-WS Artifact.
![]() With the first option, you can point to a jar file in the file system.
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.
Select the CApp project you want to create JAX-WS and click Finish.
Now you will see new JAX-WS artifact is created under the selected CApp project.
|