示例#1
0
 /**
  * Register a renderer for all objects of a particular "kind" for all templates evaluated relative
  * to this group. Use r to render if object in question is instanceof(attributeType).
  */
 public void registerRenderer(Class attributeType, AttributeRenderer r) {
   if (attributeType.isPrimitive()) {
     throw new IllegalArgumentException(
         "can't register renderer for primitive type " + attributeType.getSimpleName());
   }
   typeToAdaptorCache.clear(); // be safe, not clever; wack all values
   if (renderers == null) {
     renderers = Collections.synchronizedMap(new LinkedHashMap<Class, AttributeRenderer>());
   }
   renderers.put(attributeType, r);
 }
示例#2
0
  public AttributeRenderer getAttributeRenderer(Class attributeType) {
    if (renderers == null) return null;
    AttributeRenderer r = null;
    if (typeToRendererCache != null) {
      r = typeToRendererCache.get(attributeType);
      if (r != null) return r;
    }

    // Else look up, finding first first
    for (Class t : renderers.keySet()) {
      // t works for attributeType if attributeType subclasses t or implements
      if (t.isAssignableFrom(attributeType)) {
        r = renderers.get(t);
        if (typeToRendererCache == null) {
          typeToRendererCache =
              Collections.synchronizedMap(new LinkedHashMap<Class, AttributeRenderer>());
        }
        typeToRendererCache.put(attributeType, r);
        return r;
      }
    }
    return null;
  }
示例#3
0
/**
 * A directory or directory tree of .st template files and/or group files. Individual template files
 * contain formal template definitions. In a sense, it's like a single group file broken into
 * multiple files, one for each template. ST v3 had just the pure template inside, not the template
 * name and header. Name inside must match filename (minus suffix).
 */
public class STGroup {
  /** When we use key as a value in a dictionary, this is how we signify. */
  public static final String DICT_KEY = "key";

  public static final String DEFAULT_KEY = "default";

  /** Load files using what encoding? */
  public String encoding = "UTF-8";

  /**
   * Every group can import templates/dictionaries from other groups. The list must be synchronized
   * (see importTemplates).
   */
  protected List<STGroup> imports;

  public char delimiterStartChar = '<'; // Use <expr> by default
  public char delimiterStopChar = '>';

  /** Maps template name to StringTemplate object. synchronized. */
  protected Map<String, CompiledST> templates =
      Collections.synchronizedMap(new LinkedHashMap<String, CompiledST>());

  /**
   * Maps dict names to HashMap objects. This is the list of dictionaries defined by the user like
   * typeInitMap ::= ["int":"0"]
   */
  protected Map<String, Map<String, Object>> dictionaries =
      Collections.synchronizedMap(new HashMap<String, Map<String, Object>>());

  /**
   * A dictionary that allows people to register a renderer for a particular kind of object for any
   * template evaluated relative to this group. For example, a date should be formatted differently
   * depending on the locale. You can set Date.class to an object whose toString(Object) method
   * properly formats a Date attribute according to locale. Or you can have a different renderer
   * object for each locale.
   *
   * <p>Order of addition is recorded and matters. If more than one renderer works for an object,
   * the first registered has priority.
   *
   * <p>Renderer associated with type t works for object o if
   *
   * <p>t.isAssignableFrom(o.getClass()) // would assignment t = o work?
   *
   * <p>So it works if o is subclass or implements t.
   *
   * <p>This structure is synchronized.
   */
  protected Map<Class, AttributeRenderer> renderers;

  /**
   * A dictionary that allows people to register a model adaptor for a particular kind of object
   * (subclass or implementation). Applies for any template evaluated relative to this group.
   *
   * <p>ST initializes with model adaptors that know how to pull properties out of Objects, Maps,
   * and STs.
   *
   * <p>The last one you register gets priority; do least to most specific.
   */
  protected Map<Class, ModelAdaptor> adaptors =
      Collections.synchronizedMap(
          new LinkedHashMap<Class, ModelAdaptor>() {
            {
              put(Object.class, new ObjectModelAdaptor());
              put(ST.class, new STModelAdaptor());
              put(Map.class, new MapModelAdaptor());
              put(Aggregate.class, new AggregateModelAdaptor());
            }
          });

