package at.gv.egovernment.moa.spss.server.invoke;

import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

import at.gv.egovernment.moa.util.XPathException;
import at.gv.egovernment.moa.util.XPathUtils;

import at.gv.egovernment.moa.spss.MOAApplicationException;
import at.gv.egovernment.moa.spss.api.common.ElementSelector;

/**
 * Utility methods for invoking the IAIK MOA modules.
 * 
 * @author Patrick Peck
 * @version $Id$
 */
public class InvokerUtils {

  /**
   * Select the signature parent element.
   * 
   * @param root The root DOM element which contains the signature parent
   * element somewhere in its subtree.
   * @param location The <code>ElementSelector</code> containing the XPath 
   * expression to select the signature parent element from the document. 
   * It is also contains the namespace prefix to URI mapping.
   * @return Element The signature parent element.
   * @throws MOAApplicationException An error occurred evaluating the
   * <code>location</code>.
   */
  public static Element evaluateSignatureLocation(
    Element root,
    ElementSelector location)
    throws MOAApplicationException {

    NodeList nodes;

    try {
      nodes =
        XPathUtils.selectNodeList(
          root,
          location.getNamespaceDeclarations(),
          location.getXPathExpression());
    } catch (XPathException e) {
      throw new MOAApplicationException(
        "2212",
        new Object[] { location.getXPathExpression()},
        e);
    }

    if (nodes.getLength() != 1
      || !(nodes.item(0).getNodeType() == Node.ELEMENT_NODE)) {
      throw new MOAApplicationException(
        "2212",
        new Object[] { location.getXPathExpression()});
    }
    return (Element) nodes.item(0);
  }


}