The Jakarta XML Web Services (JAX-WS; formerly Java API for XML Web Services) is a Jakarta EE API for creating web services, particularly SOAP services. JAX-WS is one of the Java XML programming APIs.

Overview

The JAX-WS 2.2 specification defines a standard Java- to-WSDL mapping which determines how WSDL operations are bound to Java methods when a SOAP message invokes a WSDL operation. This Java-to-WSDL mapping determines which Java method gets invoked and how that SOAP message is mapped to the method's parameters.

This mapping also determines how the method's return value gets mapped to the SOAP response.

JAX-WS uses annotations, introduced in Java SE 5, to simplify the development and deployment of web service clients and endpoints. It is part of the Java Web Services Development Pack. JAX-WS can be used in Java SE starting with version 6. As of Java SE 11, JAX-WS was removed. For details, see .

JAX-WS 2.0 replaced the JAX-RPC API in Java Platform, Enterprise Edition 5 which leans more towards document style Web Services.

This API provides the core of Eclipse Metro.

JAX-WS also is one of the foundations of WSIT.

Standards Supported

  • JAX-WS 2.0/2.1/2.2 (JSR 224)
  • WS-I Basic Profile 1.2 and 2.0
  • WS-I Attachments Profile 1.0
  • WS-I Simple SOAP Binding Profile 1.0
  • WS-Addressing 1.0 - Core, SOAP Binding, WSDL Binding

Main JWS Packages

PackageDescription
javax.xml.wsHas the Core JAX-WS APIs
javax.xml.ws.httpHas APIs specific to XML/HTTP Binding
javax.xml.ws.soapHas APIs specific to SOAP/HTTP Binding
javax.xml.ws.handlerHas APIs for message handlers
javax.xml.ws.spidefines SPIs for JAX-WS
javax.xml.ws.spi.httpProvides HTTP SPI that is used for portable deployment of JAX-WS in containers
javax.xml.ws.wsaddressingHas APIs related to WS-Addressing
javax.jwsHas APIs specific to Java to WSDL mapping annotations
javax.jws.soapHas APIs for mapping the Web Service onto the SOAP protocol

XML Web Services related Specs

SpecificationVersionStds. BodyJSR/Url
Java EE 7
JAX-WS2.3JCP
Web Services1.3JCP
WS Metadata2.1JCP
JAXB2.2JCP
SAAJ1.3JCP
SOAP1.2W3C
XML1.1W3C
WSDL1.1W3C

Jakarta Web Services Metadata

Jakarta Web Services Metadata (JWS; formerly Web Services Metadata for Java platform and Java Web Services), as a part of Jakarta XML Web Services (JAX-WS), is a Java programming language specification (JSR-181) primarily used to standardize the development of web service interfaces for the Jakarta EE platform. Version is 2.1 was released on December 15, 2009.

Implementations

External links

  • java.net project pages
  • Documentation
  • Tutorials 2015-01-28 at the Wayback Machine