Package org.opensourcephysics.tools

Class LaunchNode

java.lang.Object

javax.swing.tree.DefaultMutableTreeNode

org.opensourcephysics.tools.LaunchNode

public class LaunchNode
extends javax.swing.tree.DefaultMutableTreeNode

This is a tree node that can describe and launch an application.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	LaunchNode.DisplayTab	A class to hold display tab data.

Field Summary

Fields inherited from class javax.swing.tree.DefaultMutableTreeNode

allowsChildren, children, EMPTY_ENUMERATION, parent, userObject

Constructor Summary

Constructors

Constructor	Description
LaunchNode(java.lang.String name)	Constructs a node with the specified name.

Method Summary

Modifier and Type	Method	Description
LaunchNode.DisplayTab	addDisplayTab(java.lang.String title, java.lang.String path, java.lang.String[] args)	Adds a display tab with the specified title and relative path.
LaunchNode.DisplayTab	addHTML(java.lang.String title, java.lang.String path)	Deprecated. replaced by addDisplayTab
void	addMenuItemsTo(javax.swing.JComponent menu)	Adds menu item to a JPopupMenu or JMenu.
void	addTerminateAction(javax.swing.Action action)	Adds an action to this node's actions collection.
boolean	exists()	Determines whether a resource exists for this node.
LaunchNode[]	getAllOwnedNodes()	Returns all descendents of this node with non-null file names.
java.lang.String[]	getArgs()	Gets the launch arguments of this node.
java.lang.String	getAuthor()	Gets the author.
LaunchNode	getChildNode(java.lang.String childFileName)	Gets a child node specified by fileName.
LaunchNode[]	getChildOwnedNodes()	Returns the nearest descendents of this node with non-null file names.
java.lang.String	getClassPath()	Gets the complete class path in node-to-root order.
java.lang.String	getComment()	Gets the comment of this node.
java.lang.String	getCourseLevel()	Gets the course level of this node or ancestor.
java.lang.String	getDescription()	Gets the description of this node.
LaunchNode.DisplayTab	getDisplayTab(int n)	Gets a display tab.
int	getDisplayTabCount()	Returns the number of display tabs for this node.
java.io.File	getFile()	Return an existing file with current file name and specified base.
java.lang.String	getFileName()	Gets the fileName.
LaunchNode.DisplayTab	getHTML(int n)	Deprecated. replaced by getDisplayTab
int	getHTMLCount()	Deprecated. replaced by getDisplayTabCount
java.lang.String	getID()	Gets the unique ID string for this node.
java.lang.String	getKeywords()	Gets the keywords of this node or ancestor.
java.lang.String	getLanguages()	Gets the languages for which translations exist for this node or ancestor.
java.lang.Class<?>	getLaunchClass()	Gets the launch class for this node.
java.lang.String	getLaunchClassName()	Returns the name of the class to launch
protected javax.swing.JScrollPane	getLaunchModelScroller()	Gets the launchModelScroller.
java.lang.Object	getLaunchObject()	Gets the launch object.
static XML.ObjectLoader	getLoader()	Returns the XML.ObjectLoader for this class.
java.util.logging.Level	getLogLevel()	Gets the log level.
java.lang.String	getName()	Gets the name of this node.
LaunchNode	getOwner()	Returns the nearest ancestor with a non-null file name.
java.lang.String	getPathString()	Gets the string path to this node, starting from the root.
java.util.List<java.lang.String>	getPDFPaths()	Gets the list of pdf documents associated with this node.
java.lang.String	getPreferredAppletHeight()	Gets the preferred applet height of this node.
java.lang.String	getPreferredAppletWidth()	Gets the preferred applet width of this node.
Resource	getResource()	Gets the resource, if any, for this node
java.lang.String	getTooltip()	Gets the tooltip of this node.
LaunchNode.DisplayTab	insertDisplayTab(int n, java.lang.String title, java.lang.String path, java.lang.String[] args)	Inserts a display tab with the specified title and relative path.
LaunchNode.DisplayTab	insertHTML(int n, java.lang.String title, java.lang.String path)	Deprecated. replaced by insertDisplayTab
boolean	isButtonView()	Gets the buttonView value.
boolean	isClearLog()	Gets the clearLog value.
boolean	isHiddenInLauncher()	Gets the hiddenInLauncher value.
boolean	isParentSelfContained()	Gets the parentSelfContained flag.
boolean	isPreviewing()	Gets the previewing flag.
boolean	isSavingHiddenNodes()	Gets the saveHiddenNodes flag.
boolean	isSelfContained()	Gets the selfContained flag.
boolean	isShowLog()	Gets the showLog value.
boolean	isSingleApp()	Gets the singleApp value.
boolean	isSingleton()	Gets the singleton value.
boolean	isSingleVM()	Gets the singleVM flag.
void	launch()	Launches this node.
void	launch(LaunchPanel tab)	Launches this node from the specified launch panel.
boolean	matches(LaunchNode node)	Determines if this node matches another node.
LaunchNode.DisplayTab	removeDisplayTab(int n)	Removes a display tab.
LaunchNode.DisplayTab	removeHTML(int n)	Deprecated. replaced by removeDisplayTab
void	removeTerminateAction(javax.swing.Action action)	Removes an action from this node's actions collection.
protected void	removeThread(java.lang.Runnable runner)
void	setArgs(java.lang.String[] args)	Sets the launch arguments of this node.
void	setAuthor(java.lang.String _author)	Sets the author of this node
void	setButtonView(boolean buttonView)	Sets the buttonView flag.
void	setClassPath(java.lang.String jarNames)	Sets the class path (relative jar or directory paths separated by colons or semicolons).
void	setClearLog(boolean clear)	Sets the showLog flag.
void	setComment(java.lang.String _comment)	Sets the comment of this node
void	setCourseLevel(java.lang.String _level)	Sets the course level of this node
void	setDescription(java.lang.String desc)	Sets the description of this node.
LaunchNode.DisplayTab	setDisplayTab(int n, java.lang.String title, java.lang.String path, java.lang.String[] args)	Sets the specified display tab title and url path.
java.lang.String	setFileName(java.lang.String path)	Sets the fileName.
void	setHiddenInLauncher(boolean hide)	Sets the hiddenInLauncher flag.
void	setHiddenWhenRoot(boolean hide)	Sets the hiddenWhenRoot flag.
LaunchNode.DisplayTab	setHTML(int n, java.lang.String title, java.lang.String path)	Deprecated. replaced by setDisplayTab
void	setKeyword(java.lang.String _keywords)	Sets the keywords of this node
void	setLanguages(java.lang.String _lang)	Sets the languages for which translations exist for this node
boolean	setLaunchClass(java.lang.String className)	Sets the launch class for this node.
void	setLaunchObject(java.lang.Object obj)	Sets the launch object.
void	setLogLevel(java.util.logging.Level level)	Sets the log level.
protected void	setMinimumArgLength(int n)
void	setName(java.lang.String name)	Sets the name of this node.
void	setPreferredAppletHeight(java.lang.String _height)	Sets the preferred applet height of this node
void	setPreferredAppletWidth(java.lang.String _width)	Sets the preferred applet width of this node
void	setSelfContained(boolean selfContained)	Sets the selfContained flag.
void	setShowLog(boolean show)	Sets the showLog flag.
void	setSingleApp(boolean singleApp)	Sets the singleApp flag.
void	setSingleton(boolean singleton)	Sets the singleton flag.
void	setSingleVM(boolean singleVM)	Sets the single VM flag.
void	setTooltip(java.lang.String _tooltip)	Sets the tooltip of this node
void	terminate(javax.swing.Action action)	Removes an action from this node's actions collection.
void	terminateAll()	Terminates all apps launched by this node.
void	threadRunning(boolean starting)	Signals that a launch thread for this node is about to start or end.
java.lang.String	toString()	Returns a string used as a display name for this node.

