Spring Tutorials

The Spring provides full support for standard Java web services APIs. Spring provides a convenient base class for JAX-WS servlet endpoint implementations SpringBeanAutowiringSupport. To expose our DataService we extend Spring’s SpringBeanAutowiringSupport class and implement our business logic here, usually delegating the call to the business layer. We’ll simply use Spring’s @Autowired annotation for expressing such dependencies on Spring-managed beans.

import org.springframework.web.context.
support.SpringBeanAutowiringSupport;
@WebService(serviceName="DataService")
public class DataServiceEndpoint extends 
SpringBeanAutowiringSupport {
@Autowired
private DataService service;
@WebMethod
public void insertData(Data d) {
service.insertData(d);
}
@WebMethod
public Data[] getDat(String name) {
return service.getDat(name);
}}

The DataServletEndpoint needs to run in the same web application as the Spring context to allow for access to Spring’s facilities. This is the case by default in Java EE 5 environments, using the standard contract for JAX-WS servlet endpoint deployment.

The built-in JAX-WS provider that comes with Oracle’s JDK 1.6 supports exposure of web services using the built-in HTTP server that’s included in JDK 1.6 as well. Spring’s SimpleJaxWsServiceExporter detects all @WebService annotated beans in the Spring application context, exporting them through the default JAX-WS server (the JDK 1.6 HTTP server).

The endpoint instances are defined and managed as Spring beans themselves; they will be registered with the JAX-WS engine but their lifecycle will be up to the Spring application context.

<bean class="org.springframework.remoting.
jaxws.SimpleJaxWsServiceExporter">
<property name="helloWorld" 
value="http://localhost:8080/"/>
</bean>
<bean id="dataServiceEndpoint" 
class="r4r.in.DataServiceEndpoint">
...
</bean>
...

The DataServiceEndpoint may derive from Spring’s SpringBeanAutowiringSupport but doesn’t have to since the endpoint is a fully Spring-managed bean here. This means that the endpoint implementation may look like as follows, without any superclass declared - and Spring’s @Autowired configuration annotation still being distinguished:

@WebService(serviceName="DataService")
public classDataServiceEndpoint {
@Autowired
private DataService service;
@WebMethod
public void insertData(Data d)
{
service.insertData(d);
}
@WebMethod
public List<Data> getDat(String name) {
return service.getDat(name);
}}