class-loader - Sun GlassFish Enterprise Server v3 Application Deployment Guide

Exit Print View
Sun GlassFish Enterprise Server v3 Application Deployment Guide

Previous

Next

Document Information

1. Overview of Sun GlassFish Enterprise Server v3 Application Deployment

2. Deploying Applications

A. The asadmin Deployment Subcommands

B. Enterprise Server Deployment Descriptor Files

C. Elements of the Enterprise Server Deployment Descriptors

activation-config

activation-config-property

activation-config-property-name

activation-config-property-value

admin-object-resource

backend-principal

Cache Class Names

cache-helper-ref

cache-idle-timeout-in-seconds

cache-mapping

call-property

caller-propagation

check-all-at-commit

check-modified-at-commit

check-version-of-accessed-instances

checkpoint-at-end-of-method

checkpointed-methods

client-container

client-credential

cmp-field-mapping

cmr-field-mapping

cmr-field-name

cmt-timeout-in-seconds

commit-option

compatibility

confidentiality

connector-connection-pool

connector-resource

constraint-field

constraint-field-value

cookie-properties

create-tables-at-deploy

custom-resource

database-vendor-name

debugging-enabled

default-helper

default-resource-principal

drop-tables-at-undeploy

endpoint-address-uri

enterprise-beans

entity-mapping

establish-trust-in-client

establish-trust-in-target

external-jndi-resource

flush-at-end-of-method

idempotent-url-pattern

ior-security-config

is-cache-overflow-allowed

is-one-one-cmp

is-read-only-bean

java-web-start-access

jdbc-connection-pool

jdbc-resource

jms-durable-subscription-name

jms-max-messages-load

local-home-impl

locale-charset-info

locale-charset-map

lock-when-loaded

lock-when-modified

mail-resource

manager-properties

mapping-properties

max-cache-size

max-pool-size

max-wait-time-in-millis

mdb-connection-factory

mdb-resource-adapter

message-destination

message-destination-name

message-destination-ref

message-destination-ref-name

message-security

message-security-binding

message-security-config

method-params

one-one-finders

operation-name

parameter-encoding

pass-by-reference

pm-descriptors

pool-idle-timeout-in-seconds

port-component-name

prefetch-disabled

principal-map

principal-name

property (with attributes)

property (with subelements)

provider-config

query-ordering

query-variables

refresh-field

refresh-period-in-seconds

removal-timeout-in-seconds

remote-home-impl

request-policy

request-protection

resize-quantity

resource-adapter-config

resource-adapter-mid

resource-env-ref

resource-env-ref-name

response-policy

response-protection

schema-generator-properties

secondary-table

security-role-mapping

service-endpoint-interface

service-impl-class

service-qname

service-ref-name

servlet-impl-class

session-config

session-manager

session-properties

steady-pool-size

store-properties

stub-property

sun-application

sun-application-client

sun-cmp-mapping

sun-cmp-mappings

target-server

transport-config

transport-guarantee

use-thread-pool-id

victim-selection-policy

webservice-description

webservice-description-name

webservice-endpoint

work-security-map

wsdl-override

wsdl-publish-location

`class-loader`

Configures the class loader for the web module.

Superelements

sun-web-app (sun-web.xml)

Subelements

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

`class-loader` Subelements

Element	Required	Description
`property` (with attributes)	zero or more	Specifies a property, which has a name and a value.

Attributes

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

`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. Note - For this release, the `delegate` value is ignored and assumed to be set to `true`.
`dynamic-reload-interval`		(optional) Not implemented. Included for backward compatibility with previous Sun GlassFish Web Server versions.

Note - If the delegate element 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.

`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.

Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices

Previous

Next