com.nomagic.actions

Class ActionsManager

java.lang.Object

com.nomagic.actions.ActionsManager

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

MDActionsManager

@OpenApiAll
public class ActionsManager
extends java.lang.Object
implements java.lang.Cloneable

The class responsible for managing the actions and categories. It has a list of categories and the helper maps where actions are registered by shortcuts and by id.

See Also:

ActionsCategory, NMAction

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ActionsManager.ActionPropertyChangeListener The action property change listener class.
static interface	ActionsManager.CategoryAdder Knows how to add categories to the manager.

Constructor Summary

Constructors

Constructor and Description
ActionsManager()
ActionsManager(ActionsManager parent) Creates the actions manager.

Method Summary

Modifier and Type	Method and Description
void	addActionNearTheGiven(java.lang.String givenID, boolean addAfter, NMAction action) Adds given action near the action with the given id.
void	addCategory(ActionsCategory category) Adds the given category to the manager.
void	addCategory(ActionsCategory relatedCategory, ActionsCategory category, boolean addAfter) Adds the given category to the manager.
void	addCategory(int index, ActionsCategory category) Adds the given category to the manager.
void	addCategory(java.lang.String relatedCategoryID, ActionsCategory category, boolean addAfter) Adds the given category to the manager.
java.lang.Object	clone() Clones the manager.
static MDAction	constructNoneAction() Constructs a none action.
void	dropCache()
NMAction	getActionFor(javax.swing.KeyStroke stroke) Returns the action for given stroke.
NMAction	getActionFor(java.lang.String id) Returns the action for given id.
NMAction	getActionParent(NMAction action) Returns parent action for given action.
ActionsCategory	getActionsCategoryRecursively(java.util.List<ActionsCategory> categories, java.lang.String id) Recursively finds an action category with a given id.
java.util.List<NMAction>	getAllActions() Returns the list of all actions registered in this manager.
java.util.List<NMAction>	getAllOrderedActions(boolean includeCategories) Returns the list if all ordered actions registered in this manager.
java.util.List<ActionsCategory>	getCategories() Returns the list of the categories.
ActionsCategory	getCategory(java.lang.String id) Returns the category with given id.
java.util.Map<java.lang.String,NMAction>	getIdToActionMap()
ActionsCategory	getLastActionsCategory() Returns last category by order.
ActionsManager	getParent() Returns the actions manager parent.
boolean	isEmpty()
ActionsManager	makeCopy() Copies this manager and adds property change listeners to all actions in order to have the same action state in source and copy.
void	removeAction(NMAction action) Removes action from this manager.
void	removeAction(NMAction action, NMAction parent) Removes action with given ID from this manager.
void	removeAction(java.lang.String actionID) Removes action with given ID from this manager.
void	removeAllActions() Removes all actions.
void	removeCategory(ActionsCategory category) Removes the given category from the manager.
void	setCategories(java.util.List<? extends ActionsCategory> list) Sets the list of the categories.
void	setParent(ActionsManager parent) Sets the actions manager parent.
void	setWarningsOutputEnabled(boolean mode) Setting silent mode disables outputs to std out about duplicate actions.
void	unregisterAllActions() Unregisters all actions.
void	updateCommandKeysFrom(ActionsManager manager) Takes all action from the given manager and overwrites the command keys for actions in this manager.
void	updateStateForAllActions() Calls updateState() method for all inner actions.

Methods inherited from class java.lang.Object

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

Constructor Detail

ActionsManager

public ActionsManager(@CheckForNull
                      ActionsManager parent)

Creates the actions manager.

Parameters:

parent - the parent of the actions manager. May be null.

ActionsManager

public ActionsManager()

Method Detail

getCategories

public java.util.List<ActionsCategory> getCategories()

Returns the list of the categories.

Returns:

the cloned list of the categories.

getActionsCategoryRecursively

@CheckForNull
public ActionsCategory getActionsCategoryRecursively(java.util.List<ActionsCategory> categories,
                                                                   java.lang.String id)

Recursively finds an action category with a given id.

Parameters:

categories - categories to search.

id - id of a category to find.

Returns:

found action category or null if it is not found.

setCategories

public void setCategories(java.util.List<? extends ActionsCategory> list)

Sets the list of the categories. All old actions will be unregistered and new registered.

Parameters:

list - the list of the categories.

addCategory

public void addCategory(ActionsCategory category)

Adds the given category to the manager. The actions from the given category will be registered.

Parameters:

category - the given category.

addCategory

public void addCategory(int index,
                        ActionsCategory category)

Adds the given category to the manager. The actions from the given category will be registered.

Parameters:

category - the given category.

index - index where category will be added.

removeCategory

public void removeCategory(ActionsCategory category)

Removes the given category from the manager. The actions from the given category will be unregistered.

Parameters:

category - the given category.

addCategory

