Neokernel API

XMLRequestAgent Members

XMLRequestAgent overview

Public Static Methods

savePropsToXMLFile Saves an ArrayList of Props to a XML file.
writeAutoIndent Adds the appropriate number of tabs to the request output as kept in the request's auto_indent_level prop.
writeElement Writes the specified start tag, element value, and end tag to the request output.
writeEmptyElementOverloaded. Writes the specified empty element tag to the request output, inserting the Props as attributes within the tag.
writeEndTag Writes the specified close tag to the request output.
writeProps Writes XML elements for the specified Props using the keys as tag names and the values as element content for each key.
writeStartTagOverloaded. Writes the specified start tag to the request output.
writeXMLHeader Writes the <?xml version="1.0"?> identifier, suitable for the declaration of XML 1.0 format compatibility.

Protected Static Fields

EOL

Public Instance Properties

AgentController (inherited from Agent) Assigns or returns an AgentController for this agent.
Keys (inherited from Props) Returns a Vector containing the names of property keys currently accessible by getProperty.
Props (inherited from Agent) Sets or gets the Props of this agent.
PropsContainer (inherited from Props) The IPropsContainer used to access and store properties for this object.
StateMachineModel (inherited from Agent) Called by AgentController to retrieve a reference to this agent's state machine model.

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.
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 (inherited from RequestAgent)
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 (inherited from Agent) Override this method to initialize this agent's Props before it is started.
insertProps (inherited from Props) Inserts property String values into the passed string where property names are surrounded by angle brackets.
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".
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 (inherited from ServiceAgent) Registers this instance with the ServiceManager using the service_name prop.
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 Constructors

XMLRequestAgent Constructor Initializes a new instance of the XMLRequestAgent class.

Protected Instance Fields

agent_id (inherited from Agent) This is where the agent_id is cached for use by the toString method.
agentControllerObj (inherited from Agent) This is a reference to the AgentController assigned to this agent.
debugReporter (inherited from Agent) This is a reference to the Reporter assigned to this agent for debug output. If this field is null (Nothing in Visual Basic) the debug method will be ignored.
errorReporter (inherited from Agent) This is a reference to the Reporter assigned to this agent for error output. If this field is null, (Nothing in Visual Basic), the error methods will be ignored.
printlnReporter (inherited from Agent) This is a reference to the Reporter assigned to this agent for println output. If this field is null (Nothing in Visual Basic) the println method will be ignored.
warningReporter (inherited from Agent) This is a reference to the Reporter assigned to this agent for warning output. If this field is null (Nothing in Visual Basic) the warning methods will be ignored.

Protected Instance Methods

Finalize (inherited from Object) 
getNextKey (inherited from Props)
getResponseProps This method is used to create a Props from XML documents created by the writeProps() method.
loadPropsFromXMLFile
MemberwiseClone (inherited from Object) 
sendAgentRequest Calls the specified RequestAgent with the specified request Props. Results returned by the RequestAgent as XML are parsed and returned as Props.

See Also

XMLRequestAgent Class | com.neokernel.xml Namespace