Neokernel API

HTTPAuthenticationAgent Methods

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

Public Static Methods

getUsernamePass in the Props of an HTTPAgentRequest, get the username that was used to HTTP authenticate this request. null if no username was used to authenticate. NOTE: This method does not check if the username/password is actually valid for the given path.

Public Instance Methods

addListener (inherited from Props) Adds an IPropsChangeListener to the list of listeners for this object.
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.
authenticate Authenticates HTTP request.
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.
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 This method is used only when the client is not authorized.
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. The WebServer's authentication_agent prop must be set to match this agent's service_name, or requests for urls requiring authentication will not be handed off to this agent. The default value is http_authentication.agent.
authentication_files
The file(s) used for authenticating requests. The default value is ./http.authentication. Separate multiple files with commas.
insertProps (inherited from Props) Inserts property String values into the passed string where property names are surrounded by angle brackets.
isAuthenticated Tests to see if path is Authenticated.
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.
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".
readAuthenticationFile Reads Authentication file, stores file in buffer, and prints Head Node of Authentication hash table.
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.
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
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)
MemberwiseClone (inherited from Object) 

See Also

HTTPAuthenticationAgent Class | com.neokernel.httpd Namespace