org.apache.xmlrpc.parser.XmlRpcResponseParser Maven / Gradle / Ivy
Go to download
Apache XML-RPC is a Java implementation of XML-RPC, a popular protocol
that uses XML over HTTP to implement remote procedure calls.
Compared to SOAP, or JAX-RPC, it is stable, much simpler and easier to
handle. Version 3 of Apache XML-RPC introduces several
important vendor extensions over the original XML-RPC specification.
The newest version!
/*
* Copyright 1999,2005 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.xmlrpc.parser;
import java.util.Map;
import javax.xml.namespace.QName;
import org.apache.ws.commons.util.NamespaceContextImpl;
import org.apache.xmlrpc.common.TypeFactory;
import org.apache.xmlrpc.common.XmlRpcStreamRequestConfig;
import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import org.xml.sax.SAXParseException;
/** A SAX parser for an {@link org.apache.xmlrpc.server.XmlRpcServer}'s
* response.
*/
public class XmlRpcResponseParser extends RecursiveTypeParserImpl {
private int level;
private boolean isSuccess;
private int errorCode;
private String errorMessage;
/** Creates a new instance.
* @param pConfig The response configuration.
* @param pTypeFactory The type factory for creating instances of
* {@link TypeParser}.
*/
public XmlRpcResponseParser(XmlRpcStreamRequestConfig pConfig,
TypeFactory pTypeFactory) {
super(pConfig, new NamespaceContextImpl(), pTypeFactory);
}
protected void addResult(Object pResult) throws SAXException {
if (isSuccess) {
super.setResult(pResult);
} else {
Map map = (Map) pResult;
Integer faultCode = (Integer) map.get("faultCode");
if (faultCode == null) {
throw new SAXParseException("Missing faultCode", getDocumentLocator());
}
try {
errorCode = faultCode.intValue();
} catch (NumberFormatException e) {
throw new SAXParseException("Invalid faultCode: " + faultCode,
getDocumentLocator());
}
errorMessage = (String) map.get("faultString");
}
}
public void startDocument() throws SAXException {
super.startDocument();
level = 0;
}
public void startElement(String pURI, String pLocalName, String pQName,
Attributes pAttrs) throws SAXException {
switch (level++) {
case 0:
if (!"".equals(pURI) || !"methodResponse".equals(pLocalName)) {
throw new SAXParseException("Expected methodResponse element, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
break;
case 1:
if ("".equals(pURI) && "params".equals(pLocalName)) {
isSuccess = true;
} else if ("".equals(pURI) && "fault".equals(pLocalName)) {
isSuccess = false;
} else {
throw new SAXParseException("Expected params or fault element, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
break;
case 2:
if (isSuccess) {
if (!"".equals(pURI) || !"param".equals(pLocalName)) {
throw new SAXParseException("Expected param element, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
} else {
if ("".equals(pURI) && "value".equals(pLocalName)) {
startValueTag();
} else {
throw new SAXParseException("Expected value element, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
}
break;
case 3:
if (isSuccess) {
if ("".equals(pURI) && "value".equals(pLocalName)) {
startValueTag();
} else {
throw new SAXParseException("Expected value element, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
} else {
super.startElement(pURI, pLocalName, pQName, pAttrs);
}
break;
default:
super.startElement(pURI, pLocalName, pQName, pAttrs);
break;
}
}
public void endElement(String pURI, String pLocalName, String pQName) throws SAXException {
switch (--level) {
case 0:
if (!"".equals(pURI) || !"methodResponse".equals(pLocalName)) {
throw new SAXParseException("Expected /methodResponse element, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
break;
case 1:
{
String tag;
if (isSuccess) {
tag = "params";
} else {
tag = "fault";
}
if (!"".equals(pURI) || !tag.equals(pLocalName)) {
throw new SAXParseException("Expected /" + tag + " element, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
break;
}
case 2:
if (isSuccess) {
if (!"".equals(pURI) || !"param".equals(pLocalName)) {
throw new SAXParseException("Expected /param, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
} else {
if ("".equals(pURI) && "value".equals(pLocalName)) {
endValueTag();
} else {
throw new SAXParseException("Expected /value, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
}
break;
case 3:
if (isSuccess) {
if ("".equals(pURI) && "value".equals(pLocalName)) {
endValueTag();
} else {
throw new SAXParseException("Expected /value, got "
+ new QName(pURI, pLocalName),
getDocumentLocator());
}
} else {
super.endElement(pURI, pLocalName, pQName);
}
break;
default:
super.endElement(pURI, pLocalName, pQName);
break;
}
}
/** Returns whether the response returned success. If so, the
* result object may be fetched using {@link #getResult()}.
* Otherwise, you may use the methods
* {@link #getErrorCode()} and {@link #getErrorMessage()} to
* check for error reasons.
* @return True, if the response indicated success, false otherwise.
*/
public boolean isSuccess() { return isSuccess; }
/** If the response contained a fault, returns the error code.
* @return The numeric error code.
*/
public int getErrorCode() { return errorCode; }
/** If the response contained a fault, returns the error message.
* @return The error message.
*/
public String getErrorMessage() { return errorMessage; }
}