Manages the contents of a recent or bookmark menu. More...

Collaboration diagram for net.sf.gridarta.gui.mapmenu.MapMenu:

Classes
class	DeletedNode
	Result value consisting of a TreeNode and its location (directory). More...

Public Member Functions
void	addMapMenuEntry (@NotNull final String directory, @NotNull final MapMenuEntry mapMenuEntry)
	Adds a MapMenuEntry to this menu. More...

TreePath	addMapMenuEntry (@NotNull final String directory, @NotNull final DefaultMutableTreeNode treeNode)
	Adds a DefaultMutableTreeNode to this menu. More...

DeletedNode	getDeletedNode (final boolean delete)
	Returns the last deleted node. More...

DefaultMutableTreeNode	getOrCreateDirectory (@NotNull final MutableTreeNode this2, @NotNull final String path)
	Returns the MapMenuEntryDir for a given path. More...

DefaultMutableTreeNode	getRoot ()
	Returns the root node. More...

TreePath	insertNodeInto (@NotNull final MapMenuEntry mapEntry, @NotNull final DefaultMutableTreeNode parent, final int index)
	Inserts a new node into the tree. More...

void	load ()
	Loads the contents from preferences. More...

	MapMenu (@NotNull final String key, @NotNull final PathManager pathManager)
	Creates a new instance. More...

JTree	newTree ()
	Creates a new JTree for this map menu. More...

void	removeNode (@NotNull final DefaultMutableTreeNode treeNode)
	Removes a node from the tree. More...

void	save ()
	Saves the contents to preferences if modified since last save. More...

void	saveAlways ()
	Saves the contents to preferences. More...

int	size ()
	Returns the number of entries in this menu. More...

Private Member Functions
String	getDirectory (@NotNull final TreeNode treeNode)
	Returns the directory of a TreeNode. More...

int	saveEntries (@NotNull final DefaultMutableTreeNode treeNode, final int startIndex, @NotNull final String directory)
	Saves a TreeNode instance's contents to preferences. More...

int	size (@NotNull final TreeNode root)
	Returns the number of entries in a sub-tree. More...

Private Attributes
final Deque< DeletedNode >	deletedNodes = new ArrayDeque<>()
	Recently deleted nodes. More...

final MapMenuLoader	mapMenuLoader
	The MapMenuLoader for loading/storing the menu contents. More...

final DefaultMutableTreeNode	root = new DefaultMutableTreeNode(new MapMenuEntryDir("Bookmarks"), true)
	The root node of treeModel. More...

final DefaultTreeModel	treeModel = new DefaultTreeModel(root)
	The DefaultTreeModel that contains all menu entries. More...

final TreeModelListener	treeModelListener
	The TreeModelListener attached to treeModel for detecting modifications. More...

boolean	treeModelModified
	Whether treeModel has been modified since last save. More...

Static Private Attributes
static final Category	LOG = Logger.getLogger(MapMenu.class)
	The Logger for printing log messages. More...

Detailed Description

Manages the contents of a recent or bookmark menu.

Author: Andreas Kirschbaum

Definition at line 44 of file MapMenu.java.

Constructor & Destructor Documentation

◆ MapMenu()

net.sf.gridarta.gui.mapmenu.MapMenu.MapMenu	(	@NotNull final String	key,
		@NotNull final PathManager	pathManager
	)

Creates a new instance.

Parameters

key	the preferences key prefix
pathManager	the path manager instance

Definition at line 115 of file MapMenu.java.

Member Function Documentation

◆ addMapMenuEntry() [1/2]

void net.sf.gridarta.gui.mapmenu.MapMenu.addMapMenuEntry	(	@NotNull final String	directory,
		@NotNull final MapMenuEntry	mapMenuEntry
	)

Adds a MapMenuEntry to this menu.

Parameters

directory	the directory to add to
mapMenuEntry	the map menu entry TypeMayBeWeakened

Definition at line 209 of file MapMenu.java.

