tomee-8.0/javadoc/javax/xml/registry/ConnectionFactory.html - tomee-site-pub - Git at Google

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <!-- NewPage -->
 <html lang="en">
 <head>
 <title>ConnectionFactory</title>
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
             parent.document.title="ConnectionFactory";
         }
     }
     catch(err) {
     }
 //-->
 var methods = {"i0":6,"i1":6,"i2":6,"i3":9,"i4":6};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
 var tableTab = "tableTab";
 var activeTableTab = "activeTableTab";
 </script>
 <noscript>
 <div>JavaScript is disabled on your browser.</div>
 </noscript>
 <!-- ========= START OF TOP NAVBAR ======= -->
 <div class="topNav"><a name="navbar.top">
 <!--   -->
 </a>
 <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
 <a name="navbar.top.firstrow">
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
 <li><a href="../../../overview-summary.html">Overview</a></li>
 <li><a href="package-summary.html">Package</a></li>
 <li class="navBarCell1Rev">Class</li>
 <li><a href="package-tree.html">Tree</a></li>
 <li><a href="../../../deprecated-list.html">Deprecated</a></li>
 <li><a href="../../../index-all.html">Index</a></li>
 <li><a href="../../../help-doc.html">Help</a></li>
 </ul>
 </div>
 <div class="subNav">
 <ul class="navList">
 <li><a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
 <li><a href="../../../javax/xml/registry/DeclarativeQueryManager.html" title="interface in javax.xml.registry"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
 </ul>
 <ul class="navList">
 <li><a href="../../../index.html?javax/xml/registry/ConnectionFactory.html" target="_top">Frames</a></li>
 <li><a href="ConnectionFactory.html" target="_top">No&nbsp;Frames</a></li>
 </ul>
 <ul class="navList" id="allclasses_navbar_top">
 <li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
 </ul>
 <div>
 <script type="text/javascript"><!--
   allClassesLink = document.getElementById("allclasses_navbar_top");
   if(window==top) {
     allClassesLink.style.display = "block";
   }
   else {
     allClassesLink.style.display = "none";
   }
   //-->
 </script>
 </div>
 <div>
 <ul class="subNavList">
 <li>Summary:&nbsp;</li>
 <li>Nested&nbsp;|&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.summary">Method</a></li>
 </ul>
 <ul class="subNavList">
 <li>Detail:&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.detail">Method</a></li>
 </ul>
 </div>
 <a name="skip.navbar.top">
 <!--   -->
 </a></div>
 <!-- ========= END OF TOP NAVBAR ========= -->
 <!-- ======== START OF CLASS DATA ======== -->
 <div class="header">
 <div class="subTitle">javax.xml.registry</div>
 <h2 title="Class ConnectionFactory" class="title">Class ConnectionFactory</h2>
 </div>
 <div class="contentContainer">
 <ul class="inheritance">
 <li>java.lang.Object</li>
 <li>
 <ul class="inheritance">
 <li>javax.xml.registry.ConnectionFactory</li>
 </ul>
 </li>
 </ul>
 <div class="description">
 <ul class="blockList">
 <li class="blockList">
 <hr>
 <br>
 <pre>public abstract class <span class="typeNameLabel">ConnectionFactory</span>
 extends java.lang.Object</pre>
 <div class="block">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.

  <h2>Looking Up a ConnectionFactory Using the JNDI API</h2>
  The preferred way for a client to look up a JAXR ConnectionFactory is within the Java Naming and Directory Interface<sup><font size="-2">TM</font></sup> (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.

  <h2>Looking Up a ConnectionFactory Without Using the JNDI API</h2>
  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.</div>
 <dl>
 <dt><span class="seeLabel">See Also:</span></dt>
 <dd><a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry"><code>Connection</code></a></dd>
 </dl>
 </li>
 </ul>
 </div>
 <div class="summary">
 <ul class="blockList">
 <li class="blockList">
 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
 <ul class="blockList">
 <li class="blockList"><a name="constructor.summary">
 <!--   -->
 </a>
 <h3>Constructor Summary</h3>
 <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
 <caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
 <tr>
 <th class="colOne" scope="col">Constructor and Description</th>
 </tr>
 <tr class="altColor">
 <td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#ConnectionFactory--">ConnectionFactory</a></span>()</code>&nbsp;</td>
 </tr>
 </table>
 </li>
 </ul>
 <!-- ========== METHOD SUMMARY =========== -->
 <ul class="blockList">
 <li class="blockList"><a name="method.summary">
 <!--   -->
 </a>
 <h3>Method Summary</h3>
 <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
 <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
 <tr>
 <th class="colFirst" scope="col">Modifier and Type</th>
 <th class="colLast" scope="col">Method and Description</th>
 </tr>
 <tr id="i0" class="altColor">
 <td class="colFirst"><code>abstract <a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry">Connection</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#createConnection--">createConnection</a></span>()</code>
 <div class="block">Create a named connection.</div>
 </td>
 </tr>
 <tr id="i1" class="rowColor">
 <td class="colFirst"><code>abstract <a href="../../../javax/xml/registry/FederatedConnection.html" title="interface in javax.xml.registry">FederatedConnection</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#createFederatedConnection-java.util.Collection-">createFederatedConnection</a></span>(java.util.Collection&nbsp;connections)</code>
 <div class="block">Create a FederatedConnection.</div>
 </td>
 </tr>
 <tr id="i2" class="altColor">
 <td class="colFirst"><code>abstract java.util.Properties</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#getProperties--">getProperties</a></span>()</code>
 <div class="block">Gets the Properties used during createConnection
  and createFederatedConnection calls.</div>
 </td>
 </tr>
 <tr id="i3" class="rowColor">
 <td class="colFirst"><code>static <a href="../../../javax/xml/registry/ConnectionFactory.html" title="class in javax.xml.registry">ConnectionFactory</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#newInstance--">newInstance</a></span>()</code>
 <div class="block">Creates a default <code>ConnectionFactory</code> object.</div>
 </td>
 </tr>
 <tr id="i4" class="altColor">
 <td class="colFirst"><code>abstract void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#setProperties-java.util.Properties-">setProperties</a></span>(java.util.Properties&nbsp;properties)</code>
 <div class="block">Sets the Properties used during createConnection
  and createFederatedConnection calls.</div>
 </td>
 </tr>
 </table>
 <ul class="blockList">
 <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
 <!--   -->
 </a>
 <h3>Methods inherited from class&nbsp;java.lang.Object</h3>
 <code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
 </ul>
 </li>
 </ul>
 </li>
 </ul>
 </div>
 <div class="details">
 <ul class="blockList">
 <li class="blockList">
 <!-- ========= CONSTRUCTOR DETAIL ======== -->
 <ul class="blockList">
 <li class="blockList"><a name="constructor.detail">
 <!--   -->
 </a>
 <h3>Constructor Detail</h3>
 <a name="ConnectionFactory--">
 <!--   -->
 </a>
 <ul class="blockListLast">
 <li class="blockList">
 <h4>ConnectionFactory</h4>
 <pre>public&nbsp;ConnectionFactory()</pre>
 </li>
 </ul>
 </li>
 </ul>
 <!-- ============ METHOD DETAIL ========== -->
 <ul class="blockList">
 <li class="blockList"><a name="method.detail">
 <!--   -->
 </a>
 <h3>Method Detail</h3>
 <a name="setProperties-java.util.Properties-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>setProperties</h4>
 <pre>public abstract&nbsp;void&nbsp;setProperties(java.util.Properties&nbsp;properties)
                             throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
 <div class="block">Sets the Properties used during createConnection
  and createFederatedConnection calls.
  <p>
  <DD><DL>
  <DT>
  <B>Standard Connection Properties:</B>
  <DD><CODE>javax.xml.registry.queryManagerURL</CODE> - URL String for the query manager service within the target registry provider
  <DD><CODE>javax.xml.registry.lifeCycleManagerURL</CODE> - URL String for the life cycle manager service within the target registry provider. If unspecified, must default to value of the queryManagerURL described above
  <DD><CODE>javax.xml.registry.semanticEquivalences</CODE> - String that allows specification of semantic equivalences
  <DD><CODE>javax.xml.registry.security.authenticationMethod</CODE> - 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"
  <DD><CODE>javax.xml.registry.uddi.maxRows</CODE> - integer that specifies the maximum number of rows to be returned for find operations. This property is specific for UDDI providers
  <DD><CODE>javax.xml.registry.postalAddressScheme</CODE> - String that specifies the id of a ClassificationScheme that is used as the default postal address scheme for this connection
  </DL>
  <p><DL><DT><B>Capability Level: 0 </B></DL></div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>properties</code> - configuration properties that are either
         specified by JAXR specification or are provider specific.</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
 </dl>
 </li>
 </ul>
 <a name="getProperties--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>getProperties</h4>
 <pre>public abstract&nbsp;java.util.Properties&nbsp;getProperties()
                                             throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
 <div class="block">Gets the Properties used during createConnection
  and createFederatedConnection calls.

  <p><DL><DT><B>Capability Level: 0 </B></DL></div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the Properties defined for this object</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
 </dl>
 </li>
 </ul>
 <a name="createConnection--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>createConnection</h4>
 <pre>public abstract&nbsp;<a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry">Connection</a>&nbsp;createConnection()
                                      throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
 <div class="block">Create a named connection. Such a connection can be used to
  communicate with a JAXR provider.

  <p><DL><DT><B>Capability Level: 0 </B></DL></div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the Connection created by this call</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
 </dl>
 </li>
 </ul>
 <a name="createFederatedConnection-java.util.Collection-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>createFederatedConnection</h4>
 <pre>public abstract&nbsp;<a href="../../../javax/xml/registry/FederatedConnection.html" title="interface in javax.xml.registry">FederatedConnection</a>&nbsp;createFederatedConnection(java.util.Collection&nbsp;connections)
                                                        throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
 <div class="block">Create a FederatedConnection.

  <p><DL><DT><B>Capability Level: 0 (optional) </B></DL></div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>connections</code> - Is a Collection of Connection objects. Note that
  Connection objects may also be FederatedConnection objects.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the FederatedConnection created by this call</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
 </dl>
 </li>
 </ul>
 <a name="newInstance--">
 <!--   -->
 </a>
 <ul class="blockListLast">
 <li class="blockList">
 <h4>newInstance</h4>
 <pre>public static&nbsp;<a href="../../../javax/xml/registry/ConnectionFactory.html" title="class in javax.xml.registry">ConnectionFactory</a>&nbsp;newInstance()
                                      throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
 <div class="block">Creates a default <code>ConnectionFactory</code> object.</div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>a new instance of a <code>ConnectionFactory</code></dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
 </dl>
 </li>
 </ul>
 </li>
 </ul>
 </li>
 </ul>
 </div>
 </div>
 <!-- ========= END OF CLASS DATA ========= -->
 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 <div class="bottomNav"><a name="navbar.bottom">
 <!--   -->
 </a>
 <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
 <a name="navbar.bottom.firstrow">
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
 <li><a href="../../../overview-summary.html">Overview</a></li>
 <li><a href="package-summary.html">Package</a></li>
 <li class="navBarCell1Rev">Class</li>
 <li><a href="package-tree.html">Tree</a></li>
 <li><a href="../../../deprecated-list.html">Deprecated</a></li>
 <li><a href="../../../index-all.html">Index</a></li>
 <li><a href="../../../help-doc.html">Help</a></li>
 </ul>
 </div>
 <div class="subNav">
 <ul class="navList">
 <li><a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
 <li><a href="../../../javax/xml/registry/DeclarativeQueryManager.html" title="interface in javax.xml.registry"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
 </ul>
 <ul class="navList">
 <li><a href="../../../index.html?javax/xml/registry/ConnectionFactory.html" target="_top">Frames</a></li>
 <li><a href="ConnectionFactory.html" target="_top">No&nbsp;Frames</a></li>
 </ul>
 <ul class="navList" id="allclasses_navbar_bottom">
 <li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
 </ul>
 <div>
 <script type="text/javascript"><!--
   allClassesLink = document.getElementById("allclasses_navbar_bottom");
   if(window==top) {
     allClassesLink.style.display = "block";
   }
   else {
     allClassesLink.style.display = "none";
   }
   //-->
 </script>
 </div>
 <div>
 <ul class="subNavList">
 <li>Summary:&nbsp;</li>
 <li>Nested&nbsp;|&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.summary">Method</a></li>
 </ul>
 <ul class="subNavList">
 <li>Detail:&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.detail">Method</a></li>
 </ul>
 </div>
 <a name="skip.navbar.bottom">
 <!--   -->
 </a></div>
 <!-- ======== END OF BOTTOM NAVBAR ======= -->
 </body>
 </html>
	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	<!-- NewPage -->
	<html lang="en">
	<head>
	<title>ConnectionFactory</title>
	<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
	<script type="text/javascript" src="../../../script.js"></script>
	</head>
	<body>
	<script type="text/javascript"><!--
	try {
	if (location.href.indexOf('is-external=true') == -1) {
	parent.document.title="ConnectionFactory";
	}
	}
	catch(err) {
	}
	//-->
	var methods = {"i0":6,"i1":6,"i2":6,"i3":9,"i4":6};
	var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]};
	var altColor = "altColor";
	var rowColor = "rowColor";
	var tableTab = "tableTab";
	var activeTableTab = "activeTableTab";
	</script>
	<noscript>
	<div>JavaScript is disabled on your browser.</div>
	</noscript>
	<!-- ========= START OF TOP NAVBAR ======= -->
	<div class="topNav"><a name="navbar.top">
	<!-- -->
	</a>
	<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
	<a name="navbar.top.firstrow">
	<!-- -->
	</a>
	<ul class="navList" title="Navigation">
	<li><a href="../../../overview-summary.html">Overview</a></li>
	<li><a href="package-summary.html">Package</a></li>
	<li class="navBarCell1Rev">Class</li>
	<li><a href="package-tree.html">Tree</a></li>
	<li><a href="../../../deprecated-list.html">Deprecated</a></li>
	<li><a href="../../../index-all.html">Index</a></li>
	<li><a href="../../../help-doc.html">Help</a></li>
	</ul>
	</div>
	<div class="subNav">
	<ul class="navList">
	<li><a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry"><span class="typeNameLink">Prev Class</span></a></li>
	<li><a href="../../../javax/xml/registry/DeclarativeQueryManager.html" title="interface in javax.xml.registry"><span class="typeNameLink">Next Class</span></a></li>
	</ul>
	<ul class="navList">
	<li><a href="../../../index.html?javax/xml/registry/ConnectionFactory.html" target="_top">Frames</a></li>
	<li><a href="ConnectionFactory.html" target="_top">No Frames</a></li>
	</ul>
	<ul class="navList" id="allclasses_navbar_top">
	<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
	</ul>
	<div>
	<script type="text/javascript"><!--
	allClassesLink = document.getElementById("allclasses_navbar_top");
	if(window==top) {
	allClassesLink.style.display = "block";
	}
	else {
	allClassesLink.style.display = "none";
	}
	//-->
	</script>
	</div>
	<div>
	<ul class="subNavList">
	<li>Summary: </li>
	<li>Nested \| </li>
	<li>Field \| </li>
	<li><a href="#constructor.summary">Constr</a> \| </li>
	<li><a href="#method.summary">Method</a></li>
	</ul>
	<ul class="subNavList">
	<li>Detail: </li>
	<li>Field \| </li>
	<li><a href="#constructor.detail">Constr</a> \| </li>
	<li><a href="#method.detail">Method</a></li>
	</ul>
	</div>
	<a name="skip.navbar.top">
	<!-- -->
	</a></div>
	<!-- ========= END OF TOP NAVBAR ========= -->
	<!-- ======== START OF CLASS DATA ======== -->
	<div class="header">
	<div class="subTitle">javax.xml.registry</div>
	<h2 title="Class ConnectionFactory" class="title">Class ConnectionFactory</h2>
	</div>
	<div class="contentContainer">
	<ul class="inheritance">
	<li>java.lang.Object</li>
	<li>
	<ul class="inheritance">
	<li>javax.xml.registry.ConnectionFactory</li>
	</ul>
	</li>
	</ul>
	<div class="description">
	<ul class="blockList">
	<li class="blockList">
	<hr>
	<br>
	<pre>public abstract class <span class="typeNameLabel">ConnectionFactory</span>
	extends java.lang.Object</pre>
	<div class="block">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.

	<h2>Looking Up a ConnectionFactory Using the JNDI API</h2>
	The preferred way for a client to look up a JAXR ConnectionFactory is within the Java Naming and Directory Interface<sup><font size="-2">TM</font></sup> (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.

	<h2>Looking Up a ConnectionFactory Without Using the JNDI API</h2>
	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.</div>
	<dl>
	<dt><span class="seeLabel">See Also:</span></dt>
	<dd><a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry"><code>Connection</code></a></dd>
	</dl>
	</li>
	</ul>
	</div>
	<div class="summary">
	<ul class="blockList">
	<li class="blockList">
	<!-- ======== CONSTRUCTOR SUMMARY ======== -->
	<ul class="blockList">
	<li class="blockList"><a name="constructor.summary">
	<!-- -->
	</a>
	<h3>Constructor Summary</h3>
	<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
	<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
	<tr>
	<th class="colOne" scope="col">Constructor and Description</th>
	</tr>
	<tr class="altColor">
	<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#ConnectionFactory--">ConnectionFactory</a></span>()</code> </td>
	</tr>
	</table>
	</li>
	</ul>
	<!-- ========== METHOD SUMMARY =========== -->
	<ul class="blockList">
	<li class="blockList"><a name="method.summary">
	<!-- -->
	</a>
	<h3>Method Summary</h3>
	<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
	<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span></caption>
	<tr>
	<th class="colFirst" scope="col">Modifier and Type</th>
	<th class="colLast" scope="col">Method and Description</th>
	</tr>
	<tr id="i0" class="altColor">
	<td class="colFirst"><code>abstract <a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry">Connection</a></code></td>
	<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#createConnection--">createConnection</a></span>()</code>
	<div class="block">Create a named connection.</div>
	</td>
	</tr>
	<tr id="i1" class="rowColor">
	<td class="colFirst"><code>abstract <a href="../../../javax/xml/registry/FederatedConnection.html" title="interface in javax.xml.registry">FederatedConnection</a></code></td>
	<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#createFederatedConnection-java.util.Collection-">createFederatedConnection</a></span>(java.util.Collection connections)</code>
	<div class="block">Create a FederatedConnection.</div>
	</td>
	</tr>
	<tr id="i2" class="altColor">
	<td class="colFirst"><code>abstract java.util.Properties</code></td>
	<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#getProperties--">getProperties</a></span>()</code>
	<div class="block">Gets the Properties used during createConnection
	and createFederatedConnection calls.</div>
	</td>
	</tr>
	<tr id="i3" class="rowColor">
	<td class="colFirst"><code>static <a href="../../../javax/xml/registry/ConnectionFactory.html" title="class in javax.xml.registry">ConnectionFactory</a></code></td>
	<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#newInstance--">newInstance</a></span>()</code>
	<div class="block">Creates a default <code>ConnectionFactory</code> object.</div>
	</td>
	</tr>
	<tr id="i4" class="altColor">
	<td class="colFirst"><code>abstract void</code></td>
	<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/registry/ConnectionFactory.html#setProperties-java.util.Properties-">setProperties</a></span>(java.util.Properties properties)</code>
	<div class="block">Sets the Properties used during createConnection
	and createFederatedConnection calls.</div>
	</td>
	</tr>
	</table>
	<ul class="blockList">
	<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
	<!-- -->
	</a>
	<h3>Methods inherited from class java.lang.Object</h3>
	<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
	</ul>
	</li>
	</ul>
	</li>
	</ul>
	</div>
	<div class="details">
	<ul class="blockList">
	<li class="blockList">
	<!-- ========= CONSTRUCTOR DETAIL ======== -->
	<ul class="blockList">
	<li class="blockList"><a name="constructor.detail">
	<!-- -->
	</a>
	<h3>Constructor Detail</h3>
	<a name="ConnectionFactory--">
	<!-- -->
	</a>
	<ul class="blockListLast">
	<li class="blockList">
	<h4>ConnectionFactory</h4>
	<pre>public ConnectionFactory()</pre>
	</li>
	</ul>
	</li>
	</ul>
	<!-- ============ METHOD DETAIL ========== -->
	<ul class="blockList">
	<li class="blockList"><a name="method.detail">
	<!-- -->
	</a>
	<h3>Method Detail</h3>
	<a name="setProperties-java.util.Properties-">
	<!-- -->
	</a>
	<ul class="blockList">
	<li class="blockList">
	<h4>setProperties</h4>
	<pre>public abstract void setProperties(java.util.Properties properties)
	throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
	<div class="block">Sets the Properties used during createConnection
	and createFederatedConnection calls.
	<p>
	<DD><DL>
	<DT>
	<B>Standard Connection Properties:</B>
	<DD><CODE>javax.xml.registry.queryManagerURL</CODE> - URL String for the query manager service within the target registry provider
	<DD><CODE>javax.xml.registry.lifeCycleManagerURL</CODE> - URL String for the life cycle manager service within the target registry provider. If unspecified, must default to value of the queryManagerURL described above
	<DD><CODE>javax.xml.registry.semanticEquivalences</CODE> - String that allows specification of semantic equivalences
	<DD><CODE>javax.xml.registry.security.authenticationMethod</CODE> - 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"
	<DD><CODE>javax.xml.registry.uddi.maxRows</CODE> - integer that specifies the maximum number of rows to be returned for find operations. This property is specific for UDDI providers
	<DD><CODE>javax.xml.registry.postalAddressScheme</CODE> - String that specifies the id of a ClassificationScheme that is used as the default postal address scheme for this connection
	</DL>
	<p><DL><DT><B>Capability Level: 0 </B></DL></div>
	<dl>
	<dt><span class="paramLabel">Parameters:</span></dt>
	<dd><code>properties</code> - configuration properties that are either
	specified by JAXR specification or are provider specific.</dd>
	<dt><span class="throwsLabel">Throws:</span></dt>
	<dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
	</dl>
	</li>
	</ul>
	<a name="getProperties--">
	<!-- -->
	</a>
	<ul class="blockList">
	<li class="blockList">
	<h4>getProperties</h4>
	<pre>public abstract java.util.Properties getProperties()
	throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
	<div class="block">Gets the Properties used during createConnection
	and createFederatedConnection calls.

	<p><DL><DT><B>Capability Level: 0 </B></DL></div>
	<dl>
	<dt><span class="returnLabel">Returns:</span></dt>
	<dd>the Properties defined for this object</dd>
	<dt><span class="throwsLabel">Throws:</span></dt>
	<dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
	</dl>
	</li>
	</ul>
	<a name="createConnection--">
	<!-- -->
	</a>
	<ul class="blockList">
	<li class="blockList">
	<h4>createConnection</h4>
	<pre>public abstract <a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry">Connection</a> createConnection()
	throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
	<div class="block">Create a named connection. Such a connection can be used to
	communicate with a JAXR provider.

	<p><DL><DT><B>Capability Level: 0 </B></DL></div>
	<dl>
	<dt><span class="returnLabel">Returns:</span></dt>
	<dd>the Connection created by this call</dd>
	<dt><span class="throwsLabel">Throws:</span></dt>
	<dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
	</dl>
	</li>
	</ul>
	<a name="createFederatedConnection-java.util.Collection-">
	<!-- -->
	</a>
	<ul class="blockList">
	<li class="blockList">
	<h4>createFederatedConnection</h4>
	<pre>public abstract <a href="../../../javax/xml/registry/FederatedConnection.html" title="interface in javax.xml.registry">FederatedConnection</a> createFederatedConnection(java.util.Collection connections)
	throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
	<div class="block">Create a FederatedConnection.

	<p><DL><DT><B>Capability Level: 0 (optional) </B></DL></div>
	<dl>
	<dt><span class="paramLabel">Parameters:</span></dt>
	<dd><code>connections</code> - Is a Collection of Connection objects. Note that
	Connection objects may also be FederatedConnection objects.</dd>
	<dt><span class="returnLabel">Returns:</span></dt>
	<dd>the FederatedConnection created by this call</dd>
	<dt><span class="throwsLabel">Throws:</span></dt>
	<dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
	</dl>
	</li>
	</ul>
	<a name="newInstance--">
	<!-- -->
	</a>
	<ul class="blockListLast">
	<li class="blockList">
	<h4>newInstance</h4>
	<pre>public static <a href="../../../javax/xml/registry/ConnectionFactory.html" title="class in javax.xml.registry">ConnectionFactory</a> newInstance()
	throws <a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></pre>
	<div class="block">Creates a default <code>ConnectionFactory</code> object.</div>
	<dl>
	<dt><span class="returnLabel">Returns:</span></dt>
	<dd>a new instance of a <code>ConnectionFactory</code></dd>
	<dt><span class="throwsLabel">Throws:</span></dt>
	<dd><code><a href="../../../javax/xml/registry/JAXRException.html" title="class in javax.xml.registry">JAXRException</a></code> - If the JAXR provider encounters an internal error</dd>
	</dl>
	</li>
	</ul>
	</li>
	</ul>
	</li>
	</ul>
	</div>
	</div>
	<!-- ========= END OF CLASS DATA ========= -->
	<!-- ======= START OF BOTTOM NAVBAR ====== -->
	<div class="bottomNav"><a name="navbar.bottom">
	<!-- -->
	</a>
	<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
	<a name="navbar.bottom.firstrow">
	<!-- -->
	</a>
	<ul class="navList" title="Navigation">
	<li><a href="../../../overview-summary.html">Overview</a></li>
	<li><a href="package-summary.html">Package</a></li>
	<li class="navBarCell1Rev">Class</li>
	<li><a href="package-tree.html">Tree</a></li>
	<li><a href="../../../deprecated-list.html">Deprecated</a></li>
	<li><a href="../../../index-all.html">Index</a></li>
	<li><a href="../../../help-doc.html">Help</a></li>
	</ul>
	</div>
	<div class="subNav">
	<ul class="navList">
	<li><a href="../../../javax/xml/registry/Connection.html" title="interface in javax.xml.registry"><span class="typeNameLink">Prev Class</span></a></li>
	<li><a href="../../../javax/xml/registry/DeclarativeQueryManager.html" title="interface in javax.xml.registry"><span class="typeNameLink">Next Class</span></a></li>
	</ul>
	<ul class="navList">
	<li><a href="../../../index.html?javax/xml/registry/ConnectionFactory.html" target="_top">Frames</a></li>
	<li><a href="ConnectionFactory.html" target="_top">No Frames</a></li>
	</ul>
	<ul class="navList" id="allclasses_navbar_bottom">
	<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
	</ul>
	<div>
	<script type="text/javascript"><!--
	allClassesLink = document.getElementById("allclasses_navbar_bottom");
	if(window==top) {
	allClassesLink.style.display = "block";
	}
	else {
	allClassesLink.style.display = "none";
	}
	//-->
	</script>
	</div>
	<div>
	<ul class="subNavList">
	<li>Summary: </li>
	<li>Nested \| </li>
	<li>Field \| </li>
	<li><a href="#constructor.summary">Constr</a> \| </li>
	<li><a href="#method.summary">Method</a></li>
	</ul>
	<ul class="subNavList">
	<li>Detail: </li>
	<li>Field \| </li>
	<li><a href="#constructor.detail">Constr</a> \| </li>
	<li><a href="#method.detail">Method</a></li>
	</ul>
	</div>
	<a name="skip.navbar.bottom">
	<!-- -->
	</a></div>
	<!-- ======== END OF BOTTOM NAVBAR ======= -->
	</body>
	</html>