Axis2 tutorial (1) Service specification

I Web service specifications

Build a full web service with Axis2

Axis2 history

Apache Axis2 is the core engine for Web services. It is a complete re-design and re-write of the widely used Apache Axis SOAP stack, built on the lessons learnt from Apache Axis.

- Apache Software Foundation

Required tools

We are now going to see how to build, deploy and test a end to end web service using Axis2, Eclipse and Tomcat. In order to build and run the example, you need to install the following pieces of software :

First of all you'll need to setup Axis2 into Eclipse Preferences. Go to Window > preferences and type axis2 in the filter input field. The set the location of the Axis2 runtime location on your hard drive. You are now able to use Axis2.

Axis2 Eclipse integration

Service specifications

This tutorial use our recurrent example. We will see how to make our CDService Java interface available through web services and how to invoke it. More specifically, we are going to expose the getById method only of our CDService interface.

The Dao implementation we are going to use is a very simple one. It use a Hashtable<Long,CD> as catalog and contains only one CD . Our Service implementation instantiate a Dao object to perform it's getById method.

CDDaoAxisImpl.java

package axis2.tutorial.dao;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Hashtable;
import java.util.List;

import cd.catalog.dao.CDDao;
import cd.catalog.exception.CDDaoException;
import cd.catalog.mapping.CD;

public class CDDaoAxisImpl implements CDDao {

private Hashtable<Long, CD> catalog;
	
	public CDDaoAxisImpl() {
		this.catalog = new Hashtable<Long, CD>();
		SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy");
		CD entry = new CD();
		entry.setId(new Long(1));
		entry.setName("OK Computer");
		entry.setArtistName("Radiohead");
		try {
			entry.setPublishDate(sdf.parse("21/05/1997"));
		} catch (ParseException e) {
			// --- Change the date here !!!
		}
		catalog.put(entry.getId(), entry);
	}
	
	public CD create(CD arg0) throws CDDaoException {
		// TODO Auto-generated method stub
		return null;
	}

public void delete(CD arg0) throws CDDaoException {
		// TODO Auto-generated method stub
	}

public CD retrieve(Long arg0) throws CDDaoException {
		return catalog.get(arg0);
	}

public List<CD> searchByCriteria(String arg0, String arg1, Date arg2,
			Date arg3) throws CDDaoException {
		// TODO Auto-generated method stub
		return null;
	}

public CD update(CD arg0) throws CDDaoException {
		// TODO Auto-generated method stub
		return null;
	}

}

CDServiceAxisImpl.java

package axis2.tutorial.service;

import java.util.Date;
import java.util.List;

import axis2.tutorial.dao.CDDaoAxisImpl;
import cd.catalog.dao.CDDao;
import cd.catalog.exception.CDDaoException;
import cd.catalog.exception.CDServiceException;
import cd.catalog.mapping.CD;
import cd.catalog.service.CDService;

public class CDServiceAxisImpl implements CDService {

public CDServiceAxisImpl() {}
	
	public CD addToCatalog(CD arg0) throws CDServiceException {
		// TODO Auto-generated method stub
		return null;
	}

public CD getById(Long arg0) throws CDServiceException {
		CDDao cdDao = new CDDaoAxisImpl();
		try {
			return cdDao.retrieve(arg0);
		} catch (CDDaoException e) {
			throw new CDServiceException("Error while trying to retrieve a CD", e);
		}
	}

public List<CD> listByArtist(String arg0) throws CDServiceException {
		// TODO Auto-generated method stub
		return null;
	}

public List<CD> listByName(String arg0) throws CDServiceException {
		// TODO Auto-generated method stub
		return null;
	}

public void removeFromCatalog(CD arg0) throws CDServiceException {
		// TODO Auto-generated method stub
	}

public List<CD> searchByCriteria(String arg0, String arg1, Date arg2,
			Date arg3) throws CDServiceException {
		// TODO Auto-generated method stub
		return null;
	}

public CD updateInCatalog(CD arg0) throws CDServiceException {
		// TODO Auto-generated method stub
		return null;
	}

}

Download the CDDaoAxisImpl.java CDDao implementation
Download the CDServiceAxisImpl.java CDService implementation

Java Online

I Web service specifications

Axis2 history

Required tools

Service specifications

Axis Web Service

Frameworks :

Bookmark & share