FederatedConnection

   

---

FederatedConnection

javax.xml.registry

---

JAXR 1.0; JWSDP 1.0, J2EE 1.4

 public interface FederatedConnection extends javax.xml.registry.Connection { } 

A FederatedConnection is a Connection that represents a collection of other Connection s, some of which may also be FederatedConnection s. 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 FederatedConnection s 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( )

---