The HTTPcachedFile class implements the standard means for
retrieving and caching a file that is to be provided via a URLdirectory.
Server-Side-Include processing will be automatically performed using a
HTTP_SSIprocessor object. When raw data needs to be guaranteed,
a HTTPrawCachedFile object can be used.
The initialize method takes a minimum of 4 arguments.
the object Id of the URLdirectory object associated with the
an array representing the parsed URI (typically obtained from the
an associative array of environment variables, typically used for
an associative array of file status information (typically obtained
by the getFileInfo() function).
The fifth and any additional arguments are strings. Each represents
a name under which the cached object will be registered with the
URLdirectory by some external entity.
A HTTPcachedFile object does not actually register itself with the
URLdirectory. This must be performed by the application that creates
the HTTPcachedFile object. This provides the opportunity to control
when a cached object becomes visible. The names are recorded so that when
the HTTPcachedFile object is deleted, the appropriate entries
can be unregistered with the URLdirectory.