caucho
Resin 1.1
FAQ
Reference
JavaDoc
Demo
Java Tutorial

Getting Started
Configuration
Servlet
JSP
XTP/XSL
JavaScript
JS Library

Resin Config
HTTP Config
App Config
Servlet Config
Login Config
Taglib Config
Virtual Hosts
Caching
 Resin Configuration

General (non-HTTP) configuration. resin.conf is actually a general configuration file, like NT's registry. So some Resin modules like logging and DBPool also have their configuration in resin.conf, but outside the http-server block.

Configuration is based on element XML. You can also think of is as key-value lists, like the NT registry or a Lisp assoc-list. To make the configuration more readable, you can use attributes as syntactic sugar.

The following are equivalent:

<foo><bar>13</bar></foo> canonical representation, but verbose
<foo bar=13/> typical configuration
<foo><bar id=13/></foo> Useful for a key-based list.

In general, the order is not important, but the nesting depth is. In this reference guide, caucho.com/http-server/srun-port refers to a configuration like:

<caucho.com>
  <http-server>
    <srun-port>6802</srun-port>
  </http-server>
</caucho.com>

That example could be rewritten as:

<caucho.com>
  <http-server srun-port='6802'>
</caucho.com>

caucho.com
log Starts logging for debugging.
resin:include Includes another configuration file.
java Configuration for the Java compiler
dbpool.sql Database pooling configuration.
smtp.vfs Mail configuration.

caucho.com

log

Starts logging for debugging.

id Name of debugging section
href Destination file
timestamp timestamp format
For example, to log everything to standard error use:

<caucho.com>
  <log id='/' href='stderr:' timestamp="[%H:%M:%S.%s]"/>
</caucho.com>

/ Debug everything
/caucho.com/jsp Debug jsp
/caucho.com/jsp/java See the JSP generated Java
/caucho.com/jsp/js See the JSP generated Java
/caucho.com/xsl XSL debugging
/caucho.com/tcp-server See thread creation and deletion
/caucho.com/http HTTP related information

The timestamp can include the following patterns:

%a short weekday (mon, tue, ...)
%A long weekday (Monday, Tuesday, ...)
%b short month (Jan, Feb, ...)
%B long month (January, February, ...)
%c locale specific date
%d day of month
%H 24-hour
%I 12-hour
%j day of year
%m day of month
%M minute
%p am/pm
%S seconds
%s milliseconds
%W week of year
%w day of week
%y 2-digit year
%Y 4-digit year

resin:include

Includes another configuration file.

<caucho.com>
<http-server>
  <host id='host1'>
    <resin:include href='host.conf'/>
  </host>
  <host id='host2'>
    <resin:include href='host.conf'/>
  </host>
</http-server>
</caucho.com>

java

Configuration for the Java compiler

compiler Path to the java compiler or "internal"
work-dir Compiler work directory
args Extra args to pass to the compiler

<caucho.com>
  <java compiler='/usr/local/bin/jikes'
         work-dir='/tmp/caucho'/>
         args='-g'/>
  ...
</caucho.com>

dbpool.sql

Database pooling configuration.

id Key for the database configuration
driver JDBC driver class
url JDBC url for the database
user Database user
password Database password
max-connections Maximum number of allowed connections

You can use the 'id' to configure several databases, then just refer to the key when using DBPool.

  conn = DBPool.getPool("db1").createConnection();

smtp.vfs

Mail configuration.

host SMTP host (localhost)
port SMTP port (25)

Configuration   HTTP Config
Copyright © 1998-2000 Caucho Technology. All rights reserved.
Last modified: Tue, 28 Mar 2000 08:39:23 -0800 (PST)