Java Online

III Axis2 server implementation

Build a full web service with Axis2

Server skeleton generation

To generate the java skeleton for the axis server from the definition.wsdl file (Top down Java Web Service) :

1. Create a new Dynamic Web Project called Axis2TutorialServer
2. Right-click on the definition.wsdl file in the Eclipse Project Explorer view
3. Choose : Web Services > Generate Java bean skeleton

Choose Install service in the top left spinner, and select :

• the target Server (Tomcat)
• the target Web service runtime (Axis2)
• the Service project (Axis2TutorialServer)

Click the Next button and select the custom mapping option. Select a target package for types in the namespace http://axis.tutorial/AxisTutorial :

Click the Finish button. The server skeleton sources are generated under the axis.tutorial package of the Axis2TutorialServer Project :

Service implementation

You just need to implement the getById method in the Axis2TutorialSkeleton.java class to provide the desired service :

Axis2TutorialSkeleton.java

package axis2.tutorial; import org.apache.axis2.engine.AxisError; import axis2.tutorial.service.CDServiceAxisImpl; import cd.catalog.exception.CDServiceException; import cd.catalog.service.CDService; /** * Axis2TutorialSkeleton java skeleton for the axisService */ public class Axis2TutorialSkeleton { private CDService cdService; public Axis2TutorialSkeleton() {} public axis2.tutorial.GetByIdResponse GetById(axis2.tutorial.GetById getById) { try { // --- Using the service to retrieve data cd.catalog.mapping.CD cd = getCDService().getById(new Long(getById.getIn())); GetByIdResponse response = new GetByIdResponse(); // --- No CD found if (cd==null) return response; // --- Building the response object axis2.tutorial.CD axisCD = new axis2.tutorial.CD(); axisCD.setId(cd.getId().longValue()); axisCD.setName(cd.getName()); axisCD.setArtistName(cd.getArtistName()); axisCD.setPublishDate(cd.getPublishDate()); // --- Returning the result response.setOut(axisCD); return response; } catch (CDServiceException e) { // --- Handling errors... throw new AxisError("Error while trying to retrieve a CD"); } } public void setCdService(CDService cdService) { this.cdService = cdService; } public CDService getCDService() { if (this.cdService==null) { this.cdService = new CDServiceAxisImpl(); } return this.cdService; } }

Download the full Axis2TutorialSkeleton.java file

Setting up the web application

Before you start the service provider, you must set up Axis to start and handle your web service at the application startup. The web.xml file under WebContent > WEB-INF tells Tomcat to map the Axis2 servlet to the /services URL. It means that every HTTP request made to an URL startig with /services will be handled by the Axis2 engine.

web.xml

<servlet> <display-name>Apache-Axis Servlet</display-name> <servlet-name>AxisServlet</servlet-name> <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/servlet/AxisServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>*.jws</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> <servlet> <display-name>Apache-Axis Admin Servlet Web Admin</display-name> <servlet-name>AxisAdminServlet</servlet-name> <servlet-class>org.apache.axis2.transport.http.AxisAdminServlet</servlet-class> <load-on-startup>100</load-on-startup> </servlet> <servlet-mapping> <servlet-name>AxisAdminServlet</servlet-name> <url-pattern>/axis2-admin/*</url-pattern> </servlet-mapping>

The Axis2 engine use the services.xml files under WEB-INF/services/{service}/META-INF to deploy services. The services.xml of our listEmployeesService looks like :

services.xml

<serviceGroup> <service name="Axis2Tutorial"> <messageReceivers> <messageReceiver mep="http://www.w3.org/ns/wsdl/in-out" class="axis2.tutorial.Axis2TutorialMessageReceiverInOut"/> </messageReceivers> <parameter name="ServiceClass">axis2.tutorial.Axis2TutorialSkeleton</parameter> <parameter name="useOriginalwsdl">true</parameter> <parameter name="modifyUserWSDLPortAddress">true</parameter> <operation name="GetById" mep="http://www.w3.org/ns/wsdl/in-out" namespace="http://axis2.tutorial/Axis2Tutorial/"> <actionMapping>http://axis2.tutorial/Axis2Tutorial/GetById</actionMapping> <outputActionMapping>http://axis2.tutorial/Axis2Tutorial/Axis2Tutorial/GetByIdResponse</outputActionMapping> </operation> </service> </serviceGroup>

You have nothing else to do, your service will automatically be available after the server startup. Our Axis2 web service server application is now finished. The implementation is quite simple and returns the requested CD.

Continue to part IV : Service requester implementation

Axis Web Service

• Web service specification
• Web service definition - WSDL
• Axis2 server implementation
• Axis2 client implementation
• JAX-WS web service

Frameworks :

• Axis web service
  Build a full web service with Axis
• Axis2 web service
  Build a full web service with Axis2

Bookmark & share