Classe: THttpSession  - X-Ref

THttpSession class

THttpSession provides session-level data management and the related configurations.
To start the session, call {@open}; to complete and send out session data, call {@close};
to destroy the session, call {@destroy}. If AutoStart is true, then the session
will be started once the session module is loaded and initialized.

To access data stored in session, use THttpSession like an associative array. For example,
<code>
$session=new THttpSession;
$session->open();
$value1=$session['name1'];  // get session variable 'name1'
$value2=$session['name2'];  // get session variable 'name2'
foreach($session as $name=>$value) // traverse all session variables
$session['name3']=$value3;  // set session variable 'name3'
</code>

The following configurations are available for session:
{@link setAutoStart AutoStart}, {@link setCookie Cookie},
{@link setCacheLimiter, {@link setSavePath SavePath},
{@link setUseCustomStorage UseCustomStorage}, {@link setGCProbability GCProbability},
{@link setCookieUsage CookieUsage}, {@link setTimeout Timeout}.
See the corresponding setter and getter documentation for more information.
Note, these properties must be set before the session is started.

THttpSession can be inherited with customized session storage method.
Override {@link _open}, {@link _close}, {@link _read}, {@link _write}, {@link _destroy} and {@link _gc}
and set {@link setUseCustomStorage UseCustomStorage} to true.
Then, the session data will be stored using the above methods.

By default, THttpSession is registered with {@link TApplication} as the
request module. It can be accessed via {@link TApplication::getSession()}.

THttpSession may be configured in application configuration file as follows,
<code>
<module id="session" class="THttpSession" SessionName="SSID" SavePath="/tmp"
CookieMode="Allow" UseCustomStorage="false" AutoStart="true" GCProbability="1"
UseTransparentSessionID="true" TimeOut="3600" />
</code>
where {@link getSessionName SessionName}, {@link getSavePath SavePath},
{@link getCookieMode CookieMode}, {@link getUseCustomStorage
UseCustomStorage}, {@link getAutoStart AutoStart}, {@link getGCProbability
GCProbability}, {@link getUseTransparentSessionID UseTransparentSessionID}
and {@link getTimeOut TimeOut} are configurable properties of THttpSession.

Classe: TSessionIterator  - X-Ref

TSessionIterator class

TSessionIterator implements Iterator interface.

TSessionIterator is used by THttpSession. It allows THttpSession to return a new iterator
for traversing the session variables.

Classe: THttpSessionCookieMode  - X-Ref

THttpSessionCookieMode class.
THttpSessionCookieMode defines the enumerable type for the possible methods of
using cookies to store session ID.

The following enumerable values are defined:
- None: not using cookie.
- Allow: using cookie.
- Only: using cookie only.