Creating an HTTP session

Sessions can be created using the SessionID option in the sa_set_http_option system procedure. The session ID can be defined by any non-null string.

Session state management is supported by URLs and cookies. HTTP sessions can be accessed using HTTP cookies, or through the URL of a GET request or from within the body of a POST (x-www-form-urlencoded) request. For example, the following URL utilizes the XYZ database connection when it executes:

http://localhost/sa_svc?SESSIONID=XYZ

The request is processed as a standard session-less request if an XYZ database connection does not exist.

Example

The following code illustrates how to create a RAW web service that creates and deletes sessions. A connection scope variable named request_count is increment each time an HTTP request is made while specifying a valid SessionID.

CREATE SERVICE session
    TYPE 'RAW'
    AUTHORIZATION OFF
    USER DBA
    AS CALL sp_session();

CREATE PROCEDURE sp_session()
BEGIN
    DECLARE body LONG VARCHAR;
    DECLARE sesid LONG VARCHAR;
    DECLARE newsesid LONG VARCHAR;
    DECLARE createtm TIMESTAMP;
    DECLARE lastaccesstm TIMESTAMP;

    SELECT CONNECTION_PROPERTY('sessionid') INTO sesid;
    IF HTTP_VARIABLE('delete') IS NOT NULL THEN
        CALL sa_set_http_option( 'SessionID', NULL );
        SET body = '<html><body>Deleted ' || sesid
            || '</BR><a href="http://localhost/session">Start Again</a>';
        SELECT body;
    END IF;
    IF sesid = '' THEN
        SET newsesid = set_session();
        CREATE VARIABLE request_count INT;
        SET request_count = 0;

        SET body = '<html><body> Created sessionid ' || newsesid
            || '</BR><a href="http://localhost/session?SessionID=' || newsesid || '"> Enter into Session</a>';
    ELSE
        SELECT CONNECTION_PROPERTY('sessionid') INTO sesid;

        SET request_count = request_count +1;
        SELECT CONNECTION_PROPERTY('sessioncreatetime') INTO createtm;
        SELECT CONNECTION_PROPERTY('sessionlasttime') INTO  lastaccesstm;
        
        SET body = '<html><body>Session ' || sesid || '</BR>'
            || 'created ' || createtm || '</BR>'
            || 'last access ' || lastaccesstm || '</BR>'
            || '<H3>REQUEST COUNT is '|| request_count || '</H3><HR></BR>'
            || '<a href="http://localhost/session?SessionID=' || sesid || '"> Enter into Session</a></BR>'
            || '<a href="http://localhost/session?SessionID=' || sesid || '&delete"> Delete Session</a>';
    END IF;

    SELECT body;
END;

Creating an HTTP session

Example

See also