java.lang.Object
AbstractLoggable
org.apache.cocoon.acting.AbstractAction
org.apache.cocoon.acting.AbstractConfigurableAction
org.apache.cocoon.acting.SessionStateAction
- All Implemented Interfaces:
- Action
- public class SessionStateAction
- extends AbstractConfigurableAction
Store the session's current state in a session attribute.
To keep track of the state of a user's session, a string is
stored in a session attribute in order to allow to chose between
different pipelines in the sitemap accordingly.
For added flexibility it is possible to use sub states as
well. For this declare your own name for the session state
attribute and give the number of sublevels plus the level to
modify. (This is one based!) Sub states below the current
one are removed from the session so that the default sub state will
be reentered when the user returns. If you don't like this
behaviour and prefer independent sub states, use this action
several times with different attribute names rather than sub
levels.
Global and local parameters:
state-key-prefix |
String that identifies the attribute that stores the session state in the
session object. When sublevels are used, this is a prefix ie. the
number of the level is appended to the prefix. Example prefix is
"__sessionState", sub-levels is 2, attributes
"__sessionState1", "__sessionState2", and
"__sessionState3" will be used to store the
information.
|
new-state |
String that identifies the current state |
sub-levels |
Number of sub levels to use |
state-level |
Sub level to modify, this is one based |
- Version:
- CVS $Id: SessionStateAction.java,v 1.6.2.2 2002/10/22 02:10:56 vgritsenko Exp $
| Fields inherited from interface org.apache.cocoon.acting.Action |
ROLE |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
statekey
protected java.lang.String statekey
newstate
protected java.lang.String newstate
sublevels
protected int sublevels
mylevel
protected int mylevel
SessionStateAction
public SessionStateAction()
configure
public void configure(Configuration conf)
throws ConfigurationException
- Configures the Action.
- Overrides:
configure in class AbstractConfigurableAction
act
public java.util.Map act(org.apache.cocoon.environment.Redirector redirector,
org.apache.cocoon.environment.SourceResolver resolver,
java.util.Map objectModel,
java.lang.String src,
Parameters par)
throws java.lang.Exception
- Description copied from interface:
Action
- Controls the processing against some values of the
Dictionary objectModel and returns a
Map object with values used in subsequent
sitemap substitution patterns.
NOTE: This interface is designed so that implentations can be ThreadSafe.
When an action is ThreadSafe, only one instance serves all requests : this
reduces memory usage and avoids pooling.