chrysalis-config_1_0.dtd Documentation

The ChrysalisConfig.xml file contains general Chrysalis configuration information. This file should be located in the web application's "WEB-INF/classes" directory (or more accurately, in any directory or JAR at the root of the classpath).

Attributes whose names are in italics are optional.

Tag Summary
config The root tag for ChrysalisConfig.
controller Tag for global controller configuration data.
converter Tag for converter package's configuration.
datatype Tag containing various converter datatype mappings.
default Tag for global controller defaults.
factories Tag for resource factory configuration.
factory-for Configuration for the factories for a specific type of resource.
logger Tag for the logger plugin.
mapping Mapping tag for an individual datatype.
named-factory Configuration for a named factory for a specific resource.
optionLister Tag for the optionLister (option map loader) plugin.
package Tag specifying a controller package.
plugin Tag for plugin configuration data.
properties A set of configuration properties.
property A specific configuration property.
redirect Tag controlling how view redirection is performed.
resources Tag for resource configuration.
scripter Tag for the scripter (client-side validation) plugin.
server Tag for configuration information related to server behavior of the Chrysalis servlet components.
servlet.engine Tag for the servlet engine package's configuration data.
user Tag for the user (security) plugin.

config

The root tag for ChrysalisConfig.xml.

Content: (servlet.engine, plugin?, converter?, resources?)

servlet.engine

Tag for the servlet engine package's configuration data.

Used in: config

Content: (controller, server?)

controller

Tag for global controller configuration data.

Used in: servlet.engine

Content: (package+, default?)

Attributes

  • class_suffix [CDATA]: Specifies an alternate class suffix for controller classes. If omitted, the default suffix is "Controller", so that controller names must be in the form: "XxxController".

package

Tag specifying a controller package. The controller packages are used to load controller classes into memory. More than one package may be specified. If there are controllers with the same name in multiple packages, the controller from the first package listed take precedence.

Used in: controller

Content: Text

default

Tag for global controller defaults.

Used in: controller

Content: Empty

Attributes

  • view [CDATA]: The global default view.
  • errorpage [CDATA]: The global default errorpage.

server

Tag for configuration information related to server behavior of the Chrysalis servlet components.

Used in: servlet.engine

Content: (redirect?)

redirect

Tag controlling how view redirection is performed. The "prepend_context" attribute of this tag specifies whether or not the context-path is prepended to site-relative redirect URLs (those beginning with "/").

This configuration value exists to address an ambiguity in the Servlet specifications for the behavior of the HttpResponse.sendRedirect() method. Some servers (such as Websphere) will prepend the context-path before redirection; others (such as Tomcat) will not. Chrysalis needs the context to be prepended and normally does so automatically. On servers that already prepend the URL, this value should be set to "false".

Used in: server

Content: Empty

Attributes

  • prepend_context [(true|false)]: Whether the context is prepended to redirection (true or false).

plugin

Tag for plugin configuration data.

Used in: config

Content: (user?, logger?, optionLister?, scripter?)

user

Tag for the user (security) plugin.

Used in: plugin

Content: Empty

Attributes

  • class [CDATA]: The plugin class name.

logger

Tag for the logger plugin.

Used in: plugin

Content: Empty

Attributes

  • class [CDATA]: The plugin class name.
  • debug [(true|false)]: Whether debugging is enabled.

optionLister

Tag for the optionLister (option map loader) plugin.

Used in: plugin

Content: Empty

Attributes

  • class [CDATA]: The plugin class name.

scripter

Tag for the scripter (client-side validation) plugin.

Used in: plugin

Content: Empty

Attributes

  • class [CDATA]: The plugin class name.

converter

Tag for converter package's configuration.

Used in: config

Content: (datatype)

datatype

Tag containing various converter datatype mappings.

Used in: converter

Content: (mapping+)

mapping

Mapping tag for an individual datatype. This information determines which converter class is use to manipulate data values with a given logical datatype name. Note that the default logical name for a particular Java value will be its Java class name. Datatype mappings specified in the ChrysalisConfig.xml take precedence over the default converters built into the Chrysalis framework.

Used in: datatype

Content: Empty

Attributes

  • name [CDATA]: The datatype's logical name.
  • value [CDATA]: The fully qualified class name of the datatype's converter class.

resources

Tag for resource configuration.

Used in: config

Content: (factories)

factories

Tag for resource factory configuration.

Used in: resources

Content: (factory-for+)

factory-for

Configuration for the factories for a specific type of resource.

Used in: factories

Content: (properties?, named-factory*)

Attributes

  • name [CDATA]: The fully qualified class name of the resource.
  • default-factory [CDATA]: The fully qualified class name of the default factory.

named-factory

Configuration for a named factory for a specific resource.

Used in: factory-for

Content: (properties?)

Attributes

  • name [CDATA]: The factory name, used in ResourceLocate.getResource().
  • class [CDATA]: The fully qualified class name of this named factory.

properties

A set of configuration properties.

Used in: factory-for, named-factory

Content: (property+)

property

A specific configuration property. The tag's text is the property value.

Used in: properties

Content: Text

Attributes

  • name [CDATA]: The configuration property name.