endpointserviceimpl.html

jxta的api库

 of the service. A Service interface is returned to access the service
 methods.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/service/Service.html#getInterface()">getInterface</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/service/Service.html" title="interface in net.jxta.service">Service</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Service public interface of the service<DT><B>Since:</B></DT>
  <DD>JXTA 1.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getImplAdvertisement()"><!-- --></A><H3>
getImplAdvertisement</H3>
<PRE>
public <A HREF="../../../../net/jxta/document/Advertisement.html" title="class in net.jxta.document">Advertisement</A> <B>getImplAdvertisement</B>()</PRE>
<DL>
<DD>Returns the advertisment for this service.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/service/Service.html#getImplAdvertisement()">getImplAdvertisement</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/service/Service.html" title="interface in net.jxta.service">Service</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Advertisement the advertisement.<DT><B>Since:</B></DT>
  <DD>JXTA 1.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="newMessage()"><!-- --></A><H3>
newMessage</H3>
<PRE>
public <A HREF="../../../../net/jxta/endpoint/Message.html" title="class in net.jxta.endpoint">Message</A> <B>newMessage</B>()</PRE>
<DL>
<DD>Returns a new Message object suitable for use with this endpoint
  service.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html#newMessage()">newMessage</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Message the new message.</DL>
</DD>
</DL>
<HR>

<A NAME="newEndpointAddress(java.lang.String)"><!-- --></A><H3>
newEndpointAddress</H3>
<PRE>
public <A HREF="../../../../net/jxta/endpoint/EndpointAddress.html" title="class in net.jxta.endpoint">EndpointAddress</A> <B>newEndpointAddress</B>(java.lang.String&nbsp;Uri)</PRE>
<DL>
<DD>Builds an EndpointAddress out the the given URI string.
 The resulting EndpointAddress uniquely identifies a message listener
 at a given network address.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html#newEndpointAddress(java.lang.String)">newEndpointAddress</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>Uri</CODE> - the uri. The structure of the URI is as follows:
 protocol://address/[serviceName][/serviceParam]
<DT><B>Returns:</B><DD>EndpointAddress the EndpointAddress object corresponding to the given URI.</DL>
</DD>
</DL>
<HR>

<A NAME="setTransportControl(java.lang.Object, java.lang.Object)"><!-- --></A><H3>
setTransportControl</H3>
<PRE>
public boolean <B>setTransportControl</B>(java.lang.Object&nbsp;operation,
                                   java.lang.Object&nbsp;Value)</PRE>
<DL>
<DD>{@inheritDoc}
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getTransportControl(java.lang.Object)"><!-- --></A><H3>
getTransportControl</H3>
<PRE>
public java.lang.Object <B>getTransportControl</B>(java.lang.Object&nbsp;operation)</PRE>
<DL>
<DD>{@inheritDoc}
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="propagate(net.jxta.endpoint.Message, java.lang.String, java.lang.String)"><!-- --></A><H3>
propagate</H3>
<PRE>
public void <B>propagate</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)
               throws java.io.IOException</PRE>
<DL>
<DD>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.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html#propagate(net.jxta.endpoint.Message, java.lang.String, java.lang.String)">propagate</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>srcMsg</CODE> - the message to be propagated.<DD><CODE>serviceName</CODE> - a destination service name<DD><CODE>serviceParam</CODE> - a destination queue name within that service
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE> - if the message could not be propagated</DL>
</DD>
</DL>
<HR>

