Metro Users Guide

This document explains various interesting/complex/tricky aspects of Metro, based on questions posted on the Metro users forum and answers provided. This is still a work-in-progress. Any feedback is appreciated.

1. Introduction to Metro

• 1.1. Required Software
• 1.2. What is WSIT?
• 1.3. How Metro Relates to .NET Windows Communication Foundation (WCF)
• 1.4. Metro Specifications
• 1.5. How the Metro Technologies Work

2. Using Metro

• 2.1. Metro Tools
• 2.2. Using JAX-WS from Maven
• 2.3. Developing with NetBeans
• 2.4. Developing with Eclipse
• 2.5. Developing with IDEA
• 2.6. Useful tools for your toolbox
• 2.7. Logging
• 2.8. Using JAX-WS 2.1 with JavaSE6
• 2.9. Deploying Metro endpoint
• 2.10. Handlers and MessageContext
• 2.11. Deploying JAX-WS with ...
• 2.12. Developing client application with locally packaged WSDL
• 2.13. How to invoke and endpoint by overriding endpoint address in the WSDL
• 2.14. Maintaining State in Web Services
• 2.15. FastInfoset

3. Compiling WSDL

• 3.1. Compiling multiple WSDLs that share a common schema
• 3.2. Dealing with schemas that are not referenced
• 3.3. Customizing XML Schema binding
• 3.4. Generating Javadocs from WSDL documentation
• 3.5. Passing Java Compiler options to Wsimport

4. SOAP

• 4.1. SOAP headers
• 4.2. Schema Validation

5. HTTP

• 5.1. HTTP headers
• 5.2. HTTP compression
• 5.3. HTTP cookies
• 5.4. HTTP client streaming support
• 5.5. Access HTTP headers in a Handler
• 5.6. HTTP Timeouts
• 5.7. HTTP Persistent Connections (keep-alive)
• 5.8. HTTPS HostnameVerifier
• 5.9. HTTPS SSLSocketFactory
• 5.10. HTTP address in soap:address and import locations

6. Processing Large Data

• 6.1. Receiving large SOAP requests
• 6.2. Binary Attachments (MTOM)
• 6.3. Large Attachments

7. Metro Example Using a Web Container and NetBeans IDE

• 7.1. Registering GlassFish with the IDE
• 7.2. Creating a Web Service
• 7.3. Configuring Metro's WSIT Features in the Web Service
• 7.4. Deploying and Testing a Web Service
• 7.5. Creating a Client to Consume a WSIT-Enabled Web Service

8. Bootstrapping and Configuration

• 8.1. What is a Server-Side Endpoint?
• 8.2. Creating a Client from WSDL
• 8.3. Client From WSDL Examples

9. Message Optimization

• 9.1. Creating a MTOM Web Service
• 9.2. Configuring Message Optimization in a Web Service
• 9.3. Deploying and Testing a Web Service with Message Optimization Enabled
• 9.4. Creating a Client to Consume a Message Optimization-enabled Web Service
• 9.5. Message Optimization and Secure Conversation

10. SOAP/TCP Web Service transport

• 10.1. What is SOAP/TCP?
• 10.2. Creating a SOAP/TCP enabled Web Service
• 10.3. Configuring Web Service to be able to operate over SOAP/TCP transport
• 10.4. Deploying and Testing a Web Service with SOAP/TCP Transport Enabled
• 10.5. Creating a Client to Consume a SOAP/TCP-enabled Web Service
• 10.6. Configuring Web Service client to operate over SOAP/TCP transport

11. Using Reliable Messaging

• 11.1. Introduction to Reliable Messaging
• 11.2. Configuring Web Service Endpoint
• 11.3. Configuring Web Service Client
• 11.4. Creating Web Service Providers and Clients that use Reliable Messaging
• 11.5. Using Secure Conversation With Reliable Messaging

12. Using WSIT Security

• 12.1. Configuring Security Using NetBeans IDE
• 12.2. Summary of Configuration Requirements
• 12.3. Security Mechanisms
• 12.4. Configuring SSL and Authorized Users
• 12.5. Configuring Keystores and Truststores
• 12.6. Configuring Kerberos for Glassfish and Tomcat
• 12.7. Securing Operations and Messages
• 12.8. Configuring A Secure Token Service (STS)
• 12.9. Example Applications

13. WSIT Security Features: Advanced Topics

• 13.1. Using Security Mechanisms
• 13.2. Understanding WSIT Configuration Files
• 13.3. Security Mechanism Configuration Options

14. WSIT Example Using a Web Container Without NetBeans IDE

• 14.1. Environment Configuration Settings
• 14.2. WSIT Configuration and WS-Policy Assertions
• 14.3. Creating a Web Service without NetBeans
• 14.4. Building and Deploying the Web Service
• 14.5. Creating a Web Service Client
• 14.6. Building and Deploying a Client
• 14.7. Running a Web Service Client
• 14.8. Undeploying a Web Service

15. Accessing Metro Services Using WCF Clients

• 15.1. Creating a WCF Client

16. Data Contracts

• 16.1. Web Service - Start from Java
• 16.2. Web Service - Start from WSDL
• 16.3. Customizations for WCF Service WSDL
• 16.4. Developing a Microsoft .NET Client
• 16.5. BP 1.1 Conformance

17. Using Atomic Transactions

• 17.1. About the basicWSTX Example
• 17.2. Building, Deploying and Running the basicWSTX Example

18. Managing Policies

• 18.1. Managing Policies

19. Using Metro With Spring

• 19.1. Spring Introduction
• 19.2. Using Metro With Spring and NetBeans 6.1
• 19.3. Using Metro With Spring and NetBeans 6.5
• 19.4. Using WSIT Functionality With Spring

20. Further Information

• 20.1. Links to more information