/**
 *
 * C O P Y R I G H T   N O T I C E
 *  Copyright (c) 2001 by:
 *    * The MicroArray Gene Expression Database group (MGED)
 *    * Rosetta Inpharmatics
 * 
 * Permission is hereby granted, free of charge, to any person
 * obtaining a copy of this software and associated documentation files
 * (the "Software"), to deal in the Software without restriction,
 * including without limitation the rights to use, copy, modify, merge,
 * publish, distribute, sublicense, and/or sell copies of the Software,
 * and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 *
 *
 * @author $Author: rhubley $
 * @version $Revision: 1.5 $
 *
 */
package org.biomage.tools.generate_dtd;

import java.io.FileWriter;
import java.util.Vector;

import org.biomage.tools.generate_classes.CreateFile;
import org.biomage.tools.generate_classes.CreateClassFile;
import org.biomage.tools.generate_classes.CreateMAGEFile;
import org.biomage.tools.generate_classes.CreatePackageFile;

import org.w3c.dom.*;

/**
 * <b>Description:</b>
 *      Class that is resposible for generating a DTD file
 *      for the classes represented by the list of class nodes
 *      passed into the constructor.
 *
 */
abstract
public
class
WriteDTDElement
{
    /**
     * <b>Description:</b>
     *      The createFile this class will.
     *
     */
    CreateFile createFile = null;
    
    /**
     * <b>Description:</b>
     *      Constructor for the DTD file generator.
     *
     *<p>
     *  @param createFile: the class to write to the DTD.
     *<p>
     */
    protected
    WriteDTDElement(
        CreateFile createFile
    ) throws Exception
    {
        this.createFile = createFile;
    }
    
    /**
     * <b>Description:</b>
     *     Creates the different entities, elements and attlists
     *     for the class.
     *
     *<p>
     *  @param packageOrdering: the XML configuration element for package ordering information.
     *<p>
     */
    abstract
    protected
    void
    createXMLStrings() throws Exception;
    
    /**
     * <b>Description:</b>
     *      Method to write out entities.  The base class does nothing.
     *
     *<p>
     *  @param write: the writer to use.
     *<p>
     */
    protected
    void
    writeEntities(
       FileWriter writer
    ) throws Exception
    {
    }
    
    /**
     * <b>Description:</b>
     *      Method to write out the body.
     *
     *<p>
     *  @param write: the writer to use.
     *<p>
     */
    protected
    void
    writeBody(
       FileWriter writer
    ) throws Exception
    {
    }
}