<A NAME="addListener(java.lang.String, net.jxta.endpoint.EndpointListener)"><!-- --></A><H3>
addListener</H3>
<PRE>
public void <B>addListener</B>(java.lang.String&nbsp;address,
                        <A HREF="../../../../net/jxta/endpoint/EndpointListener.html" title="interface in net.jxta.endpoint">EndpointListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Registers an incoming messages listener.

 <p/>Each incoming message addressed to the queue specified by
 the given address will be passed to the given listener.
 The address is usually formed by concatenating the the name of the
 invoking service and a parameter unique to that service accross all
 groups (the group ID is normally included for that purpose).

 <p/>For a message to match this address, it must have been sent through
 an EndpointMessenger obtained by providing an EndpointAddress constructed
 with matching serviceName and serviceParam (see newEndpointAddress and
 getMessenger), or by invoking propagate with matching serviceName
 and serviceParam.

 <p/>If a listener is already registered with the given address, an
 IllegalArgumentException is thrown.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html#addListener(java.lang.String, net.jxta.endpoint.EndpointListener)">addListener</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>address</CODE> - a queue name, unique accross all groups on this peer,<DD><CODE>listener</CODE> - a listener for these messages.</DL>
</DD>
</DL>
<HR>

<A NAME="removeListener(java.lang.String, net.jxta.endpoint.EndpointListener)"><!-- --></A><H3>
removeListener</H3>
<PRE>
public boolean <B>removeListener</B>(java.lang.String&nbsp;address,
                              <A HREF="../../../../net/jxta/endpoint/EndpointListener.html" title="interface in net.jxta.endpoint">EndpointListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Removes the given listener previously registered under the given
 address.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html#removeListener(java.lang.String, net.jxta.endpoint.EndpointListener)">removeListener</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>address</CODE> - Endpoint Address associated to the listener.<DD><CODE>listener</CODE> - a listener to remove.
<DT><B>Returns:</B><DD>boolean true is there was such a registration, false otherwise.</DL>
</DD>
</DL>
<HR>

<A NAME="addFilterListener(java.lang.String, net.jxta.endpoint.EndpointFilterListener, boolean)"><!-- --></A><H3>
addFilterListener</H3>
<PRE>
public void <B>addFilterListener</B>(java.lang.String&nbsp;name,
                              <A HREF="../../../../net/jxta/endpoint/EndpointFilterListener.html" title="interface in net.jxta.endpoint">EndpointFilterListener</A>&nbsp;listener,
                              boolean&nbsp;incoming)
                       throws java.lang.IllegalArgumentException</PRE>
<DL>
<DD>Registers an incoming messages filter listener.

 <p/>Each incoming message which contains an element with the specified
 name will be passed to the given listener.

 <p/>If a listener is already registered with the given address, an
 IllegalArgumentException is thrown.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html#addFilterListener(java.lang.String, net.jxta.endpoint.EndpointFilterListener, boolean)">addFilterListener</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name is either a qualified element name
 containing a namespace and an element name or a namespace alone. A colon
 is used to seperate the namespace and element name.<DD><CODE>listener</CODE> - a listener for these messages.<DD><CODE>incoming</CODE> - whether to run the filter on the incoming or
                    outgoing messages.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - is thrown when one of the argument
 is illegal.</DL>
</DD>
</DL>
<HR>

<A NAME="removeFilterListener(java.lang.String, net.jxta.endpoint.EndpointFilterListener, boolean)"><!-- --></A><H3>
removeFilterListener</H3>
<PRE>
public void <B>removeFilterListener</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)</PRE>
<DL>
<DD>Removes the given listener previously registered under the given
 element name
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html#removeFilterListener(java.lang.String, net.jxta.endpoint.EndpointFilterListener, boolean)">removeFilterListener</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>elementName</CODE> - the address the listener was registered for<DD><CODE>listener</CODE> - the listener that was registered<DD><CODE>incoming</CODE> - whether it was registered for incoming or outgoing
                 messages.</DL>
</DD>
</DL>
<HR>

<A NAME="processIncomingMessage(net.jxta.endpoint.Message, net.jxta.endpoint.EndpointAddress, net.jxta.endpoint.EndpointAddress)"><!-- --></A><H3>
processIncomingMessage</H3>
<PRE>
public void <B>processIncomingMessage</B>(<A HREF="../../../../net/jxta/endpoint/Message.html" title="class in net.jxta.endpoint">Message</A>&nbsp;msg,
                                   <A HREF="../../../../net/jxta/endpoint/EndpointAddress.html" title="class in net.jxta.endpoint">EndpointAddress</A>&nbsp;srcAddress,
                                   <A HREF="../../../../net/jxta/endpoint/EndpointAddress.html" title="class in net.jxta.endpoint">Endpoint