Java 17 SOAP client example

Java 17 SOAP client example

Here is a basic Java 17 SOAP client example using the JAX-WS API:

First, you need to have the jaxws-api and javax.xml.ws libraries in your classpath. If you're using Maven, you can add the following dependencies to your pom.xml file:

com.sun.xml.ws
jaxws-ri
2.3.1

Next, create a Java class that will send the SOAP request:

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import javax.xml.soap.SOAPException;
import javax.xml.ws.Dispatch;
import javax.xml.ws.Service;
import javax.xml.ws.SOAPMessageContext;
public class SoapClient {
public static void main(String[] args) {
// Create the service
Service service = Service.create(SOAPMessageContext.class, "http://localhost:8080/soap/services");
// Get the port
Dispatch dispatch = service.getPort(Dispatch.class);
// Send the request
try (BufferedReader reader = new BufferedReader(new InputStreamReader(dispatch.invoke("http://localhost:8080/soap/services", "HelloWorldSoapServicePort")));) {
String line;
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
} catch (SOAPException e) {
System.out.println(e.getMessage());
}
}
}

This example is very basic. In a real-world scenario, you would want to handle errors better and possibly send headers with your request.

Note: The Service class should be created by the Java compiler based on the WSDL file for your SOAP service. You can generate this class using the wsimport tool from the Oracle WebLogic Server SDK:

wsimport -jndi .wsdl

This will create a directory structure that you should use as-is for your project.

Java soap tutorial wsdl

Here's a Java Soap Tutorial with WSDL:

What is SOAP?

Simple Object Access Protocol (SOAP) is a protocol for exchanging structured information in the implementation of web services. It uses XML (Extensible Markup Language) to define the structure and content of the data sent between systems.

What is WSDL?

Web Service Description Language (WSDL) is an XML-based language used to describe the functionality offered by a Web service. It defines the interface, or contract, between two applications communicating over the web. In other words, WSDL is an XML file that describes the methods available in a SOAP web service.

Creating a SOAP Web Service with Java

To create a SOAP web service using Java, you need to follow these steps:

Here's an example WSDL file:

<definitions
targetNamespace="http://my.service.com/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
name="MyService"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

Here's an example Java class:

package my.service.com;
import javax.jws.WebService;
import javax.jws.WebMethod;
import javax.xml.ws.*;
public class MyService {
public String sayHello(String name) {
return "Hello, " + name + "!";
}
}

Consuming the SOAP Web Service

To consume the SOAP web service, you need to follow these steps:

Conclusion

In this tutorial, we learned how to create a SOAP web service using Java and WSDL. We also learned how to consume the web service using another Java program. With these steps, you can now create your own SOAP-based web services and clients using Java.

Additional Resources

For more information on creating SOAP-based web services and clients with Java, check out the following resources: