artisynth.core.driver

Class RootModelManager

java.lang.Object

artisynth.core.driver.RootModelManager

public class RootModelManager
extends java.lang.Object

Manages the set of known root models. This class exists to address the problem that it can take significant time (many seconds) to locate all the root models within a large package, like "artisynth.models". This in turn means that it can take a long time to initialize the ArtiSynth model menu, resulting in long application start times.

The RootModelManager mitigates this problem by maintaing a file-based cache of known root models that is read in quickly and used to initialize the model menu. Once the menu is created, a background thread is started to update the root model set. When the thread completes, the model menu is updated to reflect any changes.

Field Summary

Fields

Modifier and Type	Field and Description
static int	INCLUDE_HIDDEN
static int	RECURSIVE
static int	USE_CACHE

Constructor Summary

Constructors

Constructor and Description
RootModelManager()

Method Summary

Modifier and Type	Method and Description
boolean	cacheDiffersFromMain()
boolean	cacheDiffersFromMain(java.lang.String pkgName)
boolean	compareCacheToMain()
java.lang.String	findModelFromSimpleName(java.lang.String simpName) Try to find the class name of a model given its simple name.
java.util.ArrayList<java.lang.String>	findModels(java.lang.String pkgName, int flags)
java.io.File	getCacheFile()
java.util.Collection<java.lang.String>	getKnownPackageNames()
static java.lang.String	getLeafName(java.lang.String pathName) Returns the trailing part of a full package or class name that follows the last '.'.
static java.lang.String	getParentName(java.lang.String pathName) Returns the "parent" part of a full package or class name that preceeds the last '.'.
boolean	hasCache()
void	readCacheFile()
boolean	saveCacheIfModified()
void	setCacheFile(java.io.File file)
void	updateModelSet()
void	writeCacheFile()

Methods inherited from class java.lang.Object

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

Field Detail

RECURSIVE

public static final int RECURSIVE

See Also:

Constant Field Values

USE_CACHE

public static final int USE_CACHE

See Also:

Constant Field Values

INCLUDE_HIDDEN

public static final int INCLUDE_HIDDEN

See Also:

Constant Field Values

Constructor Detail

RootModelManager

public RootModelManager()

Method Detail

getLeafName

public static java.lang.String getLeafName(java.lang.String pathName)

Returns the trailing part of a full package or class name that follows the last '.'. For example, for 'foo.bar.bash', returns 'bash'.

getParentName

public static java.lang.String getParentName(java.lang.String pathName)

Returns the "parent" part of a full package or class name that preceeds the last '.'. For example, for 'foo.bar.bash', returns 'foo.bar'. If the name does not contain a '.', returns an empty string.

updateModelSet

public void updateModelSet()

compareCacheToMain

public boolean compareCacheToMain()

cacheDiffersFromMain

public boolean cacheDiffersFromMain()

cacheDiffersFromMain

public boolean cacheDiffersFromMain(java.lang.String pkgName)

findModelFromSimpleName

public java.lang.String findModelFromSimpleName(java.lang.String simpName)

Try to find the class name of a model given its simple name.

findModels

public java.util.ArrayList<java.lang.String> findModels(java.lang.String pkgName,
                                                        int flags)

setCacheFile

public void setCacheFile(java.io.File file)

getCacheFile

public java.io.File getCacheFile()

readCacheFile

public void readCacheFile()

hasCache

public boolean hasCache()

saveCacheIfModified

public boolean saveCacheIfModified()

writeCacheFile

public void writeCacheFile()

getKnownPackageNames

public java.util.Collection<java.lang.String> getKnownPackageNames()