Referenced by net.sf.gridarta.gui.dialog.bookmarks.ManageBookmarksDialog< G, A, R >.doUnDeleteBookmark(), net.sf.gridarta.gui.mapmenu.MapMenu.load(), and net.sf.gridarta.gui.mapmenu.MapMenuPreferencesTest.test3().

Here is the caller graph for this function:

◆ addMapMenuEntry() [2/2]

TreePath net.sf.gridarta.gui.mapmenu.MapMenu.addMapMenuEntry	(	@NotNull final String	directory,
		@NotNull final DefaultMutableTreeNode	treeNode
	)

Adds a DefaultMutableTreeNode to this menu.

Parameters

directory	the directory to add to
treeNode	the tree node

Returns: the tree path for the inserted node TypeMayBeWeakened

Definition at line 221 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenu.getOrCreateDirectory(), net.sf.gridarta.utils.StringUtils.PATTERN_SLASH, and net.sf.gridarta.gui.mapmenu.MapMenu.root.

Here is the call graph for this function:

◆ getDeletedNode()

DeletedNode net.sf.gridarta.gui.mapmenu.MapMenu.getDeletedNode ( final boolean delete )

Returns the last deleted node.

Parameters

delete whether to delete the returned node

Returns: the deleted node or
null

Definition at line 343 of file MapMenu.java.

Referenced by net.sf.gridarta.gui.dialog.bookmarks.ManageBookmarksDialog< G, A, R >.doUnDeleteBookmark().

Here is the caller graph for this function:

◆ getDirectory()

String net.sf.gridarta.gui.mapmenu.MapMenu.getDirectory ( @NotNull final TreeNode treeNode )

private

Returns the directory of a TreeNode.

Parameters

treeNode the tree node

Returns: the directory

Definition at line 320 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenuEntry.getTitle(), and net.sf.gridarta.gui.mapmenu.MapMenuEntry.toString().

Referenced by net.sf.gridarta.gui.mapmenu.MapMenu.removeNode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getOrCreateDirectory()

DefaultMutableTreeNode net.sf.gridarta.gui.mapmenu.MapMenu.getOrCreateDirectory	(	@NotNull final MutableTreeNode	this2,
		@NotNull final String	path
	)

Returns the MapMenuEntryDir for a given path.

If more than one matching path exists the last one is returned.

Parameters

this2	the tree node to insert into
path	the path; must not contain '/'

Returns: the entry

Definition at line 244 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenuEntry.allowsChildren(), net.sf.gridarta.gui.mapmenu.MapMenuEntry.getTitle(), and net.sf.gridarta.gui.mapmenu.MapMenuEntryDir.isValidDirectory().

Referenced by net.sf.gridarta.gui.mapmenu.MapMenu.addMapMenuEntry(), net.sf.gridarta.gui.mapmenu.MapMenuTest.testSubDir1(), and net.sf.gridarta.gui.mapmenu.MapMenuTest.testSubDir2().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRoot()

DefaultMutableTreeNode net.sf.gridarta.gui.mapmenu.MapMenu.getRoot ( )

Returns the root node.

Returns: the root node

Definition at line 390 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenu.root.

Here is the caller graph for this function:

◆ insertNodeInto()

TreePath net.sf.gridarta.gui.mapmenu.MapMenu.insertNodeInto	(	@NotNull final MapMenuEntry	mapEntry,
		@NotNull final DefaultMutableTreeNode	parent,
		final int	index
	)

Inserts a new node into the tree.

Parameters

mapEntry	the map entry to add
parent	the parent node to add to
index	the index to add at

Returns: the tree path for the inserted node TypeMayBeWeakened

Definition at line 280 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenu.save().

Referenced by net.sf.gridarta.gui.mapmenu.TestMapMenuPreferences.addEntry(), net.sf.gridarta.gui.mapmenu.BookmarksMapMenuPreferences.addEntry(), net.sf.gridarta.gui.mapmenu.RecentMapMenuPreferences.addEntry(), and net.sf.gridarta.gui.dialog.bookmarks.ManageBookmarksDialog< G, A, R >.doNewDirectory().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ load()

