manager-properties
Specifies session manager properties.
Superelements
session-manager (sun-web.xml)
Subelements
The following table describes subelements for the manager-properties element.
manager-properties Subelements
|
|
|
|---|
|
zero
or more |
Specifies a property, which has a name and a value. |
|
Properties
The following table describes properties for the manager-properties element.
manager-properties Properties
|
|
|
|---|
|
60 |
Specifies the number of
seconds between checks for expired sessions. This is also the interval at which
sessions are passivated if maxSessions is exceeded. If persistenceFrequency is set to time-based, active
sessions are stored at this interval. To prevent data inconsistency, set this value
lower than the frequency at which session data changes. For example, this value
should be as low as possible (1 second) for a hit counter servlet
on a frequently accessed web site, or the last few hits might be
lost each time the server is restarted. Applicable only if the persistence-type attribute of the
parent session-manager element is file or replicated.
Note - The replicated persistence type is not supported
in GlassFish v3.
|
|
-1 |
Specifies the maximum number of sessions that are permitted in
the cache, or -1 for no limit. After this, an attempt to create
a new session causes an IllegalStateException to be thrown. |
|
One of the following: domain-dir/generated/jsp/module-name/context-path_SESSIONS.ser domain-dir/generated/jsp/app-name/module-name/context-path_SESSIONS.ser |
Specifies the
absolute or relative path to the directory in which the session state is
preserved between application restarts, if preserving the state is possible. A relative path
is relative to the temporary directory for this web module. To disable preservation
of the session state, set this property's value to an empty string. Applicable only
if the persistence-type attribute of the parent session-manager element is memory. To disable this
behavior and not preserve the session state, specify an empty string as the
value of this property. |
|
web-method |
Specifies how often the session state is stored. Allowed
values are as follows:
web-method - The session state is stored at the end of each web request prior to sending a response back to the client. This mode provides the best guarantee that the session state is fully updated in case of failure. time-based - The session state is stored in the background at the frequency set by reapIntervalSeconds. This mode provides less of a guarantee that the session state is fully updated. However, it can provide a significant performance improvement because the state is not stored after each request.
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.
|
|