Methods inherited from class javax.swing.tree.DefaultMutableTreeNode

add, breadthFirstEnumeration, children, clone, depthFirstEnumeration, getAllowsChildren, getChildAfter, getChildAt, getChildBefore, getChildCount, getDepth, getFirstChild, getFirstLeaf, getIndex, getLastChild, getLastLeaf, getLeafCount, getLevel, getNextLeaf, getNextNode, getNextSibling, getParent, getPath, getPathToRoot, getPreviousLeaf, getPreviousNode, getPreviousSibling, getRoot, getSharedAncestor, getSiblingCount, getUserObject, getUserObjectPath, insert, isLeaf, isNodeAncestor, isNodeChild, isNodeDescendant, isNodeRelated, isNodeSibling, isRoot, pathFromAncestorEnumeration, postorderEnumeration, preorderEnumeration, remove, remove, removeAllChildren, removeFromParent, setAllowsChildren, setParent, setUserObject

Methods inherited from class java.lang.Object

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

Constructor Detail

LaunchNode

public LaunchNode(java.lang.String name)

Constructs a node with the specified name.

Parameters:

name - the name

Method Detail

threadRunning

public void threadRunning(boolean starting)

Signals that a launch thread for this node is about to start or end.

Parameters:

starting - true if the thread is starting

