caucho
Resin 1.1
FAQ
Reference
JavaDoc
Demo
Java Tutorial

Getting Started
Configuration
Topics
JSP
XTP/XSL
JavaScript
JS Library

Resin Config
HTTP Config
App Config
Servlet Config
Login Config
Taglib Config
Summary
 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 it 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
jsp JSP configuration
dbpool.sql Database pooling configuration.
smtp.vfs Mail configuration.
http-server httpd and srun 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>

jsp

Resin 1.1

JSP configuration

precompile use precompiled JSP classes if available
session enable/disable sessions by default
static-encoding allow JSP to precompile character encoding

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").getConnection();

smtp.vfs

Mail configuration.

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

http-server

httpd and srun configuration.

Configures both http and srun. The configuration is identical.


Configuration   HTTP Config
Copyright © 1998-2000 Caucho Technology. All rights reserved.
Last modified: Thu, 08 Jun 2000 16:56:08 -0700 (PDT)