Links Top Level Elements Connectors Containers Nested Components | Introduction |
The GlobalNamingResources element represents the global
JNDI resources which are defined
for the Server.
|
Special Features |
Environment Entries |
You can configure named values that will be made visible to
web applications as environment entry resources, by nesting
<Environment> entries inside this element. For
example, you can create an environment entry like this:
![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) |
<GlobalNamingResources ...>
...
<Environment name="maxExemptions" value="10"
type="java.lang.Integer" override="false"/>
...
</GlobalNamingResources>
| ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) |
This is equivalent to the inclusion of the following element in the
web application deployment descriptor (/WEB-INF/web.xml ):
![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) |
<env-entry>
<env-entry-name>maxExemptions</param-name>
<env-entry-value>10</env-entry-value>
<env-entry-type>java.lang.Integer</env-entry-type>
</env-entry>
| ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) |
but does not require modification of the deployment descriptor
to customize this value.
The valid attributes for an <Environment> element
are as follows:
Attribute | Description |
---|
description |
Optional, human-readable description of this environment entry.
| name |
The name of the environment entry to be created, relative to the
java:comp/env context.
| override |
Set this to false if you do not want
an <env-entry> for the same environment entry name,
found in the web application deployment descriptor, to override the
value specified here. By default, overrides are allowed.
| type |
The fully qualified Java class name expected by the web application
for this environment entry. Must be one of the legal values for
<env-entry-type> in the web application deployment
descriptor: java.lang.Boolean ,
java.lang.Byte , java.lang.Character ,
java.lang.Double , java.lang.Float ,
java.lang.Integer , java.lang.Long ,
java.lang.Short , or java.lang.String .
| value |
The parameter value that will be presented to the application
when requested from the JNDI context. This value must be convertable
to the Java type defined by the type attribute.
|
|
Resource Parameters |
This element is used to configure the resource manager (or object
factory) used to return objects when the web application performs a
JNDI lookup operation on the corresponding resource name. You
MUST define resource parameters for every resource name
that is specified by a <Resource> element inside a
<Context> or <DefaultContext>
element in $CATALINA_HOME/conf/server.xml , and/or for every
name declared in a <resource-ref> or
<resource-env-ref> element in the web application
deployment descriptor, before that resource can be successfully
accessed.
Resource parameters are defined by name, and the precise set of
parameter names supported depend on the resource manager (or object
factory) you are using - they must match the names of settable JavaBeans
properties on the corresponding factory class. The JNDI implementation
will configure an instance of the specified factory class specified by
calling all the corresponding JavaBeans property setters, and then
making the factory instance available via the JNDI lookup()
call.
The resource parameters for a JDBC data source might look something
like this:
![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) |
<GlobalNamingResources ...>
...
<ResourceParams name="jdbc/EmployeeDB">
<parameter>
<name>driverClassName</name>
<value>org.hsql.jdbcDriver</value>
</parameter>
<parameter>
<name>driverName</name>
</value>jdbc:HypersonicSQL:database</value>
</parameter>
<parameter>
<name>user</name>
<value>dbusername</value>
</parameter>
<parameter>
<name>password</name>
<value>dbpassword</value>
</parameter>
</ResourceParams>
...
</GlobalNamingResources>
| ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) | ![](../images/void.gif) |
If you need to specify the Java class name of a factory class for a
particular resource type, use a <parameter> entry
named factory nested inside the
<ResourceParams> element.
The valid attributes of a <ResourceParams> element
are as follows:
Attribute | Description |
---|
name |
The name of the resource being configured, relative to the
java:comp/env contxt. This name MUST
match the name of a resource defined by a <Resource>
element in $CATALINA_HOME/conf/server.xml , and/or
referenced in a <resource-ref> or
<resource-env-ref> element in the web application
deployment descriptor.
|
|
|
|