How to create and consume a SOAP based web service in JAVA

• To create a SOAP webservice, you need to add the JAX-WS dependency to your project

                <dependency>
<groupId>com.sun.xml.ws</groupId>
<artifactId>jaxws-rt</artifactId>
<version>${jaxws-rt.version}</version>
</dependency>

• Create an interface to expose the web methods e.g.

package com.arsoft.projects.artutorial.learning.soap.server;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
@WebService
@SOAPBinding(style = SOAPBinding.Style.RPC)
public interface HelloWorldService {
@WebMethod
public String sayHello(String name);
}

• Annotate the interface with @WebService and @SOAPBinding and the exposed method with @WebMethod

• Create the implementation class e.g.

package com.arsoft.projects.artutorial.learning.soap.server;
import javax.jws.WebService;
@WebService(endpointInterface = "com.arsoft.projects.artutorial.learning.soap.server.HelloWorldService")
public class HelloWorldServiceImpl implements HelloWorldService {
public String sayHello(String name) {
return "Hello " + name + "!!";
} 

}

• Annotate the class with @WebService providing the fully qualified name of the interface as endpointInterface 

• Publish the webservice as below

package com.arsoft.projects.artutorial.learning.soap.server;
import javax.xml.ws.Endpoint;
import com.arsoft.projects.artutorial.learning.soap.Constant;
public class SoapServer {
public static void main(String[] args) {
Endpoint.publish(Constant.helloWorldSoapServiceUrl, new HelloWorldServiceImpl());
}
}

•  To consume the above webservice, create the stubs from the wsdl by adding below plugin to the pom.xml file of the client application

                     <plugin>
<groupId>com.sun.xml.ws</groupId>
<artifactId>jaxws-maven-plugin</artifactId>
<version>2.3.2</version>
<executions>
<execution>
<id>generate-java-sources</id>
<phase>process-sources</phase>
<goals>
<goal>wsimport</goal>
</goals>
<configuration>
<extension>true</extension>
<wsdlUrls>
<wsdlUrl>http://localhost:8888/ws/hello?wsdl</wsdlUrl>
</wsdlUrls>
</configuration>
</execution>
</executions>

</plugin>

• Add the JAX-WS dependency to the client project
                <dependency>

<groupId>com.sun.xml.ws</groupId>

<artifactId>jaxws-rt</artifactId>

<version>${jaxws-rt.version}</version>
</dependency>


• Generate the stub classes by running maven goal 'mvn process-sources. The stub classes will be generated inside folder target/generated-sources. Copy the file to src directory
• Create the consumer class as below

package com.odigo.bre.reporting;

import java.net.MalformedURLException;

import java.net.URL;

import javax.xml.namespace.QName;

import javax.xml.ws.Service;

import com.arsoft.projects.artutorial.learning.soap.server.HelloWorldService;

public class SoapClient {

    public static void main(String[] args) throws MalformedURLException {

        URL webserviceURL = new URL("http://localhost:8888/ws/hello?wsdl");

        QName qname = new QName("http://server.soap.learning.artutorial.projects.arsoft.com/",

                "HelloWorldServiceImplService");

        Service service = Service.create(webserviceURL, qname);

        HelloWorldService helloWorldService = service.getPort(HelloWorldService.class);

        String message = helloWorldService.sayHello("Anshul Sood");

        System.out.println(message);

    }

}

 where QName takes targetNamespace and name from wsdl as its arguments.