  /** Cache exact attribute type to adaptor object */
  protected Map<Class, ModelAdaptor> typeToAdaptorCache =
      Collections.synchronizedMap(new LinkedHashMap<Class, ModelAdaptor>());

  /** Cache exact attribute type to renderer object */
  protected Map<Class, AttributeRenderer> typeToRendererCache;

  /**
   * Used to indicate that the template doesn't exist. Prevents duplicate group file loads and
   * unnecessary file checks.
   */
  protected static final CompiledST NOT_FOUND_ST = new CompiledST();

  public static final ErrorManager DEFAULT_ERR_MGR = new ErrorManager();

  /** Watch loading of groups and templates */
  public static boolean verbose = false;

  /**
   * For debugging with STViz. Records where in code an ST was created and where code added
   * attributes.
   */
  public static boolean trackCreationEvents = false;

  /**
   * v3 compatibility; used to iterate across values not keys like v4. But to convert ANTLR
   * templates, it's too hard to find without static typing in templates.
   */
  public static boolean iterateAcrossValues = false;

  public static STGroup defaultGroup = new STGroup();

  /**
   * The errMgr for entire group; all compilations and executions. This gets copied to parsers,
   * walkers, and interpreters.
   */
  public ErrorManager errMgr = STGroup.DEFAULT_ERR_MGR;

  public STGroup() {}

  public STGroup(char delimiterStartChar, char delimiterStopChar) {
    this.delimiterStartChar = delimiterStartChar;
    this.delimiterStopChar = delimiterStopChar;
  }

  /**
   * The primary means of getting an instance of a template from this group. Names must be absolute,
   * fully-qualified names like a/b
   */
  public ST getInstanceOf(String name) {
    if (verbose) System.out.println("getInstanceOf(" + name + ") in group " + getName());
    if (name == null) return null;
    CompiledST c = lookupTemplate(name);
    if (c != null) {
      return createStringTemplate(c);
    }
    return null;
  }

  protected ST getEmbeddedInstanceOf(
      Interpreter interp, ST enclosingInstance, int ip, String name) {
    if (verbose) System.out.println("getEmbeddedInstanceOf(" + name + ")");
    ST st = getInstanceOf(name);
    if (st == null) {
      errMgr.runTimeError(interp, enclosingInstance, ip, ErrorType.NO_SUCH_TEMPLATE, name);
      return createStringTemplateInternally(new CompiledST());
    }
    // this is only called internally. wack any debug ST create events
    if (trackCreationEvents) {
      st.debugState.newSTEvent = null; // toss it out
    }
    return st;
  }

  /** Create singleton template for use with dictionary values */
  public ST createSingleton(Token templateToken) {
    String template;
    if (templateToken.getType() == GroupParser.BIGSTRING) {
      template = Misc.strip(templateToken.getText(), 2);
    } else {
      template = Misc.strip(templateToken.getText(), 1);
    }
    CompiledST impl = compile(getFileName(), null, null, template, templateToken);
    ST st = createStringTemplateInternally(impl);
    st.groupThatCreatedThisInstance = this;
    st.impl.hasFormalArgs = false;
    st.impl.name = ST.UNKNOWN_NAME;
    st.impl.defineImplicitlyDefinedTemplates(this);
    return st;
  }

  /**
   * Is this template defined in this group or from this group below? Names must be absolute,
   * fully-qualified names like /a/b
   */
  public boolean isDefined(String name) {
    return lookupTemplate(name) != null;
  }

