Session Action

The session action helps in managing the session of a user on the server. It can create and terminate a session. The function is controlled by a parameter named 'action'.

For more information on session handling and session contexts have a look at the Session Context documentation.

Creating a Session

To create a session (if it not already exists) simply add the action in your pipeline:

    <map:act type="session"/>
  

This is the equivalent to specify the 'action' parameter with the value 'create':

    <map:act type="session">
        <map:parameter name="action" value="create"/>
    </map:act>
  

Terminating a Session

Terminating a session is as easy as creating a session, simply add the action to your pipeline and set the 'action' parameter to 'terminate':

    <map:act type="session">
        <map:parameter name="action" value="terminate"/>
    </map:act>
  

This terminates the session immediately.

You can optionally specifiy the 'mode' parameter which controlls the termination of the session. You have the choice between 'immediately' (the default) and 'if-unsued'. If you use the mode 'if-unused', the session is only terminated, if no session context exists for the user:

    <map:act type="session">
        <map:parameter name="action" value="terminate"/>
        <map:parameter name="mode" value="if-unused"/>
    </map:act>
  

• Name : session
• Class: org.apache.cocoon.webapps.session.acting.SessionAction