public interface FederatedConnection extends javax.xml.registry.Connection {
}
A FederatedConnection is a
Connection that represents a collection of other
Connections, some of which may also be
FederatedConnections. The
FederatedConnection interface defines exactly the
same methods as Connection, but differs in the
following respects:
It is created by calling the createFederatedConnection(
) method of ConnectionFactory, which
requires a Collection containing the
Connection objects that will be grouped together
by the FederatedConnection.
When a request is made of a QueryManager obtained
from a RegistryService corresponding to a
FederatedConnection, the query is sent to all of
the individual registries and the results are combined into a single
BulkResponse, thus allowing the set of registries
to be treated as one.
Updates to multiple registries grouped into a
FederatedConnection are not allowed. An attempt to
get a reference to a LifeCycleManager using the
methods of a RegistryService corresponding to a
FederatedConnection results in an
UnsupportedCapabilityException.
JAXR providers are not required to support
FederatedConnections despite the fact that it is a
level 0 feature, although this may change in a future revision of the
JAXR specification. Such providers throw an
UnsupportedCapabilityException from the
createFederatedConnection( ) method of its
ConnectionFactory method.
