store-properties - 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

`store-properties`

Specifies session persistence (storage) properties.

Superelements

session-manager (sun-web.xml)

Subelements

The following table describes subelements for the store-properties element.

`store-properties` 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 store-properties element.

`store-properties` Properties

Property	Default	Description
`directory`	`domain-dir/generated/jsp/app-name/module-name_war`	Specifies the absolute or relative pathname of the directory into which individual session files are written. A relative path is relative to the temporary work directory for this web module. Applicable only if the `persistence-type` attribute of the parent `session-manager` element is `file`.
`persistenceScope`	`session`	Specifies how much of the session state is stored. Allowed values are as follows: `session` - The entire session state is stored every time. This mode provides the best guarantee that your session data is correctly stored for any distributable web module. `modified-session` - The entire session state is stored if it has been modified. A session is considered to have been modified if `HttpSession.setAttribute()` or `HttpSession.removeAttribute()` was called. You must guarantee that `setAttribute()` is called every time an attribute is changed. This is not a Java EE specification requirement, but it is required for this mode to work properly. `modified-attribute` - Only modified session attributes are stored. For this mode to work properly, you must follow some guidelines, which are explained immediately following this table. Applicable only if the `persistence-type` attribute of the parent `session-manager` element is `replicated`. Note - The `replicated` persistence type is not supported in GlassFish v3.

If the persistenceScope store property is set to modified-attribute, a web module must follow these guidelines:

Call setAttribute() every time the session state is modified.
Make sure there are no cross-references between attributes. The object graph under each distinct attribute key is serialized and stored separately. If there are any object cross references between the objects under each separate key, they are not serialized and deserialized correctly.
Distribute the session state across multiple attributes, or at least between a read-only attribute and a modifiable attribute.

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

Previous

Next