setURIQuery

Home > Books > NetKernel API and Services Reference > Accessor Listing > Utility and System Accessors > setURIQuery

Module

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

Syntax

URI

active:setURIQuery

Argument	Rules	Description
operand	Mandatory	a URI
param	Optional	an NVP representation

Example Usage

DPML

<instr>
  <type>setURIQuery</type>
  <operand>curi:var:uri</operand>
  <param>var:nvp</param>
  <target>var:uri</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:setURIQuery");
req.addArgument("operand", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

Sets the query component on an existing URI from the values in a name value pair representation. This is useful for calling services which expose a URI which expects arguments on the query.

Example

Here is an example setting queries on a simple URI...

<instr>
  <type>setURIQuery</type>
  <operand>
                ffcpl:/my/uri
            </operand>
  <param>
    <nvp>
      <arg1>value1</arg1>
      <arg2>value2</arg2>
    </nvp>
  </param>
  <target>this:response</target>
</instr>

Which produces...

<uri>ffcpl:/my/uri?arg1=value1&arg2=value2</uri>