Class ::nsmcp::UnifiedAccessSession (public)

 ::nx::Class ::nsmcp::UnifiedAccessSession

Defined in /usr/local/ns/tcl/nsmcp/log-traffic-unified.tcl

Testcases:

No testcase defined.

Source code:

    :property adapter:required

    :public method execute {sql args} {
        #
        # Execute SQL through the unified record-store session.
        #
        # Forward the statement and options in the caller's scope so bindings and
        # callbacks retain their original context.
        #
        # @param sql Trusted SQL text; current values are resolved in the caller's
        #        scope.
        # @param args Additional arguments forwarded to the underlying operation.
        #
        # @return The underlying session's row or callback result.
        #

        set db [${:adapter} session]
        return [uplevel 1 [list $db execute $sql {*}$args]]
    }

    :public method scalar {sql} {
        #
        # Read one scalar through the unified record-store session.
        #
        # Forward the query in the caller's scope without obtaining another database
        # handle.
        #
        # @param sql Trusted SQL text; current values are resolved in the caller's
        #        scope.
        #
        # @return The first query value, or an empty result for no row.
        #

        set db [${:adapter} session]
        return [uplevel 1 [list $db scalar $sql]]
    }

    :public method changes {} {
        #
        # Read the affected-row count from the underlying store session.
        #
        # Delegate to the adapter's existing database session.
        #
        # @return The most recent SQLite change count.
        #

        return [[${:adapter} session] changes]
    }

    :public method overview {} {
        #
        # Read the unified store's retained coverage overview.
        #
        # Delegate to the record adapter without scanning source files.
        #
        # @return The store overview dictionary.
        #

        return [${:adapter} overview]
    }

    :public method close {} {
        #
        # Release the unified access session.
        #
        # Destroy this wrapper and close its owned adapter through the destructor.
        #
        # @return The object destruction result.
        #

        :destroy
    }

    :method destroy {} {
        ${:adapter} close
        next
    }

XQL Not present:

Generic, PostgreSQL, Oracle