Specifies session persistence (storage) properties.
session-manager (sun-web.xml)
The following table describes subelements for the store-properties element.
Table A–115 store-properties Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property, which has a name and a value. |
The following table describes properties for the store-properties element.
Table A–116 store-properties Properties
Property |
Default |
Description |
---|---|---|
domain-dir/generated/jsp/j2ee-apps/app-name/app-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. |
|
session |
Specifies how much of the session state is stored. Allowed values are as follows:
Applicable only if the persistence-type attribute of the parent session-manager element is ha or replicated. |
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.