cast

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

Module

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

Syntax

URI

active:cast

Argument	Rules	Description
operand	Mandatory	the resource to be cast
operator	Mandatory	the cast specification

Example Usage

DPML

<instr>
  <type>cast</type>
  <operand>foo.xml</operand>
  <operator>
    <cast>
      <mimetype>text/plain</mimetype>
    </cast>
  </operator>
  <target>this:response</target>
</instr>

NetKernel Foundation API

The cast accessor is provided for use with the DPML language. It is more efficient to use the following NKF method with scripting languages:

INKFResponse.setMimeType() set MIME type of resource

Purpose

The cast accessor is used to specify the MIME media type of a resource.

It is useful to explicitly set the MIME type for the representation of a resource when there is more than one valid form. For example, an XML resource could be equally valid as text/xml, text/html, text/xhtml or text/plain depending upon the context of the response.

The cast accessor only changes the meta data associated with a resource, it does not change the underlying data in any way.

Operator Syntax

The cast accessor takes an operator which specifies the cast.

<cast>
  <mimetype>text/plain</mimetype>
</cast>

The mimetype element can contain any valid MIME media type specification. Information about MIME media types can be found on the IANA website.