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.
