JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server 3.1 Application Deployment Guide
search filter icon
search icon

Document Information

Preface

1.  Overview of Oracle GlassFish Server 3.1 Application Deployment

2.  Deploying Applications

A.  The asadmin Deployment Subcommands

B.  GlassFish Server Deployment Descriptor Files

C.  Elements of the GlassFish Server Deployment Descriptors

activation-config

Superelements

Subelements

activation-config-property

Superelements

Subelements

activation-config-property-name

Superelements

Subelements

activation-config-property-value

Superelements

Subelements

admin-object-resource

Superelements

Subelements

Attributes

Properties

as-context

Superelements

Subelements

archive-name

Superelements

Subelements

auth-method

Superelements

Subelements

auth-realm

Superelements

Subelements

Attributes

Example

backend-principal

Superelements

Subelements

Attributes

bean-cache

Superelements

Subelements

Example

bean-pool

Superelements

Subelements

Example

cache

Superelements

Subelements

Attributes

Properties

Cache Class Names

cache-helper

Superelements

Subelements

Attributes

cache-helper-ref

Superelements

Subelements

cache-idle-timeout-in-seconds

Superelements

Subelements

cache-mapping

Superelements

Subelements

call-property

Superelements

Subelements

caller-propagation

Superelements

Subelements

cert-db

Superelements

Subelements

Attributes

check-all-at-commit

Superelements

check-modified-at-commit

Superelements

Subelements

check-version-of-accessed-instances

Superelements

Subelements

checkpoint-at-end-of-method

Superelements

Subelements

checkpointed-methods

Superelements

class-loader

Superelements

Subelements

Attributes

Properties

client-container

Superelements

Subelements

Attributes

Properties

client-credential

Superelements

Subelements

Attributes

cmp

Superelements

Subelements

cmp-field-mapping

Superelements

Subelements

cmp-resource

Superelements

Subelements

cmr-field-mapping

Superelements

Subelements

cmr-field-name

Superelements

Subelements

cmt-timeout-in-seconds

Superelements

Subelements

column-name

Superelements

Subelements

column-pair

Superelements

Subelements

commit-option

Superelements

Subelements

compatibility

Superelements

Subelements

confidentiality

Superelements

Subelements

connector-connection-pool

Superelements

Subelements

Attributes

Properties

connector-resource

Superelements

Subelements

Attributes

consistency

Superelements

Subelements

constraint-field

Superelements

Subelements

Attributes

constraint-field-value

Superelements

Subelements

Attributes

context-root

Superelements

Subelements

cookie-properties

Superelements

Subelements

Properties

create-tables-at-deploy

Superelements

Subelements

custom-resource

Superelements

Subelements

Attributes

database-vendor-name

Superelements

Subelements

debugging-enabled

Superelements

Subelements

default

Superelements

Subelements

default-helper

Superelements

Subelements

Properties

default-resource-principal

Superelements

Subelements

description

Superelements

Subelements

disable-nonportable-jndi-names

Superelements

Subelements

dispatcher

Superelements

Subelements

drop-tables-at-undeploy

Superelements

Subelements

ejb

Superelements

Subelements

Attributes

Example

ejb-name

Superelements

Subelements

ejb-ref

Superelements

Subelements

ejb-ref-name

Superelements

Subelements

eligible

Superelements

Subelements

endpoint-address-uri

Superelements

Subelements

Example

enterprise-beans

Superelements

Subelements

Example

entity-mapping

Superelements

Subelements

establish-trust-in-client

Superelements

Subelements

establish-trust-in-target

Superelements

Subelements

external-jndi-resource

Superelements

Subelements

Attributes

fetched-with

Superelements

Subelements

field-name

Superelements

Subelements

finder

Superelements

Subelements

flush-at-end-of-method

Superelements

Subelements

gen-classes

Superelements

Subelements

glassfish-application

Superelements

Subelements

glassfish-application-client

Superelements

Subelements

glassfish-ejb-jar

Superelements

Subelements

glassfish-web-app

Superelements

Subelements

Attributes

Properties

group-map

Superelements

Subelements

Attributes

group-name

Superelements

Subelements

http-method

Superelements

Subelements

idempotent-url-pattern

Superelements

