Smack

org.jivesoftware.smackx.workgroup.agent
Class AgentRoster

java.lang.Object
  extended by org.jivesoftware.smackx.workgroup.agent.AgentRoster

public class AgentRoster
extends Object

Manges information about the agents in a workgroup and their presence.

Author:
Matt Tucker
See Also:
AgentSession.getAgentRoster()

Method Summary
 void addListener(AgentRosterListener listener)
          Adds a listener to this roster.
 boolean contains(String jid)
          Returns true if the specified XMPP address is an agent in the workgroup.
 int getAgentCount()
          Returns a count of all agents in the workgroup.
 Set<String> getAgents()
          Returns all agents (String JID values) in the workgroup.
 Presence getPresence(String user)
          Returns the presence info for a particular agent, or null if the agent is unavailable (offline) or if no presence information is available.
 void reload()
          Reloads the entire roster from the server.
 void removeListener(AgentRosterListener listener)
          Removes a listener from this roster.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

reload

public void reload()
Reloads the entire roster from the server. This is an asynchronous operation, which means the method will return immediately, and the roster will be reloaded at a later point when the server responds to the reload request.


addListener

public void addListener(AgentRosterListener listener)
Adds a listener to this roster. The listener will be fired anytime one or more changes to the roster are pushed from the server.

Parameters:
listener - an agent roster listener.

removeListener

public void removeListener(AgentRosterListener listener)
Removes a listener from this roster. The listener will be fired anytime one or more changes to the roster are pushed from the server.

Parameters:
listener - a roster listener.

getAgentCount

public int getAgentCount()
Returns a count of all agents in the workgroup.

Returns:
the number of agents in the workgroup.

getAgents

public Set<String> getAgents()
Returns all agents (String JID values) in the workgroup.

Returns:
all entries in the roster.

contains

public boolean contains(String jid)
Returns true if the specified XMPP address is an agent in the workgroup.

Parameters:
jid - the XMPP address of the agent (eg "jsmith@example.com"). The address can be in any valid format (e.g. "domain/resource", "user@domain" or "user@domain/resource").
Returns:
true if the XMPP address is an agent in the workgroup.

getPresence

public Presence getPresence(String user)
Returns the presence info for a particular agent, or null if the agent is unavailable (offline) or if no presence information is available.

Parameters:
user - a fully qualified xmpp JID. The address could be in any valid format (e.g. "domain/resource", "user@domain" or "user@domain/resource").
Returns:
the agent's current presence, or null if the agent is unavailable or if no presence information is available..

Smack

Copyright © 2003-2007 Jive Software.