Interface Buddy

All Known Implementing Classes:
SFSBuddy

public interface Buddy
  • Method Details

    • getName

      String getName()
      The Buddy name, which corresponds to the User name.
      Returns:
      the name of the buddy
    • getState

      String getState()
      Returns the current Buddy State
      Returns:
      the current buddy states
    • getNickName

      String getNickName()
      Get the nickname of the Buddy. By default no Buddies have no nickname set
    • isBlocked

      boolean isBlocked()
      When a Buddy is blocked he won't be able to see the User status and send him messages
      Returns:
      true if the Buddy is blocked
    • setBlocked

      void setBlocked(boolean value)
      Block the Buddy
      Parameters:
      value - true to block the buddy, false to unblock him
    • isTemp

      boolean isTemp()
      A temporary Buddy will only exist at runtime but will be lost as soon as he goes away or the user is disconnected. It is never saved.
      Returns:
      true if the Buddy is temporary
    • setIsTemp

      void setIsTemp(boolean value)
    • isOnline

      boolean isOnline()
      Checks if the Buddy is active in the system
      Returns:
      true if the Buddy is online
    • getParentBuddyList

      BuddyList getParentBuddyList()
      Return the parent BuddyList containing this Buddy
      Returns:
      the parent BuddyList
    • setParentBuddyList

      void setParentBuddyList(BuddyList parentList)
      Set the parent BuddyList
      Parameters:
      parentList - the BuddyList
    • hasVariables

      boolean hasVariables()
      Checks if the Buddy has at least one variable set
      Returns:
      true if at least 1 variable exists for this buddy
    • getVariable

      BuddyVariable getVariable(String varName)
      Get a Buddy Variable from its name
      Parameters:
      varName - the variable name
      Returns:
      the BuddyVariable or null if no variables was ever set with that name
    • getVariables

      List<BuddyVariable> getVariables()
      Get all BuddyVariables
      Returns:
      a List with all the BuddyVariables
    • setVariable

      void setVariable(BuddyVariable buddyVariable)
      Set / modify a BuddyVariable.
      By convention any variables starting with a '$' (dollar sign) will be stored persistently when the use goes off-line
      Persistent variables are available even when the Buddy is not online.
      Parameters:
      buddyVariable - the Buddy Variable
    • setVariables

      void setVariables(List<BuddyVariable> buddyVariables)
      Sets a number of variables at once.
      Parameters:
      buddyVariables - a list of variables
    • toSFSArray

      ISFSArray toSFSArray()
    • getBuddyVariablesData

      ISFSArray getBuddyVariablesData()