/ - Diff - | gvSIG desktop 1 - gvSIG

     /**
      * Information of a plugin that is used on the installation process.
      * This information is composed by next fields:
      * </br>
      * <li>
      * <lu><b>Code</b>: unique identifier for the plugin.</lu>
      * <lu><b>Name</b>: name of the plugin.</lu>
      * <lu><b>Decription</b>: brief description of the plugin functionality</lu> *
      * <lu><b>Version</b>: number of version.</lu>
      * <lu><b>Build</b>: build number.</lu>
      * <lu><b>State</b>: the state of the plugin (testing, RC1...).</lu>
      * <lu><b>Is Official</b>: if the plugin is official or if is a not official plugin.</lu>
      * <lu><b>Type</b>: plugin type (plugin, theme, translation...). Depending of this value a
      * different installation provider is selected to control the installation process.</lu>
      * <li>
+     *
      * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera Llodr&aacute;</a>
      */
     public interface InstallerInfo {
     	/**
     	 * @return
     	 * Gets the code of the plugin.
     	 */
     	public String getCode();
     	public void setCode(String code);
     	/**
     	 * @return
     	 * Gets the name of the plugin.
     	 */
     	public String getName();
     	public void setName(String name);
     	/**
     	 * @return
     	 * Gets the description of the plugin.
     	 */
     	public String getDescription();
     	public void setDescription(String description);
     	/**
     	 * @return
     	 * Gets the version of the plugin.
     	 */
     	public String getVersion();
     	public void setVersion(String version);
     	/**
     	 * @return
     	 * Gets the build number of the plugin.
     	 */
     	public int getBuild();
     	public void setBuild(int build);
     	/**
     	 * @return
     	 * Gets the state of the plugin.
     	 */
     	public String getState();
     	public void setState(String state);
     	/**
     	 * @return
     	 * Gets if the plugin is official.
     	 */
     	public boolean isOfficial();
     	public void setOfficial(boolean official);
     	/**
     	 * @return
     	 * Gets the type of the plugin.
     	 */
     	public String getType();
     	public void setType(String type);
     	/**
     	 * Add an external file that have to be copied in the
     	 * installation process.
     	 * @param file
     	 * The file to copy.
     	 * @deprecated
     	 * This method will be deleted on next releases because
     	 * all the files that a plugin needs to work should be
     	 * contained in its directory.
     	 */
     	public void addFileToCopy(File file);
     	/**
     	 * Gets one external file that is copied on
     	 * the installation process.
     	 * @param index
     	 * The position of the external file.
     	 * @return
     	 * The file that have to be copied.
     	 * @deprecated
     	 * This method will be deleted on next releases because
     	 * all the files that a plugin needs to work should be
     	 * contained in its directory.
     	 */
     	public File getFileToCopyAt(int index);
     	/**
     	 * Gest the number of external files that have to be
     	 * copied in the installation process.
     	 * @return
     	 * The number of files.
     	 * @deprecated
     	 * This method will be deleted on next releases because
     	 * all the files that a plugin needs to work should be
     	 * contained in its directory.
     	 */
     	public int getFileToCopySize();
     	/**
     	 * Removes one of the files that have to be copied in the
     	 * installation process.
     	 * @param index
     	 * the position of the file.
     	 * @deprecated
     	 * This method will be deleted on next releases because
     	 * all the files that a plugin needs to work should be
     	 * contained in its directory.
     	 */
     	public void removeFileToCopy(int index);
     	/**
     	 * Sets the ant script that can be executed in the
     	 * installation process.
     	 * @param antScript
     	 * The ant script to copy.
     	 * @deprecated
     	 * This method will be deleted on next releases because
     	 * all the files that a plugin needs to work should be
     	 * contained in its directory.
     	 */
     	public void setAnScript(String antScript);
     	/**
     	 * Gets the ant script that has to be executed in the
     	 * installation process.
     	 * @return
     	 * the script.
     	 * @deprecated
     	 * This method will be deleted on next releases because
     	 * all the files that a plugin needs to work should be
     	 * contained in its directory.
     	 */
     	public String getAntScript();
     	public String getType();
     	public void setType(String type);
+    }

     	 */
     	private static final InstallerLocator instance = new InstallerLocator();
     	/* (non-Javadoc)
     	 * @see org.gvsig.tools.locator.Locator#getLocatorName()
     	/**
     	 * @see Locator#getLocatorName()
     	 */
     	public String getLocatorName() {
     		return LOCATOR_NAME;
-...
     	 * Registers the Class implementing the {@link InstallerManager} interface.
+    	 *
     	 * @param clazz
     	 *            implementing the InstallerManager interface
     	 * implementing the InstallerManager interface
     	 */
     	@SuppressWarnings("unchecked")
     	public static void registerInstallerManager(Class clazz) {

branches/v2_0_0_prep/extensions/org.gvsig.installer/org.gvsig.installer.lib/org.gvsig.installer.lib.api/src/main/java/org/gvsig/installer/lib/api/InstallerLibrary.java
31	31	import org.gvsig.tools.library.LibraryException;
32	32
33	33	/**
	34	* Library for the installer.
34	35	*
35	36	* @author <a href="mailto:jpiera@gvsig.org">Jorge Piera Llodrá</a>
36	37	*/
...	...
38	39
39	40	@Override
40	41	protected void doInitialize() throws LibraryException {
41		// TODO Auto-generated method stub
42
	42
43	43	}
44	44
45	45	@Override
46	46	protected void doPostInitialize() throws LibraryException {
47		// TODO Auto-generated method stub
48
	47
49	48	}
50	49
51	50	}

     import org.gvsig.tools.exception.BaseException;
     /**
      * Base exception for all the exceptions that are thrown by the process
      * of execution of an installer. The {@link InstallerExecutionService} throws
      * this exception on its methods.
+     *
      * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera Llodr&aacute;</a>
      */
     public class InstallerExecutionServiceException extends BaseException{
-...
+    	}
     	/**
     	 * @see BaseException#BaseException(String, Throwable)
     	 * @see BaseException#BaseException(String, Throwable, String, long)
     	 */
     	public InstallerExecutionServiceException(String message, Throwable cause) {
     		super(message, cause,  KEY, serialVersionUID);

     import org.gvsig.installer.lib.api.InstallerInfo;
     import org.gvsig.installer.lib.api.creation.InstallerCreationService;
     import org.gvsig.installer.lib.api.creation.InstallerCreationServiceException;
     import org.gvsig.tools.service.Service;
     /**
      * <p>
      * This service is used to execute an installer file and install the
      * plugins contained in it. It has methods to set the installer file,
      * This service is used to read an installer file and install the
      * plugins contained in it. It has methods to add installers,
      * to read the plugins that can be installed, to select the plugins
      * to install and to install them.
      * </p>
-...
     	 * Sets the stream that contains the installer that contains the
     	 * information to install some plugins. This stream is a zip file
     	 * that has to have the structure defined in the {@link InstallerCreationService}
     	 * documentation.	 *
     	 * documentation.
     	 * @param inputStream
     	 * The stream that contains the installer information.
     	 * @throws InstallerExecutionServiceException
-...
     	 */
     	public void addInstaller(InputStream inputStream) throws InstallerExecutionServiceException;
     	/**
     	 * It sets the directory where the application is located, that it has to
     	 * be a valid gvSIG root directory. This directory is used to install the plugins.
     	 * @param applicationDirectory
     	 * The directory where the gvSIG is located.
     	 * @throws InstallerExecutionServiceException
     	 * This exception is thrown when the directory doesn't exist or the directory is
     	 * not a valid gvSIG root directory.
     	 */
     	public void setApplicationDirectory(File applicationDirectory) throws InstallerExecutionServiceException;
     	/**
     	 * In the main gvSIG directory there is a directory named <b>install</b> that could
     	 * have some installers that can be used to install new plugins. This method retrieve
     	 * all the information of the installers located in this directory and allows to the
     	 * user to show this information.
     	 * @throws InstallerExecutionServiceException
     	 * If there is any problem reading the directory or the installers.
     	 */
     	public void addInstallersFromInstallDirectory() throws InstallerExecutionServiceException;
     	/**
     	 * Deletes all the information of the previous loaded installers.
     	 */
     	public void deleteInstallers();
     	/**
     	 * Sets the plugin to install.
     	 * @param index
     	 * Position of the plugin to install.
     	 * @throws InstallerExecutionServiceException
     	 * If the plugin doesn't exist.
     	 */
     	public void setPluginToInstall(int index) throws InstallerExecutionServiceException;
     	public void setApplicationDirectory(File applicationDirectory) throws InstallerExecutionServiceException;
     	/**
     	 * Sets the plugin to install.
     	 * @param code
     	 * Code of the plugin to install.
     	 * @throws InstallerExecutionServiceException
     	 * If the plugin doesn't exist.
     	 */
     	public void setPluginToInstall(String code) throws InstallerCreationServiceException;
     	/**
     	 * It
     	 * @param outputDirectory
     	 * Install the selected plugin. This method only can be executed if the
     	 * selected plugin is located on the <b>install</b> directory of gvSIG.
     	 * Otherwise the method to use is {{@link #executeInstaller(InputStream)} that
     	 * provides the strem used to install the plugin.
     	 * @throws InstallerExecutionServiceException
     	 * If there is an error installing the plugin.
     	 */
     	public void executeInstaller() throws InstallerExecutionServiceException;
     	/**
     	 * Install the selected plugin. This method provides of a stream that has been
     	 * added before using the {{@link #addInstaller(InputStream)}} method. This stream
     	 * is needed other time because there are some {@link InputStream}'s that don't
     	 * support the {@link InputStream#reset()} method.	 *
     	 * @throws InstallerExecutionServiceException
     	 * If there is an error installing the plugin.	 *
     	 */
     	public void executeInstaller(InputStream is) throws InstallerExecutionServiceException;
     	public void setPluginToInstall(int index);
     	public void setPluginToInstall(String code);
     	/**
     	 * @return
     	 * The number of plugins that can be selected to install.
     	 */
     	public int getPluginsSize();
     	/**
     	 * Return the information of a plugin from a concrete position.
     	 * @param index
     	 * The position of the plugin.
     	 * @return
     	 * The information of a plugin.
     	 */
     	public InstallerInfo getPluginInfoAt(int index);
+    }

     import org.gvsig.tools.exception.BaseException;
     /**
      * Base exception for all the exceptions that are thrown by the process
      * of creation of an installer. The {@link InstallerCreationService} throws
      * this exception on its methods.
+     *
      * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera Llodr&aacute;</a>
      */
     public class InstallerCreationServiceException extends BaseException{
-...
+    	}
     	/**
     	 * @see BaseException#BaseException(String, Throwable)
     	 * @see BaseException#BaseException(String, Throwable, String, long)
     	 */
     	public InstallerCreationServiceException(String message, Throwable cause) {
     		super(message, cause,  KEY, serialVersionUID);
+    	}
     	/**
     	 * @see BaseException#BaseException(String, String, long)
     	 */
     	public InstallerCreationServiceException(String message, String key,
     			long serialVersion) {
     		super(message, key, serialVersion);
+    	}
     	/**
     	 * @see BaseException#BaseException(String, Throwable, String, long)
     	 */
     	public InstallerCreationServiceException(String message, Throwable cause,
     			String key, long serialVersion) {
     		super(message, cause, key, serialVersion);

     import java.util.Map;
     import org.gvsig.installer.lib.api.InstallerInfo;
     import org.gvsig.installer.lib.api.creation.InstallerCreationServiceException;
     import org.gvsig.installer.lib.api.execution.InstallerExecutionService;
     import org.gvsig.installer.lib.api.execution.InstallerExecutionServiceException;
     import org.gvsig.installer.lib.impl.DefaultInstallerManager;
-...
     		return installerInfos.get(pluginToInstallIndex);
+    	}
     	public void setPluginToInstall(int index) {
     	public void setPluginToInstall(int index) throws InstallerExecutionServiceException{
     		if (index > installerInfos.size()){
     			throw new InstallerExecutionServiceException("The plugin doesn't exist");
+    		}
     		pluginToInstallIndex = index;
+    	}
-...
     		return this.manager;
+    	}
     	public void setPluginToInstall(String code) {
     		pluginToInstallIndex = -1;
     	public void setPluginToInstall(String code) throws InstallerCreationServiceException {
     		int selectedCode = -1;
     		for (int i=0 ; i<getPluginsSize() ; i++){
     			if (installerInfos.get(i).getCode().equals(code)){
     				pluginToInstallIndex = i;
     				selectedCode = i;
     				break;
+    			}
+    		}
     		if (selectedCode == -1){
     			throw new InstallerCreationServiceException("The plugin doesn't exist");
+    		}
     		pluginToInstallIndex = selectedCode;
+    	}
+    }

     import javax.swing.JPanel;
     import org.gvsig.installer.lib.api.InstallerInfo;
     import org.gvsig.installer.lib.api.creation.InstallerCreationServiceException;
     import org.gvsig.installer.lib.api.execution.InstallerExecutionService;
     import org.gvsig.installer.lib.api.execution.InstallerExecutionServiceException;
     import org.gvsig.installer.swing.impl.InstallerWizardPanel;
-...
     			setFinishedText();
     		}catch(InstallerExecutionServiceException e){
     			setExceptionText(e);
     		} catch (InstallerCreationServiceException e) {
     			setExceptionText(e);
+    		}
     		setProgress(100);
+    	}

| gvSIG desktop 1

Revision 32467