Package org.apache.velocity.tools.config

Class ToolConfiguration

  • All Implemented Interfaces:
    java.lang.Comparable<Configuration>
    public class ToolConfiguration
extends Configuration

    This class handles configuration info for tools, including their key, classname, path restriction, and properties. It also does fairly aggresive validation. Once configuration is complete, a ToolInfo instance can be created by calling createInfo().

    Most users will not find themselves directly using the API of this class.

    Version:
    $Id: ToolConfiguration.java 511959 2007-02-26 19:24:39Z nbubna $
    Author:
    Nathan Bubna

    • Constructor Detail

      • ToolConfiguration

        public ToolConfiguration()

    • Method Detail

      • setKey

        public void setKey​(java.lang.String key)

      • setClass

        @Deprecated
public void setClass​(java.lang.Class clazz)
        Deprecated.
        This method should be avoided, since considered unsafe by the security manager.
        Parameters:
        clazz - the Class
        See Also:
        setClassname(String classname)

      • setClass

        public void setClass​(java.lang.String classname)

      • setClassname

        public void setClassname​(java.lang.String classname)

      • setFactory

        public void setFactory​(java.lang.Class factory)

      • setFactoryClassname

        public void setFactoryClassname​(java.lang.String factoryClassname)

      • setRestrictTo

        public void setRestrictTo​(java.lang.String path)

      • setSkipSetters

        public void setSkipSetters​(java.lang.Boolean cfgOnly)

      • getKey

        public java.lang.String getKey()
        Returns the key set for this tool. If no key has been explicitly set, this will return the result of getDefaultKey().
        Returns:
        tool key

      • getDefaultKey

        public java.lang.String getDefaultKey()
        Returns the default key value for the set tool class. First, this looks for a DefaultKey annotation on the tool class. Then, if there is no default key annotation, the Class.getSimpleName() is transformed into the key by removing any 'Tool' suffix and lowercasing the first character. This will only return null if there is both no key and no classname set for this tool.
        Returns:
        default tool key

      • getClassname

        public java.lang.String getClassname()

      • getFactoryClassname

        public java.lang.String getFactoryClassname()

      • getToolClass

        public java.lang.Class getToolClass()

      • getFactory

        public java.lang.Class getFactory()

      • getInvalidScopes

        public java.lang.String[] getInvalidScopes()

      • getValidScopes

        public java.lang.String[] getValidScopes()

      • getRestrictTo

        public java.lang.String getRestrictTo()

      • getSkipSetters

        public java.lang.Boolean getSkipSetters()

      • createInfo

        public ToolInfo createInfo()

      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class Configuration

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object