org.apache.xmlrpc.applet
Class XmlRpcSupport

java.lang.Object
  |
  +--org.xml.sax.HandlerBase
        |
        +--org.apache.xmlrpc.applet.XmlRpcSupport
All Implemented Interfaces:
org.xml.sax.DocumentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

class XmlRpcSupport
extends org.xml.sax.HandlerBase


Inner Class Summary
(package private)  class XmlRpcSupport.Value
          This represents an XML-RPC Value while the request is being parsed.
(package private)  class XmlRpcSupport.XmlWriter
           
 
Field Summary
(package private) static int ARRAY
           
(package private) static int BASE64
           
(package private) static int BOOLEAN
           
(package private)  java.lang.StringBuffer cdata
           
(package private)  XmlRpcSupport.Value currentValue
           
(package private) static int DATE
           
static boolean debug
           
(package private) static int DOUBLE
           
(package private)  boolean fault
           
(package private) static java.text.DateFormat format
           
(package private) static int INTEGER
           
(package private)  java.lang.String methodName
           
(package private)  boolean readCdata
           
(package private)  java.lang.Object result
           
(package private) static int STRING
           
(package private) static int STRUCT
           
(package private) static java.lang.String[] types
           
(package private)  java.net.URL url
           
(package private)  java.util.Stack values
           
 
Constructor Summary
XmlRpcSupport(java.net.URL url)
           
 
Method Summary
 void characters(char[] ch, int start, int length)
          Method called by SAX driver.
 void endElement(java.lang.String name)
          Method called by SAX driver.
 void error(org.xml.sax.SAXParseException e)
          Receive notification of a recoverable parser error.
 java.lang.Object execute(java.lang.String method, java.util.Vector arguments)
          Generate an XML-RPC request and send it to the server.
 void fatalError(org.xml.sax.SAXParseException e)
          Report a fatal XML parsing error.
(package private)  void objectParsed(java.lang.Object what)
          Called when the return value has been parsed.
(package private)  void parse(java.io.InputStream is)
          Parse the input stream.
static void setDebug(boolean val)
          Switch debugging output on/off.
 void startElement(java.lang.String name, org.xml.sax.AttributeList atts)
          Method called by SAX driver.
(package private)  void writeObject(java.lang.Object what, XmlRpcSupport.XmlWriter writer)
          Writes the XML representation of a supported Java object to the XML writer.
(package private)  void writeRequest(XmlRpcSupport.XmlWriter writer, java.lang.String method, java.util.Vector params)
          Generate an XML-RPC request from a method name and a parameter vector.
 
Methods inherited from class org.xml.sax.HandlerBase
endDocument, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, startDocument, unparsedEntityDecl, warning
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, wait, wait, wait
 

Field Detail

url

java.net.URL url

methodName

java.lang.String methodName

fault

boolean fault

result

java.lang.Object result

values

java.util.Stack values

currentValue

XmlRpcSupport.Value currentValue

readCdata

boolean readCdata

format

static final java.text.DateFormat format

cdata

java.lang.StringBuffer cdata

STRING

static final int STRING

INTEGER

static final int INTEGER

BOOLEAN

static final int BOOLEAN

DOUBLE

static final int DOUBLE

DATE

static final int DATE

BASE64

static final int BASE64

STRUCT

static final int STRUCT

ARRAY

static final int ARRAY

debug

public static boolean debug

types

static final java.lang.String[] types
Constructor Detail

XmlRpcSupport

public XmlRpcSupport(java.net.URL url)
Method Detail

setDebug

public static void setDebug(boolean val)
Switch debugging output on/off.

parse

void parse(java.io.InputStream is)
     throws java.lang.Exception
Parse the input stream. For each root level object, method objectParsed is called.

writeObject

void writeObject(java.lang.Object what,
                 XmlRpcSupport.XmlWriter writer)
           throws java.io.IOException
Writes the XML representation of a supported Java object to the XML writer.

execute

public java.lang.Object execute(java.lang.String method,
                                java.util.Vector arguments)
                         throws XmlRpcException,
                                java.io.IOException
Generate an XML-RPC request and send it to the server. Parse the result and return the corresponding Java object.
Throws:
XmlRpcException: - If the remote host returned a fault message.
IOException: - If the call could not be made for lower level problems.

objectParsed

void objectParsed(java.lang.Object what)
Called when the return value has been parsed.

writeRequest

void writeRequest(XmlRpcSupport.XmlWriter writer,
                  java.lang.String method,
                  java.util.Vector params)
            throws java.io.IOException
Generate an XML-RPC request from a method name and a parameter vector.

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws org.xml.sax.SAXException
Method called by SAX driver.
Overrides:
characters in class org.xml.sax.HandlerBase
Following copied from class: org.xml.sax.HandlerBase
Parameters:
ch - The characters.
start - The start position in the character array.
length - The number of characters to use from the character array.
Throws:
org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.
See Also:
DocumentHandler.characters(char[], int, int)

endElement

public void endElement(java.lang.String name)
                throws org.xml.sax.SAXException
Method called by SAX driver.
Overrides:
endElement in class org.xml.sax.HandlerBase
Following copied from class: org.xml.sax.HandlerBase
Parameters:
name - The element type name.
attributes - The specified or defaulted attributes.
Throws:
org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.
See Also:
DocumentHandler.endElement(java.lang.String)

startElement

public void startElement(java.lang.String name,
                         org.xml.sax.AttributeList atts)
                  throws org.xml.sax.SAXException
Method called by SAX driver.
Overrides:
startElement in class org.xml.sax.HandlerBase
Following copied from class: org.xml.sax.HandlerBase
Parameters:
name - The element type name.
attributes - The specified or defaulted attributes.
Throws:
org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.
See Also:
DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)

error

public void error(org.xml.sax.SAXParseException e)
           throws org.xml.sax.SAXException
Description copied from class: org.xml.sax.HandlerBase
Receive notification of a recoverable parser error.

The default implementation does nothing. Application writers may override this method in a subclass to take specific actions for each error, such as inserting the message in a log file or printing it to the console.

Overrides:
error in class org.xml.sax.HandlerBase
Following copied from class: org.xml.sax.HandlerBase
Parameters:
e - The warning information encoded as an exception.
Throws:
org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.
See Also:
ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

fatalError

public void fatalError(org.xml.sax.SAXParseException e)
                throws org.xml.sax.SAXException
Description copied from class: org.xml.sax.HandlerBase
Report a fatal XML parsing error.

The default implementation throws a SAXParseException. Application writers may override this method in a subclass if they need to take specific actions for each fatal error (such as collecting all of the errors into a single report): in any case, the application must stop all regular processing when this method is invoked, since the document is no longer reliable, and the parser may no longer report parsing events.

Overrides:
fatalError in class org.xml.sax.HandlerBase
Following copied from class: org.xml.sax.HandlerBase
Parameters:
e - The error information encoded as an exception.
Throws:
org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.
See Also:
ErrorHandler.fatalError(org.xml.sax.SAXParseException), SAXParseException


Copyright © 1999-2002 Apache Software Foundation. All Rights Reserved.