endpointserviceinterface.html

jxta的api库

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method is invoked by the EndpointService for each incoming message
 which is addressed to this listener.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#propagate(net.jxta.endpoint.Message, java.lang.String, java.lang.String)">propagate</A></B>(<A HREF="../../../../net/jxta/endpoint/Message.html" title="class in net.jxta.endpoint">Message</A>&nbsp;srcMsg,
          java.lang.String&nbsp;serviceName,
          java.lang.String&nbsp;serviceParam)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Propagates the given message through all the endpoint protocols that
 are available to this endpoint. Some or all of these endpoint protocols
 may silently drop the message. Each endpoint protocol may interpret the
 resquest for propagation differenly. The endpointService does not
 define which destinations the message will actually reach.

 WARNING: The message object should not be reused or modified after
 the call is made. Concurrent modifications will produce unexpected
 result.

 The concatenation of the serviceName and serviceParam arguments
 uniquely designates the listener to which the message must be delivered
 on arrival.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#removeFilterListener(java.lang.String, net.jxta.endpoint.EndpointFilterListener, boolean)">removeFilterListener</A></B>(java.lang.String&nbsp;elementName,
                     <A HREF="../../../../net/jxta/endpoint/EndpointFilterListener.html" title="interface in net.jxta.endpoint">EndpointFilterListener</A>&nbsp;listener,
                     boolean&nbsp;incoming)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes the given listener previously registered under the given
 element name</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../net/jxta/endpoint/MessageFilterListener.html" title="interface in net.jxta.endpoint">MessageFilterListener</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#removeIncomingMessageFilterListener(net.jxta.endpoint.MessageFilterListener, java.lang.String, java.lang.String)">removeIncomingMessageFilterListener</A></B>(<A HREF="../../../../net/jxta/endpoint/MessageFilterListener.html" title="interface in net.jxta.endpoint">MessageFilterListener</A>&nbsp;listener,
                                    java.lang.String&nbsp;namespace,
                                    java.lang.String&nbsp;name)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes the given listener previously registered under the given
 element name</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../net/jxta/endpoint/EndpointListener.html" title="interface in net.jxta.endpoint">EndpointListener</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#removeIncomingMessageListener(java.lang.String, java.lang.String)">removeIncomingMessageListener</A></B>(java.lang.String&nbsp;serviceName,
                              java.lang.String&nbsp;serviceParam)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remove the listener for the specified address.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#removeListener(java.lang.String, net.jxta.endpoint.EndpointListener)">removeListener</A></B>(java.lang.String&nbsp;address,
               <A HREF="../../../../net/jxta/endpoint/EndpointListener.html" title="interface in net.jxta.endpoint">EndpointListener</A>&nbsp;listener)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes the given listener previously registered under the given
 address.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#removeMessageTransport(net.jxta.endpoint.MessageTransport)">removeMessageTransport</A></B>(<A HREF="../../../../net/jxta/endpoint/MessageTransport.html" title="interface in net.jxta.endpoint">MessageTransport</A>&nbsp;transpt)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes the given MessageTransport protocol from this endpoint service.

 <p/>Transports remove themselves from the list when stopped. This method
 is normally only called from the stoppApp method of the transport. To
 cleanly remove a transport, call the transport's
 <A HREF="../../../../net/jxta/platform/Module.html#stopApp()"><CODE>stopApp()</CODE></A> and allow it to
 call this method.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#removeMessengerEventListener(net.jxta.endpoint.MessengerEventListener, int)">removeMessengerEventListener</A></B>(<A HREF="../../../../net/jxta/endpoint/MessengerEventListener.html" title="interface in net.jxta.endpoint">MessengerEventListener</A>&nbsp;listener,
                             int&nbsp;prio)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes the specified listener.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../net/jxta/endpoint/MessageFilterListener.html" title="interface in net.jxta.endpoint">MessageFilterListener</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#removeOutgoingMessageFilterListener(net.jxta.endpoint.MessageFilterListener, java.lang.String, java.lang.String)">removeOutgoingMessageFilterListener</A></B>(<A HREF="../../../../net/jxta/endpoint/MessageFilterListener.html" title="interface in net.jxta.endpoint">MessageFilterListener</A>&nbsp;listener,
                                    java.lang.String&nbsp;namespace,
                                    java.lang.String&nbsp;name)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes the given listener previously registered under the given
 element name</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#startApp(java.lang.String[])">startApp</A></B>(java.lang.String[]&nbsp;arg)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Some Modules will wait for this method being invoked, before
 completing their initializatino to the point that they are fully
 functional. That is also the opportunity to supply arbitrary arguments
 (mostly to applications).
 
 <p/>If this module is a <A HREF="../../../../net/jxta/peergroup/PeerGroup.html" title="interface in net.jxta.peergroup"><CODE>PeerGroup</CODE></A> service, it may be invoked
 several times depending on its return value.
 
 <p/>Note: the name of this method is historical and no-longer adequate.

 This is here for temporary class hierarchy reasons.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceInterface.html#stopApp()">stopApp</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;One can ask a Module to stop.
  The Module cannot be forced to comply, but in the future
  we might be able to deny it access to anything after some timeout.

  <p/>Note: the name of this method is no-longer adequate.

 <p/>This is here for temporary class hierarchy reasons.
 </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">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</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>

