Jakarta XML Web Services

Jakarta EE application programming interface

Jakarta XML Web ServicesOther names| Java API for XML Web Services, JAX-WS

|

Original author(s)| Sun Microsystems
Developer(s)| Eclipse Foundation
Stable release|

2.3.3 / February 19, 2020; 3 years ago (2020-02-19)

Repository|

* github.com/eclipse-ee4j/jax-ws-api

Written in| Java
Operating system| Cross-platform
Platform| Java
Type| Application framework
License| EPL 2.0 or GPL v2 w/Classpath exception
Website| projects.eclipse.org/projects/ee4j.jaxws

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[edit]

The JAX-WS 2.2 specification JSR 224 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.[1] 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[edit]

* 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[edit]

Package | Description

|

javax.xml.ws | Has the Core JAX-WS APIs
javax.xml.ws.http | Has APIs specific to XML/HTTP Binding
javax.xml.ws.soap | Has APIs specific to SOAP/HTTP Binding
javax.xml.ws.handler | Has APIs for message handlers
javax.xml.ws.spi | defines SPIs for JAX-WS
javax.xml.ws.spi.http | Provides HTTP SPI that is used for portable deployment of JAX-WS in containers
javax.xml.ws.wsaddressing | Has APIs related to WS-Addressing
javax.jws | Has APIs specific to Java to WSDL mapping annotations
javax.jws.soap | Has APIs for mapping the Web Service onto the SOAP protocol

## XML Web Services related Specs[edit]

Java EE 7

Specification | Version | Stds. Body | JSR/Url
JAX-WS | 2.3  | JCP  | 224
Web Services | 1.3  | JCP  | 109
WS Metadata | 2.1  | JCP  | 181
JAXB | 2.2  | JCP  | 222
SAAJ | 1.3  | JCP  | 67
SOAP | 1.2  | W3C  | soap
XML | 1.1  | W3C  | xml
WSDL | 1.1  | W3C  | wsdl

## Implementations[edit]

* Eclipse Metro in Eclipse Enterprise for Java (EE4J)
* Apache CXF
* Apache Axis2
* JBossWS in WildFly
* IBM WebSphere Jax-Ws in WebSphere
* Oracle Weblogic

## References[edit]

1. ^ Yang, Young (June 3, 2007). "JAX-WS Web Services Without Java EE Containers".

## External links[edit]

* Official website
* java.net project pages
* JAX-WS java.net project page
* GlassFish java.net project page
* Documentation
* JAX-WS Javadoc
* JAX-WS in the Java EE 5 Tutorial
* Tutorials
* JAX-WS Tutorials

* v
* t
* e

Jakarta EE specifications

Web app|

* Servlet
* Pages
* Expression Language
* JSTL
* Faces
* Facelets
* WebSocket

Enterprise app|

* Dependency injection
* Bean Validation
* Enterprise Beans
* JPA
* JMS
* JTA
* Mail
* JCA
* Annotations

Web services|

* JAX-RS
* JAX-WS
* SOAP with Attachments
* Web Services Metadata
* JAXM

Other|

* JAXB
* JAF

Removed|

* JAXR
* JAX-RPC
* Management

Related|

* JAXP
* JDBC
* JMX
* Streaming API for XML

*[v]: View this template
*[t]: Discuss this template
*[e]: Edit this template