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 java.io.File;

import java.net.URL;

import java.util.List;

import org.gvsig.installer.lib.api.InstallerManager.ARCH;

import org.gvsig.installer.lib.api.InstallerManager.JVM;

import org.gvsig.installer.lib.api.InstallerManager.OS;

import org.gvsig.installer.lib.api.InstallerManager.STATE;

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

import org.gvsig.tools.lang.Cloneable;

import org.gvsig.tools.task.SimpleTaskStatus;

/**

 * Information of a package that is used on the installation process.

 * This information is composed by next fields:

 * </br> <li>

 * <lu><b>Code</b>: unique identifier for the package.</lu> <lu><b>Name</b>:

 * name of the package.</lu> <lu><b>Description</b>: brief description of the

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

 * package (testing, RC1...).</lu> <lu><b>Operating system</b>: the operating

 * system supported (lin, win, mac_10_6, ...).</lu> <lu><b>Architecture</b>: the

 * state of the package (testing, RC1, ...).</lu> <lu><b>JavaVM</b>: the minimum

 * java version supported (1.5, 1.6, ...).</lu> <lu><b>Is Official</b>: if the

 * package is official or if is a not official package.</lu> <lu><b>Type</b>:

 * package 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 PackageInfo extends Cloneable {

    /**

     * @return

     *         Gets the code of the package.

     */

    public String getCode();

    public void setCode(String code);

    public String getID();

    /**

     * @return

     *         Gets the name of the package.

     */

    public String getName();

    public void setName(String name);

    /**

     * @return

     *         Gets the description of the package.

     */

    public String getDescription();

    public void setDescription(String description);

    /**

     * @return

     *         Gets the version of the package.

     */

    public Version getVersion();

    public void setVersion(String version);

    public void setVersion(Version version);

    /**

     * @return

     *         Gets the build number of the package.

     */

    public int getBuild();

    public void setBuild(int build);

    /**

     * @return

     *         Gets the state of the package.

     * @see STATE

     */

    public String getState();

    /**

     * Sets the state of the package

     * 

     * @param state

     * @see STATE

     */

    public void setState(String state);

    /**

     * @return

     *         Gets if the package is official.

     */

    public boolean isOfficial();

    public void setOfficial(boolean official);

    /**

     * @return

     *         Gets the type of the package.

     */

    public String getType();

    public void setType(String type);

    /**

     * Returns the supported operating system.

     * 

     * @return the supported operating system

     * @see OS

     */

    public String getOperatingSystem();

    /**

     * Sets the supported operating system.

     * 

     * @param operatingSystem

     *            the supported operating system

     * @see OS

     */

    public void setOperatingSystem(String operatingSystem);

    /**

     * Returns the supported hardware architecture.

     * 

     * @return the supported hardware architecture

     * @see ARCH

     */

    public String getArchitecture();

    /**

     * Sets the supported hardware architecture.

     * 

     * @param architecture

     *            the supported hardware architecture

     * @see ARCH

     */

    public void setArchitecture(String architecture);

    /**

     * Returns the supported java vm version.

     * 

     * @return the supported java vm version

     * @see JVM

     */

    public String getJavaVM();

    /**

     * Sets the supported java vm version.

     * 

     * @param javaVM

     *            the supported java vm version

     * @see JVM

     */

    public void setJavaVM(String javaVM);

    /**

     * Returns the supported gvSIG version.

     * 

     * @return the supported gvSIG version

     */

    public String getGvSIGVersion();

    /**

     * Sets the supported gvSIG version.

     * 

     * @param gvSIGVersion

     *            the supported gvSIG version

     */

    public void setGvSIGVersion(String gvSIGVersion);

    /**

     * Returns the package bundle download {@link URL}.

     * 

     * May be null if there is no remote URL to download the bundle.

     * 

     * @return the package bundle download {@link URL}

     */

    public URL getDownloadURL();

    public String getDownloadURLAsString();

//    /**

//     * Returns the package bundle download {@link URL}.

//     * 

//     * May be null if there is no remote URL to download the bundle.

//     * 

//     * @return the package bundle download {@link URL}

//     */

    public URL getDownloadURL(URL baseURL);

    /**

     * Sets the package bundle download {@link URL}. Optional.

     * 

     * @param defaultURL

     *            the package bundle download {@link URL}

     */

    public void setDownloadURL(URL defaultURL);

    public void setDownloadURL(String defaultDownloadURL);

    /**

     * Returns the package info model version.

     * 

     * @return the package info model version

     */

    public String getModelVersion();

    /**

     * Sets the package info model version.

     * 

     * @param modelVersion

     *            the package info model version

     */

    public void setModelVersion(String modelVersion);

    public String getOwner();

    /**

     * Sets the package owner.

     * 

     * @param owner

     *            the package owner

     */

    public void setOwner(String owner);

    /**

     * Returns the package source files url {@link URL}.

     * 

     * @return the package source files url {@link URL}

     */

    public URL getSourcesURL();

    /**

     * Sets the package sources.

     * 

     * @param sources

     *            the package sources

     */

    public void setSourcesURL(URL sources);

    /**

     * Returns the package web url {@link URL}.

     * 

     * @return the package web url {@link URL}

     */

    public URL getWebURL();

    /**

     * Sets the package web url {@link URL}.

     * 

     * @param webURL

     *            the package web url {@link URL}

     */

    public void setWebURL(URL webURL);

    /**

     * Gets the ant script that has to be executed in the

     * installation process.

     * 

     * @return

     *         the script.

     */

    public String getAntScript();

    /**

     * Sets the ant script that can be executed in the

     * installation process.

     * 

     * @param antScript

     *            The ant script to copy.

     */

    public void setAntScript(String antScript);

    public File downloadFile() throws InstallPackageServiceException;

    public File downloadFile(SimpleTaskStatus taskStatus)

        throws InstallPackageServiceException;

    /**

     * @return

     */

    public void addFileToCopy(File file);

    public File getFileToCopy(int i);

    public void removeFileToCopy(File file);

    public void clearFilesToCopy();

    public List<File> getFilesToCopy();

    /**

     * @param folder

     * @return

     */

    public boolean removeInstallFolder(File folder);

    public boolean removeFilesFolder(File folder);

    /**

     * @param string

     * @return

     */

    public boolean matchID(String string);

    public Dependencies getDependencies();

    public void setDependencies(String dependencies);

    public void setDependencies(Dependencies dependencies);

    public String toStringCompact();

    public List<String> getCategories();

    public void setCategories(List<String> categoriesList);

    public String getCategoriesAsString();

    public void addCategoriesAsString(String categoriesString);

}