64 lines
3.1 KiB
HTML
64 lines
3.1 KiB
HTML
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
<body>
|
|
|
|
<p>This package contains the standard <code>Manager</code> and
|
|
<code>Session</code> implementations that represent the collection of
|
|
active sessions and the individual sessions themselves, respectively,
|
|
that are associated with a <code>Context</code>. Additional implementations
|
|
of the <code>Manager</code> interface can be based upon the supplied
|
|
convenience base class (<code>ManagerBase</code>), if desired. Different
|
|
implementations of <code>Session</code> are possible, but a need for
|
|
functionality beyond what is provided by the standard implementation
|
|
(<code>StandardSession</code>) is not expected.</p>
|
|
|
|
<p>The convenience <code>ManagerBase</code> base class is configured by
|
|
setting the following properties:</p>
|
|
<ul>
|
|
<li><b>algorithm</b> - Message digest algorithm to be used when
|
|
generating session identifiers. This must be the name of an
|
|
algorithm supported by the <code>java.security.MessageDigest</code>
|
|
class on your platform. [DEFAULT_ALGORITHM]</li>
|
|
<li><b>debug</b> - Debugging detail level for this component. [0]</li>
|
|
<li><b>distributable</b> - Has the web application we are associated with
|
|
been marked as "distributable"? If it has, attempts to add or replace
|
|
a session attribute object that does not implement the
|
|
<code>java.io.Serializable</code> interface will be rejected.
|
|
[false]</li>
|
|
<li><b>maxInactiveInterval</b> - The default maximum inactive interval,
|
|
in minutes, for sessions created by this Manager. The standard
|
|
implementation automatically updates this value based on the configuration
|
|
settings in the web application deployment descriptor. [60]</li>
|
|
<li><b>randomClass</b> - The Java class name of the random number generator
|
|
to be used when creating session identifiers for this Manager.
|
|
[java.security.SecureRandom]</li>
|
|
</ul>
|
|
|
|
<p>The standard implementation of the <code>Manager</code> interface
|
|
(<code>StandardManager</code>) supports the following additional configuration
|
|
properties:</p>
|
|
<ul>
|
|
<li><b>maxActiveSessions</b> - The maximum number of active sessions that
|
|
will be allowed, or -1 for no limit. [-1]</li>
|
|
<li><b>pathname</b> - Pathname to the file that is used to store session
|
|
data persistently across container restarts. If this pathname is relative,
|
|
it is resolved against the temporary working directory provided by our
|
|
associated Context, if any. ["sessions.ser"]</li>
|
|
</ul>
|
|
|
|
</body>
|