Tuesday Mar 06, 2007
Hi, I'm Ken Hofsass. I've been at Sun since 1998 and a member of the Java Web Services group for several years. More specifically, I've been on the Web Services Interoperability Technologies (WSIT) project for the last year and a half (give or take).
Most likely, the posts here will focus on topics related to WSIT and interop with .NET 3.0.
Thanks for checking in!
Tuesday Mar 06, 2007
If you're interested in having GlassFish v2 and Java web services interoperate with .NET 3.0, the WSIT (Web Services Interoperability Technologies) project can help. This blog entry can help you get started using WSIT with some code samples and pointers to more in depth documentation.
WSIT is now an integrated part of the GlassFish v2 application server. So there is no additional download or installation required. The WSIT 'How To' documents describe the initial steps required to get started with WSIT, most importantly for us, how to build and deploy applications with GlassFish. However, if you are using the Tomcat web container or want to build the very latest WSIT sources for yourself, the 'How To' docs describe that too.
Accompanying the introductory WSIT 'How To' documents is a set of four very basic samples. Each of them demonstrates the 'round-trip' of a client sending its request to the server and the server returning a response. In each case, the client sends two requests: one which is expected to be successful and one which intentionally causes an exception to occur and will receive a fault message rather than a regular response. Each of the samples is available as a downloadable .zip file which contains the buildable source code.
In the 'How To' documents, there are two that deal with building projects in the WSIT environment. The first of the two documents, 'Building a JAX-WS Application in the WSIT Environment', discusses building a standard JAX-WS-style project within the WSIT environment that does not enable any WSIT functionality. There are two samples for this document: one which starts from a WSDL document and one which starts from a Java class. They are primarily intended to provide a sanity check for your development environment's setup and tooling. Again, these two samples do not exercise any of the WSIT technologies.
These two samples are named 'wsit-jaxws-fromwsdl.zip' and 'wsit-jaxws-fromjava.zip'.
The second document, 'Enabling WSIT Functionality in a Web Service Application', demonstrates enabling very basic WSIT functionality through WSIT configuration files. Specfically, it uses WS-Policy assertions to enable WS-ReliableMessaging. Again there are two samples: one starting from a WSDL document, which now includes WS-Policy assertions, and the other that starts from a Java class but now includes a WSIT configuration file which contains the WS-Policy assertions. A WSIT configuration file is simply a WSDL-formatted file which contains the assertions necessary to configure the service (in this case) or client (not shown in this sample).
These samples are named 'wsit-enabled-fromwsdl.zip' and 'wsit-enabled-fromjava.zip'.
The zip bundles of the sample code can be retrieved using the embedded links above, from the How To pages, or as part of the WSIT CVS repository on java.net (which also includes the samples in expanded directory form). These samples will also likely be included in the 'glassfish-samples' project in the near future.
Once downloaded, unzip them. Each will extract into an individual subdirectory. It is probably best to follow the instructions provided in the respective 'How To' documents: 'Building a JAX-WS Application in the WSIT Environment' and/or 'Enabling WSIT Functionality in a Web Service Application'
Resources:
WSIT main page
WSIT How To index page
Project GlassFish