Subelements

Attributes

Example

integrity

Superelements

Subelements

ior-security-config

Superelements

Subelements

is-cache-overflow-allowed

Superelements

is-one-one-cmp

Superelements

is-read-only-bean

Superelements

Subelements

java-method

Superelements

Subelements

java-web-start-access

Superelements

Subelements

jdbc-connection-pool

Superelements

Subelements

Attributes

GlassFish Server Properties

Database Properties

jdbc-resource

Superelements

Subelements

Attributes

jms-durable-subscription-name

Superelements

Subelements

jms-max-messages-load

Superelements

Subelements

jndi-name

Superelements

Subelements

jnlp-doc

Superelements

Subelements

jsp-config

Superelements

Subelements

Properties

keep-state

Superelements

Subelements

key-field

Superelements

Subelements

Attributes

level

Superelements

Subelements

local-home-impl

Superelements

Subelements

local-impl

Superelements

Subelements

locale-charset-info

Superelements

Subelements

Attributes

locale-charset-map

Superelements

Subelements

Attributes

Example Agents

localpart

Superelements

Subelements

lock-when-loaded

Superelements

Subelements

lock-when-modified

Superelements

log-service

Superelements

Subelements

Attributes

login-config

Superelements

Subelements

mail-resource

Superelements

Subelements

Attributes

Properties

manager-properties

Superelements

Subelements

Properties

mapping-properties

Superelements

max-cache-size

Superelements

Subelements

max-pool-size

Superelements

Subelements

max-wait-time-in-millis

Superelements

mdb-connection-factory

Superelements

Subelements

mdb-resource-adapter

Superelements

Subelements

message

Superelements

Subelements

message-destination

Superelements

Subelements

message-destination-name

Superelements

Subelements

message-destination-ref

Superelements

Subelements

message-destination-ref-name

Superelements

Subelements

message-security

Superelements

Subelements

message-security-binding

Superelements

Subelements

Attributes

message-security-config

Superelements

Subelements

Attributes

method

Superelements

Subelements

method-intf

Superelements

Subelements

method-name

Superelements

Subelements

Examples

method-param

Superelements

Subelements

method-params

Superelements

Subelements

name

Superelements

Subelements

named-group

Superelements

Subelements

namespaceURI

Superelements

Subelements

none

Superelements

Subelements

one-one-finders

Superelements

Subelements

operation-name

Superelements

Subelements

parameter-encoding

Superelements

Subelements

Attributes

pass-by-reference

Superelements

Subelements

password

Superelements

Subelements

per-request-load-balancing

Superelements

Subelements

pm-descriptors

Superelements

pool-idle-timeout-in-seconds

Superelements

Subelements

port-component-name

Superelements

Subelements

port-info

Superelements

Subelements

prefetch-disabled

Superelements

Subelements

principal

Superelements

Subelements

principal-map

Superelements

Subelements

Attributes

principal-name

Superelements

Subelements

Attributes

property (with attributes)

Superelements

Subelements

Attributes

Example

property (with subelements)

Superelements

Subelements

Example

provider-config

Superelements

Subelements

Attributes

query-filter

Superelements

Subelements

query-method

Superelements

Subelements

query-ordering

Superelements

Subelements

query-params

Superelements

Subelements

query-variables

Superelements

Subelements

read-only

Superelements

Subelements

realm

Superelements

Subelements

refresh-field

Superelements

Subelements

Attributes

refresh-period-in-seconds

Superelements

Subelements

removal-timeout-in-seconds

Superelements

Subelements

remote-home-impl

Superelements

Subelements

remote-impl

Superelements

Subelements

request-policy

Superelements

Subelements

Attributes

request-protection

Superelements

Subelements

Attributes

required

Superelements

Subelements

res-ref-name

Superelements

Subelements

resize-quantity

Superelements

Subelements

resource-adapter-config

Superelements

Subelements

Attributes

Properties

resource-adapter-mid

Superelements

Subelements

resource-env-ref

Superelements

Subelements

Example

resource-env-ref-name

Superelements

Subelements

resource-ref

Superelements

Subelements

Example

resources

Superelements

Subelements

response-policy

Superelements

Subelements

Attributes

response-protection

Superelements

Subelements

