buildSessionResourceURI

Home > Books > NetKernel API and Services Reference > Accessor Listing > Session Extensions > buildSessionResourceURI

Module

The buildSessionResourceURI accessor is exported by the urn:org:ten60:netkernel:ext:session module. Import this module to gain access to the accessor.

Syntax

URI

active:buildSessionResourceURI

Argument	Rules	Description
operand	Mandatory	the URI of the session
operator	Mandatory	a document holding the key identifier to build the URI with

Example Usage

DPML

<instr>
  <type>buildSessionResourceURI</type>
  <operand>this:param:session</operand>
  <operator>
    <key>myresource</key>
  </operator>
  <target>var:mySessionObjectURI</target>
</instr>

NetKernel Foundation API

With NKF based scripting languages it is easier to create a sub-request for a session resource directly.

req=context.createSubRequest();
req.setURI("session:AB134534652AF56321545");
req.addArgument("key", "myresource");
myresource=context.issueSubRequest(req);

Purpose

A session has a URI of the form session:AB134534652AF56321545, a session resource belongs to a session and is identified by an active URI of the form.

session:AB134534652AF56321545+key@myresource

The buildSessionResourceURI is a convenience utility for declarative languages to construct a session resource active URI. The session URI is provided as the operand. The operator is an XML document with root <key> containing an identifier for the session resource. The result is canonical compound URI document of the form show above. This URI can be used to reference the session resource.