| gvSIG desktop 1

/* XMLParserFactory.java                                           NanoXML/Java

 *

 * $Revision: 1.1 $

 * $Date: 2006/06/14 07:29:07 $

 * $Name:  $

 *

 * This file is part of NanoXML 2 for Java.

 * Copyright (C) 2001 Marc De Scheemaecker, All Rights Reserved.

 *

 * This software is provided 'as-is', without any express or implied warranty.

 * In no event will the authors be held liable for any damages arising from the

 * use of this software.

 *

 * Permission is granted to anyone to use this software for any purpose,

 * including commercial applications, and to alter it and redistribute it

 * freely, subject to the following restrictions:

 *

 *  1. The origin of this software must not be misrepresented; you must not

 *     claim that you wrote the original software. If you use this software in

 *     a product, an acknowledgment in the product documentation would be

 *     appreciated but is not required.

 *

 *  2. Altered source versions must be plainly marked as such, and must not be

 *     misrepresented as being the original software.

 *

 *  3. This notice may not be removed or altered from any source distribution.

 */

package net.n3.nanoxml;

/**

 * Creates an XML parser.

 *

 * @author Marc De Scheemaecker

 * @version $Name:  $, $Revision: 1.1 $

 */

public class XMLParserFactory

{

    /**

     * The class name of the default XML parser.

     */

    public static final String DEFAULT_CLASS = "net.n3.nanoxml.StdXMLParser";

    /**

     * The Java properties key of the XML parser class name.

     */

    public static final String CLASS_KEY = "net.n3.nanoxml.XMLParser";

    /**

     * Creates a default parser.

     *

     * @see #DEFAULT_CLASS

     * @see #CLASS_KEY

     *

     * @return the non-null parser.

     *

     * @throws java.lang.ClassNotFoundException

     *                if the class of the parser or validator could not be found.

     * @throws java.lang.InstantiationException

     *                if the parser could not be created

     * @throws java.lang.IllegalAccessException

     *                if the parser could not be created

     */

    public static IXMLParser createDefaultXMLParser()

        throws ClassNotFoundException,

               InstantiationException,

               IllegalAccessException

    {

        String className = System.getProperty(XMLParserFactory.CLASS_KEY,

                                              XMLParserFactory.DEFAULT_CLASS);

        return XMLParserFactory.createXMLParser(className,

                                                new StdXMLBuilder());

    }

    /**

     * Creates a default parser.

     *

     * @see #DEFAULT_CLASS

     * @see #CLASS_KEY

     *

     * @param builder the XML builder.

     *

     * @return the non-null parser.

     *

     * @throws java.lang.ClassNotFoundException

     *                if the class of the parser could not be found.

     * @throws java.lang.InstantiationException

     *                if the parser could not be created

     * @throws java.lang.IllegalAccessException

     *                if the parser could not be created

     */

    public static IXMLParser createDefaultXMLParser(IXMLBuilder builder)

        throws ClassNotFoundException,

               InstantiationException,

               IllegalAccessException

    {

        String className = System.getProperty(XMLParserFactory.CLASS_KEY,

                                              XMLParserFactory.DEFAULT_CLASS);

        return XMLParserFactory.createXMLParser(className, builder);

    }

    /**

     * Creates a parser.

     *

     * @param className the name of the class of the XML parser

     * @param builder the XML builder.

     *

     * @return the non-null parser.

     *

     * @throws java.lang.ClassNotFoundException

     *                if the class of the parser could not be found.

     * @throws java.lang.InstantiationException

     *                if the parser could not be created

     * @throws java.lang.IllegalAccessException

     *                if the parser could not be created

     */

    public static IXMLParser createXMLParser(String      className,

                                             IXMLBuilder builder)

        throws ClassNotFoundException,

               InstantiationException,

               IllegalAccessException

    {

        Class cls = Class.forName(className);

        IXMLParser parser = (IXMLParser) cls.newInstance();

        parser.setBuilder(builder);

        parser.setValidator(new NonValidator());

        return parser;

    }

}