Java Web Services in a Nutshell

Name

FederatedConnection

Synopsis

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.

Returned By

ConnectionFactory.createFederatedConnection( )