Derek Hulley 8307ba5ba9 AMP dependency checking on the tool side.
This is work in progress and the repo is not currently double checking the runtime dependencies.

To declare a dependency, add the following to your module.properties:
   module.depends.ABC=ABCfromVersion - ABCtoVersion
Wildcard * can be used in place of fromVersion or toVersion, as well as just a single version.
The most common usage will be:
   module.depends.ABC=1.0-*
i.e. this module depends on ABC version 1.0 or later being present.


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@5601 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
2007-05-02 20:28:20 +00:00

148 lines
4.6 KiB
Java

/*
* Copyright (C) 2005-2007 Alfresco Software Limited.
*
* 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.
* As a special exception to the terms and conditions of version 2.0 of
* the GPL, you may redistribute this Program in connection with Free/Libre
* and Open Source Software ("FLOSS") applications as described in Alfresco's
* FLOSS exception. You should have recieved a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.service.cmr.module;
import java.io.Serializable;
import java.util.Date;
import java.util.List;
import java.util.Properties;
import org.alfresco.util.VersionNumber;
/**
* Module details, contains the details of an installed alfresco module.
*
* @author Roy Wetherall
* @since 2.0
*/
public interface ModuleDetails extends Serializable
{
static final String PROP_ID = "module.id";
static final String PROP_ALIASES = "module.aliases";
static final String PROP_VERSION = "module.version";
static final String PROP_TITLE = "module.title";
static final String PROP_DESCRIPTION = "module.description";
static final String PROP_REPO_VERSION_MIN = "module.repo.version.min";
static final String PROP_REPO_VERSION_MAX = "module.repo.version.max";
static final String PROP_DEPENDS_PREFIX = "module.depends.";
static final String PROP_INSTALL_DATE = "module.installDate";
static final String PROP_INSTALL_STATE = "module.installState";
static final String INVALID_ID_REGEX = ".*[^\\w.-].*";
/**
* Get all defined properties.
*
* @return Returns the properties defined by this set of details
*/
Properties getProperties();
/**
* Get the id of the module
*
* @return module id
*/
String getId();
/**
* @return Returns a list of IDs by which this module may once have been known
*/
List<String> getAliases();
/**
* Get the version number of the module
*
* @return module version number
*/
VersionNumber getVersion();
/**
* Get the title of the module
*
* @return module title
*/
String getTitle();
/**
* Get the description of the module
*
* @return module description
*/
String getDescription();
/**
* @return Returns the minimum version of the repository in which the module may be active
*/
VersionNumber getRepoVersionMin();
/**
* @param repoVersionMin the minimum version of the repository in which the module may be acitve
*/
void setRepoVersionMin(VersionNumber repoVersionMin);
/**
* @return Returns the maximum version of the repository in which the module may be active
*/
VersionNumber getRepoVersionMax();
/**
* @param repoVersionMax the maximum version of the repository in which the module may be acitve
*/
void setRepoVersionMax(VersionNumber repoVersionMax);
/**
* @return Returns a list of module dependencies that must be present for this module
*/
List<ModuleDependency> getDependencies();
/**
* Get the modules install date
*
* @return module install date or <tt>null</tt> if it has not been set
*/
Date getInstallDate();
/**
* Set the module installation date.
*
* @param installDate the module install date
*/
void setInstallDate(Date installDate);
/**
* Get the modules install state
*
* @return the modules install state
*/
ModuleInstallState getInstallState();
/**
* Set the module install state.
*
* @param installState the module install state
*/
void setInstallState(ModuleInstallState installState);
}