public class ConfigurationUtils extends Object
Type | Property and Description |
---|---|
static FactoryConfiguration |
findFromSystem
Returns a
FactoryConfiguration loaded from the path specified
in the "org.apache.velocity.tools" system property (if any). |
Modifier and Type | Field and Description |
---|---|
static String |
AUTOLOADED_PROPS_PATH |
static String |
AUTOLOADED_XML_PATH |
static String |
CONFIG_FACTORY_METHOD |
static String |
GENERIC_DEFAULTS_PATH |
static ConfigurationUtils |
INSTANCE |
static String |
STRUTS_DEFAULTS_PATH |
static String |
SYSTEM_PROPERTY_KEY |
static String |
VIEW_DEFAULTS_PATH |
Modifier and Type | Method and Description |
---|---|
static void |
clean(Configuration config)
Convenience method that automatically creates a new
ConfigurationCleaner and applies it to the specified
Configuration . |
static ToolboxFactory |
createFactory()
Returns a new, standard
ToolboxFactory configured
with the results of both getAutoLoaded() and
findFromSystemProperty() . |
static FactoryConfiguration |
find(String path)
Searches for a configuration file at the specified path and returns
it in the form of a
FactoryConfiguration . |
static FactoryConfiguration |
findFromSystemProperty()
Returns a
FactoryConfiguration loaded from the path specified
in the "org.apache.velocity.tools" system property (if any). |
static FactoryConfiguration |
findInClasspath(String path) |
static FactoryConfiguration |
findInClasspath(String path,
Object caller)
Searches the classpath for a configuration file matching the
specified path.
|
static FactoryConfiguration |
findInFileSystem(String path)
Searches the file system for a configuration file matching the
specified path.
|
static FactoryConfiguration |
getAutoLoaded()
Returns a
FactoryConfiguration including all
getDefaultTools() as well as any tools that can be
automatically loaded from "tools.xml" or "tools.properties" found
at the root of the classpath or in the current directory. |
static FactoryConfiguration |
getAutoLoaded(boolean includeDefaults)
Returns a
FactoryConfiguration composed, in order of the
following configurations:
getDefaultTools() (only if includeDefaults is true )
All "tools.xml" configurations found in the classpath root, in the order found
All "tools.properties" configurations found in the classpath root, in the order found
The "tools.xml" file in the current directory (if any)
The "tools.properties" file in the current directory (if any)
If the includeDefaults parameter is null and no such files described above
can be found, then the configuration returned by this method will be
empty, but it should never be null . |
static FactoryConfiguration |
getDefaultTools()
Returns the "default"
FactoryConfiguration . |
static FactoryConfiguration |
getFromClass(Class factory) |
static FactoryConfiguration |
getFromClass(String classname) |
static FactoryConfiguration |
getGenericTools()
Returns a
FactoryConfiguration including all default
"GenericTools" available and no others. |
ConfigurationUtils |
getInstance() |
static FactoryConfiguration |
getVelocityStruts()
Returns a
FactoryConfiguration including all default
"VelocityStruts" tools available as well as the default "VelocityView"
tools and "GenericTools". |
static FactoryConfiguration |
getVelocityView()
Returns a
FactoryConfiguration including all default
"VelocityView" tools available as well as the default "GenericTools". |
static FactoryConfiguration |
load(String path)
Returns a
FactoryConfiguration loaded from a configuration file
at the specified path. |
static FactoryConfiguration |
read(URL url)
Returns a
FactoryConfiguration read from a known configuration
file type at the specified URL . |
public static FactoryConfiguration findFromSystemProperty
FactoryConfiguration
loaded from the path specified
in the "org.apache.velocity.tools" system property (if any).
If no such property has been set null
will be returned.public static final String GENERIC_DEFAULTS_PATH
public static final String VIEW_DEFAULTS_PATH
public static final String STRUTS_DEFAULTS_PATH
public static final String AUTOLOADED_XML_PATH
public static final String AUTOLOADED_PROPS_PATH
public static final String SYSTEM_PROPERTY_KEY
public static final ConfigurationUtils INSTANCE
public static final String CONFIG_FACTORY_METHOD
public ConfigurationUtils getInstance()
public static FactoryConfiguration getDefaultTools()
FactoryConfiguration
. This includes
all the standard tools developed by this project and available in
the jar being used. In other words, if the velocity-tools-generic-2.x.jar
is being used, then only the generic tools will be included. If
the velocity-tools-struts-2.x.jar is being used, then all VelocityTools
will be available. This also means that subclasses in the larger jars
will override their superclasses. So, if you are using the VelocityStruts
jar, then your $link reference will be a StrutsLinkTool. If you are using
the VelocityView jar, it will be a standard LinkTool.public static FactoryConfiguration getGenericTools()
FactoryConfiguration
including all default
"GenericTools" available and no others.public static FactoryConfiguration getVelocityView()
FactoryConfiguration
including all default
"VelocityView" tools available as well as the default "GenericTools".{@link
- ConfigurationException} if a tools.xml is not found
at the VIEW_DEFAULTS_PATH
.public static FactoryConfiguration getVelocityStruts()
FactoryConfiguration
including all default
"VelocityStruts" tools available as well as the default "VelocityView"
tools and "GenericTools".{@link
- ConfigurationException} if a tools.xml is not found
at the VIEW_DEFAULTS_PATH
or STRUTS_DEFAULTS_PATH
.public static FactoryConfiguration getAutoLoaded()
FactoryConfiguration
including all
getDefaultTools()
as well as any tools that can be
automatically loaded from "tools.xml" or "tools.properties" found
at the root of the classpath or in the current directory.getAutoLoaded(boolean includeDefaults)
public static FactoryConfiguration getAutoLoaded(boolean includeDefaults)
FactoryConfiguration
composed, in order of the
following configurations:
getDefaultTools()
(only if includeDefaults is true
)null
.public static FactoryConfiguration findFromSystemProperty()
FactoryConfiguration
loaded from the path specified
in the "org.apache.velocity.tools" system property (if any).
If no such property has been set null
will be returned.public static ToolboxFactory createFactory()
ToolboxFactory
configured
with the results of both getAutoLoaded()
and
findFromSystemProperty()
.public static void clean(Configuration config)
ConfigurationCleaner
and applies it to the specified
Configuration
.public static FactoryConfiguration load(String path)
FactoryConfiguration
loaded from a configuration file
at the specified path. If no such file is found at that path, this
will throw a ResourceNotFoundException
.find(String path)
public static FactoryConfiguration find(String path)
FactoryConfiguration
. This method will
look for a matching file in both the classpath and the file system.
If perchance a match is found in both, then both are loaded and the
configuration loaded from the file system is given precedence (i.e.
it is added onto the other). If no match is found in either, then
this will return null
.public static FactoryConfiguration findInFileSystem(String path)
FactoryConfiguration
. If not found, this will return
null
.IllegalStateException
- if the file exists, but its path could not be converted to a URL for reading.public static FactoryConfiguration findInClasspath(String path)
public static FactoryConfiguration findInClasspath(String path, Object caller)
FactoryConfiguration
. If not found, this will return
null
. If there are multiple matching resources in the
classpath, then they will be added together in the order found
(i.e. the last one will have precedence).public static FactoryConfiguration read(URL url)
FactoryConfiguration
read from a known configuration
file type at the specified URL
. If the file is missing or unreadable,
this will simply return null
(i.e. if an IOException is thrown).UnsupportedOperationException
- if the file type (identified via suffix)
is neither ".xml" or ".properties"public static FactoryConfiguration getFromClass(String classname)
public static FactoryConfiguration getFromClass(Class factory)
Copyright © 2002–2014 Apache Software Foundation. All rights reserved.