com.planet_ink.coffee_mud.Libraries
Class AutoTitles

java.lang.Object
  com.planet_ink.coffee_mud.Libraries.StdLibrary
      com.planet_ink.coffee_mud.Libraries.AutoTitles

All Implemented Interfaces:

CMObject, AutoTitlesLibrary, CMLibrary, java.lang.Cloneable, java.lang.Comparable<CMObject>

public class AutoTitles
extends StdLibrary
implements AutoTitlesLibrary

Constructor Summary

AutoTitles()

Method Summary

java.util.Enumeration<java.lang.String>	autoTitles() Returns an enumerator of the auto-title strings themselves.
void	dispossesTitle(java.lang.String title) Scans all users in the database to ensure that the given title still belongs with them.
java.lang.String	evaluateAutoTitle(java.lang.String row, boolean addIfPossible) Scans an admin-given auto-title definition string to see if it is properly formatted for adding to the list of auto-titles.
boolean	evaluateAutoTitles(MOB mob) Scans all existing titles to see if any should be added to the given mob.
java.lang.String	getAutoTitleMask(java.lang.String title) Returns the string mask attributed to a particular title string.
java.lang.String	ID() The CoffeeMud Java Class ID shared by all instances of this object.
boolean	isExistingAutoTitle(java.lang.String title) Returns whether the given string matches one of the defined player titles.
void	reloadAutoTitles() Forces this library to re-load its list of titles from the resource file titles.txt.

Methods inherited from class com.planet_ink.coffee_mud.Libraries.StdLibrary

activate, compareTo, copyOf, getSupportThread, initializeClass, newInstance, propertiesLoaded, shutdown

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.planet_ink.coffee_mud.Libraries.interfaces.CMLibrary

activate, getSupportThread, propertiesLoaded, shutdown

Methods inherited from interface com.planet_ink.coffee_mud.core.interfaces.CMObject

copyOf, initializeClass, newInstance

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Detail

AutoTitles

public AutoTitles()

Method Detail

ID

public java.lang.String ID()

Description copied from interface: CMObject

The CoffeeMud Java Class ID shared by all instances of this object. Unlike the Java Class name, this method does not include package information. However, it must return a String value unique to its class category in the ClassLoader. Class categories include Libraries, Common, Areas, Abilities, Behaviors, CharClasses, Commands, Exits Locales, MOBS, Races, WebMacros, Basic Items, Armor, Weapons, ClanItems, MiscTech. The name is typically identical to the class name.

Specified by:

ID in interface CMObject

Overrides:

ID in class StdLibrary

Returns:

the name of this class

evaluateAutoTitle

public java.lang.String evaluateAutoTitle(java.lang.String row,
                                          boolean addIfPossible)

Description copied from interface: AutoTitlesLibrary

Scans an admin-given auto-title definition string to see if it is properly formatted for adding to the list of auto-titles.

Specified by:

evaluateAutoTitle in interface AutoTitlesLibrary

Parameters:

row - the admin-entered command string

addIfPossible - true to add it to the list, false to scan-only

Returns:

true if the title meets the criterium, false if it is rejected

isExistingAutoTitle

public boolean isExistingAutoTitle(java.lang.String title)

Description copied from interface: AutoTitlesLibrary

Returns whether the given string matches one of the defined player titles.

Specified by:

isExistingAutoTitle in interface AutoTitlesLibrary

Parameters:

title - the strong to match

Returns:

true if a title of that string exists, false otherwise

autoTitles

public java.util.Enumeration<java.lang.String> autoTitles()

Description copied from interface: AutoTitlesLibrary

Returns an enumerator of the auto-title strings themselves. The strings will substitute a * character for the players name when building the final title.

Specified by:

autoTitles in interface AutoTitlesLibrary

Returns:

an enumerator of the auto-title strings themselves

getAutoTitleMask

public java.lang.String getAutoTitleMask(java.lang.String title)

Description copied from interface: AutoTitlesLibrary

Returns the string mask attributed to a particular title string. The mask is as described by the masking library.

Specified by:

getAutoTitleMask in interface AutoTitlesLibrary

Parameters:

title - the title itself

Returns:

the zapper mask to determine who should get this title

See Also:

MaskingLibrary

evaluateAutoTitles

public boolean evaluateAutoTitles(MOB mob)

Description copied from interface: AutoTitlesLibrary

Scans all existing titles to see if any should be added to the given mob. If any match, the title is added to the mobs list of choices, after being customized.

Specified by:

evaluateAutoTitles in interface AutoTitlesLibrary

Parameters:

mob - the mob to check for new titles for

Returns:

true if any titles were added, false otherwise

dispossesTitle

public void dispossesTitle(java.lang.String title)

Description copied from interface: AutoTitlesLibrary

Scans all users in the database to ensure that the given title still belongs with them. If it doesn't, the title is removed.

Specified by:

dispossesTitle in interface AutoTitlesLibrary

Parameters:

title - the title to scan users qualifications for

reloadAutoTitles

public void reloadAutoTitles()

Description copied from interface: AutoTitlesLibrary

Forces this library to re-load its list of titles from the resource file titles.txt.

Specified by:

reloadAutoTitles in interface AutoTitlesLibrary