Preface

This preface describes the document accessibility features and conventions used in this guide—Extensibility Guide for Oracle Web Services Manager.

Intended Audience

This manual is intended for software developers who are interested in creating custom assertions for Web services.

This document describes the following:

About Policies and Assertions

Learn about predefined policies and assertions

For more information, see "Predefined Policies and Assertions" and "About Custom Assertions".
Learn about parts and types of custom assertions

For more information, see "Policies, Assertions, Expressions, and Operators" and "Types of Custom Assertions".
Review the rules and restrictions about categories and bindings

For more information, see"Understanding Assertion Categories" and "Rules for Binding of Custom Assertions".
Review the lifecycle of a custom assertion

For more information, see"Life Cycle of a Custom Assertion".
Understand the types of custom assertions

For more information, see"Types of Custom Assertions".

Creation of Custom Assertions

Review the naming conventions for policies and assertions

For more information, see "Naming Conventions for Policies and Assertions".
Create the custom assertions

For more information, see "Developing Custom Assertions for Web Service".
Test the custom assertion

For more information, see "Testing the Web Service".
Generate a client policy from a Web service policy created using custom assertions

For more information, see "Creating a Custom Client Policy with Custom Assertions".

Code Examples

Advanced Topics

Implement advanced features:
- input parameters to the assertion
- access Oracle WSM context properties
- access request, response, and fault message objects
- access specific parts of a message based on XPath
- access certificate used by container for SSL
- access transport properties such as HTTP requests and responses
- access CSF keys
For more information, see "Implementing Advanced Features in Custom Assertions".
Handling exceptions

For more information, see "Handling Exceptions in Custom Assertions".

References

XML schema for creating custom assertions

For more information, see "Schema Reference for Custom Assertions".
Java API reference for Oracle WSM

For more information, see Java API Reference for Oracle Web Services Manager.

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

The following text conventions are used in this document:

Convention	Meaning
boldface	Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.
italic	Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.
`monospace`	Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.