org.xins.server.XMLCallingConvention Maven / Gradle / Ivy
/*
* $Id: XMLCallingConvention.java,v 1.48 2007/09/18 08:45:03 agoubard Exp $
*
* Copyright 2003-2007 Orange Nederland Breedband B.V.
* See the COPYRIGHT file for redistribution and use restrictions.
*/
package org.xins.server;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Iterator;
import java.util.List;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.xins.common.collections.BasicPropertyReader;
import org.xins.common.text.TextUtils;
import org.xins.common.xml.Element;
/**
* XML calling convention.
*
* @version $Revision: 1.48 $ $Date: 2007/09/18 08:45:03 $
* @author Anthony Goubard
*/
public class XMLCallingConvention extends CallingConvention {
/**
* The response encoding format.
*/
protected static final String RESPONSE_ENCODING = "UTF-8";
/**
* The content type of the HTTP response.
*/
protected static final String RESPONSE_CONTENT_TYPE = "text/xml; charset=" + RESPONSE_ENCODING;
protected String[] getSupportedMethods() {
return new String[] { "POST" };
}
/**
* Checks if the specified request can be handled by this calling
* convention.
*
* This method will not throw any exception.
*
* @param httpRequest
* the HTTP request to investigate, cannot be null.
*
* @return
* true if this calling convention is possibly
* able to handle this request, or false if it
* definitely not able to handle this request.
*
* @throws Exception
* if analysis of the request causes an exception;
* false will be assumed.
*/
protected boolean matches(HttpServletRequest httpRequest)
throws Exception {
// Parse the XML in the request (if any)
Element element = parseXMLRequest(httpRequest);
return element.getLocalName().equals("request") &&
element.getAttribute("function") != null;
}
/**
* Converts an HTTP request to a XINS request (implementation method). This
* method should only be called from class CallingConvention. Only
* then it is guaranteed that the httpRequest argument is not
* null.
*
* @param httpRequest
* the HTTP request, will not be null.
*
* @return
* the XINS request object, never null.
*
* @throws InvalidRequestException
* if the request is considerd to be invalid.
*
* @throws FunctionNotSpecifiedException
* if the request does not indicate the name of the function to execute.
*/
protected FunctionRequest convertRequestImpl(HttpServletRequest httpRequest)
throws InvalidRequestException,
FunctionNotSpecifiedException {
Element requestElem = parseXMLRequest(httpRequest);
String functionName = requestElem.getAttribute("function");
// Determine function parameters
BasicPropertyReader functionParams = new BasicPropertyReader();
Iterator parameters = requestElem.getChildElements("param").iterator();
while (parameters.hasNext()) {
Element nextParam = (Element) parameters.next();
String name = nextParam.getAttribute("name");
String value = nextParam.getText();
functionParams.set(name, value);
}
// Check if function is specified
if (TextUtils.isEmpty(functionName)) {
throw new FunctionNotSpecifiedException();
}
// Remove all invalid parameters
cleanUpParameters(functionParams);
// Get data section
Element dataElement = null;
List dataElementList = requestElem.getChildElements("data");
if (dataElementList.size() == 1) {
dataElement = (Element) dataElementList.get(0);
} else if (dataElementList.size() > 1) {
throw new InvalidRequestException("Found multiple data sections.");
}
return new FunctionRequest(functionName, functionParams, dataElement);
}
/**
* Converts a XINS result to an HTTP response (implementation method).
*
* @param xinsResult
* the XINS result object that should be converted to an HTTP response,
* will not be null.
*
* @param httpResponse
* the HTTP response object to configure, will not be null.
*
* @param httpRequest
* the HTTP request, will not be null.
*
* @throws IOException
* if calling any of the methods in httpResponse causes an
* I/O error.
*/
protected void convertResultImpl(FunctionResult xinsResult,
HttpServletResponse httpResponse,
HttpServletRequest httpRequest)
throws IOException {
// Send the XML output to the stream and flush
httpResponse.setContentType(RESPONSE_CONTENT_TYPE);
PrintWriter out = httpResponse.getWriter();
httpResponse.setStatus(HttpServletResponse.SC_OK);
CallResultOutputter.output(out, xinsResult);
out.close();
}
}