📄 java.telephony.jtapipeerfactory.html
字号:
<!--NewPage--><html><head><!-- Generated by javadoc on Fri Feb 07 16:42:30 PST 1997 --><a name="_top_"></a><title> Class java.telephony.JtapiPeerFactory</title></head><body><pre><a href="packages.html">All Packages</a> <a href="tree.html">Class Hierarchy</a> <a href="Package-java.telephony.html">This Package</a> <a href="Package-java.telephony.html">Previous</a> <a href="Package-java.telephony.html">Next</a> <a href="AllNames.html">Index</a></pre><hr><h1> Class java.telephony.JtapiPeerFactory</h1><pre><a href="java.lang.Object.html#_top_">java.lang.Object</a> | +----java.telephony.JtapiPeerFactory</pre><hr><dl> <dt> public class <b>JtapiPeerFactory</b> <dt> extends <a href="java.lang.Object.html#_top_">Object</a></dl>The JtapiPeerFactory class is a static class which is the primary meansused by applications to obtain a Provider object. The term 'peer' is usedthroughout Java to mean "a particular platform-specific implementation ofa Java interface or API. This term has the same meaning for the JavaTelephony API. Applications are not permitted to create an instance ofthe JtapiPeerFactory class.<p>Applications use this class to first obtain a class which implements the<EM>java.telephony.JtapiPeer</EM> interface. This JtapiPeer interfacerepresents a paritcular vendor's implementation of the telephony API.<p>Once applications have a JtapiPeer object for a particular platform-dependent implementation, they may obtain a Provider object via thatinterface. The details of that interface are discussed in the specificationfor the JtapiPeer interface.<p>Applications use the <EM>getJtapiPeer()</EM> method on this class toobtain a JtapiPeer object. The argument to this method is a classnamewhich represents an object which implements the JtapiPeer interface. Thisobject and the classname under which it can be found must be supplied bythe vendor of the implementation. Note that this object is not a Provider,however, this interface is used to obtain Providers from that particularimplementation.<p>The Java Telephony API places conventions on vendors on the classnamethey use for their JtapiPeer object. This class name <EM>must</EM> beginwith the domain name assigned to the vendor in reverse order. Because thespace of domain names is managed, it ensures that collisions between twodifferent vendor's implementations will not happen. For example, animplementation from Sun Microsystem's will have "com.sun" as the prefixto its JtapiPeer class. After the reversed domain name, vendor's arefree to choose any class hierarchy they desire.<p>In basic environments, applications and users do not want the burden offinding out the class name in order to use a particular implementation.Therefore, the JtapiPeerFactory class supports a mechanism for applicationsto obtain the default implementation for their system. If applications usea null argument to the <EM>getJtapiPeer()</EM> method, they will bereturned the default installed implementation on their system.<p><STRONG>Note:</STRONG> It is the responsibilty of implementation vendor'sto supply a version of this JtapiPeerFactory class which has a defaultimplementation programmed into it. During the installation of theirimplementation on a system, this generic class should be replaced with theirown version which points to a default implementation. Implementation justhave to implement the private <EM>getDefaultJtapiPeerName()</EM> method.The specification provides a generic version of this class with no defaultprovider built-in.<hr><a name="index"></a><h2> <img src="images/method-index.gif" width=207 height=38 alt="Method Index"></h2><dl> <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getJtapiPeer(java.lang.String)"><b>getJtapiPeer</b></a>(String) <dd> Returns an instance of a JtapiPeer object given a fully qualifiedclassname of the class which implements the JtapiPeer object.</dl><a name="methods"></a><h2> <img src="images/methods.gif" width=151 height=38 alt="Methods"></h2><a name="getJtapiPeer(java.lang.String)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a><a name="getJtapiPeer"><b>getJtapiPeer</b></a><pre> public static synchronized <a href="java.telephony.JtapiPeer.html#_top_">JtapiPeer</a> getJtapiPeer(<a href="java.lang.String.html#_top_">String</a> _jtapiPeerName) throws <a href="java.telephony.JtapiPeerUnavailableException.html#_top_">JtapiPeerUnavailableException</a></pre><dl> <dd> Returns an instance of a JtapiPeer object given a fully qualifiedclassname of the class which implements the JtapiPeer object.<p>If no classname is provided (null), a default is picked by thecurrent implementation of this class.<p> <dl> <dt> <b>Parameters:</b> <dd> _jtapiPeerName - The classname of the JtapiPeer object class. <dt> <b>Returns:</b> <dd> An instance of the JtapiPeer object. <dt> <b>Throws:</b> <a href="java.telephony.JtapiPeerUnavailableException.html#_top_">JtapiPeerUnavailableException</a> <dd> Indicates that the JtapiPeerspecified by the classname is not available. </dl></dl><hr><pre><a href="packages.html">All Packages</a> <a href="tree.html">Class Hierarchy</a> <a href="Package-java.telephony.html">This Package</a> <a href="Package-java.telephony.html">Previous</a> <a href="Package-java.telephony.html">Next</a> <a href="AllNames.html">Index</a></pre></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -