JAX-WS Tutorial

Java API for XML Web Services (JAX-WS), is a set of APIs for creating web services in XML format (SOAP). JAX-WS provides many annotation to simplify the development and deployment for both web service clients and web service providers (endpoints).

In this tutorials, it provides many step by step examples and explanations on both JAX-WS 2.0 and JAXWS 2.1.

Happy learning JAX-WS :)

Quick Start

Some quick start examples for JAX-WS 2.x.

Figure : JAX-WS communication – Image Source

• JAX-WS hello world example – RPC Style
  Tutorial to show you how to create a rpc style web service endpoint by using JAX-WS, and web service client in Java, wsimport and Ruby.
• JAX-WS Hello World Example – Document Style
  Tutorial to show you how to create a document style web service endpoint by using JAX-WS, and showing the flow of SOAP envelope between client and server.
• How to trace SOAP message in Eclipse IDE
  Tutorial to show you how to enable this “TCP/IP Monitor” in Eclipse IDE, and also intercept the SOAP messages generated by web service.
• JAX-WS : wsimport tool example
  The wsimport tool is used to parse an existing Web Services Description Language (WSDL) file and generate required files (JAX-WS portable artifacts) for web service client to access the published web services.
• JAX-WS : wsgen tool example
  The wsgen tool is used to parse an existing web service implementation class and generates required files (JAX-WS portable artifacts) for web service deployment.

JAX-WS Attachment

How to handle attachment in JAX-WS 2.x.

• JAX-WS attachment with MTOM
  A complete JAX-WS SOAP-based example to show how to use Message Transmission Optimization Mechanism (MTOM) and XML-Binary Optimized Packaging (XOP) technique to send a binary attachment (image) from server to client and vice verse.

JAX-WS Handler

SOAP handler is a SOAP message interceptor, which is able to intercept incoming or outgoing SOAP message and manipulate its values.

• Part 1 : JAX-WS – SOAP handler in server side
  In this article, we show you how to create a SOAP handler and attach it in server side, to retrieve the mac address in SOAP header block from every incoming SOAP message. And do validation to allow only computer with MAC address “90-4C-E5-44-B9-8F” to access this published service.
• Part 2 : JAX-WS – SOAP handler in client side
  In this article, you will develop a web service client to access the published service in previous article, and attach a handler to inject client’s MAC address into header block, for every outgoing SOAP message that’s send by client side.
• Part 3 : JAX-WS – SOAP handler testing for client and server side
  A testing result for above two SOAP handler articles.

JAX-WS Integration

How to integrate JAX-WS with Web Application and Spring framework.

• JAX-WS + Java Web Application integration example
  Here we show you how to integrate JAX-WS with Java web application.
• JAX-WS + Spring integration example
  Here we show you how to integrate JAX-WS with Spring framework.
• Unable to locate Spring NamespaceHandler for XML schema namespace [http://jax-ws.dev.java.net/spring/servlet]
  Common error message to integrate JAX-WS with Spring framework.

JAX-WS Security in Tomcat

How to JAX-WS security in Tomcat.

• Deploy JAX-WS web services on Tomcat
  Here’s a guide to show you how to deploy JAX-WS web services on Tomcat servlet container.
• Deploy JAX-WS web services on Tomcat + SSL connection
  Here’s a guide to show you how to deploy JAX-WS web services on Tomcat + SSL connection enabled.
• Application Authentication with JAX-WS
  Here’s a detail example to show you how to handle application level authentication with JAX-WS.
• Container Authentication with JAX-WS + (Tomcat version)
  Here’s a detail example to show you how to implement container authentication with JAX-WS, under Tomcat.
• Make Tomcat to support SSL or https connection
• How to bypass certificate checking in a Java web service client
• java.security.cert.CertificateException: No name matching localhost found
• SunCertPathBuilderException: unable to find valid certification path to requested target

JAX-WS Error Message

Some common error messages in JAX-WS development.

• Metro on WebSphere 7 – com.ibm.xml.xlxp2.jaxb.JAXBContextImpl incompatible exception
• Spring + jax-ws : ‘xxx’ is an interface, and JAXB can’t handle interfaces
• Spring + jax-ws : ‘#xxx’ is not a valid value for ‘NCName’
• javax.xml.stream.XMLStreamException : ParseError at [row,col]:[x,xx]
• java.net.BindException: Address already in use: bind
• Wrapper class package.jaxws.methodName is not found. Have you run APT to generate them?
• java.lang.ClassNotFoundException: com.sun.xml.ws.transport.http.servlet.WSServletContextListener
• java.lang.ClassNotFoundException : com/sun/xml/bind/v2/model/annotation/AnnotationReader
• java.lang.ClassNotFoundException : com/sun/xml/stream/buffer/XMLStreamBuffer
• java.lang.ClassNotFoundException : com/sun/xml/ws/policy/PolicyException
• java.lang.ClassNotFoundException : javax.xml.ws.soap.AddressingFeature$Responses
• java.lang.ClassNotFoundException : org.jvnet.staxex.XMLStreamReaderEx
• java.lang.ClassNotFoundException : org.glassfish.gmbal.ManagedObjectManager
• java.lang.ClassNotFoundException : org.glassfish.external.amx.AMXGlassfish
• java.lang.ClassNotFoundException: org.springframework.beans.factory.support.ReaderContext
• java.lang.ClassNotFoundException: org.apache.xbean.spring.context.v2.XBeanNamespaceHandler

References

1. http://jax-ws.java.net/
2. http://download.oracle.com/javaee/5/tutorial/doc/bnayn.html
3. http://java.sun.com/developer/technicalArticles/WebServices/high_performance/
4. http://java.sun.com/developer/technicalArticles/J2SE/jax_ws_2/
5. http://blogs.sun.com/kamna/entry/using_jax_ws_handlers_to
6. http://tomcat.apache.org/tomcat-6.0-doc/realm-howto.html
7. http://www.ibm.com/developerworks/webservices/library/ws-docstyle.html
8. http://www.oracle.com/technology/sample_code/tech/java/j2ee/jintdemo/tutorials/webservices.html
9. http://www.coderanch.com/how-to/java/WebServicesFaq
10. http://www.oracle.com/technetwork/articles/javase/index-137171.html