launch

public void launch()

Launches this node.

launch

public void launch(LaunchPanel tab)

Launches this node from the specified launch panel.

Parameters:

tab - the launch panel

getOwner

public LaunchNode getOwner()

Returns the nearest ancestor with a non-null file name. This node is returned if it has a non-null file name.

Returns:

the file node

getAllOwnedNodes

public LaunchNode[] getAllOwnedNodes()

Returns all descendents of this node with non-null file names. This node is not included.

Returns:

an array of launch nodes

getChildOwnedNodes

public LaunchNode[] getChildOwnedNodes()

Returns the nearest descendents of this node with non-null file names. This node is not included.

Returns:

an array of launch nodes

toString

public java.lang.String toString()

Returns a string used as a display name for this node.

Overrides:

toString in class javax.swing.tree.DefaultMutableTreeNode

Returns:

the string name of this node

getID

public java.lang.String getID()

Gets the unique ID string for this node.

Returns:

the ID string

setName

public void setName(java.lang.String name)

Sets the name of this node.

Parameters:

name - the name

getName

public java.lang.String getName()

Gets the name of this node.

Returns:

the name

setDescription

public void setDescription(java.lang.String desc)

Sets the description of this node.

Parameters:

desc - the description

getDescription

public java.lang.String getDescription()

Gets the description of this node.

Returns:

the description

setArgs

public void setArgs(java.lang.String[] args)

Sets the launch arguments of this node.

Parameters:

args - the arguments

getArgs

public java.lang.String[] getArgs()

Gets the launch arguments of this node.

Returns:

the launch arguments

setTooltip

public void setTooltip(java.lang.String _tooltip)

Sets the tooltip of this node

Parameters:

_tooltip - the tooltip

getTooltip

public java.lang.String getTooltip()

Gets the tooltip of this node.

Returns:

the tooltip

setAuthor

public void setAuthor(java.lang.String _author)

Sets the author of this node

Parameters:

_author - the author

getAuthor

public java.lang.String getAuthor()

Gets the author.

Returns:

the first non-null author of this or an ancestor

setKeyword

public void setKeyword(java.lang.String _keywords)

Sets the keywords of this node

Parameters:

_keywords - the keywords

getKeywords

public java.lang.String getKeywords()

Gets the keywords of this node or ancestor.

Returns:

the keywords

setComment

public void setComment(java.lang.String _comment)

Sets the comment of this node

Parameters:

_comment - the comment

getComment

public java.lang.String getComment()

Gets the comment of this node.

Returns:

the comment

setPreferredAppletWidth

public void setPreferredAppletWidth(java.lang.String _width)

Sets the preferred applet width of this node

Parameters:

_width - the width

getPreferredAppletWidth

public java.lang.String getPreferredAppletWidth()

Gets the preferred applet width of this node.

Returns:

the width

setPreferredAppletHeight

public void setPreferredAppletHeight(java.lang.String _height)

Sets the preferred applet height of this node

Parameters:

_height - the height

getPreferredAppletHeight

public java.lang.String getPreferredAppletHeight()

Gets the preferred applet height of this node.

Returns:

the height

setCourseLevel

public void setCourseLevel(java.lang.String _level)

Sets the course level of this node

Parameters:

_level - the level

getCourseLevel

public java.lang.String getCourseLevel()

Gets the course level of this node or ancestor.

Returns:

the level

setLanguages

public void setLanguages(java.lang.String _lang)

Sets the languages for which translations exist for this node

Parameters:

_lang - the languages

getLanguages

public java.lang.String getLanguages()

Gets the languages for which translations exist for this node or ancestor.

Returns:

the languages

getClassPath

public java.lang.String getClassPath()

Gets the complete class path in node-to-root order. If Launcher is running from a jar, that jar is in every classpath.

Returns:

the class path

setClassPath

public void setClassPath(java.lang.String jarNames)

Sets the class path (relative jar or directory paths separated by colons or semicolons).

Parameters:

jarNames - the class path

getLaunchClassName

public java.lang.String getLaunchClassName()

Returns the name of the class to launch

Returns:

the class name

setLaunchClass

public boolean setLaunchClass(java.lang.String className)

