Jakarta XML Web Services API Introduction Tutorial
Jakarta XML Web Services API Introduction Tutorial
Jakarta XML Web Services API (hereinafter referred to as JAX-WS API) is a Java API for Web services for generating and developing the XML protocol for interaction.This tutorial will introduce how to create and deploy Web services with JAX-WS API, and provide some Java code examples.
1. Environmental requirements
Before starting, make sure that the following software has been installed on your computer:
-Java Development Kit (JDK) 1.6 or higher version
-Apache Tomcat 7 or higher version
-Eclipse IDE (optional)
2. Create a simple web service
First, let's create a simple web service that will provide a method that can add two numbers.
Create a new Java project and name it "Calculatorservice".
Create a new Java class that names it "Calculator", and defines a method called "ADD" in it. This method accepts two integers as a parameter and returns their sum.
// Calculator.java
public class Calculator {
public int add(int a, int b) {
return a + b;
}
}
3. Use JAX-WS to generate a web service
Now, let's use the JAX-WS API to generate a web service.In Eclipse, you can click the project by right -click, select "New"> "Other", and then select "Web Service" from the drop -down menu to create a service.
Select "Bottom Up Java Bean Web Service" and then click "Next".
In "Service Implementation", select the "Calculator" class as a service implementation and click "Next".
In "Web Service", select "Generate WSDL" and click "Finish".
This will generate a web service based on your Java class.
4. Deploy web service
Next, let's deploy our web service to the Apache Tomcat server.
Copy the creating WEB service to the "WebApps" directory of Tomcat.
Start the Tomcat server.
5. Test web service
Open any web browser and enter the following URL to test the web service:
http://localhost:8080/CalculatorService/Calculator?wsdl
This will display the generated WSDL file.
6. Create a client application
Finally, let's create a Java client application using our web service.
In Eclipse, create a new Java project and name it "CalculatorClient".
Right -click the project, select "Properties", and then go to "Java Build Path"> "Libraries"> "Add External Jars".
Select all the jar files in the "Common" directory of Tomcat and click "OK".
Create a new Java class, name it "CalculatorClient", and write the following code:
// CalculatorClient.java
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import com.example.Calculator;
public class CalculatorClient {
public static void main(String[] args) {
try {
URL url = new URL("http://localhost:8080/CalculatorService/Calculator?wsdl");
QName qname = new QName("http://example.com/", "CalculatorService");
Service service = Service.create(url, qname);
Calculator calculator = service.getPort(Calculator.class);
int result = calculator.add(5, 3);
System.out.println("Result: " + result);
} catch (Exception e) {
e.printStackTrace();
}
}
}
Run the client application, you will see the output on the console:
Result: 8
This shows that our web service has been successfully called.
This is an entry -level tutorial that uses Jakarta XML Web Services API to create and deploy Web services.I hope this article can help you get started with JAX-WS API quickly and start building a strong web service.
