Application: gvSIG desktop

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* 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.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2010 {Prodevelop}   {Task}

*/

package org.gvsig.installer.lib.api;

import org.gvsig.installer.lib.api.creation.InstallerCreationService;

import org.gvsig.installer.lib.api.creation.InstallerCreationServiceException;

import org.gvsig.installer.lib.api.execution.InstallerExecutionService;

import org.gvsig.installer.lib.api.execution.InstallerExecutionServiceException;

/**

 * <p>

 * This manager is used to register and create the services that are used

 * to manage the plugin installers. The services that offers are basically

 * two: the creation of installers service and the execution of installers

 * service.

 * </p>

 * 

 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera Llodr&aacute;</a>

 */

public interface InstallerManager {

        /**

         * It registers a class that implements the service for the creation of

         * installers. It has to implement the {@link InstallerCreationService} interface.

         * 

         * @param clazz

         * Class that implements the {@link InstallerCreationService} interface.

         */

        @SuppressWarnings(value = "unchecked")

        public void registerInstallerCreationService(Class clazz);

        /**

         * It creates and returns an object that is used to create an installer for

         * a selected plugin. All the parameters are set using the {@link InstallerCreationService} 

         * interface.

         * 

         * @return

         * An object that is used to create a plugin installer 

         * @throws InstallerCreationServiceException

         * When there is a problem creating the service

         */

        public InstallerCreationService getInstallerCreationService() throws InstallerCreationServiceException;

        /**

         * It registers a class that implements the service for the execution of

         * installers. It has to implement the {@link InstallerExecutionService} interface.

         * 

         * @param clazz

         * Class that implements the {@link InstallerExecutionService} interface.

         */

        @SuppressWarnings("unchecked")

        public void registerInstallerExecutionService(Class clazz);

        /**

         * It creates and returns an object that is used to execute an installer for

         * the installation of plugins in gvSIG. All the parameters are set using the

         * {@link InstallerExecutionService} interface.

         * 

         * @return

         * An object that is used to install the installer file 

         * @throws InstallerExecutionServiceException

         * When there is a problem creating the service

         */

        public InstallerExecutionService getInstallerExecutionService() throws InstallerExecutionServiceException;

}