Sets the launch class for this node.

Parameters:

className - the name of the class

Returns:

true if the class was successfully loaded for the first time

getLaunchClass

public java.lang.Class<?> getLaunchClass()

Gets the launch class for this node.

Returns:

the launch class

getLaunchObject

public java.lang.Object getLaunchObject()

Gets the launch object. May be null.

Returns:

the launch object

setLaunchObject

public void setLaunchObject(java.lang.Object obj)

Sets the launch object.

Parameters:

obj - the launch object

setDisplayTab

public LaunchNode.DisplayTab setDisplayTab(int n,
                                           java.lang.String title,
                                           java.lang.String path,
                                           java.lang.String[] args)

Sets the specified display tab title and url path. Specifying a tab number greater than the current tab count adds a new tab. Setting a path to null removes the tab.

Parameters:

n - the tab number

title - the tab title

path - the path.

args - model arguments. May be null.

Returns:

the DisplayTab, or null if unsuccessful

addDisplayTab

public LaunchNode.DisplayTab addDisplayTab(java.lang.String title,
                                           java.lang.String path,
                                           java.lang.String[] args)

Adds a display tab with the specified title and relative path. No tab is added if path is null or "".

Parameters:

title - the tab title. May be null.

path - the path.

args - model arguments. May be null.

Returns:

the newly created DisplayTab, if any

insertDisplayTab

public LaunchNode.DisplayTab insertDisplayTab(int n,
                                              java.lang.String title,
                                              java.lang.String path,
                                              java.lang.String[] args)

Inserts a display tab with the specified title and relative path. No tab is inserted if path is null or "", or if the specified tab index is invalid.

Parameters:

n - the insertion index

title - the tab title. May be null.

path - the path.

args - model arguments. May be null.

Returns:

the newly created DisplayTab, if any

removeDisplayTab

public LaunchNode.DisplayTab removeDisplayTab(int n)

Removes a display tab.

Parameters:

n - the tab number

Returns:

the DisplayTab removed, or null if none removed

getDisplayTab

public LaunchNode.DisplayTab getDisplayTab(int n)

Gets a display tab.

Parameters:

n - the tab number

Returns:

the DisplayTab, or null if none found

getDisplayTabCount

public int getDisplayTabCount()

Returns the number of display tabs for this node.

Returns:

the tab count

getPDFPaths

public java.util.List<java.lang.String> getPDFPaths()

Gets the list of pdf documents associated with this node.

Returns:

a list of PDF documents (may be empty)

getFileName

public java.lang.String getFileName()

Gets the fileName.

Returns:

the fileName, assumed to be a relative path

getPathString

public java.lang.String getPathString()

Gets the string path to this node, starting from the root. This returns the names of the nodes in the path, separated by "/".

Returns:

the path

setFileName

public java.lang.String setFileName(java.lang.String path)

Sets the fileName. Accepts relative paths or will convert absolute paths to relative.

Parameters:

path - the path to the file

Returns:

the file name

isParentSelfContained

public boolean isParentSelfContained()

Gets the parentSelfContained flag.

Returns:

true if parentSelfContained is true for this or an ancestor

isSelfContained

public boolean isSelfContained()

Gets the selfContained flag.

Returns:

true if selfContained is true for this or an ancestor

isPreviewing

public boolean isPreviewing()

Gets the previewing flag.

Returns:

true if previewing is true for this or an ancestor

isSavingHiddenNodes

public boolean isSavingHiddenNodes()

Gets the saveHiddenNodes flag.

Returns:

true if saveHiddenNodes is true for this or an ancestor

setSelfContained

public void setSelfContained(boolean selfContained)

Sets the selfContained flag.

Parameters:

selfContained - true if self contained

isSingleVM

public boolean isSingleVM()

Gets the singleVM flag.

Returns:

true if singleVM is true for this or an ancestor

setSingleVM

public void setSingleVM(boolean singleVM)

Sets the single VM flag.

Parameters:

singleVM - true if single vm

isShowLog

public boolean isShowLog()

Gets the showLog value.

Returns:

true if showLog is true for this or an ancestor

setShowLog

public void setShowLog(boolean show)

Sets the showLog flag.

Parameters:

show - true to show the OSPLog (single vm only)

isClearLog

public boolean isClearLog()

Gets the clearLog value.

Returns:

true if clearLog is true for this or an ancestor

setClearLog

public void setClearLog(boolean clear)

Sets the showLog flag.

Parameters:

