Package com.smartfoxserver.buddylist

Class SFSBuddyListManager

java.lang.Object

com.smartfoxserver.buddylist.SFSBuddyListManager

All Implemented Interfaces:

com.smartfoxserver.bitswarm.service.IService, BuddyListManager

public class SFSBuddyListManager
extends Object
implements BuddyListManager

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	active
protected final ISFSBuddyApi	buddyApi
protected final Map<String,BuddyList>	buddyLists
protected List<String>	buddyStates
protected BuddyStorage	buddyStorage
protected int	bvCacheSize
protected final org.slf4j.Logger	log
protected int	maxListSize
protected int	maxVariables
protected boolean	offlineBuddyVariables
protected com.smartfoxserver.buddylist.cache.BuddyVariablesCache	offlineVarsCache
protected final String	serviceName
protected final SmartFoxServer	sfs
protected boolean	useBadWordsFilter
protected final ISFSEventListener	userExitEventHandler
protected boolean	useTempBuddies
protected final Zone	zone

Constructor Summary

Constructors

Constructor	Description
SFSBuddyListManager(Zone parentZone, boolean isActive)

Method Summary

Modifier and Type	Method	Description
Buddy	addBuddy(String ownerName, String buddyName, boolean isTemp)	Use the SFSBuddyAPI
boolean	allowOfflineBuddyVariables()	Check if the "offline" (persistent) Buddy Variables are supported in the current Zone
void	destroy(Object o)
boolean	getApplyBadWordsFilter()	Check if the current Zone applies the WordFilter to the Buddy messages
BuddyList	getBuddyList(String ownerName)	Get the Buddy List of a specific user
int	getBuddyListMaxSize()	Get the maximum size of a BuddyList
List<String>	getBuddyStates()	Get a list of custom Buddy states such as "Available", "Occupied", "Be right back" etc...
List<ISession>	getClientsWatchingBuddy(String buddyName)
List<ISession>	getClientsWatchingBuddy(String buddyName, boolean onlineUsersOnly)
int	getMaxBuddyVariables()	Get the limit of BuddyVariables that each User can create
String	getName()
BuddyVariable	getOfflineBuddyVariable(String ownerName, String varName)
List<BuddyVariable>	getOfflineBuddyVariables(String ownerName)
List<BuddyVariable>	getOfflineBuddyVariables(String ownerName, boolean bypassCache)
int	getOfflineBuddyVariablesCacheSize()	Get the size of the "offline" Buddy Variables cache.
List<String>	getRecipientNamesForUpdate(String owner)
BuddyStorage	getStorageHandler()	Get a reference to the instance of the BuddyStorage class, which handles the data persistence
boolean	getUseTempBuddies()	Check if the current Zone supports temporary Buddies
Zone	getZone()	Get the parent Zone
void	handleMessage(Object arg0)
void	init(Object o)
boolean	isActive()	Check if the BuddyList management is active in the Zone
BuddyList	loadBuddyList(String ownerName)	Use the SFSBuddyAPI
Buddy	removeBuddy(String ownerName, String buddyName)	Use the SFSBuddyAPI
void	removeBuddyList(String ownerName)
void	saveAll()	This is called automatically by the system
void	saveBuddyList(String ownerName)	This is called automatically by the system
void	setActive(boolean value)
void	setAllowOfflineBuddyVariables(boolean value)
void	setApplyBadWordsFilter(boolean value)
void	setBuddyListMaxSize(int maxSize)
void	setBuddyStates(List<String> states)
void	setMaxBuddyVariables(int maxVariables)
void	setName(String arg0)
void	setOfflineBuddyVariablesCacheSize(int size)
void	setStorageHandler(BuddyStorage buddyStorage)
void	setUseTempBuddies(boolean value)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

log

protected final org.slf4j.Logger log

zone

protected final Zone zone

serviceName

protected final String serviceName

active

protected boolean active

offlineBuddyVariables

protected boolean offlineBuddyVariables

useTempBuddies

protected boolean useTempBuddies

useBadWordsFilter

protected boolean useBadWordsFilter

