DSSSLread-locator

Synopsis

(read-locator format rdestination . keywordparameters) => locator

(write-locator format rdestionation . keywordparameters) => locator

Description

Creates a locator for the client side (browser) to read respectively write to the locations specified by rdestination.

The purpose of these functions is to keep the Askemos level code agnostic about the access method (which is usually HTTP) the client uses. As a conviniece to simplify creation of reply document, the message carry the location format as slot location-format.

rdestination is a reverse list of the destination-URL to be produced. Note: That's essentially so, because the tail is typically shared with the location slot of the current message. see example below.

keywordparameters An even number of optional parameters, where the odd elements are keywords indication the purpose of the next even parameter object. The following keyword parameters are defined:

body:

An XML form element.

Example

This example produces a locator for the "index.html" object "within itself" or "down the tree" in directory style objects. Note how the current location is easily extended.