DefaultCommandRegistry

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.

The following summary of the commands only discuss differences from the NCSA directive set. 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 SSIResource.

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 SSIResource 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)