  /** Look up a fully-qualified name */
  public CompiledST lookupTemplate(String name) {
    CompiledST code = rawGetTemplate(name);
    if (code == NOT_FOUND_ST) {
      if (verbose) System.out.println(name + " not found");
      return null;
    }
    // try to load from disk and look up again
    if (code == null) code = load(name);
    if (code == null) code = lookupImportedTemplate(name);
    if (code == null) {
      if (verbose) System.out.println(name + " not found");
      templates.put(name, NOT_FOUND_ST);
    }
    if (verbose) if (code != null) System.out.println("found " + name + " in " + getName());
    return code;
  }

  /**
   * "unload" all templates and dictionaries but leave renderers, adaptors, and import
   * relationships. This essentially forces next getInstanceOf to reload templates.
   */
  public synchronized void unload() {
    templates.clear();
    dictionaries.clear();
  }

  /**
   * Load st from disk if dir or load whole group file if .stg file (then return just one template).
   * name is fully-qualified.
   */
  protected CompiledST load(String name) {
    return null;
  }

  /** Force a load if it makes sense for the group */
  public void load() {
    ;
  }

  protected CompiledST lookupImportedTemplate(String name) {
    if (imports == null) return null;
    for (STGroup g : imports) {
      CompiledST code = g.lookupTemplate(name);
      if (code != null) {
        if (verbose) System.out.println("found " + name + " in " + g.getName());
        return code;
      }
    }
    if (verbose) System.out.println(name + "not found in imports");
    return null;
  }

  public CompiledST rawGetTemplate(String name) {
    return templates.get(name);
  }

  public Map<String, Object> rawGetDictionary(String name) {
    return dictionaries.get(name);
  }

  public boolean isDictionary(String name) {
    return dictionaries.get(name) != null;
  }

  // for testing
  public CompiledST defineTemplate(String templateName, String template) {
    try {
      CompiledST impl =
          defineTemplate(
              templateName, new CommonToken(GroupParser.ID, templateName), null, template, null);
      return impl;
    } catch (STException se) {
      // we have reported the error; the exception just blasts us
      // out of parsing this template
    }
    return null;
  }

  // for testing
  public CompiledST defineTemplate(String name, String argsS, String template) {
    String[] args = argsS.split(",");
    List<FormalArgument> a = new ArrayList<FormalArgument>();
    for (String arg : args) {
      a.add(new FormalArgument(arg));
    }
    return defineTemplate(name, new CommonToken(GroupParser.ID, name), a, template, null);
  }

  public CompiledST defineTemplate(
      String templateName,
      Token nameT,
      List<FormalArgument> args,
      String template,
      Token templateToken) {
    if (templateName == null || templateName.length() == 0) {
      throw new IllegalArgumentException("empty template name");
    }
    if (templateName.indexOf('.') >= 0) {
      throw new IllegalArgumentException("cannot have '.' in template names");
    }
    template = Misc.trimOneStartingNewline(template);
    template = Misc.trimOneTrailingNewline(template);
    // compile, passing in templateName as enclosing name for any embedded regions
    CompiledST code = compile(getFileName(), templateName, args, template, templateToken);
    code.name = templateName;
    rawDefineTemplate(templateName, code, nameT);
    code.defineArgDefaultValueTemplates(this);
    code.defineImplicitlyDefinedTemplates(this); // define any anonymous subtemplates

    return code;
  }

  /** Make name and alias for target. Replace any previous def of name */
  public CompiledST defineTemplateAlias(Token aliasT, Token targetT) {
    String alias = aliasT.getText();
    String target = targetT.getText();
    CompiledST targetCode = rawGetTemplate(target);
    if (targetCode == null) {
      errMgr.compileTimeError(ErrorType.ALIAS_TARGET_UNDEFINED, null, aliasT, alias, target);
      return null;
    }
    templates.put(alias, targetCode);
    return targetCode;
  }

