pepservice.html

开源软件openfire的API文件。进行openfire的二次开发所必需的工具。

<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#getShowPresences(org.xmpp.packet.JID)">PubSubService</A></CODE></B></DD>
<DD>Returns the show values of the last know presence of all connected resources of the
 specified subscriber. When the subscriber JID is a bare JID then the answered collection
 will have many entries one for each connected resource. Moreover, if the user
 is offline then an empty collectin is returned. Available show status is represented
 by a <tt>online</tt> value. The rest of the possible show values as defined in RFC 3921.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#getShowPresences(org.xmpp.packet.JID)">getShowPresences</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>subscriber</CODE> - the JID of the subscriber. This is not the JID of the affiliate.
<DT><B>Returns:</B><DD>an empty collection when offline. Otherwise, a collection with the show value
         of each connected resource.</DL>
</DD>
</DL>
<HR>

<A NAME="canCreateNode(org.xmpp.packet.JID)"><!-- --></A><H3>
canCreateNode</H3>
<PRE>
public boolean <B>canCreateNode</B>(<A HREF="../../../../org/xmpp/packet/JID.html" title="class in org.xmpp.packet">JID</A>&nbsp;creator)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#canCreateNode(org.xmpp.packet.JID)">PubSubService</A></CODE></B></DD>
<DD>Returns true if the pubsub service allows the specified user to create nodes.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#canCreateNode(org.xmpp.packet.JID)">canCreateNode</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>creator</CODE> - the JID of the entity trying to create a new node.
<DT><B>Returns:</B><DD>true if the pubsub service allows the specified user to create nodes.</DL>
</DD>
</DL>
<HR>

<A NAME="isCollectionNodesSupported()"><!-- --></A><H3>
isCollectionNodesSupported</H3>
<PRE>
public boolean <B>isCollectionNodesSupported</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isCollectionNodesSupported()">PubSubService</A></CODE></B></DD>
<DD>Returns true if the pubsub service supports collection nodes. When collection nodes is
 supported it is possible to create hierarchy of nodes where a <A HREF="../../../../org/jivesoftware/openfire/pubsub/CollectionNode.html" title="class in org.jivesoftware.openfire.pubsub"><CODE>CollectionNode</CODE></A>
 may only hold children nodes of type <A HREF="../../../../org/jivesoftware/openfire/pubsub/CollectionNode.html" title="class in org.jivesoftware.openfire.pubsub"><CODE>CollectionNode</CODE></A> or <A HREF="../../../../org/jivesoftware/openfire/pubsub/LeafNode.html" title="class in org.jivesoftware.openfire.pubsub"><CODE>LeafNode</CODE></A>. On the
 other hand, <A HREF="../../../../org/jivesoftware/openfire/pubsub/LeafNode.html" title="class in org.jivesoftware.openfire.pubsub"><CODE>LeafNode</CODE></A> can only hold <A HREF="../../../../org/jivesoftware/openfire/pubsub/PublishedItem.html" title="class in org.jivesoftware.openfire.pubsub"><CODE>PublishedItem</CODE></A>.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isCollectionNodesSupported()">isCollectionNodesSupported</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>true if the pubsub service supports collection nodes.</DL>
</DD>
</DL>
<HR>

<A NAME="isInstantNodeSupported()"><!-- --></A><H3>
isInstantNodeSupported</H3>
<PRE>
public boolean <B>isInstantNodeSupported</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isInstantNodeSupported()">PubSubService</A></CODE></B></DD>
<DD>Returns true if the pubsub service allows users to create nodes without specifying
 the node ID. The service will create a random node ID and assigne it to the node.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isInstantNodeSupported()">isInstantNodeSupported</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>true if the pubsub service allows users to create nodes without specifying
         the node ID.</DL>
</DD>
</DL>
<HR>

<A NAME="isMultipleSubscriptionsEnabled()"><!-- --></A><H3>
isMultipleSubscriptionsEnabled</H3>
<PRE>
public boolean <B>isMultipleSubscriptionsEnabled</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isMultipleSubscriptionsEnabled()">PubSubService</A></CODE></B></DD>
<DD>Returns true if a user may have more than one subscription with the node. When
 multiple subscriptions is enabled each subscription request, event notification and
 unsubscription request should include a <tt>subid</tt> attribute.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isMultipleSubscriptionsEnabled()">isMultipleSubscriptionsEnabled</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>true if a user may have more than one subscription with the node.</DL>
</DD>
</DL>
<HR>

<A NAME="isServiceAdmin(org.xmpp.packet.JID)"><!-- --></A><H3>
isServiceAdmin</H3>
<PRE>
public boolean <B>isServiceAdmin</B>(<A HREF="../../../../org/xmpp/packet/JID.html" title="class in org.xmpp.packet">JID</A>&nbsp;user)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isServiceAdmin(org.xmpp.packet.JID)">PubSubService</A></CODE></B></DD>
<DD>Returns true if the specified user is a sysadmin of the pubsub service or has
 admin privileges.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#isServiceAdmin(org.xmpp.packet.JID)">isServiceAdmin</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>user</CODE> - the user to check if he has admin privileges.