clear - true to clear the OSPLog (single vm only)

getLogLevel

public java.util.logging.Level getLogLevel()

Gets the log level.

Returns:

the level

setLogLevel

public void setLogLevel(java.util.logging.Level level)

Sets the log level.

Parameters:

level - the level

isSingleApp

public boolean isSingleApp()

Gets the singleApp value.

Returns:

true if singleApp is true for this or an ancestor

setSingleApp

public void setSingleApp(boolean singleApp)

Sets the singleApp flag.

Parameters:

singleApp - true to close other apps when launching new app (single vm only)

setHiddenWhenRoot

public void setHiddenWhenRoot(boolean hide)

Sets the hiddenWhenRoot flag.

Parameters:

hide - true to hide node when at root

isButtonView

public boolean isButtonView()

Gets the buttonView value.

Returns:

true if buttonView is true for this or an ancestor

setButtonView

public void setButtonView(boolean buttonView)

Sets the buttonView flag.

Parameters:

buttonView - true to display in buttonView

isSingleton

public boolean isSingleton()

Gets the singleton value.

Returns:

true if singleApp is true for this or an ancestor

setSingleton

public void setSingleton(boolean singleton)

Sets the singleton flag.

Parameters:

singleton - true to allow single instance when in separate vm

isHiddenInLauncher

public boolean isHiddenInLauncher()

Gets the hiddenInLauncher value.

Returns:

true if hiddenInLauncher is true for this or an ancestor

setHiddenInLauncher

public void setHiddenInLauncher(boolean hide)

Sets the hiddenInLauncher flag.

Parameters:

hide - true to hide this node in Launcher

getResource

public Resource getResource()

Gets the resource, if any, for this node

Returns:

the resource

exists

public boolean exists()

Determines whether a resource exists for this node.

Returns:

true if a resource exists

getFile

public java.io.File getFile()

Return an existing file with current file name and specified base. May return null.

Returns:

existing file, or null

matches

public boolean matches(LaunchNode node)

Determines if this node matches another node.

Parameters:

node - the node to match

Returns:

true if the nodes match

getChildNode

public LaunchNode getChildNode(java.lang.String childFileName)

Gets a child node specified by fileName.

Parameters:

childFileName - the file name of the child

Returns:

the first child found, or null

addMenuItemsTo

public void addMenuItemsTo(javax.swing.JComponent menu)

Adds menu item to a JPopupMenu or JMenu.

Parameters:

menu - the menu

addTerminateAction

public void addTerminateAction(javax.swing.Action action)

Adds an action to this node's actions collection.

Parameters:

action - the action to add

removeTerminateAction

public void removeTerminateAction(javax.swing.Action action)

Removes an action from this node's actions collection.

Parameters:

action - the action to remove

terminate

public void terminate(javax.swing.Action action)

Removes an action from this node's actions collection.

Parameters:

action - the action to remove

terminateAll

public void terminateAll()

Terminates all apps launched by this node.

getLaunchModelScroller

protected javax.swing.JScrollPane getLaunchModelScroller()

Gets the launchModelScroller. May return null.

Returns:

the scroller containing the modelPane from the launch class

getLoader

public static XML.ObjectLoader getLoader()

Returns the XML.ObjectLoader for this class.

Returns:

the object loader

setMinimumArgLength

protected void setMinimumArgLength(int n)

removeThread

protected void removeThread(java.lang.Runnable runner)

addHTML

public LaunchNode.DisplayTab addHTML(java.lang.String title,
                                     java.lang.String path)

Deprecated. replaced by addDisplayTab

Adds an HTML tab with the specified title and relative path.

insertHTML

public LaunchNode.DisplayTab insertHTML(int n,
                                        java.lang.String title,
                                        java.lang.String path)

Deprecated. replaced by insertDisplayTab

Inserts an HTML tab with the specified title and relative path.

removeHTML

public LaunchNode.DisplayTab removeHTML(int n)

Deprecated. replaced by removeDisplayTab

Removes an HTML tab.

getHTML

public LaunchNode.DisplayTab getHTML(int n)

Deprecated. replaced by getDisplayTab

Gets an HTML tab.

getHTMLCount

public int getHTMLCount()

Deprecated. replaced by getDisplayTabCount

Returns the number of html objects in the list.

setHTML

public LaunchNode.DisplayTab setHTML(int n,
                                     java.lang.String title,
                                     java.lang.String path)

Deprecated. replaced by setDisplayTab

Sets the specified HTML tab title and url path.