  public CompiledST defineRegion(
      String enclosingTemplateName, Token regionT, String template, Token templateToken) {
    String name = regionT.getText();
    template = Misc.trimOneStartingNewline(template);
    template = Misc.trimOneTrailingNewline(template);
    CompiledST code = compile(getFileName(), enclosingTemplateName, null, template, templateToken);
    String mangled = getMangledRegionName(enclosingTemplateName, name);

    if (lookupTemplate(mangled) == null) {
      errMgr.compileTimeError(
          ErrorType.NO_SUCH_REGION, templateToken, regionT, enclosingTemplateName, name);
      return new CompiledST();
    }
    code.name = mangled;
    code.isRegion = true;
    code.regionDefType = ST.RegionType.EXPLICIT;
    code.templateDefStartToken = regionT;

    rawDefineTemplate(mangled, code, regionT);
    code.defineArgDefaultValueTemplates(this);
    code.defineImplicitlyDefinedTemplates(this);

    return code;
  }

  public void defineTemplateOrRegion(
      String templateName,
      String regionSurroundingTemplateName,
      Token templateToken,
      String template,
      Token nameToken,
      List<FormalArgument> args) {
    try {
      if (regionSurroundingTemplateName != null) {
        defineRegion(regionSurroundingTemplateName, nameToken, template, templateToken);
      } else {
        defineTemplate(templateName, nameToken, args, template, templateToken);
      }
    } catch (STException e) {
      // after getting syntax error in a template, we emit msg
      // and throw exception to blast all the way out here.
    }
  }

  public void rawDefineTemplate(String name, CompiledST code, Token defT) {
    CompiledST prev = rawGetTemplate(name);
    if (prev != null) {
      if (!prev.isRegion) {
        errMgr.compileTimeError(ErrorType.TEMPLATE_REDEFINITION, null, defT);
        return;
      }
      if (prev.isRegion) {
        if (code.regionDefType != ST.RegionType.IMPLICIT
            && prev.regionDefType == ST.RegionType.EMBEDDED) {
          errMgr.compileTimeError(
              ErrorType.EMBEDDED_REGION_REDEFINITION, null, defT, getUnMangledTemplateName(name));
          return;
        } else if (code.regionDefType == ST.RegionType.IMPLICIT
            || prev.regionDefType == ST.RegionType.EXPLICIT) {
          errMgr.compileTimeError(
              ErrorType.REGION_REDEFINITION, null, defT, getUnMangledTemplateName(name));
          return;
        }
      }
    }
    code.nativeGroup = this;
    code.templateDefStartToken = defT;
    templates.put(name, code);
  }

  public void undefineTemplate(String name) {
    templates.remove(name);
  }

  /** Compile a template */
  public CompiledST compile(
      String srcName,
      String name,
      List<FormalArgument> args,
      String template,
      Token templateToken) // for error location
      {
    // System.out.println("STGroup.compile: "+enclosingTemplateName);
    Compiler c = new Compiler(this);
    return c.compile(srcName, name, args, template, templateToken);
  }

  /** The "foo" of t() ::= "<@foo()>" is mangled to "region#t#foo" */
  public static String getMangledRegionName(String enclosingTemplateName, String name) {
    return "region__" + enclosingTemplateName + "__" + name;
  }

  /** Return "t.foo" from "region__t__foo" */
  public static String getUnMangledTemplateName(String mangledName) {
    String t = mangledName.substring("region__".length(), mangledName.lastIndexOf("__"));
    String r = mangledName.substring(mangledName.lastIndexOf("__") + 2, mangledName.length());
    return t + '.' + r;
  }

  /**
   * Define a map for this group; not thread safe...do not keep adding these while you reference
   * them.
   */
  public void defineDictionary(String name, Map<String, Object> mapping) {
    dictionaries.put(name, mapping);
  }

  /** Make this group import templates/dictionaries from g. */
  public void importTemplates(STGroup g) {
    if (g == null) return;
    if (imports == null) imports = Collections.synchronizedList(new ArrayList<STGroup>());
    imports.add(g);
  }

