- java.lang.Object
-
- javax.xml.registry.ConnectionFactory
-
public abstract class ConnectionFactory extends Object
This is the abstract base class for factory classes for creating a JAXR connection. A JAXR ConnectionFactory object is configured in a provider-specific way to create connections with registry providers.Looking Up a ConnectionFactory Using the JNDI API
The preferred way for a client to look up a JAXR ConnectionFactory is within the Java Naming and Directory InterfaceTM (JNDI) API. A ConnectionFactory object is registered with a naming service in a provider specific way, such as one based on the JNDI API. This registration associates the ConnectionFactory object with a logical name. When an application wants to establish a connection with the provider associated with that ConnectionFactory object, it does a lookup, providing the logical name. The application can then use the ConnectionFactory object that is returned to create a connection to the messaging provider.Looking Up a ConnectionFactory Without Using the JNDI API
The JAXR API provides an alternative way to look up a JAXR ConnectionFactory that does not require the use of the JNDI API. This is done using the newInstance static method on the abstract class ConnectionFactory provided in the JAXR API. The newInstance method returns a JAXR ConnectionFactory. The client may indicate which factory class should be instantiated by the newInstance method by defining the system property javax.xml.registry.ConnectionFactoryClass. If this property is not set, the JAXR provider must return a default ConnectionFactory instance.- Author:
- Farrukh S. Najmi
- See Also:
Connection
-
-
Constructor Summary
Constructors Constructor and Description ConnectionFactory()
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method and Description abstract Connection
createConnection()
Create a named connection.abstract FederatedConnection
createFederatedConnection(Collection connections)
Create a FederatedConnection.abstract Properties
getProperties()
Gets the Properties used during createConnection and createFederatedConnection calls.static ConnectionFactory
newInstance()
Creates a defaultConnectionFactory
object.abstract void
setProperties(Properties properties)
Sets the Properties used during createConnection and createFederatedConnection calls.
-
-
-
Method Detail
-
setProperties
public abstract void setProperties(Properties properties) throws JAXRException
Sets the Properties used during createConnection and createFederatedConnection calls.- Standard Connection Properties:
javax.xml.registry.queryManagerURL
- URL String for the query manager service within the target registry providerjavax.xml.registry.lifeCycleManagerURL
- URL String for the life cycle manager service within the target registry provider. If unspecified, must default to value of the queryManagerURL described abovejavax.xml.registry.semanticEquivalences
- String that allows specification of semantic equivalencesjavax.xml.registry.security.authenticationMethod
- string that provides a hint to the JAXR provider on the authentication method to be used when authenticating with the registry provider. Possible value include but are not limited to "UDDI_GET_AUTHTOKEN", "HTTP_BASIC", "CLIENT_CERTIFICATE", "MS_PASSPORT"javax.xml.registry.uddi.maxRows
- integer that specifies the maximum number of rows to be returned for find operations. This property is specific for UDDI providersjavax.xml.registry.postalAddressScheme
- String that specifies the id of a ClassificationScheme that is used as the default postal address scheme for this connection
- Capability Level: 0
- Parameters:
properties
- configuration properties that are either specified by JAXR specification or are provider specific.- Throws:
JAXRException
- If the JAXR provider encounters an internal error
-
getProperties
public abstract Properties getProperties() throws JAXRException
Gets the Properties used during createConnection and createFederatedConnection calls.- Capability Level: 0
- Returns:
- the Properties defined for this object
- Throws:
JAXRException
- If the JAXR provider encounters an internal error
-
createConnection
public abstract Connection createConnection() throws JAXRException
Create a named connection. Such a connection can be used to communicate with a JAXR provider.- Capability Level: 0
- Returns:
- the Connection created by this call
- Throws:
JAXRException
- If the JAXR provider encounters an internal error
-
createFederatedConnection
public abstract FederatedConnection createFederatedConnection(Collection connections) throws JAXRException
Create a FederatedConnection.- Capability Level: 0 (optional)
- Parameters:
connections
- Is a Collection of Connection objects. Note that Connection objects may also be FederatedConnection objects.- Returns:
- the FederatedConnection created by this call
- Throws:
JAXRException
- If the JAXR provider encounters an internal error
-
newInstance
public static ConnectionFactory newInstance() throws JAXRException
Creates a defaultConnectionFactory
object.- Returns:
- a new instance of a
ConnectionFactory
- Throws:
JAXRException
- If the JAXR provider encounters an internal error
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/xml/registry/ConnectionFactory.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.