Package tigase.xmpp.impl.roster
Class DynamicRosterTest123
java.lang.Object
tigase.xmpp.impl.roster.DynamicRosterTest123
- All Implemented Interfaces:
DynamicRosterIfc
- Author:
- Artur Hefczyc Created Apr 1, 2011
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionJID[]
getBuddies
(XMPPResourceConnection session) getBuddies
method returnsString
array with all roster buddies JIDs.getBuddyItem
(XMPPResourceConnection session, JID buddy) getBuddyItem
method returns buddy item element for a given JID ornull
if the buddy doesn't exist on the user roster list.getItemExtraData
(Element item) Returns a new roster Item element with additional, non-standard information for a given item.getRosterItems
(XMPPResourceConnection session) getRosterItems
method returns a full list with all buddies generated by this dynamic roster implementation.void
init
method is called at the initialization time when simple form of startup parameters are used:void
init
method is used to provide configuration parameters and initialize the object.void
setItemExtraData
(Element item)
-
Constructor Details
-
DynamicRosterTest123
public DynamicRosterTest123()
-
-
Method Details
-
setItemExtraData
- Specified by:
setItemExtraData
in interfaceDynamicRosterIfc
-
getItemExtraData
Description copied from interface:DynamicRosterIfc
Returns a new roster Item element with additional, non-standard information for a given item. This is a way to associate custom roster information with a contact.- Specified by:
getItemExtraData
in interfaceDynamicRosterIfc
- Parameters:
item
- is aElement
- Returns:
- a value of
Element
-
init
Description copied from interface:DynamicRosterIfc
init
method is used to provide configuration parameters and initialize the object. Please have a look at the interface description for more details about configuration parameters. The object is never used before it'sinit(...)
method is called but it might be used straight away after the method has finished.- Specified by:
init
in interfaceDynamicRosterIfc
- Parameters:
props
- aMap<String, Object> props
is a configuration parameters map in the form: key:value exactly as they were specified in the configuration file.
-
init
Description copied from interface:DynamicRosterIfc
init
method is called at the initialization time when simple form of startup parameters are used:sess-man/plugins-conf/class-name.init=configuration-string
Theconfiguration-string
is passed to thisinit(...)
method in exact form as it was found in the configuration file.- Specified by:
init
in interfaceDynamicRosterIfc
- Parameters:
par
- aString
value of the configuration string.
-
getBuddies
Description copied from interface:DynamicRosterIfc
getBuddies
method returnsString
array with all roster buddies JIDs. Normally they are bare JIDs (without resource part). This method is normally used by presence plugin to send probe and initial presence to all contacts in the dynamic roster.- Specified by:
getBuddies
in interfaceDynamicRosterIfc
- Parameters:
session
- aXMPPResourceConnection
value of the connection session object.- Returns:
- a
String[]
array of bare JIDs for the dynamic part of the user roster. - Throws:
NotAuthorizedException
- may be thrown if the connection session is not yet authenticated but authorization is required to access roster data.
-
getBuddyItem
public Element getBuddyItem(XMPPResourceConnection session, JID buddy) throws NotAuthorizedException Description copied from interface:DynamicRosterIfc
getBuddyItem
method returns buddy item element for a given JID ornull
if the buddy doesn't exist on the user roster list.- Specified by:
getBuddyItem
in interfaceDynamicRosterIfc
- Parameters:
session
- aXMPPResourceConnection
value of the connection session object.buddy
- aString
value of the buddy JID. It may be bare JID or full JID.- Returns:
- an
Element
value of the XML element with all the roster item data - JID, subscription, nick name and groups. Sample code for creating the buddy element could look like this:Element item = new Element("item", new Element[] { new Element("group", "Tigase devs")}, new String[] {"jid", "subscription", "name"}, new String[] {peer, "both", JIDUtils.getNodeNick(peer)});
- Throws:
NotAuthorizedException
- may be thrown if the connection session is not yet authenticated but authorization is required to access roster data.
-
getRosterItems
Description copied from interface:DynamicRosterIfc
getRosterItems
method returns a full list with all buddies generated by this dynamic roster implementation. The list contains all contacts for the roster with all contacts details - buddy JID, nick name, subscription (typically always both) and groups. Please have a look atgetBuddyItem(...)
description for details how to create an Element entry for the roster item.
In theory you could here call thegetBuddies(...)
method and then for each entry from the array call thegetBuddyItem(...)
. I strongly advice to not do it. This is a server with thousands of connected users and possibly thousands of packets going through the server. Think of a performance and execute database query once if possible rather then many times.- Specified by:
getRosterItems
in interfaceDynamicRosterIfc
- Parameters:
session
- aXMPPResourceConnection
value of the connection session object.- Returns:
- a
List<Element>
value - Throws:
NotAuthorizedException
- may be thrown if the connection session is not yet authenticated but authorization is required to access roster data.
-