Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer's Guide

- Previous: C
- Next: E

# D

## database-vendor-name

Specifies the name of the database vendor for which tables can be created. Allowed values are `db2`, `mssql`, `oracle`, `pointbase`, 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 Table 7–4.

### Superelements

cmp-resource (`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–36 `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–37 `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 CacheKeyGenerator Interface.

## 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 3 2005Q4 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–38 `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 Table 7–4.

### Superelements

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

### Subelements

none - contains data

- Previous: C
- Next: E

- © 2010, Oracle Corporation and/or its affiliates