  /**
   * Import template files, directories, and group files. Priority is given to templates defined in
   * the current group; this, in effect, provides inheritance. Polymorphism is in effect so that if
   * an inherited template references template t() then we search for t() in the subgroup first.
   *
   * <p>If you specify an absolute file name or directory name, the import statement uses that
   * directly. If it is not an absolute path, we look that entity up in the directory holding the
   * group that initiates the import. If file or directory is not in that directory, then we load
   * using the classpath.
   *
   * <p>Templates are loaded on-demand from import dirs. Imported groups are loaded on-demand when
   * searching for a template.
   *
   * <p>The listener of this group is passed to the import group so errors found while loading
   * imported element are sent to listener of this group.
   */
  public void importTemplates(Token fileNameToken) {
    String fileName = fileNameToken.getText();
    // do nothing upon syntax error
    if (fileName == null || fileName.equals("<missing STRING>")) return;
    fileName = Misc.strip(fileName, 1);

    // System.out.println("import "+fileName);
    boolean isGroupFile = fileName.endsWith(".stg");
    boolean isTemplateFile = fileName.endsWith(".st");
    boolean isGroupDir = !(isGroupFile || isTemplateFile);

    STGroup g = null;

    File f = new File(fileName);
    if (f.isAbsolute()) { // load directly if absolute
      if (isTemplateFile) {
        g = new STGroup();
        g.setListener(this.getListener());
        g.loadAbsoluteTemplateFile(fileName);
      } else if (isGroupFile) {
        g = new STGroupFile(fileName, delimiterStartChar, delimiterStopChar);
        g.setListener(this.getListener());
      } else if (isGroupDir) {
        g = new STGroupDir(fileName, delimiterStartChar, delimiterStopChar);
        g.setListener(this.getListener());
      }
      importTemplates(g);
      return;
    }

    // it's a relative name; search path is working dir, g.stg's dir, CLASSPATH
    URL thisRoot = getRootDirURL();
    URL fileUnderRoot = null;
    //		System.out.println("thisRoot="+thisRoot);
    try {
      fileUnderRoot = new URL(thisRoot + "/" + fileName);
    } catch (MalformedURLException mfe) {
      errMgr.internalError(null, "can't build URL for " + thisRoot + "/" + fileName, mfe);
      return;
    }
    if (isTemplateFile) {
      g = new STGroup();
      g.setListener(this.getListener());
      URL fileURL;
      if (Misc.urlExists(fileUnderRoot)) fileURL = fileUnderRoot;
      else fileURL = getURL(fileName); // try CLASSPATH
      if (fileURL != null) {
        try {
          InputStream s = fileURL.openStream();
          ANTLRInputStream templateStream = new ANTLRInputStream(s);
          templateStream.name = fileName;
          CompiledST code = g.loadTemplateFile("", fileName, templateStream);
          if (code == null) g = null;
        } catch (IOException ioe) {
          errMgr.internalError(null, "can't read from " + fileURL, ioe);
          g = null;
        }
      } else {
        g = null;
      }
    } else if (isGroupFile) {
      // System.out.println("look for fileUnderRoot: "+fileUnderRoot);
      if (Misc.urlExists(fileUnderRoot)) {
        g = new STGroupFile(fileUnderRoot, encoding, delimiterStartChar, delimiterStopChar);
        g.setListener(this.getListener());
      } else {
        g = new STGroupFile(fileName, delimiterStartChar, delimiterStopChar);
        g.setListener(this.getListener());
      }
    } else if (isGroupDir) {
      //			System.out.println("try dir "+fileUnderRoot);
      if (Misc.urlExists(fileUnderRoot)) {
        g = new STGroupDir(fileUnderRoot, encoding, delimiterStartChar, delimiterStopChar);
        g.setListener(this.getListener());
      } else {
        // try in CLASSPATH
        //				System.out.println("try dir in CLASSPATH "+fileName);
        g = new STGroupDir(fileName, delimiterStartChar, delimiterStopChar);
        g.setListener(this.getListener());
      }
    }

    if (g == null) {
      errMgr.compileTimeError(ErrorType.CANT_IMPORT, null, fileNameToken, fileName);
    } else {
      importTemplates(g);
    }
  }

