JAX-WS + Java Web Application Integration Example

Posted on March 14, 2011 ,     Last modified : August 29, 2012

By mkyong

Often times, JAX-WS always be part of your Java web application. Here we show you how to integrate JAX-WS into Java web application easily.

1. Project Folder

First, review this project folder structure.

2. Web Service

A super simple web service. Code is self-explanatory.

File : HelloWorld.java

package com.mkyong.ws;
 
import javax.jws.WebMethod;
import javax.jws.WebService;
 
@WebService
public class HelloWorld{
 
 @WebMethod(operationName="getHelloWorld")
 public String getHelloWorld(String name) {
  return "Hello World JAX-WS " + name;
 }
 
}

3. Web Service Deployment Descriptor (sun-jaxws.xml)

Create a web service deployment descriptor, named sun-jaxws.xml.

File : sun-jaxws.xml

 version="1.0" encoding="UTF-8"?>

  xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"
  version="2.0">
  
      name="HelloWorldWs"
      implementation="com.mkyong.ws.HelloWorld"
      url-pattern="/hello"/>

4. Web Application Deployment Descriptor (web.xml)

In the standard web.xml,

1. Defines “com.sun.xml.ws.transport.http.servlet.WSServletContextListener” as listener class.
2. Defines “com.sun.xml.ws.transport.http.servlet.WSServlet” as your web service (hello) servlet.

File : web.xml

 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >
 

 Archetype Created Web Application

  com.sun.xml.ws.transport.http.servlet.WSServletContextListener hello com.sun.xml.ws.transport.http.servlet.WSServlet 1 hello /hello  

5. Done

The integration between JAX-WS and web application is done. Deploy it and access via URL :http://localhost:8080/WebServicesExample/hello

Download Source Code

Download it – JAX-WS-Integrate-WebApplication-Example.zip (7KB)

Reference

1. How to deploy JAX-WS on Tomcat
2. JAX-WS hello world example (document-style)