void net.sf.gridarta.gui.mapmenu.MapMenu.load ( )

Loads the contents from preferences.

Definition at line 127 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenu.addMapMenuEntry(), net.sf.gridarta.gui.mapmenu.MapMenuLoader.loadEntry(), and net.sf.gridarta.gui.mapmenu.MapMenuLoader.loadNumEntries().

Referenced by net.sf.gridarta.gui.mapmenu.MapMenuManager< G extends GameObject< G, A, R, A extends MapArchObject< A, R extends Archetype< G, A, R >.initRecent(), net.sf.gridarta.gui.mapmenu.MapMenuPreferencesTest.test2(), and net.sf.gridarta.gui.mapmenu.MapMenuPreferencesTest.test3().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ newTree()

JTree net.sf.gridarta.gui.mapmenu.MapMenu.newTree ( )

Creates a new JTree for this map menu.

Returns: the tree

Definition at line 381 of file MapMenu.java.

◆ removeNode()

void net.sf.gridarta.gui.mapmenu.MapMenu.removeNode ( @NotNull final DefaultMutableTreeNode treeNode )

Removes a node from the tree.

Parameters

treeNode the tree node to remove TypeMayBeWeakened

Definition at line 295 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenu.getDirectory(), and net.sf.gridarta.gui.mapmenu.MapMenu.save().

Referenced by net.sf.gridarta.gui.dialog.bookmarks.ManageBookmarksDialog< G, A, R >.doRemoveBookmark().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

void net.sf.gridarta.gui.mapmenu.MapMenu.save ( )

Saves the contents to preferences if modified since last save.

Definition at line 149 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenu.saveAlways().

Referenced by net.sf.gridarta.gui.mapmenu.MapMenu.insertNodeInto(), net.sf.gridarta.gui.mapmenu.MapMenu.removeNode(), and net.sf.gridarta.gui.dialog.bookmarks.ManageBookmarksDialog< G, A, R >.setValue().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveAlways()

void net.sf.gridarta.gui.mapmenu.MapMenu.saveAlways ( )

Saves the contents to preferences.

Definition at line 161 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenuLoader.loadNumEntries(), net.sf.gridarta.gui.mapmenu.MapMenuLoader.removeEntry(), net.sf.gridarta.gui.mapmenu.MapMenu.saveEntries(), and net.sf.gridarta.gui.mapmenu.MapMenuLoader.saveNumEntries().

Referenced by net.sf.gridarta.gui.mapmenu.MapMenu.save(), net.sf.gridarta.gui.mapmenu.MapMenuPreferencesTest.test2(), and net.sf.gridarta.gui.mapmenu.MapMenuPreferencesTest.test3().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveEntries()

int net.sf.gridarta.gui.mapmenu.MapMenu.saveEntries	(	@NotNull final DefaultMutableTreeNode	treeNode,
		final int	startIndex,
		@NotNull final String	directory
	)

private

Saves a TreeNode instance's contents to preferences.

Parameters

treeNode	the tree node instance
startIndex	the preference index for saving the first entry
directory	the directory of the tree node

Returns: the preference index for saving the next entry

Definition at line 177 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenuLoader.Type.DIR, net.sf.gridarta.model.mapmodel.MapFile.getFile(), net.sf.gridarta.gui.mapmenu.MapMenuEntryMap.getMapFile(), net.sf.gridarta.gui.mapmenu.MapMenuEntry.getTitle(), net.sf.gridarta.gui.mapmenu.MapMenuLoader.Type.MAP, net.sf.gridarta.gui.mapmenu.MapMenuLoader.saveEntry(), and net.sf.gridarta.gui.mapmenu.MapMenuEntry.visit().

Referenced by net.sf.gridarta.gui.mapmenu.MapMenu.saveAlways().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ size() [1/2]

int net.sf.gridarta.gui.mapmenu.MapMenu.size ( )

Returns the number of entries in this menu.

Returns: the number of entries

Definition at line 351 of file MapMenu.java.

