Jakarta XML Web Services
{{Short description|Jakarta EE application programming interface}}
{{Infobox software
| name = Jakarta XML Web Services
| other_names = Java API for XML Web Services, JAX-WS
| screenshot =
| caption =
| author = Sun Microsystems
| developer = Eclipse Foundation
| latest release version = 2.3.3
| latest release date = {{Start date and age|2020|02|19}}
| latest preview version =
| latest preview date =
| operating system = Cross-platform
| platform = Java
| programming language = Java
| genre = Application framework
| license = EPL 2.0 or GPL v2 w/Classpath exception
| website = {{Official URL}}
}}
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 [http://jcp.org/en/jsr/detail?id=224 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.{{cite web |title=JAX-WS Web Services Without Java EE Containers |url=https://community.oracle.com/docs/DOC-983165 |date=June 3, 2007 |first=Young |last=Yang}} As of Java SE 11, JAX-WS was removed. For details, see [http://openjdk.java.net/jeps/320 JEP 320].
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
| class="wikitable" width="80%" | |
| 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 |
Implementations
- Eclipse Metro in Eclipse Enterprise for Java (EE4J)
- Apache CXF
- Apache Axis2
- JBossWS in WildFly
- IBM WebSphere Jax-Ws in WebSphere
- Oracle Weblogic
References
{{Reflist}}
External links
- {{Official website}}
- java.net project pages
- [https://javaee.github.io/metro-jax-ws/ JAX-WS java.net project page]
- [https://javaee.github.io/glassfish/ GlassFish java.net project page]
- Documentation
- [https://javadoc.io/doc/com.sun.xml.ws/jaxws-rt/2.3.0 JAX-WS Javadoc]
- [http://docs.oracle.com/javaee/5/tutorial/doc/?wp405739&JAXWS.html#wp72279 JAX-WS in the Java EE 5 Tutorial]
- Tutorials
- [http://memorynotfound.com/category/java/jax-ws/ JAX-WS Tutorials] {{Webarchive|url=https://web.archive.org/web/20150128151045/http://memorynotfound.com/category/java/jax-ws/ |date=2015-01-28 }}
{{Jakarta EE}}