RegistryService

   

---

RegistryService

javax.xml.registry

---

JAXR 1.0; JWSDP 1.0, J2EE 1.4

 public interface RegistryService {  // Property Accessor Methods (by property name)  public abstract BusinessLifeCycleManager getBusinessLifeCycleManager(  )        throws JAXRException;  // L0  public abstract BusinessQueryManager getBusinessQueryManager(  )        throws JAXRException;  // L0  public abstract CapabilityProfile getCapabilityProfile(  )        throws JAXRException;  // L0  public abstract DeclarativeQueryManager getDeclarativeQueryManager(  )         throws JAXRExceptionUnsupportedCapabilityException;  // L1  public abstract javax.xml.registry.infomodel.ClassificationScheme getDefaultPostalScheme(  )         throws JAXRException;  // L0   // Public Instance Methods  public abstract BulkResponse getBulkResponse(String   requestId   )        throws InvalidRequestExceptionJAXRException;  // L0  public abstract String makeRegistrySpecificRequest(String   request   )        throws JAXRException;  // L0  } 

This interface provides methods that are used to access the principal services provided by a registry provider. To obtain a RegistryService object, first get a Connection or FederatedConnection from a ConnectionFactory , then call its getRegistryService( ) method.

The most important methods in this interface are getBusinessQueryManager( ) and getBusinessLifeCycleManager( ) . The former returns a BusinessQueryManager object associated with the registry whose URL is given by the javax.xml.registry.queryManagerURL property of the ConnectionFactory used when creating the RegistryService . BusinessQueryManager lets you query the content of the registry. The latter method returns a BusinessLifeCycleManager that can be used to make changes to the registry whose URL is given by the javax.xml.registry.lifeCycleManagerURL property. The getDeclarativeQueryManager method, which is supported only by level 1 providers, returns an object that you can use to form and send queries expressed in a query language such as SQL-92 or the ebXML filter query language.

The getCapabilityProfile( ) method returns an object that can be used to find out which version of the JAXR specification the provider implements and its capability level. The getDefaultPostalScheme( ) method returns a ClassificationScheme that describes the mapping of fields in a postal address as used within the registry to the fields of the generic postal address used by the JAXR provider itself. Refer to Chapter 7 for a discussion of postal addresses. The getBulkResponse( ) method is supplied the unique identifier of a previously initiated asynchronous request, and returns the BulkResponse that contains the responses from that request, which may still be in progress and therefore incomplete. See the description of the BulkResponse for a discussion of asynchronous request handling. The makeRegistrySpecificRequest( ) method can be used to send a request expressed as an XML message in the format expected by the target registry, and to receive the XML response.

Returned By

javax.xml.registry.Connection.getRegistryService( ) , LifeCycleManager.getRegistryService( ) , QueryManager.getRegistryService( )

---