TDADBSessionManager

From RemObjects Software

This is a Data Abstract Architecture entry
Feel free to add your notes to this topic below.

Overview

TDADBSessionManager implements a session manager that stores session data in a database accessed using Data Abstract. This database can in theory be shared by multiple servers, allowing session state to be accessible across a server farm.

The component works similarly to the TRODBSessionManager session manager shipped with RemObjects SDK.

File

uDADBSessionManager

Declaration

TDADBSessionManager = class(TROCustomSessionManager);

Hierarchy

• TROCustomSessionManager
  • TDADBSessionManager

Properties

Property	Type	Description
ClearSessionsCommand	String	Defines the command that will be used to DELETE all sessions from the database, when ClearSessions is called or if the ClearSessionsOnCreate or ClearSessionsOnDestroy properties are set to true.
ClearSessionsOnCreate	Boolean	Decides whether the session manager should clear the database of old sessions when the component is created (i.e. usually at application startup). Set this property to true if you want your server to start with a clean slate at each startup; keep it to false if you want sessions from previous executions to persist when the server shuts down and is restarted, or if multiple servers will share the same session database.
ClearSessionsOnDestroy	Boolean	Specifies whether the session manager should clear the database of old sessions when the component is destroyed (i.e. usually at application shutdown). Set this property to true if you want your server to leave a clean slate on shutdown; keep it to false if you want sessions from previous executions to persist when the server shuts down and is restarted, or if multiple servers will share the same session database.
Connection	String	Sets the name of the connection to the database that contains the session data.
DeleteSessionCommand	String	Defines the command that will be used to DELETE sessions from the database, when they expire or are explicitly deleted.
FieldNameCreated	String	Assigns the database field used to store the time and date the session was originally created.
FieldNameData	String	Specifies the database field used to store the session data. This must be a BLOB field.
FieldNameLastAccessed	String	Sets the database field used to store the time and date the session was last accessed.
FieldNameSessionID	String	Specifies the database field used to store the session ID. This must be a GUID field, or a string field of 38 characters.
GetAllSessionIDsDataset	String	Defines the dataset (data table) that will be used to get the complete list of session IDs from the database.
GetSessionCountDataSet	String	Determines the dataset that will be used to get the number of sessions contained in the database.
GetSessionDataSet	String	Specifies the dataset (data table) that will be used to SELECT (i.e. retrieve) sessions from the database, when needed.
InsertSessionCommand	String	Defines the command that will be used to INSERT new session into the database, when it is first created.
Schema	TDASchema	Sets the TDASchema used to access the session data. This is the schema that must define all the GetSessionDataset, InsertSessionCommand, UpdateSessionCommand, DeleteSessionCommand, GetAllSessionIDsDataset and GetSessionCountDataSet tables and commands.
UpdateSessionCommand	String	Defines the command that will be used to UPDATE sessions in the database, when they have been touched by the user.

Events

Event	Description
OnConvertGUID	Fires whenever a Session ID is used to access the database, allowing to convert the actual GUIDs used by the RemObjects SDK's session management to a different format for storage in a database.

See Also

• Session Management
• Lists
  • Class List (Data Abstract for Delphi)
  • Interface List (Data Abstract for Delphi)
  • Enum List (Data Abstract for Delphi)
  • Data Types (Data Abstract)
  • File Types (Data Abstract)

Product: RemObjects Data Abstract
Current version: Data Abstract 'Vinci' (5.0)

Lists — Glossary — Features — How To — Drivers — Components — Tools — Samples — Articles — Architecture — Issues