Sun Java System Application Server 9.1 Application Deployment Guide

D

database-vendor-name

Specifies the name of the database vendor for which tables can be created. Allowed values are javadb, db2, mssql, oracle, postgresql, pointbase, derby (also for CloudScape), and sybase, case-insensitive.

If no value is specified, a connection is made to the resource specified by the jndi-name subelement of the cmp-resource element, and the database vendor name is read. If the connection cannot be established, or if the value is not recognized, SQL-92 compliance is presumed.

This element can be overridden during deployment. See Generation Options for CMP in Sun Java System Application Server 9.1 Developer’s Guide.

Superelements

cmp-resource (sun-ejb-jar.xml)

Subelements

none - contains data

debugging-enabled

Specifies whether the debugging servlet is enabled for this web service endpoint. Allowed values are true (the default) and false.

Superelements

webservice-endpoint (sun-web.xml, sun-ejb-jar.xml)

Subelements

none - contains data

default

Specifies that a field belongs to the default hierarchical fetch group, and enables prefetching for a CMR field. To disable prefetching for specific query methods, use a prefetch-disabled element in the sun-ejb-jar.xml file.

Superelements

fetched-with (sun-cmp-mappings.xml)

Subelements

none - element is present or absent

default-helper

Passes property values to the built-in default cache-helper class.

Superelements

cache (sun-web.xml)

Subelements

The following table describes subelements for the default-helper element.

Table A–39 default-helper Subelements

Element 

Required 

Description 

property (with attributes)

zero or more 

Specifies a property, which has a name and a value. 

Properties

The following table describes properties for the default-helper element.

Table A–40 default-helper Properties

Property 

Default 

Description 

cacheKeyGeneratorAttrName

Uses the built-in default cache-helper key generation, which concatenates the servlet path with key-field values, if any.

The caching engine looks in the ServletContext for an attribute with a name equal to the value specified for this property to determine whether a customized CacheKeyGenerator implementation is used. An application can provide a customized key generator rather than using the default helper. See The CacheKeyGenerator Interface in Sun Java System Application Server 9.1 Developer’s Guide.

default-resource-principal

Specifies the default principal (user) for the resource.

If this element is used in conjunction with a JMS Connection Factory resource, the name and password subelements must be valid entries in the Sun JavaTM System Message Queue broker user repository. See the Security Management chapter in the Sun Java System Message Queue 4.1 Administration Guide for details.

Superelements

resource-ref (sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml); cmp-resource, mdb-connection-factory (sun-ejb-jar.xml)

Subelements

The following table describes subelements for the default-resource-principal element.

Table A–41 default-resource-principal Subelements

Element 

Required 

Description 

name

only one 

Specifies the default resource principal name used to sign on to a resource manager. 

password

only one 

Specifies password of the default resource principal. 

description

Specifies a text description of the containing element.

Superelements

property (with attributes) (sun-web.xml); activation-config, method (sun-ejb-jar.xml); target-server (sun-acc.xml)

Subelements

none - contains data

dispatcher

Specifies a comma-separated list of RequestDispatcher methods for which caching is enabled on the target resource. Valid values are REQUEST, FORWARD, INCLUDE, and ERROR . If this element is not specified, the default is REQUEST. See SRV.6.2.5 of the Servlet 2.4 specification for more information.

Superelements

cache-mapping (sun-web.xml)

Subelements

none - contains data

drop-tables-at-undeploy

Specifies whether database tables that were automatically created when the bean(s) were last deployed are dropped when the bean(s) are undeployed. If true, drops tables from the database. If false (the default if this element is not present), does not drop tables.

This element can be overridden during deployment. See Generation Options for CMP in Sun Java System Application Server 9.1 Developer’s Guide.

Superelements

cmp-resource (sun-ejb-jar.xml)

Subelements

none - contains data