org.stringtemplate.v4

Class STGroupFile

java.lang.Object

org.stringtemplate.v4.STGroup

org.stringtemplate.v4.STGroupFile

public class STGroupFile
extends STGroup

The internal representation of a single group file (which must end in ".stg"). If we fail to find a group file, look for it via the CLASSPATH as a resource. Templates are only looked up in this file or an import.

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	fileName
java.net.URL	url

Fields inherited from class org.stringtemplate.v4.STGroup

DEFAULT_ERR_MGR, DEFAULT_KEY, defaultGroup, delimiterStartChar, delimiterStopChar, DICT_KEY, encoding, errMgr, iterateAcrossValues, trackCreationEvents, verbose

Constructor Summary

Constructors

Constructor and Description
STGroupFile(java.lang.String fileName) Load a file relative to current dir or from root or via CLASSPATH.
STGroupFile(java.lang.String fileName, char delimiterStartChar, char delimiterStopChar)
STGroupFile(java.lang.String fullyQualifiedFileName, java.lang.String encoding)
STGroupFile(java.lang.String fullyQualifiedFileName, java.lang.String encoding, char delimiterStartChar, char delimiterStopChar)
STGroupFile(java.net.URL url, java.lang.String encoding, char delimiterStartChar, char delimiterStopChar)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getFileName()
java.lang.String	getName()
java.net.URL	getRootDirURL() Return root dir if this is group dir; return dir containing group file if this is group file.
boolean	isDefined(java.lang.String name) Is this template defined in this group or from this group below? Names must be absolute, fully-qualified names like /a/b
boolean	isDictionary(java.lang.String name)
void	load() Force a load if it makes sense for the group
java.lang.String	show()
void	unload() "unload" all templates, dictionaries and import relationships, but leave renderers and adaptors.

Methods inherited from class org.stringtemplate.v4.STGroup

compile, createSingleton, createStringTemplate, createStringTemplateInternally, createStringTemplateInternally, defineDictionary, defineRegion, defineTemplate, defineTemplate, defineTemplate, defineTemplateAlias, defineTemplateOrRegion, getAttributeRenderer, getImportedGroups, getInstanceOf, getListener, getMangledRegionName, getModelAdaptor, getTemplateNames, getUnMangledTemplateName, getURL, importTemplates, importTemplates, invalidateModelAdaptorCache, loadAbsoluteTemplateFile, loadGroupFile, loadTemplateFile, lookupTemplate, rawDefineTemplate, rawGetDictionary, rawGetTemplate, registerModelAdaptor, registerRenderer, registerRenderer, setListener, toString, undefineTemplate

Methods inherited from class java.lang.Object

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

Field Detail

fileName

public java.lang.String fileName

url

public java.net.URL url

Constructor Detail

STGroupFile

public STGroupFile(java.lang.String fileName)

Load a file relative to current dir or from root or via CLASSPATH.

STGroupFile

public STGroupFile(java.lang.String fileName,
           char delimiterStartChar,
           char delimiterStopChar)

STGroupFile

public STGroupFile(java.lang.String fullyQualifiedFileName,
           java.lang.String encoding)

STGroupFile

public STGroupFile(java.lang.String fullyQualifiedFileName,
           java.lang.String encoding,
           char delimiterStartChar,
           char delimiterStopChar)

STGroupFile

public STGroupFile(java.net.URL url,
           java.lang.String encoding,
           char delimiterStartChar,
           char delimiterStopChar)

Method Detail

isDictionary

public boolean isDictionary(java.lang.String name)

Overrides:

isDictionary in class STGroup

isDefined

public boolean isDefined(java.lang.String name)

Description copied from class: STGroup

Is this template defined in this group or from this group below? Names must be absolute, fully-qualified names like /a/b

Overrides:

isDefined in class STGroup

unload

public void unload()

Description copied from class: STGroup

"unload" all templates, dictionaries and import relationships, but leave renderers and adaptors. This essentially forces next getInstanceOf to reload templates. Call unload() on each group in the imports list and remove every import from the imports list imported with "clearOnUnload".

Overrides:

unload in class STGroup

load

public void load()

Description copied from class: STGroup

Force a load if it makes sense for the group

Overrides:

load in class STGroup

show

public java.lang.String show()

Overrides:

show in class STGroup

getName

public java.lang.String getName()

Overrides:

getName in class STGroup

getFileName

public java.lang.String getFileName()

Overrides:

getFileName in class STGroup

getRootDirURL

public java.net.URL getRootDirURL()

Description copied from class: STGroup

Return root dir if this is group dir; return dir containing group file if this is group file. This is derived from original incoming dir or filename. If it was absolute, this should come back as full absolute path. If only a URL is available, return URL of one dir up.

Overrides:

getRootDirURL in class STGroup