Metacat

/*

 * ClientFgdcHelper.java

 *

 * Created on June 25, 2007, 9:58 AM

 *

 * To change this template, choose Tools | Template Manager

 * and open the template in the editor.

 */

package edu.ucsb.nceas.metacat.clientview;

import com.oreilly.servlet.multipart.MultipartParser;

import edu.ucsb.nceas.metacat.client.MetacatException;

import edu.ucsb.nceas.utilities.XMLUtilities;

import java.io.BufferedReader;

import java.io.IOException;

import java.io.InputStream;

import java.io.Reader;

import java.io.StringReader;

import java.util.HashMap;

import java.util.Iterator;

import java.util.Properties;

import javax.xml.xpath.XPath;

import javax.xml.xpath.XPathConstants;

import javax.xml.xpath.XPathExpressionException;

import javax.xml.xpath.XPathFactory;

import org.w3c.dom.Document;

import org.w3c.dom.DocumentType;

import org.w3c.dom.Node;

import org.w3c.dom.NodeList;

/**

 *

 * @author barteau

 */

public abstract class ClientFgdcHelper {

    private static XPath                    xpath = XPathFactory.newInstance().newXPath();

    /**

     * Data Document ID location within an FGDC document.  XPath expression.

     */

    public static final String              FGDC_DATA_FILE_DOCID_XPATH = "/metadata/distinfo/stdorder/digform/digtopt/onlinopt/computer/networka/networkr";

    public static final String              PATH4ANCESTOR = FGDC_DATA_FILE_DOCID_XPATH + "[text()='%1$s']/ancestor::node()[name()='%2$s']";

    /**

     * Metadata Document ID location within an FGDC document.  XPath expression.

     */

    public static final String              FGDC_DOCID_XPATH = "/metadata/distinfo/resdesc";

    public static final String              XPATH_QUERY_TEMPLATE = FGDC_DOCID_XPATH + "[text()='%1$s']";

    /**

     * Identifies the FGDC DTD.

     */

    public static final String              FGDC_SYSTEM_ID = "http://www.fgdc.gov/metadata/fgdc-std-001-1998.dtd";

    /**

     * Handles a client's request to delete a document.

     * If its a data document, it removes the Doc Id from the FGDC metadata in the

     * Metacat database.  It determines what metadata Doc ID is including this Doc Id.

     * It then queries metacat for the parent FGDC document and removes the Doc Id from it, and

     * reloads the new version with a new revision number.

     * If its a metadata document, it deletes any related data documents, then it

     * deletes the metadata.  In either instance, it sets the server feedback in

     * the session ("updateFeedback").

     * @param request HttpServletRequest which contains docId parameter.

     */

    public static void clientDeleteRequest(ClientView clientViewBean, ClientViewHelper clientViewHelper) {

        String                      result = null, docId, subDocId, parentDocId, revisedDocId;

        NodeList                    nodeLst;

        final String                SUB_DOCS_PATH = FGDC_DATA_FILE_DOCID_XPATH + "/text()";

        Node                        node;

        Document                    resultSetDoc;

        docId = clientViewBean.getDocId();

        try {

            //*** First, determine what metadata file is including this file (if any).

            resultSetDoc = clientViewHelper.query(FGDC_DATA_FILE_DOCID_XPATH, docId, null);

            parentDocId = xpath.evaluate("/resultset/document/docid", resultSetDoc.getDocumentElement());

            if (parentDocId != null && !parentDocId.equals("")) {

                clientViewHelper.setMetadataDoc(parentDocId);

                //*** Remove Doc Id from any parent metadata document.

                revisedDocId = removeDataDocIdFromFGDC(docId, parentDocId, clientViewHelper);

                clientViewBean.setDocId(revisedDocId);

            } else {

                clientViewHelper.setMetadataDoc(docId);

                //*** This is a metadata document, so remove all of the sub-docId's.

                nodeLst = (NodeList) xpath.evaluate(SUB_DOCS_PATH, clientViewHelper.getMetadataDoc().getDocumentElement(), XPathConstants.NODESET);

                for(int i = 0; i < nodeLst.getLength(); i++) {

                    node = nodeLst.item(i);

                    subDocId = node.getNodeValue();

                    //*** Remove the sub-document.

                    try {

                        clientViewHelper.getMetacatClient().delete(subDocId);

                    } catch (MetacatException ex) {

                        ex.printStackTrace();

                    }

                }

            }

            //*** Remove the document.

            result = clientViewHelper.getMetacatClient().delete(docId);

            //*** Save the server feedback in the session, to be used by the view.

            clientViewBean.setMessage(ClientView.DELETE_MESSAGE, result);

        } catch (Exception ex) {

            ex.printStackTrace();

        }

    }

    private static String removeDataDocIdFromFGDC(String docId, String parentDocId, ClientViewHelper clientViewHelper) throws Exception {

        String                          pathToDigform, revision = "", xPathQuery;

        Document                        doc;

        InputStream                     response;

        BufferedReader                  buffy;

        Properties                      prop;

        Node                            node;

        NodeList                        nodeLst;

        Reader                          reader;

        //*** Get the metadata document and remove the digform branch.

        doc = clientViewHelper.getMetadataDoc();

        if (doc != null) {

            pathToDigform = String.format(PATH4ANCESTOR, docId, "digform");

            node = (Node) xpath.evaluate(pathToDigform, doc.getDocumentElement(), XPathConstants.NODE);

            node.getParentNode().removeChild(node);

            xPathQuery = String.format(XPATH_QUERY_TEMPLATE, docId);

            revision = clientViewHelper.nextVersion(parentDocId, xPathQuery);

            reader = XMLUtilities.getDOMTreeAsReader(doc.getDocumentElement(), false);

            clientViewHelper.getMetacatClient().update(revision, reader, null);

        }

        return(revision);

    }

