1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
/*
Wotonomy: OpenStep design patterns for pure Java applications.
Copyright (C) 2000 Intersect Software Corporation
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, see http://www.gnu.org
*/
package net.wotonomy.web.xml;
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import net.wotonomy.foundation.internal.WotonomyException;
import net.wotonomy.foundation.xml.XMLDecoder;
import org.xml.sax.SAXException;
/**
* An implementation of XMLDecoder that reads objects from
* XMLRPC format.
* This implementation is not thread-safe, so a new instances
* should be created to accomodate multiple threads.
*/
public class XMLRPCDecoder implements XMLDecoder
{
XMLRPCDecoderHelper helper = new XMLRPCDecoderHelper();
/**
* Decodes an object in XML-RPC format from the specified input stream.
* @param anInputStream The input stream from which to read.
* The stream will be read fully.
* @param aDescription A description to accompany error messages
* for the stream, typically a file name.
* @param aURL A URL against which relative references within the
* XML will be resolved.
* @return The object that was constructed from the XML content,
* or null if no object could be constructed.
*/
public Object decode(
InputStream anInputStream, String aDescription, URL aURL )
{
Object result = null;
try {
SAXParser sparser = SAXParserFactory.newInstance().newSAXParser();
sparser.parse(anInputStream,helper,aURL.toExternalForm());
result = helper.getResult();
} catch (ParserConfigurationException e) {
throw new WotonomyException("Problem in parser configuration", e );
} catch (IOException e) {
throw new WotonomyException("IOException thrown while parsing", e );
} catch (SAXException e) {
throw new WotonomyException("SAXException thrown while parsing", e );
}
helper.reset();
return result;
}
/**
* Decodes an XML-RPC message from the specified input stream.
* Stand-alone values not wrapped in "methodCall" or "param"
* tags will be treated as a response.
* @param anInputStream The input stream from which to read.
* The stream will be read fully.
* @param aReceiver an XMLRPCReceiver that will be invoked with
* the appropriate method: request, response, or fault.
*/
public void decode(
InputStream anInputStream, XMLRPCReceiver aReceiver )
{
try
{
SAXParser sparser = SAXParserFactory.newInstance().newSAXParser();
sparser.parse(anInputStream,helper);
if ( helper.isRequest() )
{
aReceiver.request( helper.getMethodName(), helper.getParameters() );
}
else
if ( helper.isFault() )
{
aReceiver.fault( helper.getFaultCode(), helper.getFaultString() );
}
else // all else is considered a response
{
aReceiver.response( helper.getResult() );
}
} catch (ParserConfigurationException e) {
throw new WotonomyException("Problem in parser configuration", e );
} catch (IOException e) {
throw new WotonomyException("IOException thrown while parsing", e );
} catch (SAXException e) {
throw new WotonomyException("SAXException thrown while parsing", e );
}
helper.reset();
}
}
|
