This is the top-level tag for a client configuration. There may be several of these in a single configuration file, all given different names.
Attribute | Required? | Default | Description |
name | N | (none) | An arbitrary name for this configuration. Multiple configurations in a file are supported. |
version | N | latest | The version of the configuration file. If omitted, the most current is used. |
debug | N | "warn" | Enable debugging for this service. This will be written to the Tomcat logs and might be rather verbose. Use it only if you need it. The levels supported are (in order of increasin verbosity) "off", "info", "warn", "error", "severe", "trace". Setting debug to "trace" will dump out virtually everything and give a running account of the operation of the service. This may be very, very large. |
disableDefaultStores | N | false | The default behavior is to default to using a memory store if no other store is explicitly set. If set to true, this will make the server throw an exception if there is no store configured. |
The name can be anything. The name of the configuration to use may be specified in the deployment descriptor (web.xml) file. If there is a single configuration in the file, that will be used. If there are multiple configurations and no name is specified, an exception is raised.
<config> <client> <!-- more stuff --> </client> </config>
There is a single configuration (so no name is needed) and every configuration default as per the table above will be used. However, the server address and other items must be configured or this will not work.
<config> <client name="organic-test" debug="true"> <!-- more stuff --> </client> <client name="organic" debug="false" disableDefaultStores="true"> <!-- more stuff --> </client> </config>
In this situation there are two client configurations, one for production organic and one for testing organic-test. The production server has turned off debugging and is configured so if storage is not explicitly created, an exception will be thrown. The test server will create in-memory stores as needed and all debugging is enabled.