| This class provides the most general and commonly used SSI commands.
Compatibility with the NCSA-style directive set has been maintained
as much as it made sense to, and new functionality adequate to Jigsaw
has been added.
In the description that follows, please refer to
the NCSA server-side includes tutorial
for comparison.
The full set of commands of the DefaultCommandRegistry is:
-
config
- The
errmsg tag is not implemented.
-
include
-
The
file and virtual tags are handled in
the same way. Both originate an internal request to the URL given
as the value of the tag. There is no provision for including a file
that is not indexed by Jigsaw. This command can be used to include
the content of any resource. This includes the SSIFrame.
In addition, the following tags are admissible:
-
ifheader
-
Its value is interpreted as a header name. It causes the
resource to be included only if that header was defined in the
original (client) request.
-
else
-
Used in conjunction with
ifheader, it specifies a
URL to be included in case the header is not defined.
-
echo
-
In addition to the
var tag, which has the NCSA
behavior, the following tags are admissible:
-
reqstate
-
Its value is interpreted as a Jigsaw request state, and
is expanded as the value of the state. For instance, the
command
<!--#echo
reqstate="org.w3c.jigsaw.filters.CounterFilter.count"-->
will print the current hit-count, assuming a
CounterFilter exists for the resource.
-
reqheader
-
Its value is interpreted as a header in the request, and is
expanded as the value of the header.
-
here
If this tag is present, command is expanded as interpreted relative
to the innermost internal request. By default, it is interpreted
relative to the original (client) request.
-
fsize
-
Behaves like its NCSA counterpart, except that it also
recognizes the tag
here. If present, this tag
indicates to include the file size of the innermost included
file. Normally, it includes the file size of the topmost
SSI-parsed file requested by the client. It honors the
sizefmt variable, as set by
config.
-
flastmod
-
In addition to NCSA behavior, it honors the
here tag, which indicates to include the time
stamp of the innermost included file.
-
exec
-
It accepts only the
cmd tag. Given
that the include command can include
CgiResources, the cgi tag is superfluous.
If the SSIFrame secure attribute is set,
this command will be inoperative.
-
params
-
This command expands to an HTML unordered list of the
parameters that it was called with. Provided mainly for instructional
purposes.
-
count
-
Expands to the access count reported by the CounterFilter.
(This may or may not mean the access count of the document,
depending on the way the CounterFilter is set up)
author:
Antonio Ramirez |