  /** Load a group file with full path fileName; it's relative to root by prefix. */
  public void loadGroupFile(String prefix, String fileName) {
    // System.out.println("load group file prefix="+prefix+", fileName="+fileName);
    GroupParser parser = null;
    try {
      URL f = new URL(fileName);
      ANTLRInputStream fs = new ANTLRInputStream(f.openStream(), encoding);
      GroupLexer lexer = new GroupLexer(fs);
      fs.name = fileName;
      CommonTokenStream tokens = new CommonTokenStream(lexer);
      parser = new GroupParser(tokens);
      parser.group(this, prefix);
    } catch (Exception e) {
      errMgr.IOError(null, ErrorType.CANT_LOAD_GROUP_FILE, e, fileName);
    }
  }

  /** Load template file into this group using absolute filename */
  public CompiledST loadAbsoluteTemplateFile(String fileName) {
    ANTLRFileStream fs;
    try {
      fs = new ANTLRFileStream(fileName, encoding);
      fs.name = fileName;
    } catch (IOException ioe) {
      // doesn't exist
      // errMgr.IOError(null, ErrorType.NO_SUCH_TEMPLATE, ioe, fileName);
      return null;
    }
    return loadTemplateFile("", fileName, fs);
  }

  /** Load template stream into this group */
  public CompiledST loadTemplateFile(String prefix, String fileName, CharStream templateStream) {
    GroupLexer lexer = new GroupLexer(templateStream);
    CommonTokenStream tokens = new CommonTokenStream(lexer);
    GroupParser parser = new GroupParser(tokens);
    parser.group = this;
    lexer.group = this;
    try {
      parser.templateDef(prefix);
    } catch (RecognitionException re) {
      errMgr.groupSyntaxError(ErrorType.SYNTAX_ERROR, fileName, re, re.getMessage());
    }
    String templateName = Misc.getFileNameNoSuffix(fileName);
    if (prefix != null && prefix.length() > 0) templateName = prefix + "/" + templateName;
    return rawGetTemplate(templateName);
  }

  /**
   * Add an adaptor for a kind of object so ST knows how to pull properties from them. Add adaptors
   * in increasing order of specificity. ST adds Object, Map, and ST model adaptors for you first.
   * Adaptors you add have priority over default adaptors.
   *
   * <p>If an adaptor for type T already exists, it is replaced by the adaptor arg.
   *
   * <p>This must invalidate cache entries, so set your adaptors up before render()ing your
   * templates for efficiency.
   */
  public void registerModelAdaptor(Class attributeType, ModelAdaptor adaptor) {
    if (attributeType.isPrimitive()) {
      throw new IllegalArgumentException(
          "can't register ModelAdaptor for primitive type " + attributeType.getSimpleName());
    }
    adaptors.put(attributeType, adaptor);
    invalidateModelAdaptorCache(attributeType);
  }

  /** remove at least all types in cache that are subclasses or implement attributeType */
  public void invalidateModelAdaptorCache(Class attributeType) {
    typeToAdaptorCache.clear(); // be safe, not clever; wack all values
  }

  public ModelAdaptor getModelAdaptor(Class attributeType) {
    ModelAdaptor a = typeToAdaptorCache.get(attributeType);
    if (a != null) return a;

    // System.out.println("looking for adaptor for "+attributeType);
    // Else, we must find adaptor that fits;
    // find last fit (most specific)
    for (Class t : adaptors.keySet()) {
      // t works for attributeType if attributeType subclasses t or implements
      // System.out.println("checking "+t.getSimpleName()+" against "+attributeType);
      if (t.isAssignableFrom(attributeType)) {
        // System.out.println(t.getName()+" = "+attributeType.getName());
        a = adaptors.get(t);
      }
    }
    // System.out.println("adaptor for "+attributeType+" is "+a);
    typeToAdaptorCache.put(attributeType, a); // cache it for next time
    return a;
  }