public void addCategory(java.lang.String relatedCategoryID,
                        ActionsCategory category,
                        boolean addAfter)

Adds the given category to the manager. The actions from the given category will be registered.

Parameters:

relatedCategoryID - related category id

category - the given category

addAfter - add after related category or before related category

addCategory

public void addCategory(@CheckForNull
                        ActionsCategory relatedCategory,
                        ActionsCategory category,
                        boolean addAfter)

Adds the given category to the manager. The actions from the given category will be registered.

Parameters:

relatedCategory - related category

category - the given category

addAfter - add after related category or before related category

getCategory

@CheckForNull
public ActionsCategory getCategory(java.lang.String id)

Returns the category with given id.

Parameters:

id - the id of the category.

Returns:

the category with given id or null if this manager does not have such category.

updateCommandKeysFrom

public void updateCommandKeysFrom(ActionsManager manager)

Takes all action from the given manager and overwrites the command keys for actions in this manager.

Parameters:

manager - the given manager.

getAllActions

public java.util.List<NMAction> getAllActions()

Returns the list of all actions registered in this manager.

Returns:

the list of all registered actions.

isEmpty

public boolean isEmpty()

Returns:

true if this manager currently contains no actions, false if there are actions. Parent actions are not considered

getAllOrderedActions

public java.util.List<NMAction> getAllOrderedActions(boolean includeCategories)

Returns the list if all ordered actions registered in this manager.

Parameters:

includeCategories - If true, then ActionsCategories will be included in the list

Returns:

the list of all registered actions.

removeAllActions

public void removeAllActions()

Removes all actions.

unregisterAllActions

public void unregisterAllActions()

Unregisters all actions.

getActionFor

@CheckForNull
public NMAction getActionFor(javax.swing.KeyStroke stroke)

Returns the action for given stroke. If this manager does not have such action, it looks in the parent.

Parameters:

stroke - stroke

Returns:

the action for given stroke or null if there are no action with such stroke.

getActionFor

@CheckForNull
public NMAction getActionFor(java.lang.String id)

Returns the action for given id. If this manager does not have such action, it looks in the parent.

Parameters:

id - action id

Returns:

the action for given id or null if there are no action with such id.

getIdToActionMap

public java.util.Map<java.lang.String,NMAction> getIdToActionMap()

clone

public java.lang.Object clone()

Clones the manager. Does deep clone.

Overrides:

clone in class java.lang.Object

Returns:

cloned instance

dropCache

public void dropCache()

setParent

public void setParent(@CheckForNull
                      ActionsManager parent)

Sets the actions manager parent.

Parameters:

parent - the new parent.

getParent

@CheckForNull
public ActionsManager getParent()

Returns the actions manager parent.

Returns:

parent.

getActionParent

@CheckForNull
public NMAction getActionParent(NMAction action)

Returns parent action for given action. Searches for the action object itself, if a provided object is not found actions are compared using equals(by action ID).

Parameters:

action - the given action.

Returns:

parent of given action.

makeCopy

public ActionsManager makeCopy()

Copies this manager and adds property change listeners to all actions in order to have the same action state in source and copy.

Returns:

copied manager.

setWarningsOutputEnabled

public void setWarningsOutputEnabled(boolean mode)

Setting silent mode disables outputs to std out about duplicate actions.

Parameters:

mode - mode of output warnings. True disables warnings.

updateStateForAllActions

public void updateStateForAllActions()

Calls updateState() method for all inner actions.

See Also:

NMAction.updateState()

getLastActionsCategory

@CheckForNull
public ActionsCategory getLastActionsCategory()

Returns last category by order.

Returns:

last category

removeAction

public void removeAction(java.lang.String actionID)

Removes action with given ID from this manager. Searches for action parent, removes action from it's parent and removes parent if it does not have any more actions. If given ID is id of root category(added into manager), removes this category.

Parameters:

actionID - actionID id of action to remove.

removeAction

public void removeAction(NMAction action)

Removes action from this manager.

Parameters:

action - action to remove.

removeAction

public void removeAction(NMAction action,
                         @CheckForNull
                         NMAction parent)

Removes action with given ID from this manager. Takes given parent, removes action from it's parent and removes parent if it does not have any more actions. If given ID is id of root category(added into manager), removes this category.

Parameters:

action - action to remove.

parent - parent of action to remove from.

addActionNearTheGiven

public void addActionNearTheGiven(@CheckForNull
                                  java.lang.String givenID,
                                  boolean addAfter,
                                  @CheckForNull
                                  NMAction action)

Adds given action near the action with the given id. The given action will be added into the same parent as action with givenID. The position of the given action will be above or below the "givenID".

Parameters:

givenID - the id of action to add near.

addAfter - add after or before "givenID"

action - the action to add.

constructNoneAction

public static MDAction constructNoneAction()

Constructs a none action.

Returns:

created none action.