Java^TM API for XML Registries (JAXR) 1.0_03
Release Notes

Specification Version: 1.0
Reference Implementation (RI) Version: 1.0.6

For an updated, online version of these release notes, see Release Notes.

Revised: 2/11/07

Read This Section First
What This Release Includes
Setting Properties on JAXR Connections
Current Limitations
Known Issues

Read This Section First

Before you work with this release, make sure that you have installed the required software and are on a supported operating system. You can find this information in the Java^TM Web Services Developer Pack (Java WSDP) home page and Release Notes and the JAXR home page.

What This Release Includes

This release includes

The JAXR 2.0 Reference Implementation (RI) using JAXB 2.0
API documentation
Sample programs, including a Registry Browser

This release implements version 1.0 of the JAXR specification. The specification is available from the JAXR downloads page, http://java.sun.com/xml/downloads/jaxr.html.

The JAXR RI release contents are arranged in the following structure within the Java WSDP release:

Directory Name	Contents
`jaxr/bin`	Registry Browser scripts
`jaxr/docs`	Release documentation for the JAXR RI
`jaxr/lib`	JAR files used by the JAXR RI
`jaxr/samples`	Example code, including the Registry Browser. See Samples.html for details.
`<JAXR-RI_HOME>/javadocs/api`	API documentation for the JAXR RI

Setting Properties on JAXR Connections

The implementation of JAXR in the Java WSDP allows you to set a number of properties on a JAXR connection. Some of these are standard properties described in the JAXR specification. Others are implementation-specific properties. The following tables list and describe these properties.

**Standard Properties**
Property Name	Description	Data Type	Default Value
`javax.xml.registry.queryManagerURL`	Specifies the URL of the query manager service within the target registry provider	String	None
`javax.xml.registry.lifeCycleManagerURL`	Specifies the URL of the life cycle manager service within the target registry provider (for registry updates)	String	Same as the specified `queryManagerURL` value
`javax.xml.registry.semanticEquivalences`	Specifies semantic equivalences of concepts as one or more tuples of the ID values of two equivalent concepts separated by a comma; the tuples are separated by vertical bars: id1,id2\|id3,id4	String	None
`javax.xml.registry.security.authenticationMethod`	Provides a hint to the JAXR provider on the authentication method to be used for authenticating with the registry provider	String	None (`UDDI_GET_AUTHTOKEN` is the only supported value)
`javax.xml.registry.uddi.maxRows`	The maximum number of rows to be returned by find operations. Specific to UDDI providers	Integer	None
`javax.xml.registry.postalAddressScheme`	The ID of a ClassificationScheme to be used as the default postal address scheme	String	None

**Implementation-specific Properties**
Property Name	Description	Data Type	Default Value
`com.sun.xml.registry.http.proxyHost`	Specifies the HTTP proxy host to be used for accessing external registries	String	Proxy host value specified in the appropriate properties file.
`com.sun.xml.registry.http.proxyPort`	Specifies the HTTP proxy port to be used for accessing external registries; usually 8080	String	Proxy port value specified in the appropriate properties file.
`com.sun.xml.registry.https.proxyHost`	Specifies the HTTPS proxy host to be used for accessing external registries	String	Same as HTTP proxy host value
`com.sun.xml.registry.https.proxyPort`	Specifies the HTTPS proxy port to be used for accessing external registries; usually 8080	String	Same as HTTP proxy port value
`com.sun.xml.registry.http.proxyUserName`	Specifies the user name for the proxy host for HTTP proxy authentication, if one is required	String	None
`com.sun.xml.registry.http.proxyPassword`	Specifies the password for the proxy host for HTTP proxy authentication, if one is required	String	None
`com.sun.xml.registry.useCache`	Tells the JAXR implementation to look for registry objects in the cache first and then to look in the registry if not found	Boolean, passed in as String	True
`com.sun.xml.registry.userTaxonomyFilenames`	For details on setting this property, see the section "Using Taxonomies in JAXR Clients" in the Java Web Services Tutorial.	String	None

You can set these properties as follows:

Most of these properties must be set in a JAXR client program. For example:

Properties props = new Properties();
props.setProperty("javax.xml.registry.queryManagerURL",
    "http://test.uddi.com/testregistry/inquiryapi");
props.setProperty("javax.xml.registry.lifeCycleManagerURL", 
    "https://test.uddi.com/testregistry/publishapi");
ConnectionFactory factory = ConnectionFactory.newInstance();
factory.setProperties(props);
connection = factory.createConnection();

The postalAddressScheme and useCache properties may be set in a <sysproperty> tag in a build.xml file for the Ant tool. For example:
```
<sysproperty key="useCache" value="true"/>
```
These properties may also be set with the -D option on the java command line.

Current Limitations

The 2.0 release of the JAXR RI has the following limitations:

It implements the level 0 capability profile of the JAXR specification, not the level 1 capability profile. It is compatible with Version 2 of the Universal Description, Discovery and Integration (UDDI) specification.

It supports access to UDDI registries but not to ebXML registries. More specifically, it supports access to Version 2 UDDI registries but not to Version 1 UDDI registries. This release of the Java WSDP includes Service Registry 3.0 EA, an ebXML registry, repository, and JAXR provider. See the Service Registry documentation for details.

It does not implement the optional DeclarativeQueryManager interface.

It does not provide a preconfigured connection factory that can be placed in a Java Naming and Directory Interface^TM (JNDI) API namespace.

It allows a SpecificationLink object to have no more than one usage parameter, which must be no more than 255 characters in length. (See Section D.6.3.1 of the JAXR Specification.)

Known Issues

At this release, the JAXR RI has no known issues.