Preface

The Service Registry 3.1 Developer's Guide describes how to use the Java^TM API for XML Registries (JAXR) to query Service Registry (“the Registry”) and to publish content to it.

Service Registry is an ebXML Registry: a federated registry and repository that manages all types of electronic content described by standard and extensible metadata. It provides federated, secure information management of Service Oriented Architecture (SOA) and other content and metadata. It supports the ebXML Registry 3.0 and UDDI 3.0 registry protocols.

Who Should Use This Book

The Developer's Guide is intended for applications programmers who plan to develop JAXR clients that search the Registry and that publish content to the Registry.

This guide assumes you are familiar with the following:

• The Java programming language

• The basic concepts of the ebXML Registry and Repository specifications

Before You Read This Book

You should be familiar with the basic concepts of these specifications:

• ebXML Registry Information Model Version 3.0

• ebXML Registry Services and Protocols Version 3.0

As you develop code, you can use the Web Console provided with the Service Registry software to verify that your code is working correctly. Read the Service Registry 3.1 User’s Guide to familiarize yourself with the Web Console.

Service Registry is a component of Sun Java Enterprise System (“Java ES”), a software infrastructure that supports enterprise applications distributed across a network or Internet environment. You should be familiar with the Java ES* documentation at http://docs.sun.com/coll/1286.2.

How This Book Is Organized

The contents of this book are as follows:

Chapter 1, Overview of JAXR provides a brief overview of JAXR.

Chapter 2, Setting Up a JAXR Client describes the first steps to follow to implement a JAXR client that can perform queries and updates to the Service Registry.

Chapter 3, Querying a Registry describes the interfaces and methods JAXR provides for querying a registry.

Chapter 4, Publishing Objects to the Registry describes how to publish objects to the Registry.

Chapter 5, Managing Objects in the Registry describes how to perform operations on objects in the registry, such as deleting objects and changing their state.

Chapter 6, Developing Client Programs for the UDDI Interface describes how to develop Java client programs that enable you to use UDDI queries to search the Registry.

Chapter 7, Troubleshooting describes solutions to some problems that you can encounter when using JAXR with Service Registry.

Appendix A, Canonical Constants lists constants that you can use to search for objects by their unique identifiers.

Service Registry Documentation Set

The Service Registry documentation set is available at http://docs.sun.com/app/docs/coll/1314.2. To learn about Service Registry, refer to the books listed in the following table.

Related Books

When you install Service Registry, it is deployed to the Sun Java System Application Server. For information about administering Application Server, refer to Sun Java System Application Server Enterprise Edition 8.2 Administration Guide.

The Java ES documentation set describes deployment planning and system installation. The URL for system documentation is http://docs.sun.com/coll/1286.2. For an introduction to Java ES, refer to the books in the order in which they are listed in the following table.

The URL for all documentation about Java ES and its components is http://docs.sun.com/prod/entsys.5.

Default Paths and File Names

The following table describes the default paths and file names that are used in this book.

Typographic Conventions

The following table describes the typographic changes that are used in this book.

Shell Prompts in Command Examples

The following table shows default system prompts and superuser prompts.

Symbol Conventions

The following table explains symbols that might be used in this book.

Documentation, Support, and Training

The Sun web site provides information about the following additional resources:

• Documentation (http://www.sun.com/documentation/)

• Support (http://www.sun.com/support/)

• Training (http://www.sun.com/training/)

Searching Sun Product Documentation

Besides searching Sun product documentation from the docs.sun.com^SM web site, you can use a search engine by typing the following syntax in the search field:

search-term site:docs.sun.com

For example, to search for “broker,” type the following:

broker site:docs.sun.com

To include other Sun web sites in your search (for example, java.sun.com, www.sun.com, and developers.sun.com), use sun.com in place of docs.sun.com in the search field.

Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 819-4638.