com.netspective.commons.lang.ClassJavaDoc.java Source code

Introduction

Here is the source code for com.netspective.commons.lang.ClassJavaDoc.java

Source

/*
 * Copyright (c) 2000-2004 Netspective Communications LLC. All rights reserved.
 *
 * Netspective Communications LLC ("Netspective") permits redistribution, modification and use of this file in source
 * and binary form ("The Software") under the Netspective Source License ("NSL" or "The License"). The following
 * conditions are provided as a summary of the NSL but the NSL remains the canonical license and must be accepted
 * before using The Software. Any use of The Software indicates agreement with the NSL.
 *
 * 1. Each copy or derived work of The Software must preserve the copyright notice and this notice unmodified.
 *
 * 2. Redistribution of The Software is allowed in object code form only (as Java .class files or a .jar file
 *    containing the .class files) and only as part of an application that uses The Software as part of its primary
 *    functionality. No distribution of the package is allowed as part of a software development kit, other library,
 *    or development tool without written consent of Netspective. Any modified form of The Software is bound by these
 *    same restrictions.
 *
 * 3. Redistributions of The Software in any form must include an unmodified copy of The License, normally in a plain
 *    ASCII text file unless otherwise agreed to, in writing, by Netspective.
 *
 * 4. The names "Netspective", "Axiom", "Commons", "Junxion", and "Sparx" are trademarks of Netspective and may not be
 *    used to endorse or appear in products derived from The Software without written consent of Netspective.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT A WARRANTY OF ANY KIND. ALL EXPRESS OR IMPLIED REPRESENTATIONS AND
 * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
 * ARE HEREBY DISCLAIMED.
 *
 * NETSPECTIVE AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY THIRD PARTY AS A
 * RESULT OF USING OR DISTRIBUTING THE SOFTWARE. IN NO EVENT WILL NETSPECTIVE OR ITS LICENSORS BE LIABLE FOR ANY LOST
 * REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
 * CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN
 * IF IT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 */
package com.netspective.commons.lang;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.xpath.XPathAPI;
import org.w3c.dom.Document;
import org.w3c.dom.Node;

public class ClassJavaDoc extends JavaDoc {
    private static final Log log = LogFactory.getLog(ClassJavaDoc.class);
    private Document xmlDocument;
    private Map methodJavaDocsByMethodName = new HashMap();

    public ClassJavaDoc(Class owner) {
        setOwner(owner);
    }

    public Document getXmlDocument() {
        return xmlDocument;
    }

    protected void setOwner(Class owner) {
        super.setOwner(owner);
        setName(owner.getName());
        try {
            setXmlDocument(JavaDocs.getInstance().getXmlDocForClass(getOwner()));
        } catch (IOException e) {
            log.error("Unable to retrievel XML document for class " + owner.getName(), e);
            setRetrievalError(e);
        }
    }

    protected void setXmlDocument(Document xmlDocument) {
        this.xmlDocument = xmlDocument;
        if (xmlDocument == null) {
            setFound(false);
            return;
        }

        try {
            Node descrLeadNode = XPathAPI.selectSingleNode(xmlDocument.getDocumentElement(), "/*/description/lead");
            Node descrDetailNode = XPathAPI.selectSingleNode(xmlDocument.getDocumentElement(),
                    "/*/description/detail");

            if (descrLeadNode != null)
                setDescriptionLead(descrLeadNode.getFirstChild().getNodeValue());

            if (descrDetailNode != null)
                setDescriptionDetail(descrDetailNode.getFirstChild().getNodeValue());
        } catch (Exception e) {
            log.error("Error retrieving description for class " + getOwner(), e);
            setRetrievalError(e);
        }
    }

    public MethodJavaDoc getMethodDoc(String methodName) {
        MethodJavaDoc result = (MethodJavaDoc) methodJavaDocsByMethodName.get(methodName);
        if (result == null) {
            result = new MethodJavaDoc(this, methodName);
            methodJavaDocsByMethodName.put(methodName, result);
        }
        return result;
    }
}