About This Tutorial

Who Should Use This Tutorial

Prerequisites

How to Use This Tutorial

Building the Examples

Further Information

How to Print This Tutorial

Typographical Conventions

Feedback

Chapter 1:   Binding XML Schema to Java Classes with JAXB

JAXB Architecture

Architectural Overview

The JAXB Binding Process

JAXB Binding Framework

More About javax.xml.bind

More About Unmarshalling

More About Marshalling

More About Validation

XML Schemas

Representing XML Content

Binding XML Names to Java Identifiers

Java Representation of XML Schema

Binding XML Schemas

Simple Type Definitions

Default Data Type Bindings

Default Binding Rules Summary

Customizing JAXB Bindings

Scope

Scope Inheritance

What is Not Supported

JAXB APIs and Tools

Chapter 2:   Using JAXB

General Usage Instructions

Description

Using the Examples

Configuring and Running the Samples

JAXB Compiler Options

About the Schema-to-Java Bindings

Schema-Derived JAXB Classes

Basic Examples

Unmarshal Read Example

Modify Marshal Example

Create Marshal Example

Unmarshal Validate Example

Validate-On-Demand Example

Customizing JAXB Bindings

Why Customize?

Customization Overview

Customize Inline Example

Datatype Converter Example

External Customize Example

Fix Collides Example

Bind Choice Example

Chapter 3:   Securing JAX-RPC Applications with XML and Web Services Security

Does XWS-Security Implement Any Specifications?

On Which Technologies Is XWS-Security Based?

What is the XWS-Security Framework?

Configuring Security Configuration Files

Understanding Security Configuration Files

XWS-Security Configuration File Schema

Semantics of Security Configuration File Elements

How Do I Specify the Security Configuration for the Build Files?

Are There Any Sample Applications Demonstrating XWS-Security?

Setting Up To Use XWS-Security With the Sample Applications

Setting System Properties

Configuring a JCE Provider

Setting Up the Application Server For the Examples

Keystore and Truststore Files with XWS-Security

Setting Build Properties

Understanding and Running the Simple Sample Application

Plugging in Security Configurations

Sample Security Configuration File Options

Running the Simple Sample Application

Understanding and Running the JAAS-Sample Application

Understanding JAAS-Sample Security Configuration Files

Setting Up For the JAAS-Sample

Running the JAAS-Sample Application

Writing SecurityEnvironmentHandlers for XWS-Security Applications

Using the SubjectAccessor API

Useful XWS-Security Command-Line Tools

pkcs12import

keyexport

wscompile

Troubleshooting XWS-Security Applications

Further Information

Chapter 4:   Java XML Digital Signature API

How XWS-Security and XML Digital Signature API Are Related

XML Security Stack

Package Hierarchy

Service Providers

Introduction to XML Signatures

Example of an XML Signature

XML Digital Signature API Examples

validate Example

genenveloped Example

Appendix A:   The Java WSDP Registry Server

Starting the Registry Server

Changing the Port for the Registry Server

Adding and Deleting Users

Adding a New User to the Registry

Deleting a User from the Registry

Further Information

Appendix B:   Registry Browser

Starting the Browser

Querying a Registry

Querying by Name

Querying by Classification

Managing Registry Data

Adding an Organization

Adding Services to an Organization

Adding Service Bindings to a Service

Adding and Removing Classifications

Submitting the Data

Deleting an Organization

Stopping the Browser

Appendix C:   XWS-Security Formal Schema Definition

Formal Schema Definition

Index