home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-cocoon-addon-1.4.9-installer.exe / session.xml < prev    next >
Encoding:
Extensible Markup Language  |  2004-07-12  |  2.7 KB  |  62 lines
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!--
  3.   Copyright 1999-2004 The Apache Software Foundation
  4.  
  5.   Licensed under the Apache License, Version 2.0 (the "License");
  6.   you may not use this file except in compliance with the License.
  7.   You may obtain a copy of the License at
  8.  
  9.       http://www.apache.org/licenses/LICENSE-2.0
  10.  
  11.   Unless required by applicable law or agreed to in writing, software
  12.   distributed under the License is distributed on an "AS IS" BASIS,
  13.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.   See the License for the specific language governing permissions and
  15.   limitations under the License.
  16. -->
  17. <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "document-v10.dtd">
  18. <document>
  19.     <header>
  20.         <title>Session Management</title>
  21.         <authors>
  22.             <person name="Carsten Ziegeler" email="cziegeler@s-und-n.de"/>
  23.         </authors>
  24.     </header>
  25.     <body>
  26.   <s1 title="Introduction">
  27.      <p>This chapter describes the basic Cocoon session management using
  28.         the session transformer.</p>    
  29.  
  30.      <p>The chapter "Special Contexts" explains some special
  31.         contexts which do not require a session. They are available everytime. These
  32.         special contexts are the request context and the
  33.         temporary context.</p>
  34.   </s1>
  35.   <s1 title="Session Tracking">
  36.     <p>If a user has a session, Cocoon is able to connect new requests from this user
  37.        to the session of the user. This is done by session tracking. Basically,
  38.        the session tracking of Cocoon uses the session tracking of the environment,
  39.        which is usually the servlet engine.
  40.     </p>
  41.     <p>There are two methods for session tracking: cookies and url rewriting. If you
  42.        use cookies, you don't have to care about session tracking. Just refer to
  43.        the documentation of your servlet engine on how to turn on cookies for session
  44.        handling.</p>
  45.     <p>URL rewriting instead is a little bit complicated. For url rewriting, each link
  46.        the user can select, needs a special session ID appended to this link. 
  47.        Unfortunately, this is not done automatically by Cocoon or the servlet engine.
  48.        You can either do this by hand or you can use the <em>encodeURL</em> transformer
  49.        just before the <em>html serializer</em>.
  50.     </p>
  51.   </s1>
  52.   <s1 title="Sessions">
  53.      <p>The session action is responsible for creating and
  54.         terminating a session. It is controlled by a sitemap parameter named "action".
  55.         This parameter can have the values "create" and "terminate". If no parameter is
  56.         set, it defaults to "create".</p>
  57.      <p>The action either creates a new session immediately (if not already
  58.         available), or terminates it (if available).</p>
  59.   </s1>
  60. </body>
  61. </document>
  62.