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.

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 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