<!-- ============ FIELD DETAIL =========== -->

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

<A NAME="theRealThing"><!-- --></A><H3>
theRealThing</H3>
<PRE>
<A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceImpl.html" title="class in net.jxta.impl.endpoint">EndpointServiceImpl</A> <B>theRealThing</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>

<A NAME="oldOutFilters"><!-- --></A><H3>
oldOutFilters</H3>
<PRE>
java.util.HashMap <B>oldOutFilters</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>

<A NAME="oldInFilters"><!-- --></A><H3>
oldInFilters</H3>
<PRE>
java.util.HashMap <B>oldInFilters</B></PRE>
<DL>
<DL>
</DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

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

<A NAME="EndpointServiceInterface(net.jxta.impl.endpoint.EndpointServiceImpl)"><!-- --></A><H3>
EndpointServiceInterface</H3>
<PRE>
public <B>EndpointServiceInterface</B>(<A HREF="../../../../net/jxta/impl/endpoint/EndpointServiceImpl.html" title="class in net.jxta.impl.endpoint">EndpointServiceImpl</A>&nbsp;s)</PRE>
<DL>
</DL>

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

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

<A NAME="init(net.jxta.peergroup.PeerGroup, net.jxta.id.ID, net.jxta.document.Advertisement)"><!-- --></A><H3>
init</H3>
<PRE>
public void <B>init</B>(<A HREF="../../../../net/jxta/peergroup/PeerGroup.html" title="interface in net.jxta.peergroup">PeerGroup</A>&nbsp;pg,
                 <A HREF="../../../../net/jxta/id/ID.html" title="class in net.jxta.id">ID</A>&nbsp;id,
                 <A HREF="../../../../net/jxta/document/Advertisement.html" title="class in net.jxta.document">Advertisement</A>&nbsp;ia)</PRE>
<DL>
<DD>Initialize the module, passing it its peer group and advertisement.
 
 <p/>Note: when subclassing one of the existing PeerGroup implementations
 (which implement Module), it may not be recommended to overload the init
 method. See the documentation of the PeerGroup class being subclassed.

  <p/>FIXME: This is meaningless for the interface object;
 it is there only to satisfy the requirements of the
 interface that we implement. Ultimately, the API should define
 two levels of interfaces: one for the real service implementation
 and one for the interface object. Right now it feels a bit heavy
 to so that since the only different between the two would be
 init() and may-be getName().
<P>
<DD><DL>