sipfactory.html

jsip开发文档,对于开发SIP软电话和presence服务很有用

 particular vendor's implementation of this specification.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="getInstance()"><!-- --></A><H3>
getInstance</H3>
<PRE>
public static <A HREF="../../javax/sip/SipFactory.html" title="class in javax.sip">SipFactory</A> <B>getInstance</B>()</PRE>
<DL>
<DD>Returns an instance of a SipFactory. This is a singleton class so this
 method is the global access point for the SipFactory.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the single instance of this singleton SipFactory</DL>
</DD>
</DL>
<HR>

<A NAME="createSipStack(java.util.Properties)"><!-- --></A><H3>
createSipStack</H3>
<PRE>
public <A HREF="../../javax/sip/SipStack.html" title="interface in javax.sip">SipStack</A> <B>createSipStack</B>(java.util.Properties&nbsp;properties)
                        throws <A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></PRE>
<DL>
<DD>Creates an instance of a SipStack implementation based on the
 configuration properties object passed to this method. The 
 recommended behaviour is to not specify an
 "javax.sip.IP_ADDRESS" property in the Properties argument, in this 
 case the "javax.sip.STACK_NAME" uniquely identifies the stack. 
 A new stack instance will be returned for each different stack name 
 associated with a specific vendor implementation. The 
 ListeningPoint is used to configure the IP Address argument. 
 For backwards compatability, if a "javax.sip.IP_ADDRESS" is supplied, 
 this method ensures that only one instance of a SipStack is returned 
 to the application for that IP Address, independent of the number of 
 times this method is called. Different SipStack instances are 
 returned for each different IP address.
 <p> 
 See <A HREF="../../javax/sip/SipStack.html" title="interface in javax.sip"><CODE>SipStack</CODE></A> for the expected format of the 
 <code>properties</code> argument.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></CODE> - if the peer class could not be found</DL>
</DD>
</DL>
<HR>

<A NAME="createMessageFactory()"><!-- --></A><H3>
createMessageFactory</H3>
<PRE>
public <A HREF="../../javax/sip/message/MessageFactory.html" title="interface in javax.sip.message">MessageFactory</A> <B>createMessageFactory</B>()
                                    throws <A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></PRE>
<DL>
<DD>Creates an instance of the MessageFactory implementation. This method
 ensures that only one instance of a MessageFactory is returned to the
 application, no matter how often this method is called.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></CODE> - if peer class could not be found</DL>
</DD>
</DL>
<HR>

<A NAME="createHeaderFactory()"><!-- --></A><H3>
createHeaderFactory</H3>
<PRE>
public <A HREF="../../javax/sip/header/HeaderFactory.html" title="interface in javax.sip.header">HeaderFactory</A> <B>createHeaderFactory</B>()
                                  throws <A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></PRE>
<DL>
<DD>Creates an instance of the HeaderFactory implementation. This method
 ensures that only one instance of a HeaderFactory is returned to the
 application, no matter how often this method is called.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></CODE> - if peer class could not be found</DL>
</DD>
</DL>
<HR>

<A NAME="createAddressFactory()"><!-- --></A><H3>
createAddressFactory</H3>
<PRE>
public <A HREF="../../javax/sip/address/AddressFactory.html" title="interface in javax.sip.address">AddressFactory</A> <B>createAddressFactory</B>()
                                    throws <A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></PRE>
<DL>
<DD>Creates an instance of the AddressFactory implementation. This method
 ensures that only one instance of an AddressFactory is returned to the
 application, no matter how often this method is called.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/sip/PeerUnavailableException.html" title="class in javax.sip">PeerUnavailableException</A></CODE> - if peer class could not be found</DL>
</DD>
</DL>
<HR>

<A NAME="setPathName(java.lang.String)"><!-- --></A><H3>
setPathName</H3>
<PRE>
public void <B>setPathName</B>(java.lang.String&nbsp;pathName)</PRE>
<DL>
<DD>Sets the <var>pathname</var> that identifies the location of a
 particular vendor's implementation of this specification. The
 <var>pathname</var> must be the reverse domain name assigned to the
 vendor providing the implementation. An application must call
 <A HREF="../../javax/sip/SipFactory.html#resetFactory()"><CODE>resetFactory()</CODE></A> before changing between different
 implementations of this specification.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pathName</CODE> - -
            the reverse domain name of the vendor, e.g. Sun Microsystem's
            would be 'com.sun'</DL>
</DD>
</DL>
<HR>

<A NAME="getPathName()"><!-- --></A><H3>
getPathName</H3>
<PRE>
public java.lang.String <B>getPathName</B>()</PRE>
<DL>
<DD>Returns the current <var>pathname</var> of the SipFactory. The
 <var>pathname</var> identifies the location of a particular vendor's
 implementation of this specification as defined the naming convention.
 The pathname must be the reverse domain name assigned to the vendor
 providing this implementation. This value is defaulted to
 <code>gov.nist</code> the location of the Reference Implementation.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the string identifying the current vendor implementation.</DL>
</DD>
</DL>
<HR>

<A NAME="resetFactory()"><!-- --></A><H3>
resetFactory</H3>
<PRE>
public void <B>resetFactory</B>()</PRE>
<DL>
<DD>This method reset's the SipFactory's references to the object's it has
 created. It allows these objects to be garbage collected assuming the
 application no longer holds references to them. This method must be
 called to reset the factories references to a specific vendors
 implementation of this specification before it creates another vendors
 implementation of this specification by changing the <var>pathname</var>
 of the SipFactory.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>JSIP API v1.2<br><font size=-1>November 2006</font></b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../javax/sip/SipException.html" title="class in javax.sip"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../javax/sip/SipListener.html" title="interface in javax.sip"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html?javax/sip/SipFactory.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="SipFactory.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<center>If you have any comments, please mail them to <a href=mailto:[e-mail]>[e-mail]</a> after subscribing at <a href=http://archives.java.sun.com>http://archives.java.sun.com</a><br><a href=../../copyright.html>Copyright</a> - 2006 BEA Systems and Sun Microsystems</center>
</BODY>
</HTML>