src/org/apache/xml/dtm/ref/TestDTM.java

/*
 * The Apache Software License, Version 1.1
 *
 *
 * Copyright (c) 1999 The Apache Software Foundation.  All rights 
 * reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer. 
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The end-user documentation included with the redistribution,
 *    if any, must include the following acknowledgment:  
 *       "This product includes software developed by the
 *        Apache Software Foundation (http://www.apache.org/)."
 *    Alternately, this acknowledgment may appear in the software itself,
 *    if and wherever such third-party acknowledgments normally appear.
 *
 * 4. The names "Xalan" and "Apache Software Foundation" must
 *    not be used to endorse or promote products derived from this
 *    software without prior written permission. For written 
 *    permission, please contact apache@apache.org.
 *
 * 5. Products derived from this software may not be called "Apache",
 *    nor may "Apache" appear in their name, without prior written
 *    permission of the Apache Software Foundation.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of the Apache Software Foundation and was
 * originally based on software copyright (c) 1999, Lotus
 * Development Corporation., http://www.lotus.com.  For more
 * information on the Apache Software Foundation, please see
 * <http://www.apache.org/>.
 */
package org.apache.xml.dtm.ref;

import javax.xml.transform.Source;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.sax.SAXSource;
import javax.xml.transform.stream.StreamSource;
import org.apache.xml.dtm.DTM;
import org.apache.xml.dtm.DTMManager;


/**
 * Unit test for DTMManager/DTM
 *
 * Loads an XML document from a file (or, if no filename is supplied,
 * an internal string), then dumps its contents. Replaces the old
 * version, which was specific to the ultra-compressed implementation.
 * (Which, by the way, we probably ought to revisit as part of our ongoing
 * speed/size performance evaluation.)
 *
 * %REVIEW% Extend to test DOM2DTM, incremental, DOM view of the DTM, 
 * whitespace-filtered, indexed/nonindexed, ...
 * */
public class TestDTM {

  public static void main(String argv[])
  {
    try
    {
      // Pick our input source
      Source source=null;
      if(argv.length<1)
      {
	String defaultSource=
	  "<?xml version=\"1.0\"?>\n"+
	  "  <dummyDocument>\n"+
	  "   <A>\n"+
	  "    <B hat=\"new\" car=\"Honda\" dog=\"Boxer\">Life is good</B>\n"+
	  "   </A>\n"+
	  "   <C>My Anaconda<D/>Words</C>\n"+
	  "  To test with a more interesting docuent, provide the URI on the command line!\n"+
	  "  </dummyDocument>\n";
	source=new StreamSource(new java.io.StringReader(defaultSource));
      }
      else if (argv.length>1 &&  "X".equalsIgnoreCase(argv[1]))
      {
	// XNI stream startup goes here
	// Remember to perform Schema validation, to obtain PSVI annotations

      }
      else
      {
	// Read from a URI via whatever mechanism the DTMManager prefers
	source=new StreamSource(argv[0]);
      }
	

      // Get a DTM manager, and ask it to load the DTM "uniquely",
      // with no whitespace filtering, nonincremental, but _with_
      // indexing (a fairly common case, and avoids the special
      // mode used for RTF DTMs).
      DTMManager manager=
	new org.apache.xml.dtm.ref.DTMManagerDefault().newInstance
	  (new org.apache.xpath.objects.XMLStringFactoryImpl());
      DTM dtm=manager.getDTM(source, true, null, false, true);
      
      // Get the root node. NOTE THE ASSUMPTION that this is a single-document
      // DTM -- which will always be true for a node obtained this way, but
      // won't be true for "shared" DTMs used to hold XSLT variables
      int rootNode=dtm.getDocument();
      
      // Simple test: Recursively dump the DTM's content.
      // We'll want to replace this with more serious examples
      recursiveDumpNode(dtm,rootNode);
    }
    catch(Exception e)
      {
        e.printStackTrace();
      }
  }

  static final String[] TYPENAME={
    "NULL",
    "ELEMENT",
    "ATTRIBUTE",
    "TEXT",
    "CDATA_SECTION",
    "ENTITY_REFERENCE",
    "ENTITY",
    "PROCESSING_INSTRUCTION",
    "COMMENT",
    "DOCUMENT",
    "DOCUMENT_TYPE",
    "DOCUMENT_FRAGMENT",
    "NOTATION",
    "NAMESPACE"
  };
  
  static void recursiveDumpNode(DTM dtm,int nodeHandle)
  {
    // ITERATE over siblings
    for(;
	nodeHandle!=DTM.NULL;
	nodeHandle=dtm.getNextSibling(nodeHandle))
    {
      printNode(dtm,nodeHandle,"");
      
      // List the namespaces, if any.
      // Include only node's local namespaces, not inherited
      // %ISSUE% Consider inherited?
      int kid=dtm.getFirstNamespaceNode(nodeHandle,false);
      if(kid!=DTM.NULL)
      {
	System.out.println("\tNAMESPACES:");
	for(;
	    kid!=DTM.NULL;
	    kid=dtm.getNextNamespaceNode(nodeHandle,kid,false))
	{
	  printNode(dtm,kid,"\t");
	}
      }
      
      // List the attributes, if any
      kid=dtm.getFirstAttribute(nodeHandle);
      if(kid!=DTM.NULL)
      {
	System.out.println("\tATTRIBUTES:");
	for(;
	    kid!=DTM.NULL;
	    kid=dtm.getNextSibling(kid))
	{
	  printNode(dtm,kid,"\t");
	}
      }
      
      // Recurse into the children, if any
      recursiveDumpNode(dtm,dtm.getFirstChild(nodeHandle));
      }
    }

  static void printNode(DTM dtm,int nodeHandle,String indent)
  {
    // Briefly display this node
    // Don't bother displaying namespaces or attrs; we do that at the
    // next level up.
    // %REVIEW% Add namespace info, type info, ...

    // Formatting hack -- suppress quotes when value is null, to distinguish
    // it from "null".
    String value=dtm.getNodeValue(nodeHandle);
    String vq=(value==null) ? "" : "\"";

    System.out.println(indent+
		       "Node "+nodeHandle+": "+
		       TYPENAME[dtm.getNodeType(nodeHandle)]+" \""+
		       dtm.getNodeName(nodeHandle)+
		       "\" expandedType="+dtm.getExpandedTypeID(nodeHandle)+
		       "\n"+

		       indent+
		       "\tParent=" + dtm.getParent(nodeHandle) +
		       " FirstChild=" + dtm.getFirstChild(nodeHandle) +
		       " NextSib=" + dtm.getNextSibling(nodeHandle)+"\n"+
		       
		       indent+
		       "\tValue=" + vq + value + vq
		       ); 

  }
  
}