The EnvEntryDecoratorMapper allows the reference to a web-app environment entry for the
decorator name, and falls back to ConfigDecoratorMapper's behavior if no matching
environment entry is found.
In some cases, it's desirable to allow a deployer, as opposed to a developer,
to specify a decorator. In a .WAR file, this can be very difficult, since
decorator mappings are specified in decorators.xml (more or less).
This mapper corrects that by allowing two types of mapping. If the decorator
name is found in an <env-entry>, the entry's value is used
as the decorator reference.
Known Issues:
It still uses the decorator path (from decorators.xml). This
needs to be corrected for full functionality. If anyone has a suggestion
on how...
Retrieves the
com.opensymphony.module.sitemesh.Decorator specified by the decorator name. If it's not in the environment
entries of the web application, assume it's a named decorator
from decorators.xml.