W3C Jigsaw


All resources All frames

CgiFrame

This resource class runs CGI scripts, conforming to the CGI/1.1 specification. You can use it as an extension template, to get automatic indexing of your CGI scripts, based on their extension.

It also has a special interpreter attribute that makes running scripts on Windows easy to configure, and somwhow more efficient then you could expect.


Inherits

The CgiFrame class inerits from the following classes:


Attributes description

The CgiFrame defines the following attributes:


interpreter
semantics
Some operating systems don't support the nice UNIX feature !# that allows UNIX to launch the appropriate interpreter for the appropriate script. This attribute allows the CgiResource to be configured to use a certain interpreter to interpret the script pointed to by the command attribute. By using this attribute in the predefined extensions, you can state that on Windows boxes, all .pl files are to be exported by the CgiResource, with default interpreter /Perl/bin/perl.exe. This will allow you to automatically index cgi scripts.
type
This attribute is an editable StringAttribute
default value
This attribute defaults to null.


command
semantics
The command to launch in order to run the CGI script. This should provide the full pat hto the executable script. Each entry of the (String) array gives is passed as an extra argument to the script, the first one being (by convention) the full script's path.
type
This attribute is an editable StringArrayAttribute
default value
This attribute defaults to null.


noheader
semantics
Will the script emits its one headers, or should Jigsaw emit them. Classical CGI scripts will usually not emit any headers, so it is up to their hosting server to emit them. However, in some situation (server push, for example), the script might prefer to emit its own set of headers. When this flag is set to true it is up to the script to emit the headers, otherwise, the server will do it.
type
This attribute is an editable BooleanAttribute
default value
This attribute defaults to false.


generates-form
semantics
Should the script be used to generate the form to be filled-in ? This resource allows you to put your form in a file, instead of having to launch the script to generate it. For compatibilty, this flags is turned to false by default, although, the second alternative (having the form in a separate file) will probably be much (much) more efficient.
type
This attribute is an editable BooleanAttribute
default value
This attribute defaults to true.


remote-host
semantics
If turned on, this flag will enable the REMOTE_HOST env var computation.
type
This attribute is an editable BooleanAttribute
default value
This attribute defaults to null.


cgi-debug
semantics
Turns debug on for that script. This nifty feature allow you to debug your script, by emitting a document containing the script output, instead of letting the script generates the document. The returned document will be of content type text/plain.
type
This attribute is an editable BooleanAttribute
default value
This attribute defaults to false.


env
semantics
Gives additional environment variables to the script. Windows users may find it useful to define WINDIR=%windir% and SYSTEMROOT=%systemroot%.
type
This attribute is an editable PropertiesAttribute
default value
This attribute defaults to null.


Jigsaw Team
$Id: org.w3c.jigsaw.frames.CgiFrame.html,v 1.3 1998/03/27 08:19:05 bmahe Exp $