/*
 * Copyright (c) 2002,2008 Declarative Engineering LLC.
 * All rights reserved.  This program and the accompanying materials
 * are made available under the terms of the Declarative Engineering LLC
 * verson 1 which accompanies this distribution, and is available at
 * http://declarativeengineering.com/legal/DE_Developer_License_v1.txt
 */
package com.foundation.util.xml;

import com.foundation.util.IManagedList;

/**
 * Note: A document contains metadata elements, then a doctype, then elements, in that order.
 */
public interface IDocument extends IAbstractNode {
/**
 * Gets the collection of ordered metadata nodes and comments defined at the very top of the document.
 * <p>Note that these node objects cannot contain child elements.  We may at some point define a special class for this data instead of using the Node class.</p>
 * @return The ordered metadata nodes &lt;?name attr="value" ... ?&gt defined at the top of the document.
 */
public IManagedList getMetadataElements();
/**
 * Gets the DOCTYPE data for the document.
 * @return The document type metadata or null if none was provided.
 */
public IDocType getDocType();
/**
 * Sets the DOCTYPE data for the document.
 * @param docType The document type metadata or null if none is provided.
 */
public void setDocType(IDocType docType);
}//IDocument//