Control directives

This article requires cleanup and may refer to a legacy version of Resin. Please visit http://www.caucho.com/documentation/ for the most up-to-date documentation.

The directives in the namespace http://caucho.com/ns/resin/core provide general configuration abilities like conditional configuration.

In general, we recommend avoiding the use of resin:if and resin:choose when possible, in order to keep configuration files manageable.

directive	meaning
<resin:if>	configures a block conditionally
resin:import	imports a file into the current directive
resin:message	output a log message during configuration
resin:set	sets a variable or jndi-value
resin:choose	selects one of a group of choices.

resin:import imports a configuration file into the current tag. The configuration file will match the current context, the a resin:import file in a <web-app> will be an XML file with a <web-app> tag.

tag	meaning
fileset	a set of files to import
path	the file to import
optional	if true, the target is optional

The web.xml and resin-web.xml files are loaded with a resin:import tag in the conf/app-default.xml file.

app-default.xml

...
<web-app-default>
  ...
  <resin:import path="WEB-INF/web.xml" optional="true"/>
  <resin:import path="WEB-INF/resin-web.xml" optional="true"/>
</web-app-default>
...