Package org.stringtemplate.v4
Class STGroupFile
java.lang.Object
org.stringtemplate.v4.STGroup
org.stringtemplate.v4.STGroupFile
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
FieldsModifier and TypeFieldDescriptionprotected boolean
Just records how user "spelled" the file name they wanted to load.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
ConstructorsConstructorDescriptionSTGroupFile
(String fileName) Load a file relative to current directory or from root or via CLASSPATH.STGroupFile
(String fileName, char delimiterStartChar, char delimiterStopChar) STGroupFile
(String fullyQualifiedFileName, String encoding) STGroupFile
(String fullyQualifiedFileName, String encoding, char delimiterStartChar, char delimiterStopChar) STGroupFile
(URL url) Convenience ctorSTGroupFile
(URL url, String encoding, char delimiterStartChar, char delimiterStopChar) Pass in a URL with the location of a group file. -
Method Summary
Modifier and TypeMethodDescriptiongetName()
Return root dir if this is group dir; return dir containing group file if this is group file.boolean
Is this template defined in this group or from this group below? Names must be absolute, fully-qualified names like/a/b
.boolean
isDictionary
(String name) void
load()
Force a load if it makes sense for the group.protected CompiledST
Load st from disk if directory or load whole group file if .stg file (then return just one template).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
-
Field Details
-
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
Where to find the group file. NonNull. -
alreadyLoaded
protected boolean alreadyLoaded
-
-
Constructor Details
-
STGroupFile
Load a file relative to current directory or from root or via CLASSPATH. -
STGroupFile
-
STGroupFile
-
STGroupFile
-
STGroupFile
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", 'invalid input: '<'', '>'); -
STGroupFile
Convenience ctor
-
-
Method Details
-
isDictionary
- Overrides:
isDictionary
in classSTGroup
-
isDefined
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
. -
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 toSTGroup.getInstanceOf(java.lang.String)
to reload templates. Callunload()
on each group in theSTGroup.imports
list, and remove all elements inSTGroup.importsToClearOnUnload
fromSTGroup.imports
. -
load
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. -
load
public void load()Description copied from class:STGroup
Force a load if it makes sense for the group. -
show
-
getName
-
getFileName
- Overrides:
getFileName
in classSTGroup
-
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 classSTGroup
-