caucho
Resin
FAQ
Reference Guide
Demo
Tutorial

Getting Started
Configuration
IDE
Topics
JSP
XML/XSLT

Basic Config
Directory
Servlets
Filters
Resources
Databases
Messaging
Security Config
Log Config
Taglib Config
Misc resin.conf
Host resin.conf
Port resin.conf
App resin.conf
Summary
Glossary
Index
 Semi-Formal Configuration Description

App resin.conf
Configuration
Glossary

Configuration is based on element-only XML like the Servlet 2.2 deployment descriptors.

For convenience, Resin allows any element to be used as an attribute. This syntactic sugar makes the configuration files more readable and maintainable.

Using the 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.

The special element resin:include can be used in any place to read in another file.

Semi-Formal Description


caucho.com ::= log* |
               java |
               jsp |
               smtp.vfs | 
               env-entry* |
               resource-ref* |
               ejb-ref* |
               jndi-link*
               env-entry* | 
               user-name |
               group-name |
               http-server

log ::= id |
        href |
        timestamp

java ::= compiler |
         work-dir |
         compiler-args

smtp.vfs ::= host |
             port

http-server ::=	http* |
                srun* |
                srun-backup* |
                thread-max |
                thread-keepalive |
                request-timeout |
                cache |
                host* |
                classpath* |
                any host tag for host defaults
		 
http ::= host |
         port |
         ssl (default: false) |
         key-store-type (default: jks) |
         key-store-file |
         key-store-password |
         certificate-pem ||
         key-pem
		 
srun ::= host |
         port
         ssl (default: false) |
         key-store-type (default: jks) |
         key-store-file |
         key-store-password
		 
srun-backup ::= host |
                port |
                ssl (default: false) |
                key-store-type (default: jks) |
                key-store-file |
                key-store-password

cache ::= dir |
          entries |
          size

host ::= id |
         regexp |
         app-dir |
         error-log |
         access-log* |
         war-dir* |
         web-app* |
         any web-app tag (for "/" web-app)
	  
access-log ::= id |
               format |

web-app ::= id |
            url-regexp |
            app-dir |
            servlet-mapping* |
            servlet* |
            filter-mapping* |
            filter* |
            classpath* |
            class-update-interval |
            context-param* |
            session-config |
            error-page* |
            path-mapping* |
            mime-mapping* |
            cache-mapping* |
            chain-mapping* |
            welcome-file-list |
            character-encoding |
            directory-servlet |
            jsp |
            taglib* |
            temp-dir |
            resource-ref* |
            env-entry* |
            resource-ref* |
            ejb-ref* |
            jndi-link*

servlet-mapping ::= url-pattern |
                    url-regexp |
                    servlet-name |
                    path-info |
                    servlet-class |
                    init-param* |
                    load-on-startup |
                    run-at*

servlet ::= servlet-name |
            servlet-class |
            init-param* |
            load-on-startup |
            run-at*

init-param ::= param-name |
               param-value |

classpath ::= id |
              source (default: same as id) |
              compile (default: true)

context-param ::= param-name |
                  param-value

ejb-ref ::= ejb-ref-name |
            ejb-ref-factory |
            init-param

browser-mapping ::= regexp |
                    force10

cache-mapping ::= url-pattern |
                  url-regexp |
                  expires

env-entry ::= env-entry-name |
              env-entry-type |
              env-entry-value

error-page ::= location |
               exception |
               error-code

filter-mapping ::= mime-type |
                   servlet-name

jndi-link ::= jndi-name |
              property-file |
              jndi-factory |
              init-param

mime-mapping ::= extension |
                 mime-type

path-mapping ::= url-pattern |
                 url-regexp |
                 real-path

resource-ref ::= res-ref-name |
                 res-type |
                 init-param*

session-config ::= session-timeout |
                  session-max |
                  enable-cookies |
                  enable-url-rewriting


App resin.conf
Configuration
Glossary
Copyright © 1998-2002 Caucho Technology, Inc. All rights reserved.
Resin® is a registered trademark, and HardCoretm and Quercustm are trademarks of Caucho Technology, Inc.