  /**
   * Register a renderer for all objects of a particular "kind" for all templates evaluated relative
   * to this group. Use r to render if object in question is instanceof(attributeType).
   */
  public void registerRenderer(Class attributeType, AttributeRenderer r) {
    if (attributeType.isPrimitive()) {
      throw new IllegalArgumentException(
          "can't register renderer for primitive type " + attributeType.getSimpleName());
    }
    typeToAdaptorCache.clear(); // be safe, not clever; wack all values
    if (renderers == null) {
      renderers = Collections.synchronizedMap(new LinkedHashMap<Class, AttributeRenderer>());
    }
    renderers.put(attributeType, r);
  }

  public AttributeRenderer getAttributeRenderer(Class attributeType) {
    if (renderers == null) return null;
    AttributeRenderer r = null;
    if (typeToRendererCache != null) {
      r = typeToRendererCache.get(attributeType);
      if (r != null) return r;
    }

    // Else look up, finding first first
    for (Class t : renderers.keySet()) {
      // t works for attributeType if attributeType subclasses t or implements
      if (t.isAssignableFrom(attributeType)) {
        r = renderers.get(t);
        if (typeToRendererCache == null) {
          typeToRendererCache =
              Collections.synchronizedMap(new LinkedHashMap<Class, AttributeRenderer>());
        }
        typeToRendererCache.put(attributeType, r);
        return r;
      }
    }
    return null;
  }

  public ST createStringTemplate(CompiledST impl) {
    ST st = new ST();
    st.impl = impl;
    st.groupThatCreatedThisInstance = this;
    if (impl.formalArguments != null) {
      st.locals = new Object[impl.formalArguments.size()];
      Arrays.fill(st.locals, ST.EMPTY_ATTR);
    }
    return st;
  }

  /**
   * differentiate so we can avoid having creation events for regions, map operations, and other
   * "new ST" events used during interp.
   */
  public ST createStringTemplateInternally(CompiledST impl) {
    ST st = createStringTemplate(impl);
    if (trackCreationEvents && st.debugState != null) {
      st.debugState.newSTEvent = null; // toss it out
    }
    return st;
  }

  public ST createStringTemplateInternally(ST proto) {
    return new ST(proto); // no need to wack debugState; not set in ST(proto).
  }

  public String getName() {
    return "<no name>;";
  }

  public String getFileName() {
    return null;
  }

  /**
   * 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.
   */
  public URL getRootDirURL() {
    return null;
  }

  public URL getURL(String fileName) {
    URL url = null;
    ClassLoader cl = Thread.currentThread().getContextClassLoader();
    url = cl.getResource(fileName);
    if (url == null) {
      cl = this.getClass().getClassLoader();
      url = cl.getResource(fileName);
    }
    return url;
  }

  public String toString() {
    return getName();
  }

  public String show() {
    StringBuilder buf = new StringBuilder();
    if (imports != null) buf.append(" : " + imports);
    for (String name : templates.keySet()) {
      CompiledST c = rawGetTemplate(name);
      if (c.isAnonSubtemplate || c == NOT_FOUND_ST) continue;
      int slash = name.lastIndexOf('/');
      name = name.substring(slash + 1, name.length());
      buf.append(name);
      buf.append('(');
      if (c.formalArguments != null)
        buf.append(Misc.join(c.formalArguments.values().iterator(), ","));
      buf.append(')');
      buf.append(" ::= <<" + Misc.newline);
      buf.append(c.template + Misc.newline);
      buf.append(">>" + Misc.newline);
    }
    return buf.toString();
  }

  public STErrorListener getListener() {
    return errMgr.listener;
  }

  public void setListener(STErrorListener listener) {
    errMgr = new ErrorManager(listener);
  }
}