Tutorials : Integrating Apache Axis with the Spring Framework :

The Code for the Business Logic

You will be writing a Web service which will have a String doSomeWork(String work). This method is implemented by the BusinessLogic.java interface and BusinessLogicImpl.java class. The functionality of this method is that it can do whatever you need. Here is the sample interface:

package us.prokhorenko.springaxis;

public interface BusinessLogic {

	public String doSomeWork(String work);

}
Here's the code for the class, implementing the interface:

package us.prokhorenko.springaxis;

public class BusinessLogicImpl implements BusinessLogic {

	public String doSomeWork(String work) {

		String ret;

		ret = "The work " + " is done.";

		return ret;
	}
}
This code is simple and does not require any comments. The business logic can contain any methods you want.

The Code for the Web Service

The Web service requires you to have an interface and an implementation. First comes the interface, WebService.java:

package us.prokhorenko.springaxis.soap;

public interface WebService extends java.rmi.Remote {

	public String doSomeWork(String work) throws java.rmi.RemoteException;

}
The interface needs to extend java.rmi.Remote and its method can throw java.rmi.RemoteException exception. The implementation of this interface will look a bit more complex, but I will try to vanish all your fears. So, this is the WebServiceImpl.java class:

package us.prokhorenko.springaxis.soap;

import us.prokhorenko.springaxis.BusinessLogic;
import us.prokhorenko.springaxis.BusinessLogicImpl;

import org.springframework.remoting.jaxrpc.ServletEndpointSupport;

public class WebServiceImpl extends ServletEndpointSupport implements WebService {

	private BusinessLogic logic;

	protected final void onInit() {
		this.logic = (BusinessLogicImpl)getWebApplicationContext()
.getBean("bizLogic");
	}

	public String doSomeWork(String work)
	 throws java.rmi.RemoteException {
			return logic.doSomeWork(work);
	}

}
This implementation is much like the business logic (except the fact that it does not include method itself). This class extends the org.springframework.remoting.jaxrpc.ServletEndpointSupport abstract class. This is one of the key elements of intergrating of Spring and Axis. Extending this class provides a reference to the current Spring application context—like looking up a bean or resource loading.

Using the Spring framework, initialize the BusinessLogic logic variable, to let String doSomeWork(String work) make a call to the method in the business logic, which will do the actual work. Next, define a private variable for logic and leave its initialization to the onInit() method. This is the method that performs callbacks for custom initialization after the context has been set up. bizLogic is the name of the bean, which defines the business logic.

The Spring Configuration

The Spring configuration starts in the web.xml file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app version="2.4">

	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/applicationContext.xml</param-value>
					</context-param>

	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener
		</listener-class>
	</listener>

	<servlet>
		<servlet-name>springaxis</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet
		</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>

	<servlet-mapping>
		<servlet-name>springaxis</servlet-name>
		<url-pattern>*.html</url-pattern>
	</servlet-mapping>

</web-app>
This configures Spring's application context path and sets the mapping of *.html to the springaxis servlet. It will require the springaxis-servlet.xml configuration file, which you'll leave empty for now. The last step is to configure the application context and beans in the applicationContext.xml file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN"
"http://www.springframework.org/dtd/spring-beans.dtd">

<beans>

	<bean id="bizLogic" class="us.prokhorenko.springaxis.BusinessLogicImpl" />

</beans>
Note: The Web service servlet needs to run in the same Web application as the Spring context to allow for access to Spring's facilities.

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.

Elsewhere on internet.com:

WebDeveloper Java
Lots of Java information on webdeveloper.com

WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.

ScriptSearch Java
Hundreds of free Java code files to download.

jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.