resolveURI

Home > Books > NetKernel API and Services Reference > Accessor Listing > XML Accessors > resolveURI

Module

The resolveURI accessor is exported by the urn:org:ten60:netkernel:ext:xml:ura module. Import this module to gain access to the accessor.

Syntax

URI

active:resolveURI

Argument	Rules	Description
operand	Mandatory	the relative canonical URI to resolve
operator	Mandatory	the absolute canonical URI to resolve against
param	Optional	optional URIs document to append to

Example Usage

DPML

<instr>
  <type>resolveURI</type>
  <operand>
    <uri>foo.xml</uri>
  </operand>
  <operator>
    <uri>file:/base/path/</uri>
  </operator>
  <target>var:resolveduri</target>
</instr>

NetKernel Foundation API

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

Purpose

The resolveURI accessor resolves a relative canonical URI document against an absolute canonical URI.

<instr>
  <type>resolveURI</type>
  <operand>
    <uri>mydoc.xml</uri>
  </operand>
  <operator>
    <uri>file:///a/base/path/</uri>
  </operator>
  <target>var:mydocuri</target>
</instr>

Would produce in var:mydocuri...

<uri>file:///a/base/path/mydoc.xml</uri>

resolveURI takes an optional canonical uris parameter document. If this is provided the result will be the resolved canonical URI appended to the uris document.