|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--project.XmlRpcClient
This class facilitates development of XML messaging clients which use HTTP(S) POSTing to synchronously exchange XML documents. This may be used directly, or be subclassed to add application-specific behaviours such as specialized processing for some element vocabularies found in those documents.
Constructor Summary | |
XmlRpcClient()
Constructs a client; its URL must be set later. |
|
XmlRpcClient(java.net.URL url)
Constructs a client, and sets its URL. |
Method Summary | |
com.sun.xml.tree.XmlDocument |
call(com.sun.xml.tree.XmlDocument request)
This method sends the HTTP/HTTPS POST request to the object identified by the URL passed to the constructor. |
protected void |
customizeDocument(com.sun.xml.tree.SimpleElementFactory factory,
boolean trustDocuments)
The request document that's built from the request can be customized, so that the generic DOM functionality can be augmented with behaviour specific to each element type. |
protected void |
customizeResolver(org.xml.sax.EntityResolver r)
Subclasses can provide a customized entity resolver to be used when resolving external entities such as DTDs. |
protected boolean |
getCheckTypes()
Returns true if all documents must be validated (the default), or false if the servers are trusted to provide correct data |
java.net.URL |
getUrl()
Returns the URL for which this client is a proxy. |
protected void |
setCheckTypes(boolean value)
This method is used to indicate whether servers are controlled well enough that the data they provide doesn't need the XML analogue of static type checking: validation. |
void |
setUrl(java.net.URL url)
Sets the URL for which this client is a proxy (stand-in); this is a write-once attribute; |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public XmlRpcClient()
public XmlRpcClient(java.net.URL url)
Method Detail |
public void setUrl(java.net.URL url)
url
- the URL to which requests will be sent.public java.net.URL getUrl()
public com.sun.xml.tree.XmlDocument call(com.sun.xml.tree.XmlDocument request) throws java.io.IOException
request
- the document sent to the object for processingprotected void setCheckTypes(boolean value)
protected boolean getCheckTypes()
protected void customizeDocument(com.sun.xml.tree.SimpleElementFactory factory, boolean trustDocuments)
factory
- used to acquire customized element nodestrustDocuments
- if true, the document can add its own
mappings from element names to Java element node classesprotected void customizeResolver(org.xml.sax.EntityResolver r)
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |