Neokernel API

HTTPFileServerAgent Methods

The methods of the HTTPFileServerAgent class are listed below. For a complete list of HTTPFileServerAgent class members, see the HTTPFileServerAgent Members topic.

Public Instance Methods

addListener (inherited from Props) Adds an IPropsChangeListener to the list of listeners for this object.
addVirtualDirectoryThis method adds a physical directory/virtual path mapping. If the mapping exists, or the virtual path already exists as a physical one, false will be returned.
append (inherited from Props) If the specified object is a String, it is the specified String is appended to it. Otherwise the call is ignored.
copy (inherited from Props) Copies the value of the property with the same name as key from srcProps into the IPropsContainer for this object.
copyFrom (inherited from Props)Copies the contents of the specified Props into this one.
copyTo (inherited from Props) Copies the contents of this Props into the one specified.
currentStateEquals (inherited from Agent) Returns true if the specified state is the current state.
debug (inherited from Agent) Prints a debug message tagged with this agent's identity to the output stream.
decrementInteger (inherited from Props)Decrements the integer value of the specified key by 1.
destroy (inherited from Agent) Override this method to perform special cleanup before an agent is destroyed.
dump (inherited from Props) Dumps a list of properties and their values to System.out.
dumpToString (inherited from Props) This returns the name/value pairs in a human-readable string.
enableListeners (inherited from Props)
enumerateKeys (inherited from Props) Returns an Enumeration of keys representing properties contained by this object's IPropsContainer.
Equals (inherited from Object) 
error (inherited from Agent)Overloaded. Prints an error message tagged with this agent's identity to the error stream.
format (inherited from Props) Uses the specified MessageFormat pattern this method generates a string containing the inserted values from the corresponding properties. The pattern string is passed to java.text.MessageFormat.format() after substituting appropriate argument indexes for property names.
generateDirectoryList Generates a directory Listing. Takes File and String path as input.
getBoolean (inherited from Props) Returns the boolean value of the requested property
getByteArray (inherited from Props) Returns specified object as a byte array. If the object is a String its getBytes methods is called to obtain a byte array. Otherwise, the object's String value is used to obtain a byte array.
getCharacter (inherited from Props) Returns the char value of the requested property
getDouble (inherited from Props) Returns the double value of the requested property
getFloat (inherited from Props) Returns the float value of the requested property
GetHashCode (inherited from Object) 
getHexString (inherited from Props) Returns the specified object as a String of hexadecimal bytes.
getInteger (inherited from Props) Returns the int value of the requested property
getLong (inherited from Props) Returns the long value of the requested property
getProperty (inherited from Props) Returns the property with the same name as the key parameter if available. If the requested property does not exist, null is returned instead.
getServiceImpl (inherited from Agent) Returns a reference to the requested Service from the ServiceManager or null (Nothing in Visual Basic) if the requested service does not exist, or the ServiceManager has not been loaded.
getSize (inherited from Props)Returns the size of the specified object. If the object is a Vector, the number of elements it contains is returned. If the object is a String, its length is returned. For other objects the length of the object's string value is returned. If the object does not exist, zero is returned.
getString (inherited from Props) Returns the String value of the requested property
getTokens (inherited from Props)Overloaded. Returns a Vector of Strings representing the tokens stored stored in the specified property separated by a comma, semi-colon, carriage return, or line-feed.
getTrimmedString (inherited from Props)Returns the specified object as a trimmed String.
GetType (inherited from Object) 
getVector (inherited from Props) Returns the specified object as a Vector. If the specified object is not a Vector, it is placed in a Vector and returned. if the object does not exist, an empty Vector is returned.
handleRequest Writes the http response header and returns the requested file if one exists. If the file is ends with .aspx, the ASP.net runtime is used to execute the file and the ASP.net output is returned.
hasProperty (inherited from Props) Tests the existence of the specified property.
incrementInteger (inherited from Props)Increments the integer value of the specified key by 1.
initProps Provides default values for the following props if they haven't been set previously:
service_name
The name this agent uses to register with Service Manager. If virtual_hosts is enabled in the WebServer, this name specifies the domain that this agent will handle requests for, for instance localhost/ or www.myserver.com/.
HTTPFileServerAgent
html_directory
The path to the directory where HTML files are served from.
./
default_index
The default files (separated by commas) served when no filename is specified in the HTTP request.
index.html
allow_directory_lists
If this is set to true, this agent will display links to all files in a directory when a web request specifies a directory instead of a file.
false
dont_index_list
This is the list of files that shouldn't appear in directory index listings, can use '*' to denote a wildcard. This property is not used if the allow_directory_lists property is set to false.
Not set by default
alpha_sort_index
If set to true, directory lists will be sorted in alphanumerical order.
true
aspnet_config_file
The path to an XML file containing ASP.NET configuration and debugging information. Defaults to web.config.
web.config
file_buffer_size
The size of the buffer to read and write static files to the Socket connected to the client.
5120
virtual_directories_config
The config file that defines virtual directories. This is a text file with alternating lines of physdir:[physical path] and virtpath:[virtual path], where the [physical path] can be a fully qualified pathname to an existing physical directory or a relative path and the [virtual path] is a URI path starting with the / character that is to be mapped to the physical directory. The virtpath: MUST follow a physdir:.
virtdirs
restricted_directories
A set of directory names that will be denied access if they appear in the URI path. They are separated by commas and must not include any / path separators.
bin, obj, app_browsers, app_code, app_data, app_localresources, app_globalresources, app_webreferences
restricted_access_404
If this property is set to true, attempted accesses to restricted directories will return a 404 Not Found instead of the default 403 Forbidden. Set this to true if you want the added protection of less information disclosure of making access to a restricted directory appear as if the directory isn't there at all.
false
insertProps (inherited from Props) Inserts property String values into the passed string where property names are surrounded by angle brackets.
isKeepAlive Checks if the request given asks for a keep-alive
notifyPropsChanged (inherited from Props) Can be called externally to manually send props changes messages to all registered IPropsChangeListeners.
notifyPropsChangedIgnore (inherited from Props)Overloaded. Can be called externally to manually send props changes messages to all registered IPropsChangeListeners, except the one passed. Passing a null IPropsChangeLister will result in the notification of all registered listeners; the same as notifyPropsChanged.
preloadPageOverloaded. Preload's an ASP.NET runtime so that the first access doesn't require the time to load and compile the aspx file.
println (inherited from Agent) Prints a message tagged with this agent's identity to the output stream. Can be disabled by setting hide_println prop to "true".
register (inherited from Agent) Registers this instance with the service manager using the service_name prop.
registerService (inherited from Agent) Registers the specified object with the service manager using the specified prop.
removeAll (inherited from Props) Removes all properties referenced by this class.
removeListener (inherited from Props) Removes an IPropsChangeListener from the list of listeners for this object.
removeProperty (inherited from Props) Removes the property with the same name as the key parameter if available. If the requested property does not exist, false is returned.
removeVirtualDirectoryThis method removes a physical directory/virtual path mapping. If the mapping doesn't exist, nothing will happen.
resumeNotify (inherited from Props)Resumes the automatic notification of IPropsChangeListeners. Calling this method will immediately call the propsChanged method of its IPropsChangeListeners passing an array of property names which have changed since suspendNotify was called.
setBoolean (inherited from Props) Sets the property key to a Boolean of the passed value.
setCharacter (inherited from Props) Sets the property key to a Character of the passed value.
setDefault (inherited from Props)If there is no value for the specified object, it is set to the value specified as default.
setDouble (inherited from Props) Sets the property key to a Double of the passed value.
setFloat (inherited from Props) Sets the property key to a Float of the passed value.
setInteger (inherited from Props) Sets the property key to a Integer of the passed value.
setLong (inherited from Props) Sets the property key to a Long of the passed value.
setProperty (inherited from Props)Overloaded. Sets the property key to the passed value.
start Registers Server and sets up directories, url's, etc.
stop (inherited from ServiceAgent) Unregisters this instance with the service manager using the service_name prop.
suspendNotify (inherited from Props)Suspends the automatic notification of IPropsChangeListeners. This is useful for when several property changes need to be made without calling the propsChanged method of the IPropsChangeListeners for each one. After this method is called, property changes are queued until the resumeNotify method is called. Each successive call to this method must be matched with a call to resumeNotify in order for notification to work correctly.
ToString (inherited from Agent) Returns the string representation of this agent using the format <agent_id>_<name> taken from this agent's Props the first time this method is called, and cached for future calls. This format follows the standard naming conventions for agent Props files and allows the agent's output to be formatted in a manner consistent with these files.
unregister (inherited from Agent) Unregisters this service implementation instance with the service manager using the service_name prop.
unregisterService (inherited from Agent) Unregisters the service implementation instance with the service manager using the specified prop.
warning (inherited from Agent)Overloaded. Prints a warning message tagged with this agent's identity to the error stream.

Protected Instance Methods

Finalize (inherited from Object) 
getNextKey (inherited from Props)
isRestrictedDirectoryThis method returns true if the URI path is attempting to access something in a restricted directory, as specified in the restricted_directories property.
loadVirtualDirectoriesThis method loads the physical directory/virtual path mappings file denoted by the virtual_directories_config property.
MemberwiseClone (inherited from Object) 
printRedirect Prints redirect information for a site to HTML output. Takes AgentRequest and String path as input.

See Also

HTTPFileServerAgent Class | com.neokernel.httpd Namespace