Referenced by net.sf.gridarta.gui.mapmenu.MapMenu.size(), net.sf.gridarta.gui.mapmenu.MapMenuPreferencesTest.test2(), and net.sf.gridarta.gui.mapmenu.MapMenuManagerTest.testSaveBookmarks().

Here is the caller graph for this function:

◆ size() [2/2]

int net.sf.gridarta.gui.mapmenu.MapMenu.size ( @NotNull final TreeNode root )

private

Returns the number of entries in a sub-tree.

Parameters

root	the root of the sub-tree

Returns: the number of entries

Definition at line 360 of file MapMenu.java.

References net.sf.gridarta.gui.mapmenu.MapMenuEntry.allowsChildren(), and net.sf.gridarta.gui.mapmenu.MapMenu.size().

Here is the call graph for this function:

Member Data Documentation

◆ deletedNodes

final Deque<DeletedNode> net.sf.gridarta.gui.mapmenu.MapMenu.deletedNodes = new ArrayDeque<>()

private

Recently deleted nodes.

The first node is the last deleted node.

Definition at line 74 of file MapMenu.java.

◆ LOG

final Category net.sf.gridarta.gui.mapmenu.MapMenu.LOG = Logger.getLogger(MapMenu.class)

staticprivate

The Logger for printing log messages.

Definition at line 50 of file MapMenu.java.

◆ mapMenuLoader

final MapMenuLoader net.sf.gridarta.gui.mapmenu.MapMenu.mapMenuLoader

private

The MapMenuLoader for loading/storing the menu contents.

Definition at line 56 of file MapMenu.java.

◆ root

final DefaultMutableTreeNode net.sf.gridarta.gui.mapmenu.MapMenu.root = new DefaultMutableTreeNode(new MapMenuEntryDir("Bookmarks"), true)

private

The root node of treeModel.

Definition at line 62 of file MapMenu.java.

Referenced by net.sf.gridarta.gui.mapmenu.MapMenu.addMapMenuEntry(), and net.sf.gridarta.gui.mapmenu.MapMenu.getRoot().

◆ treeModel

final DefaultTreeModel net.sf.gridarta.gui.mapmenu.MapMenu.treeModel = new DefaultTreeModel(root)

private

The DefaultTreeModel that contains all menu entries.

Definition at line 68 of file MapMenu.java.

◆ treeModelListener

final TreeModelListener net.sf.gridarta.gui.mapmenu.MapMenu.treeModelListener

private

Initial value:

= new TreeModelListener() {
        @Override
        public void treeNodesChanged(final TreeModelEvent e) {
            treeModelModified = true;
        }
        @Override
        public void treeNodesInserted(final TreeModelEvent e) {
            treeModelModified = true;
        }
        @Override
        public void treeNodesRemoved(final TreeModelEvent e) {
            treeModelModified = true;
        }
        @Override
        public void treeStructureChanged(final TreeModelEvent e) {
            treeModelModified = true;
        }
    }

The TreeModelListener attached to treeModel for detecting modifications.

Definition at line 86 of file MapMenu.java.

◆ treeModelModified

boolean net.sf.gridarta.gui.mapmenu.MapMenu.treeModelModified

private

Whether treeModel has been modified since last save.

Definition at line 79 of file MapMenu.java.

The documentation for this class was generated from the following file:

gridarta-gridarta/src/gridarta/src/main/java/net/sf/gridarta/gui/mapmenu/MapMenu.java

Classes

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ MapMenu()

Member Function Documentation

◆ addMapMenuEntry() [1/2]

◆ addMapMenuEntry() [2/2]

◆ getDeletedNode()

◆ getDirectory()

◆ getOrCreateDirectory()

◆ getRoot()

◆ insertNodeInto()

◆ load()

◆ newTree()

◆ removeNode()

◆ save()

◆ saveAlways()

◆ saveEntries()

◆ size() [1/2]

◆ size() [2/2]

Member Data Documentation

◆ deletedNodes

◆ LOG

◆ mapMenuLoader

◆ root

◆ treeModel

◆ treeModelListener

◆ treeModelModified