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
protected boolean	alreadyLoaded
java.lang.String	fileName Just records how user "spelled" the file name they wanted to load.
java.net.URL	url Where to find the group file.

Fields inherited from class org.stringtemplate.v4.STGroup

adaptors, DEFAULT_ERR_MGR, DEFAULT_KEY, defaultGroup, delimiterStartChar, delimiterStopChar, DICT_KEY, dictionaries, encoding, errMgr, GROUP_FILE_EXTENSION, imports, importsToClearOnUnload, iterateAcrossValues, NOT_FOUND_ST, renderers, TEMPLATE_FILE_EXTENSION, templates, trackCreationEvents, verbose

Constructor Summary

Constructors

Constructor and Description
STGroupFile(java.lang.String fileName) Load a file relative to current directory 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) Convenience ctor
STGroupFile(java.net.URL url, java.lang.String encoding, char delimiterStartChar, char delimiterStopChar) Pass in a URL with the location of a group file.

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.
protected CompiledST	load(java.lang.String name) Load st from disk if directory or load whole group file if .stg file (then return just one template).
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, getEmbeddedInstanceOf, getImportedGroups, getInstanceOf, getListener, getMangledRegionName, getModelAdaptor, getTemplateNames, getUnMangledTemplateName, getURL, importTemplates, importTemplates, importTemplates, isReservedCharacter, loadAbsoluteTemplateFile, loadGroupFile, loadTemplateFile, lookupImportedTemplate, lookupTemplate, rawDefineTemplate, rawGetDictionary, rawGetTemplate, registerModelAdaptor, registerRenderer, registerRenderer, setListener, toString, undefineTemplate

Methods inherited from class java.lang.Object

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

Field Detail

fileName

public java.lang.String fileName

Just records how user "spelled" the file name they wanted to load. The url is the key field here for loading content. If they use ctor with URL arg, this field is null.

url

public java.net.URL url

Where to find the group file. NonNull.

alreadyLoaded

protected boolean alreadyLoaded

Constructor Detail

STGroupFile

public STGroupFile(java.lang.String fileName)

Load a file relative to current directory 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)

Pass in a URL with the location of a group file. E.g., STGroup g = new STGroupFile(loader.getResource("org/foo/templates/g.stg"), "UTF-8", '<', '>');

STGroupFile

public STGroupFile(java.net.URL url)

Convenience ctor

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 the next call to STGroup.getInstanceOf(java.lang.String) to reload templates. Call unload() on each group in the STGroup.imports list, and remove all elements in STGroup.importsToClearOnUnload from STGroup.imports.

Overrides:

unload in class STGroup

load

protected CompiledST load(java.lang.String name)

Description copied from class: STGroup

Load st from disk if directory or load whole group file if .stg file (then return just one template). name is fully-qualified.

Overrides:

load 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