1.1 --- a/docs/sessions-usage.html Tue Sep 06 22:03:41 2005 +0000
1.2 +++ b/docs/sessions-usage.html Tue Sep 06 22:04:08 2005 +0000
1.3 @@ -1,12 +1,10 @@
1.4 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
1.5 -<html xmlns="http://www.w3.org/1999/xhtml">
1.6 -<head>
1.7 +<html xmlns="http://www.w3.org/1999/xhtml"><head>
1.8 <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type" />
1.9 - <title>Using Sessions</title>
1.10 - <meta name="generator"
1.11 - content="amaya 8.1a, see http://www.w3.org/Amaya/" />
1.12 - <link href="styles.css" rel="stylesheet" type="text/css" />
1.13 -</head>
1.14 +
1.15 + <title>Using Sessions</title><meta name="generator" content="amaya 8.1a, see http://www.w3.org/Amaya/" />
1.16 + <link href="styles.css" rel="stylesheet" type="text/css" /></head>
1.17 +
1.18 <body>
1.19 <h1>Using Sessions</h1>
1.20 <p>Unlike cookies, session information is always stored on the server
1.21 @@ -25,8 +23,7 @@
1.22 <div class="WebStack">
1.23 <h3>WebStack API - Using Sessions</h3>
1.24 <p>In WebStack, a session appears as a dictionary to applications and
1.25 -is acquired for a specific user through the <a
1.26 - href="../apidocs/public/WebStack.Generic.Transaction-class.html">transaction</a>
1.27 +is acquired for a specific user through the <a href="../apidocs/public/WebStack.Generic.Transaction-class.html">transaction</a>
1.28 object. The following methods are provided in the transaction for
1.29 accessing and maintenance of session information:</p>
1.30 <dl>
1.31 @@ -66,5 +63,12 @@
1.32 <pre> # In the respond method...<br /> trans.expire_session()</pre>
1.33 <p>Note that WebStack automatically knows which session is to be
1.34 expired since only one such session can exist for the identified user.</p>
1.35 -</body>
1.36 -</html>
1.37 +<h2>Session Limitations and Guidelines</h2>
1.38 +<ul>
1.39 + <li>Due to various limitations in the storage of session information,
1.40 +it is recommended that each item of data is converted to a string value
1.41 +when being set in the session, and that the key employed is also a
1.42 +string value. These limitations may be removed in a later release.</li>
1.43 +</ul>
1.44 +
1.45 +</body></html>
1.46 \ No newline at end of file