xrl resolve

Home > Books > NetKernel API and Services Reference > Accessor Listing > XRL > xrl resolve

Module

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

Syntax

URI

active:resolveXRLURI

Argument	Rules	Description
operand	Mandatory	the xrl: scheme uri
operator	Optional	the links document

Example Usage

DPML

<seq>
  <instr>
    <comment>lookup mylink</comment>
    <type>resolveXRLURI</type>
    <operator>links.xml</operator>
    <operand>xrl:mylink</operand>
    <target>var:uri</target>
  </instr>
  <instr>
    <comment>create redirect to this address</comment>
    <type>HTTPRedirect</type>
    <operator>var:uri</operator>
    <target>this:response</target>
  </instr>
</seq>

NetKernel Foundation API

main()
{   // lookup mylink
    req=context.createSubRequest("active:resolveXRLURI");
    req.addArgument("operand","xrl:mylink");
    uri=context.issueSubRequest(req);
    
    // create redirect to this address
    req=context.createSubRequest("active:HTTPRedirect");
    req.addArgument("operator",uri);
    redirect=context.issueSubRequest(req);
    
    context.createResponseFrom(redirect);
}

Purpose

The resolveXRLURI accessor is used to map a one off XRL link name into its external link address. This is useful in web applications that want to do a programmatic redirect to another page. The response is a canonical URI XML document of the form:

<uri>ffcpl:/myapp/index.html</uri>

For more details of XRL runtime see the guide.