<DT><B>Returns:</B><DD>true if the specified user is a sysadmin of the pubsub service or has
         admin privileges.</DL>
</DD>
</DL>
<HR>

<A NAME="isNodeCreationRestricted()"><!-- --></A><H3>
isNodeCreationRestricted</H3>
<PRE>
public boolean <B>isNodeCreationRestricted</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="presenceSubscriptionNotRequired(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.JID)"><!-- --></A><H3>
presenceSubscriptionNotRequired</H3>
<PRE>
public void <B>presenceSubscriptionNotRequired</B>(<A HREF="../../../../org/jivesoftware/openfire/pubsub/Node.html" title="class in org.jivesoftware.openfire.pubsub">Node</A>&nbsp;node,
                                            <A HREF="../../../../org/xmpp/packet/JID.html" title="class in org.xmpp.packet">JID</A>&nbsp;user)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#presenceSubscriptionNotRequired(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.JID)">PubSubService</A></CODE></B></DD>
<DD>Requests the pubsub service to unsubscribe from the presence of the user. If the service
 was not subscribed to the user's presence or any node still requires to be subscribed to
 the user presence then do nothing.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#presenceSubscriptionNotRequired(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.JID)">presenceSubscriptionNotRequired</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>node</CODE> - the node that originated the unsubscription request.<DD><CODE>user</CODE> - the JID of the affiliate to unsubscribe from his presence.</DL>
</DD>
</DL>
<HR>

<A NAME="presenceSubscriptionRequired(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.JID)"><!-- --></A><H3>
presenceSubscriptionRequired</H3>
<PRE>
public void <B>presenceSubscriptionRequired</B>(<A HREF="../../../../org/jivesoftware/openfire/pubsub/Node.html" title="class in org.jivesoftware.openfire.pubsub">Node</A>&nbsp;node,
                                         <A HREF="../../../../org/xmpp/packet/JID.html" title="class in org.xmpp.packet">JID</A>&nbsp;user)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#presenceSubscriptionRequired(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.JID)">PubSubService</A></CODE></B></DD>
<DD>Requests the pubsub service to subscribe to the presence of the user. If the service
 has already subscribed to the user's presence then do nothing.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#presenceSubscriptionRequired(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.JID)">presenceSubscriptionRequired</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>node</CODE> - the node that originated the subscription request.<DD><CODE>user</CODE> - the JID of the affiliate to subscribe to his presence.</DL>
</DD>
</DL>
<HR>

<A NAME="send(org.xmpp.packet.Packet)"><!-- --></A><H3>
send</H3>
<PRE>
public void <B>send</B>(<A HREF="../../../../org/xmpp/packet/Packet.html" title="class in org.xmpp.packet">Packet</A>&nbsp;packet)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#send(org.xmpp.packet.Packet)">PubSubService</A></CODE></B></DD>
<DD>Sends the specified packet.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#send(org.xmpp.packet.Packet)">send</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>packet</CODE> - the packet to send.</DL>
</DD>
</DL>
<HR>

<A NAME="broadcast(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.Message, java.util.Collection)"><!-- --></A><H3>
broadcast</H3>
<PRE>
public void <B>broadcast</B>(<A HREF="../../../../org/jivesoftware/openfire/pubsub/Node.html" title="class in org.jivesoftware.openfire.pubsub">Node</A>&nbsp;node,
                      <A HREF="../../../../org/xmpp/packet/Message.html" title="class in org.xmpp.packet">Message</A>&nbsp;message,
                      <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A>&lt;<A HREF="../../../../org/xmpp/packet/JID.html" title="class in org.xmpp.packet">JID</A>&gt;&nbsp;jids)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#broadcast(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.Message, java.util.Collection)">PubSubService</A></CODE></B></DD>
<DD>Broadcasts the specified Message containing an event notification to a list
 of subscribers to the specified node. Each message being sent has to have a unique
 ID value so that the service can properly track any notification-related errors
 that may occur.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html#broadcast(org.jivesoftware.openfire.pubsub.Node, org.xmpp.packet.Message, java.util.Collection)">broadcast</A></CODE> in interface <CODE><A HREF="../../../../org/jivesoftware/openfire/pubsub/PubSubService.html" title="interface in org.jivesoftware.openfire.pubsub">PubSubService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>node</CODE> - the node that triggered the event notification.<DD><CODE>message</CODE> - the message containing the event notification.<DD><CODE>jids</CODE> - the list of entities to get the event notification.</DL>
</DD>