JavaTM API for XML Registries ("JAXR") 1.0 EA 

Contents

Please send feedback on this JAXR 1.0 EA release to jaxr-ri-feedback@sun.com.

JAXR API Overview

The JavaTM API for XML Registries (JAXR) provides a uniform and standard API for accessing different kinds of XML Registries. XML registries are an enabling infrastructure for building, deployment and discovery of web services.

Currently there are several overlapping specifications for XML registries. Examples include ISO 11179, OASIS, eCo Framework, ebXML, and the Universal Description, Discovery and Integration (UDDI) project. The JAXR API enables programmers to use a single, easy-to-use abstraction API to access a variety of XML registries. Simplicity and ease of use are facilitated within the JAXR API by a unified JAXR information model, which describes content and metadata within XML registries.

The current version of the JAXR specification includes detailed bindings between the JAXR information model and both the ebXML registry and the UDDI registry specifications.

Release Documentation

Configuring the JAXR RI

Set environment variables. You must set the following environment variable to use the JAXR RI, in addition to those required by the Java Web Services Developer Pack (Java WSDP):

In the rest of this document, <JAXR_HOME> and <CATALINA_HOME> both refer to <JWSDP_HOME>.

Set the classpath. To run a JAXR client, set your classpath to include the <JAXR_HOME>/common/lib directory and the JAR files in it.

Set properties. To set properties correctly for JAXR, do the following:

  1. Copy the file <JAXR_HOME>/docs/jaxr/sample.jaxr.properties to your home directory and rename it .jaxr.properties.

    Note: You can run the following class file to find out where your home directory is: 

    public class WhichHome {
    public static void main(String args[]) {
        System.out.println(System.getProperty("user.home"));
    }
}

  2. Open the .jaxr.properties file in an editor.

  3. Edit the line that begins with servletHost to point to your own system (usually localhost).

  4. If you are using the JAXR RI behind a firewall, you must also provide proxy information when your application is launched. Edit the lines that begin with http.proxyHost and https.proxyHost to point to your Web proxy server, and insert the correct proxyPort values.

  5. Edit the line that begins with tomcat.home to point to the <CATALINA_HOME> directory. Make sure this path is absolute, not relative (on a UNIX® system, do not use $HOME or $CATALINA_HOME).

Start Tomcat. You must start Tomcat in order to run JAXR clients, including the Registry Browser. See the Java Web Services Tutorial for instructions on how to do this.

Related Information