Application: gvSIG desktop

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright ? 2007-2014 gvSIG Association

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.xml2db.lib.api;

import org.gvsig.tools.locator.BaseLocator;

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * This locator is the entry point for the XML library, providing

 * access to all XML services through the {@link Xml2dbManager}

 * 

 */

public class Xml2dbLocator extends BaseLocator {

    /**

     * XML locator name

     */

    private static final String LOCATOR_NAME = "XMLLocator";

    /**

     * XML manager name

     */

    public static final String MANAGER_NAME = "XML.manager";

    /**

     * XML manager description

     */

    private static final String MANAGER_DESCRIPTION =

        "XML Manager of gvSIG";

    /**

     * Unique instance

     */

    private static final Xml2dbLocator instance = new Xml2dbLocator();

    /**

     * Returns the singleton instance.

     *

     * @return the singleton instance

     */

    public static Xml2dbLocator getInstance() {

        return instance;

    }

    /**

     * Returns the Locator's name

     * 

     * @return a String with the Locator's name

     */

    @Override

    public String getLocatorName() {

        return LOCATOR_NAME;

    }

    /**

     * Return a reference to XMLLocator.

     *

     * @return a reference to XMLLocator

     * @throws LocatorException

     *             if there is no access to the class or the class

     *             cannot be instantiated

     * @see Locator#get(String)

     */

    public static Xml2dbManager getManager() throws LocatorException {

        return getXml2dbManager();

    }

    public static Xml2dbManager getXml2dbManager() throws LocatorException {

        return (Xml2dbManager) getInstance().get(MANAGER_NAME);

    }

    /**

     * Registers the Class implementing the XMLLocator interface.

     *

     * @param clazz

     *            implementing the XMLLocator interface

     */

    public static void registerXMLManager(Class clazz) {

        getInstance().register(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);

    }

    /**

     * Registers the default Class implementing the XMLLocator interface

     * 

     * @param clazz

     *            implementing the XMLLocator interface

     */

    public static void registerDefaultXMLManager(Class clazz) {

        getInstance().registerDefault(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);

    }

}