Skip to content

Servlet init params

chuckdumont edited this page Jan 15, 2013 · 11 revisions

Servlet specific options may be specified using servlet init-params in the plugin.xml used to define the servlet as in the following example:

    <extension point="org.eclipse.equinox.http.registry.servlets">
        <servlet alias="/testaggr" class="com.ibm.jaggr.service.impl.AggregatorImpl">
            <init-param name="config" value="testaggr-config.js"/>
        </servlet>
    </extension>

The Aggregator supports the following servlet init-params:

Name Description
config This init-param is required and has no default value.  It specifies the name of the server-side AMD config file.
modulebuilders Specifies the id of an extension implementing the com.ibm.jaggr.service.modulebuilders extension point that is used by the application.  More than one modulebuilders init-param may be specified.  If none are specified, then the default.modulebuilders extension defined in the Aggregator's plugin.xml is used.  See Extensibility for a description of module builder extensions.
resourcefactories Specifies the id of an extension implementing the com.ibm.jaggr.service.resourcefactries extension point that is used by the application.  More than one resourcefactories extension may be specified.  If none are specified, then the default.modulebilders extension defined in the Aggregator's plugin.xml is used.  See Extensibility for a description of resource factory extensions.
httptransport Specifies the id of an extension implementing the com.ibm.jaggr.service.httptransport extension point that is used by the application.  If not specified, the dojo.httptransport extension defined in the Aggregator's plugin.xml is used.  See Extensibility for a description of http transport extensions.
maxlayercachecapacity_mb Specifies the maximum layer cache capacity in mega-bytes of on-disk storage space. The default value is 500.

This parameter is intended to guard against possible DOS attacks which might attempt to consume all available disk space on the server by methodically sending requests for layers with arbitrary combinations of modules. By specifying an upper limit on the size of the cache, the worse effects of this type of attack (running the server out of disk space) can be avoided. The Aggregator uses a LRU algorithm for evicting cache entries when the maximum capacity is reached.

options Specifies the filename of the properties file containing Aggregator options. If not specified, the default options file is aggregator.properties in the home directory of the user that launched the server.