Generated: Mon, 27 Jul 2020 18:57:17 EDT
class Standard . URLfileLoader {oid accessChecker;set defaultFileNames;set directoryRoots;string logicalRoot;any objectClass;oid urlDir;} inherits from Object;
The class URLfileLoader is the default handler for many HTTP server requests. Its role is to load files located on the local file system (e.g, HTML, GIF, JPEG, etc.) that were referenced by HTTP requests.
URLfileLoader:create(oid urlDirectory, string objClass, string root, oid checker, optional any dirRoots)
See initialize.
URLfileLoader:initialize(oid urlDirectory, any objClass, string root, oid checker, any dirRoots)
The initialize method takes three mandatory arguments. The urlDirectory argument specifies the URLdirectory object for the site. The objClass argument specifies the class to be used when creating any cached objects; normally, this is HTTPcachedFile. The root parameter specifies the logical root of the document tree for which the URLfileLoader object will be responsible. If the section of the tree is to be protected from access, the object Id of an URLprotectedFile object is provided as the checker argument; otherwise is is specified as nil. All remaining arguments specified directories in the locally accessible filesystems that should be searched for files.
The URLfileLoader object registers itself as a directory handler by sending the URLdirectory object a registerDirectoryHandler message.
URLfileLoader:handlerReplaced(string path)
If a new handler is registered for the path associated with an existing URLfileLoader object, the URLdirectory object sends a handlerReplaced message to the previously registered URLfileLoader handler object.
URLfileLoader:getAccessController()
This method returns the object Id of the URLprotectedFile object that validates access to section of the document tree for which the URLfileLoader object is responsible.
URLfileLoader:getDirectoryRoots()
Returns the set of top-level directories that will be searched for files.
URLfileLoader:getDefaultFiles()
Returns the set of file names that will be searched when a URL refers to a directory. The default names are Default.htm and index.html, but alternate names can be specified using the setDefaultFiles method.
URLfileLoader:setDefaultFiles(string file1, string file2, string file3)
Replaces the set of file names that will be searched when a URL refers to a directory with the list of names that are passed as arguments. Order is significant: each argument has precedence over subsequent arguments.
URLfileLoader:loadFile(array uriInfo, assoc substVars, any requestOp)
The loadFile method is the means by which a document is located and cached using an HTTPcachedFile (or allomorphic equivalent) object. The first argument, uriInfo is a parsed URI, which is typically obtained from a URI string using the parseHTTPuriData() function. The second argument, substVars is an associative array of environment variables that can be used by a newly created object. As an example, HTML pages with server-side-include directives can be automatically processed by a HTTP_SSIprocessor object and the substVars argument holds the initial environment.
The third argument, requestOp indicates the HTTP method associated with the retrieval. If not present, it is assumed to be "GET".
Note: the newly created object is not registered with the URLdirectory object; if desired, this must be done later using the registerObject method.
If the requested file cannot be loaded, nil is returned; otherwise an array describing the cached result is returned. Subscript 0 holds the object Id of the HTTPcachedObject (or equivalent). Subscript 1 holds a set of names that refer to the cached document; these names normally should be registered with the URLdirectory representing the logical site.