::nsmcp::Object ::nsmcp::Object dict getdef ::nx::Object ::nx::Object ::nsmcp::Object->::nx::Object ::nsmcp::UnifiedAccessSession ::nsmcp::UnifiedAccessSession changes close destroy execute overview scalar ::nsmcp::UnifiedAccessSession->::nsmcp::Object

Class ::nsmcp::UnifiedAccessSession

::nsmcp::UnifiedAccessSession[i] create ... \
           [ -adapter:required adapter:required ]

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

Class Relations

  • class: ::nx::Class[i]
  • superclass: ::nsmcp::Object[i]
::nx::Class create ::nsmcp::UnifiedAccessSession \
     -superclass ::nsmcp::Object

Methods (to be applied on instances)

  • changes (scripted, public)

     <instance of nsmcp::UnifiedAccessSession[i]> changes

    Read the affected-row count from the underlying store session. Delegate to the adapter's existing database session.

    Returns:
    The most recent SQLite change count.

    Testcases:
    No testcase defined.
    return [[${:adapter} session] changes]
  • close (scripted, public)

     <instance of nsmcp::UnifiedAccessSession[i]> close

    Release the unified access session. Destroy this wrapper and close its owned adapter through the destructor.

    Returns:
    The object destruction result.

    Testcases:
    No testcase defined.
    :destroy
  • execute (scripted, public)

     <instance of nsmcp::UnifiedAccessSession[i]> execute sql args \
        [ 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.

    Parameters:
    sql (required)
    Trusted SQL text; current values are resolved in the caller's scope.
    args (required)
    Additional arguments forwarded to the underlying operation.
    Returns:
    The underlying session's row or callback result.

    Testcases:
    No testcase defined.
    set db [${:adapter} session]
    return [uplevel 1 [list $db execute $sql {*}$args]]
  • overview (scripted, public)

     <instance of nsmcp::UnifiedAccessSession[i]> overview

    Read the unified store's retained coverage overview. Delegate to the record adapter without scanning source files.

    Returns:
    The store overview dictionary.

    Testcases:
    No testcase defined.
    return [${:adapter} overview]
  • scalar (scripted, public)

     <instance of nsmcp::UnifiedAccessSession[i]> scalar sql

    Read one scalar through the unified record-store session. Forward the query in the caller's scope without obtaining another database handle.

    Parameters:
    sql (required)
    Trusted SQL text; current values are resolved in the caller's scope.
    Returns:
    The first query value, or an empty result for no row.

    Testcases:
    No testcase defined.
    set db [${:adapter} session]
    return [uplevel 1 [list $db scalar $sql]]