Axis tutorial (3) Server implementation

III Axis server implementation

Build a full web service with Axis

Server skeleton generation

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

Create a new Dynamic Web Project called AxisTutorialServer
Right-click on the definition.wsdl file in the Eclipse Project Explorer view
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 (Axis)
the Service project (AxisTutorialServer)

Top down Axis Web Service

Click the Next button and select the custom mapping option :

Axis custom mapping option

Select a target package for types in the namespace http://axis.tutorial/AxisTutorial :

Axis custom mapping definition

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

AxisTutorialServer project

Service implementation

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

AxisTutorialSOAPImpl.java

package axis.tutorial;

import java.rmi.RemoteException;

import axis.tutorial.service.CDServiceAxisImpl;

import cd.catalog.exception.CDServiceException;
import cd.catalog.service.CDService;

public class AxisTutorialSOAPImpl implements axis.tutorial.AxisTutorial_PortType{
    
	private CDService cdService;
	
	public AxisTutorialSOAPImpl() {}
	
	public axis.tutorial.CD getById(long in) throws java.rmi.RemoteException {
		try {
			// --- Using the service to retrieve data
			cd.catalog.mapping.CD cd = getCDService().getById(new Long(in));
			
			// --- No CD found
			if (cd==null) return null;
			
			// --- Building the response object
	        axis.tutorial.CD axisCD = new axis.tutorial.CD();
	        axisCD.setId(cd.getId().longValue());
	        axisCD.setName(cd.getName());
	        axisCD.setArtistName(cd.getArtistName());
	        axisCD.setPublishDate(cd.getPublishDate());
	        
	        // --- Returning the result
	        return axisCD;
		} catch (CDServiceException e) {
			// --- Handling errors...
			throw new RemoteException("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 ListEmployeesSoapBindingImpl.java file

Set up the web application

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

web.xml

The Axis servlet use the server-config.wsdd file under WebContent > WEB-INF to deploy services. Create this file and use the following server-config.wsdd template.

server-config.wsdd

<service name="AdminService" provider="java:MSG">
        <namespace>http://xml.apache.org/axis/wsdd/
        </namespace>
        <parameter name="allowedMethods" value="AdminService" />
        <parameter name="enableRemoteAdmin" value="false" />
        <parameter name="className" value="org.apache.axis.utils.Admin" />
    </service>

</deployment>

Download the server-config.wsdd template

If you want your service to be deployed on startup like AdminService and Version, just paste the service node of your generated deploy.wsdd file into the server-config.wsdd file. The deploy.wsdd file is generated under WebContent/WEB-INF/axis/tutorial/.

server-config.wsdd

<service name="AdminService" provider="java:MSG">
		<namespace>http://xml.apache.org/axis/wsdd/
		</namespace>
		<parameter name="allowedMethods" value="AdminService" />
		<parameter name="enableRemoteAdmin" value="false" />
		<parameter name="className" value="org.apache.axis.utils.Admin" />
	</service>

<service name="AxisTutorialSOAP" provider="java:RPC" style="wrapped"
		use="literal">
		<parameter name="wsdlTargetNamespace" value="http://axis.tutorial/AxisTutorial/" />
		<parameter name="wsdlServiceElement" value="AxisTutorial" />
		<parameter name="schemaUnqualified" value="http://axis.tutorial/AxisTutorial/" />
		<parameter name="wsdlServicePort" value="AxisTutorialSOAP" />
		<parameter name="className" value="axis.tutorial.AxisTutorialSOAPSkeleton" />
		<parameter name="wsdlPortType" value="AxisTutorial" />
		<parameter name="typeMappingVersion" value="1.2" />
		<parameter name="allowedMethods" value="*" />

</deployment>

Download the final server-config.wsdd file

Our service provider web application is now finished. The implementation is quite simple and return a CD from the catalog. It's now time to build the service requester.

Java Online

III Axis server implementation

Server skeleton generation

Service implementation

Set up the web application

Axis Web Service

Frameworks :

Bookmark & share