Attributes

role-name

Superelements

Subelements

sas-context

Superelements

Subelements

schema

Superelements

Subelements

Examples

schema-generator-properties

Superelements

Subelements

Properties

Example

secondary-table

Superelements

Subelements

security

Superelements

Subelements

security-map

Superelements

Subelements

Attributes

security-role-mapping

Superelements

Subelements

service-endpoint-interface

Superelements

Subelements

service-impl-class

Superelements

Subelements

service-qname

Superelements

Subelements

service-ref

Superelements

Subelements

service-ref-name

Superelements

Subelements

servlet

Superelements

Subelements

servlet-impl-class

Superelements

Subelements

servlet-name

Superelements

Subelements

session-config

Superelements

Subelements

session-manager

Superelements

Subelements

Attributes

session-properties

Superelements

Subelements

Properties

ssl

Superelements

Subelements

Attributes

steady-pool-size

Superelements

Subelements

store-properties

Superelements

Subelements

Properties

stub-property

Superelements

Subelements

Properties

Example

sun-cmp-mapping

Superelements

Subelements

sun-cmp-mappings

Superelements

Subelements

table-name

Superelements

Subelements

target-server

Superelements

Subelements

Attributes

tie-class

Superelements

Subelements

timeout

Superelements

Subelements

Attributes

transport-config

Superelements

Subelements

transport-guarantee

Superelements

Subelements

unique-id

Superelements

Subelements

url-pattern

Superelements

Subelements

user-group

Superelements

Subelements

use-thread-pool-id

Superelements

Subelements

value

Superelements

Subelements

valve

Superelements

Subelements

Attributes

Example

vendor

Superelements

Subelements

version-identifier

Superelements

Subelements

victim-selection-policy

Superelements

Subelements

Example

web

Superelements

Subelements

web-uri

Superelements

Subelements

webservice-description

Superelements

Subelements

webservice-description-name

Superelements

Subelements

webservice-endpoint

Superelements

Subelements

work-security-map

Superelements

Subelements

Attributes

wsdl-override

Superelements

Subelements

Example

wsdl-port

Superelements

Subelements

wsdl-publish-location

Superelements

Subelements

Example

Index

class-loader

Configures the class loader for the web module.

Superelements

glassfish-web-app (glassfish-web.xml)

Subelements

The following table describes subelements for the class-loader element.

Table C-22 class-loader Subelements

Element
Required
Description
zero or more
Specifies a property, which has a name and a value.

Attributes

The following table describes attributes for the class-loader element.

Table C-23 class-loader Attributes

Attribute
Default
Description
extra-class-path
null
(optional) Specifies a colon or semicolon separated list of additional classpaths for this web module. Paths can be absolute or relative to the web module's root, for example:
extra-class-path="WEB-INF/lib/extra/extra.jar"
delegate
true
(optional) If true, the web module follows the standard class loader delegation model and delegates to its parent class loader first before looking in the local class loader. You must set this to true for a web module that accesses EJB components or that acts as a web service client or endpoint.

If false, the web module follows the delegation model specified in the Servlet specification and looks in its class loader before looking in the parent class loader. It’s safe to set this to false only for a web module that does not interact with any other modules.

For a number of packages, including java.* and javax.*, symbol resolution is always delegated to the parent class loader regardless of the delegate setting. This prevents applications from overriding core Java runtime classes or changing the API versions of specifications that are part of the Java EE platform.

dynamic-reload-interval
(optional) Not implemented. Included for backward compatibility with previous Oracle Web Server versions.

Note - If the delegate attribute is set to false, the class loader delegation behavior complies with the Servlet 2.4 specification, section 9.7.2. If set to its default value of true, classes and resources residing in container-wide library JAR files are loaded in preference to classes and resources packaged within the WAR file.

Portable programs that use this element should not be packaged with any classes or interfaces that are a part of the Java EE specification. The behavior of a program that includes such classes or interfaces in its WAR file is undefined.


Properties

The following table describes properties for the class-loader element.

Table C-24 class-loader Properties

Property
Default
Description
ignoreHiddenJarFiles
false
If true, specifies that all JAR and ZIP files in the WEB-INF/lib directory that start with a period (.) are ignored by the class loader.