    public static boolean handlePackageUpload(String metaDocId, HashMap dataDocIDs, String contactName, Document metadataDoc) throws IOException {

        boolean                         result = true;

        Node                            newBranch, metaRootNode;

        //*** Store the User Name and Doc Id in the FGDC document.

        newBranch = getFGDCdisinfo(contactName, metaDocId, dataDocIDs);

        System.out.println("ClientFgdcHelper.handlePackageUpload: " + XMLUtilities.getDOMTreeAsString(newBranch));

        metaRootNode = addDistInfoToFGDC(newBranch, metadataDoc);

        return(result);

    }

    public static boolean isFGDC(Document metadataDoc) {

        boolean                     result = false;

        DocumentType                docType;

        String                      sysId;

        final String                FGDC_TEST_EXPRESSION = "/metadata/idinfo/citation/citeinfo/title";

        Node                        node = null;

        //*** First, try the rigid proper way of determining it.

        if (metadataDoc != null) {

            docType = metadataDoc.getDoctype();

            if (docType != null) {

                sysId = docType.getSystemId();

                if (sysId != null)

                    result = sysId.contains(FGDC_SYSTEM_ID);

            }

        }

        //*** It might not have a doc type line, so try another method.

        if (metadataDoc != null && !result) {

            try {

                node = (Node) xpath.evaluate(FGDC_TEST_EXPRESSION, metadataDoc.getDocumentElement(), XPathConstants.NODE);

            } catch (XPathExpressionException ex) {

                ex.printStackTrace();

            }

            result = (node != null);

        }

        return(result);

    }

    private static Node getFGDCdisinfo(String contactName, String resourceDescription, HashMap dataDocIDs) throws IOException {

        Node                        result = null, node, digformBranch, formname, stdorder;

        Document                    doc;

        Iterator                    iterIt;

        String                      key, value;

        //*** This is a valid/minimal FGDC "distinfo" branch.

        final String XML = "<distinfo>"

                + "    <distrib>"

                + "        <cntinfo>"

                + "            <cntperp>"

                + "                <cntper></cntper>"

                + "            </cntperp>"

                + "            <cntaddr>"

                + "                <addrtype></addrtype>"

                + "                <address></address>"

                + "                <city></city>"

                + "                <state></state>"

                + "                <postal></postal>"

                + "                <country></country>"

                + "            </cntaddr>"

                + "            <cntvoice></cntvoice>"

                + "        </cntinfo>"

                + "    </distrib>"

                + "    <resdesc></resdesc>"

                + "    <distliab></distliab>"

                + "    <stdorder>"

                + "        <digform>"

                + "            <digtinfo>"

                + "                <formname></formname>"

                + "            </digtinfo>"

                + "            <digtopt>"

                + "                <onlinopt>"

                + "                    <computer>"

                + "                        <networka>"

                + "                            <networkr></networkr>"

                + "                        </networka>"

                + "                    </computer>"

                + "                </onlinopt>"

                + "            </digtopt>"

                + "        </digform>"

                + "        <fees></fees>"

                + "    </stdorder>"

                + "</distinfo>";

        doc = XMLUtilities.getXMLReaderAsDOMDocument(new StringReader(XML));

        result = doc.getDocumentElement();

        try {

            //*** Set the Contact Person.

            node = (Node) xpath.evaluate("/distinfo/distrib/cntinfo/cntperp/cntper", result, XPathConstants.NODE);

            node.setTextContent(contactName);

            //*** Set the metadata Doc Id.

            node = (Node) xpath.evaluate("/distinfo/resdesc", result, XPathConstants.NODE);

            node.setTextContent(resourceDescription);

            //*** Loop thru the files, setting their format and Doc Id.

            stdorder = (Node) xpath.evaluate("/distinfo/stdorder", result, XPathConstants.NODE);

            digformBranch = (Node) xpath.evaluate("/distinfo/stdorder/digform", result, XPathConstants.NODE);

            iterIt = dataDocIDs.keySet().iterator();

            while(iterIt.hasNext()) {

                //*** Save the data file Doc ID (required).

                key = (String) iterIt.next();

                node = (Node) xpath.evaluate("digtopt/onlinopt/computer/networka/networkr", digformBranch, XPathConstants.NODE);

                node.setTextContent(key);

                //*** Save the data file format (optional).

                formname = (Node) xpath.evaluate("digtinfo/formname", digformBranch, XPathConstants.NODE);

                if ((value = (String) dataDocIDs.get(key)) != null && !value.equals("")) {

                    formname.setTextContent(value);

                } else {

                    //*** We did a deep clone of the branch, so clear prior contents.

                    formname.setTextContent("");

                }

                //*** Clone branch for next file.

                if (iterIt.hasNext()) {

                    digformBranch = digformBranch.cloneNode(true);

                    stdorder.appendChild(digformBranch);

                }

            }

        } catch (XPathExpressionException ex) {

            ex.printStackTrace();

        }

        return(result);

    }

    private static Node addDistInfoToFGDC(Node newBranch, Document metadataDoc) {

        Node                        result = null, node;

        if (newBranch != null) {

            result = metadataDoc.getDocumentElement();

            try {

                //*** Get a reference to the FGDC required "metainfo" node (only 1 allowed).

                node = (Node) xpath.evaluate("/metadata/metainfo", result, XPathConstants.NODE);

                if (node != null) {

                    newBranch = metadataDoc.importNode(newBranch, true);

                    //*** Add the new "distinfo" before it.

                    result.insertBefore(newBranch, node);

                }

            } catch (XPathExpressionException ex) {

                ex.printStackTrace();

            }

        }

        return(result);

    }

}