maxListSize

protected int maxListSize

maxVariables

protected int maxVariables

bvCacheSize

protected int bvCacheSize

buddyStorage

protected BuddyStorage buddyStorage

offlineVarsCache

protected com.smartfoxserver.buddylist.cache.BuddyVariablesCache offlineVarsCache

userExitEventHandler

protected final ISFSEventListener userExitEventHandler

buddyLists

protected final Map<String,BuddyList> buddyLists

sfs

protected final SmartFoxServer sfs

buddyApi

protected final ISFSBuddyApi buddyApi

buddyStates

protected List<String> buddyStates

Constructor Details

SFSBuddyListManager

public SFSBuddyListManager(Zone parentZone,
 boolean isActive)

Method Details

init

public void init(Object o)

Specified by:

init in interface com.smartfoxserver.bitswarm.service.IService

destroy

public void destroy(Object o)

Specified by:

destroy in interface com.smartfoxserver.bitswarm.service.IService

allowOfflineBuddyVariables

public boolean allowOfflineBuddyVariables()

Check if the "offline" (persistent) Buddy Variables are supported in the current Zone

Specified by:

allowOfflineBuddyVariables in interface BuddyListManager

Returns:

true if the "offline" (persistent) Buddy Variables are supported in the current Zone

setAllowOfflineBuddyVariables

public void setAllowOfflineBuddyVariables(boolean value)

Specified by:

setAllowOfflineBuddyVariables in interface BuddyListManager

addBuddy

public Buddy addBuddy(String ownerName,
 String buddyName,
 boolean isTemp)
               throws SFSBuddyListException

Use the SFSBuddyAPI

Specified by:

addBuddy in interface BuddyListManager

Throws:

SFSBuddyListException

See Also:

• SFSBuddyApi.addBuddy(com.smartfoxserver.entities.User, String, boolean, boolean, boolean)

getBuddyList

public BuddyList getBuddyList(String ownerName)

Get the Buddy List of a specific user

Specified by:

getBuddyList in interface BuddyListManager

Parameters:

ownerName - the user name

Returns:

the Buddy List

getBuddyListMaxSize

public int getBuddyListMaxSize()

Get the maximum size of a BuddyList

Specified by:

getBuddyListMaxSize in interface BuddyListManager

Returns:

the maximum size of a BuddyList

getMaxBuddyVariables

public int getMaxBuddyVariables()

Get the limit of BuddyVariables that each User can create

Specified by:

getMaxBuddyVariables in interface BuddyListManager

Returns:

the limit of BuddyVariables that each User can create

getStorageHandler

public BuddyStorage getStorageHandler()

Get a reference to the instance of the BuddyStorage class, which handles the data persistence

Specified by:

getStorageHandler in interface BuddyListManager

Returns:

a reference to the instance of the BuddyStorage class, which handles the data persistence

getZone

public Zone getZone()

Get the parent Zone

Specified by:

getZone in interface BuddyListManager

Returns:

the parent Zone

isActive

public boolean isActive()

Check if the BuddyList management is active in the Zone

Specified by:

isActive in interface BuddyListManager

Returns:

true if the BuddyList management is active in the Zone

loadBuddyList

public BuddyList loadBuddyList(String ownerName)
                        throws IOException

Use the SFSBuddyAPI

Specified by:

loadBuddyList in interface BuddyListManager

Throws:

IOException

See Also:

• SFSBuddyApi.initBuddyList(com.smartfoxserver.entities.User, boolean)

removeBuddy

public Buddy removeBuddy(String ownerName,
 String buddyName)

Use the SFSBuddyAPI

Specified by:

removeBuddy in interface BuddyListManager

removeBuddyList

public void removeBuddyList(String ownerName)

Specified by:

removeBuddyList in interface BuddyListManager

saveAll

public void saveAll()

This is called automatically by the system

Specified by:

saveAll in interface BuddyListManager

saveBuddyList

public void saveBuddyList(String ownerName)
                   throws IOException

This is called automatically by the system

Specified by:

saveBuddyList in interface BuddyListManager

Throws:

IOException

getBuddyStates

public List<String> getBuddyStates()

Get a list of custom Buddy states such as "Available", "Occupied", "Be right back" etc... These states are defined in the Zone configuration and are transmitted to the client upon Buddy List initialization.

Specified by:

getBuddyStates in interface BuddyListManager

Returns:

a list of custom Buddy states

setBuddyStates

public void setBuddyStates(List<String> states)

Specified by:

setBuddyStates in interface BuddyListManager

getApplyBadWordsFilter

public boolean getApplyBadWordsFilter()

Check if the current Zone applies the WordFilter to the Buddy messages

Specified by:

getApplyBadWordsFilter in interface BuddyListManager

Returns:

true if the current Zone applies the WordFilter to the Buddy messages

See Also:

• SFSBuddyApi.sendBuddyMessage(com.smartfoxserver.entities.User, com.smartfoxserver.entities.User, String, com.smartfoxserver.entities.data.ISFSObject)

setApplyBadWordsFilter

public void setApplyBadWordsFilter(boolean value)

Specified by:

setApplyBadWordsFilter in interface BuddyListManager

getOfflineBuddyVariable

public BuddyVariable getOfflineBuddyVariable(String ownerName,
 String varName)

Specified by:

getOfflineBuddyVariable in interface BuddyListManager

getOfflineBuddyVariables

public List<BuddyVariable> getOfflineBuddyVariables(String ownerName)

Specified by:

getOfflineBuddyVariables in interface BuddyListManager

getOfflineBuddyVariables

public List<BuddyVariable> getOfflineBuddyVariables(String ownerName,
 boolean bypassCache)

Specified by:

getOfflineBuddyVariables in interface BuddyListManager

setActive

public void setActive(boolean value)

Specified by:

setActive in interface BuddyListManager

setBuddyListMaxSize

public void setBuddyListMaxSize(int maxSize)

Specified by:

setBuddyListMaxSize in interface BuddyListManager

setMaxBuddyVariables

public void setMaxBuddyVariables(int maxVariables)

Specified by:

setMaxBuddyVariables in interface BuddyListManager

getOfflineBuddyVariablesCacheSize

public int getOfflineBuddyVariablesCacheSize()

Get the size of the "offline" Buddy Variables cache.

Specified by:

getOfflineBuddyVariablesCacheSize in interface BuddyListManager

Returns:

the size of the "offline" Buddy Variables cache.

setOfflineBuddyVariablesCacheSize

public void setOfflineBuddyVariablesCacheSize(int size)

Specified by:

setOfflineBuddyVariablesCacheSize in interface BuddyListManager

setStorageHandler

public void setStorageHandler(BuddyStorage buddyStorage)

Specified by:

setStorageHandler in interface BuddyListManager

getName

public String getName()

Specified by:

getName in interface com.smartfoxserver.bitswarm.service.IService

handleMessage

public void handleMessage(Object arg0)
                   throws Exception

Specified by:

handleMessage in interface com.smartfoxserver.bitswarm.service.IService

Throws:

Exception

setName

public void setName(String arg0)

Specified by:

setName in interface com.smartfoxserver.bitswarm.service.IService

getUseTempBuddies

public boolean getUseTempBuddies()

Check if the current Zone supports temporary Buddies

Specified by:

getUseTempBuddies in interface BuddyListManager

Returns:

true if the current Zone supports temporary Buddies

setUseTempBuddies

public void setUseTempBuddies(boolean value)

Specified by:

setUseTempBuddies in interface BuddyListManager

getClientsWatchingBuddy

public List<ISession> getClientsWatchingBuddy(String buddyName)

Specified by:

getClientsWatchingBuddy in interface BuddyListManager

getRecipientNamesForUpdate

public List<String> getRecipientNamesForUpdate(String owner)

Specified by:

getRecipientNamesForUpdate in interface BuddyListManager

getClientsWatchingBuddy

public List<ISession> getClientsWatchingBuddy(String buddyName,
 boolean onlineUsersOnly)

Specified by:

getClientsWatchingBuddy in interface BuddyListManager