/** @return Returns the custom file mapping properties or null if they weren't overwritten */
private Properties getCustomFileMappings(String ampFileLocation) {
File file =
new File(
ampFileLocation + "/" + FILE_MAPPING_PROPERTIES,
ModuleManagementTool.DETECTOR_AMP_AND_WAR);
if (!file.exists()) {
// Nothing there
return null;
}
Properties mappingProperties = new Properties();
InputStream is = null;
try {
is = new BufferedInputStream(new FileInputStream(file));
mappingProperties.load(is);
} catch (IOException exception) {
throw new ModuleManagementToolException(
"Unable to load default extension file mapping properties.", exception);
} finally {
if (is != null) {
try {
is.close();
} catch (Throwable e) {
}
}
}
return mappingProperties;
}
@NotNull
@Override
public Value getLastUpdate() {
return valueTableDirectory.exists()
? DateTimeType.get().valueOf(new Date(valueTableDirectory.lastModified()))
: DateTimeType.get().nullValue();
}
/**
* Lists all the currently installed modules in the WAR
*
* @param warLocation the war location
*/
public void listModules(String warLocation) {
ModuleDetails moduleDetails = null;
boolean previous = this.verbose;
this.verbose = true;
try {
File moduleDir = new File(warLocation + MODULE_DIR, DETECTOR_AMP_AND_WAR);
if (moduleDir.exists() == false) {
outputMessage("No modules are installed in this WAR file");
}
java.io.File[] dirs = moduleDir.listFiles();
if (dirs != null && dirs.length != 0) {
for (java.io.File dir : dirs) {
if (dir.isDirectory() == true) {
File moduleProperties =
new File(dir.getPath() + "/module.properties", DETECTOR_AMP_AND_WAR);
if (moduleProperties.exists() == true) {
try {
InputStream is = new FileInputStream(moduleProperties);
moduleDetails = ModuleDetailsHelper.createModuleDetailsFromPropertiesStream(is);
} catch (IOException exception) {
throw new ModuleManagementToolException(
"Unable to open module properties file '" + moduleProperties.getPath() + "'",
exception);
}
outputMessage(
"Module '" + moduleDetails.getId() + "' installed in '" + warLocation + "'");
outputMessage(" Title: " + moduleDetails.getTitle(), true);
outputMessage(" Version: " + moduleDetails.getVersion(), true);
outputMessage(" Install Date: " + moduleDetails.getInstallDate(), true);
outputMessage(" Description: " + moduleDetails.getDescription(), true);
}
}
}
} else {
outputMessage("No modules are installed in this WAR file");
}
} finally {
this.verbose = previous;
}
}
/**
* Removes a file from the given location in the war file.
*
* @param warLocation the war file location
* @param filePath the path to the file that is to be deleted
* @param preview indicates whether this is a preview install
*/
private void removeFile(String warLocation, String filePath, boolean preview) {
File removeFile = new File(warLocation + filePath, DETECTOR_AMP_AND_WAR);
if (removeFile.exists() == true) {
outputMessage("Removing file '" + filePath + "' from war", true);
if (preview == false) {
removeFile.delete();
}
} else {
outputMessage(
"The file '" + filePath + "' was expected for removal but was not present in the war",
true);
}
}
/**
* Copies a file from the AMP location to the correct location in the WAR, interating on
* directories where appropraite.
*
* @param ampFileLocation the AMP file location
* @param warFileLocation the WAR file location
* @param sourceDir the directory in the AMP to copy from. It must start with "/".
* @param destinationDir the directory in the WAR to copy to. It must start with "/".
* @param installedFiles a list of the currently installed files
* @param preview indicates whether this is a preview install or not
* @throws IOException throws any IOExpceptions thar are raised
*/
private void copyToWar(
String ampFileLocation,
String warFileLocation,
String sourceDir,
String destinationDir,
InstalledFiles installedFiles,
boolean preview)
throws IOException {
if (sourceDir.length() == 0 || !sourceDir.startsWith("/")) {
throw new IllegalArgumentException("sourceDir must start with '/'");
}
if (destinationDir.length() == 0 || !destinationDir.startsWith("/")) {
throw new IllegalArgumentException("destinationDir must start with '/'");
}
// Handle source and destination if they are just the root '/'
if (sourceDir.equals("/")) {
sourceDir = "";
}
if (destinationDir.equals("/")) {
destinationDir = "";
}
String sourceLocation = ampFileLocation + sourceDir;
File ampConfig = new File(sourceLocation, DETECTOR_AMP_AND_WAR);
java.io.File[] files = ampConfig.listFiles();
if (files != null) {
for (java.io.File sourceChild : files) {
String destinationFileLocation =
warFileLocation + destinationDir + "/" + sourceChild.getName();
File destinationChild = new File(destinationFileLocation, DETECTOR_AMP_AND_WAR);
if (sourceChild.isFile() == true) {
String backupLocation = null;
boolean createFile = false;
if (destinationChild.exists() == false) {
createFile = true;
} else {
// Backup file about to be updated
backupLocation = BACKUP_DIR + "/" + generateGuid() + ".bin";
if (preview == false) {
File backupFile = new File(warFileLocation + backupLocation, DETECTOR_AMP_AND_WAR);
backupFile.copyFrom(destinationChild);
}
}
if (createFile == true) {
installedFiles.addAdd(destinationDir + "/" + sourceChild.getName());
this.outputMessage(
"File '" + destinationDir + "/" + sourceChild.getName() + "' added to war from amp",
true);
} else {
installedFiles.addUpdate(destinationDir + "/" + sourceChild.getName(), backupLocation);
this.outputMessage(
"WARNING: The file '"
+ destinationDir
+ "/"
+ sourceChild.getName()
+ "' is being updated by this module and has been backed-up to '"
+ backupLocation
+ "'",
true);
}
} else {
boolean mkdir = false;
if (destinationChild.exists() == false) {
mkdir = true;
}
copyToWar(
ampFileLocation,
warFileLocation,
sourceDir + "/" + sourceChild.getName(),
destinationDir + "/" + sourceChild.getName(),
installedFiles,
preview);
if (mkdir == true) {
installedFiles.addMkdir(destinationDir + "/" + sourceChild.getName());
this.outputMessage(
"Directory '" + destinationDir + "/" + sourceChild.getName() + "' added to war",
true);
}
}
}
}
}
/**
* Installs a given AMP file into a given WAR file.
*
* @param ampFileLocation the location of the AMP file to be installed
* @param warFileLocation the location of the WAR file into which the AMP file is to be installed.
* @param preview indicates whether this should be a preview install. This means that the process
* of installation will be followed and reported, but the WAR file will not be modified.
* @param forceInstall indicates whether the installed files will be replaces reguarless of the
* currently installed version of the AMP. Generally used during development of the AMP.
* @param backupWAR indicates whether we should backup the war we are modifying or not
*/
public void installModule(
String ampFileLocation,
String warFileLocation,
boolean preview,
boolean forceInstall,
boolean backupWAR) {
try {
outputMessage("Installing AMP '" + ampFileLocation + "' into WAR '" + warFileLocation + "'");
if (preview == false) {
// Make sure the module and backup directory exisits in the WAR file
File moduleDir = new File(warFileLocation + MODULE_DIR, DETECTOR_AMP_AND_WAR);
if (moduleDir.exists() == false) {
moduleDir.mkdir();
}
File backUpDir = new File(warFileLocation + BACKUP_DIR, DETECTOR_AMP_AND_WAR);
if (backUpDir.exists() == false) {
backUpDir.mkdir();
}
// Make a backup of the war we are going to modify
if (backupWAR == true) {
java.io.File warFile = new java.io.File(warFileLocation);
if (warFile.exists() == false) {
throw new ModuleManagementToolException(
"The war file '" + warFileLocation + "' does not exist.");
}
String backupLocation = warFileLocation + "-" + System.currentTimeMillis() + ".bak";
java.io.File backup = new java.io.File(backupLocation);
copyFile(warFile, backup);
outputMessage("WAR has been backed up to '" + backupLocation + "'");
}
}
// Get the details of the installing module
String propertiesLocation = ampFileLocation + "/module.properties";
ModuleDetails installingModuleDetails =
ModuleDetailsHelper.createModuleDetailsFromPropertyLocation(propertiesLocation);
if (installingModuleDetails == null) {
throw new ModuleManagementToolException(
"No module.properties file has been found in the installing .amp file '"
+ ampFileLocation
+ "'");
}
String installingId = installingModuleDetails.getId();
VersionNumber installingVersion = installingModuleDetails.getVersion();
// Check that the target war has the necessary dependencies for this install
List<ModuleDependency> installingModuleDependencies =
installingModuleDetails.getDependencies();
List<ModuleDependency> missingDependencies = new ArrayList<ModuleDependency>(0);
for (ModuleDependency dependency : installingModuleDependencies) {
String dependencyId = dependency.getDependencyId();
ModuleDetails dependencyModuleDetails =
ModuleDetailsHelper.createModuleDetailsFromWarAndId(warFileLocation, dependencyId);
// Check the dependency. The API specifies that a null returns false, so no null check is
// required
if (!dependency.isValidDependency(dependencyModuleDetails)) {
missingDependencies.add(dependency);
continue;
}
}
if (missingDependencies.size() > 0) {
throw new ModuleManagementToolException(
"The following modules must first be installed: " + missingDependencies);
}
// Try to find an installed module by the ID
ModuleDetails installedModuleDetails =
ModuleDetailsHelper.createModuleDetailsFromWarAndId(warFileLocation, installingId);
if (installedModuleDetails == null) {
// It might be there as one of the aliases
List<String> installingAliases = installingModuleDetails.getAliases();
for (String installingAlias : installingAliases) {
ModuleDetails installedAliasModuleDetails =
ModuleDetailsHelper.createModuleDetailsFromWarAndId(warFileLocation, installingAlias);
if (installedAliasModuleDetails == null) {
// There is nothing by that alias
continue;
}
// We found an alias and will treat it as the same module
installedModuleDetails = installedAliasModuleDetails;
outputMessage(
"Module '"
+ installingAlias
+ "' is installed and is an alias of '"
+ installingId
+ "'");
break;
}
}
// Now clean up the old instance
if (installedModuleDetails != null) {
String installedId = installedModuleDetails.getId();
VersionNumber installedVersion = installedModuleDetails.getVersion();
int compareValue = installedVersion.compareTo(installingVersion);
if (forceInstall == true || compareValue == -1) {
if (forceInstall == true) {
// Warn of forced install
outputMessage(
"WARNING: The installation of this module is being forced. All files will be removed and replaced regardless of exiting versions present.");
}
// Trying to update the extension, old files need to cleaned before we proceed
outputMessage(
"Clearing out files relating to version '"
+ installedVersion
+ "' of module '"
+ installedId
+ "'");
cleanWAR(warFileLocation, installedId, preview);
} else if (compareValue == 0) {
// Trying to install the same extension version again
outputMessage(
"WARNING: This version of this module is already installed in the WAR. Installation skipped.");
return;
} else if (compareValue == 1) {
// Trying to install an earlier version of the extension
outputMessage(
"WARNING: A later version of this module is already installed in the WAR. Installation skipped.");
return;
}
}
// Check if a custom mapping file has been defined
Properties fileMappingProperties = null;
Properties customFileMappingProperties = getCustomFileMappings(ampFileLocation);
if (customFileMappingProperties == null) {
fileMappingProperties = defaultFileMappingProperties;
} else {
fileMappingProperties = new Properties();
// A custom mapping file was present. Check if it must inherit the default mappings.
String inheritDefaultStr =
customFileMappingProperties.getProperty(PROP_INHERIT_DEFAULT, "true");
if (inheritDefaultStr.equalsIgnoreCase("true")) {
fileMappingProperties.putAll(defaultFileMappingProperties);
}
fileMappingProperties.putAll(customFileMappingProperties);
fileMappingProperties.remove(PROP_INHERIT_DEFAULT);
}
// Copy the files from the AMP file into the WAR file
outputMessage(
"Adding files relating to version '"
+ installingVersion
+ "' of module '"
+ installingId
+ "'");
InstalledFiles installedFiles = new InstalledFiles(warFileLocation, installingId);
for (Map.Entry<Object, Object> entry : fileMappingProperties.entrySet()) {
// The file mappings are expected to start with "/"
String mappingSource = (String) entry.getKey();
if (mappingSource.length() == 0 || !mappingSource.startsWith("/")) {
throw new AlfrescoRuntimeException(
"File mapping sources must start with '/', but was: " + mappingSource);
}
String mappingTarget = (String) entry.getValue();
if (mappingTarget.length() == 0 || !mappingTarget.startsWith("/")) {
throw new AlfrescoRuntimeException(
"File mapping targets must start with '/' but was '" + mappingTarget + "'");
}
// Run throught the files one by one figuring out what we are going to do during the copy
copyToWar(
ampFileLocation,
warFileLocation,
mappingSource,
mappingTarget,
installedFiles,
preview);
if (preview == false) {
// Get a reference to the source folder (if it isn't present don't do anything)
File source = new File(ampFileLocation + "/" + mappingSource, DETECTOR_AMP_AND_WAR);
if (source != null && source.list() != null) {
// Get a reference to the destination folder
File destination =
new File(warFileLocation + "/" + mappingTarget, DETECTOR_AMP_AND_WAR);
if (destination == null) {
throw new ModuleManagementToolException(
"The destination folder '"
+ mappingTarget
+ "' as specified in mapping properties does not exist in the war");
}
// Do the bulk copy since this is quicker than copying files one by one
destination.copyAllFrom(source);
}
}
}
if (preview == false) {
// Save the installed file list
installedFiles.save();
// Update the installed module details
installingModuleDetails.setInstallState(ModuleInstallState.INSTALLED);
installingModuleDetails.setInstallDate(new Date());
ModuleDetailsHelper.saveModuleDetails(warFileLocation, installingModuleDetails);
// Update the zip files
File.update();
// Set the modified date
java.io.File warFile = new java.io.File(warFileLocation);
if (warFile.exists()) {
warFile.setLastModified(System.currentTimeMillis());
}
}
} catch (ZipWarningException ignore) {
// Only instances of the class ZipWarningException exist in the chain of
// exceptions. We choose to ignore this.
} catch (ZipControllerException exception) {
// At least one exception occured which is not just a ZipWarningException.
// This is a severe situation that needs to be handled.
throw new ModuleManagementToolException(
"A Zip error was encountered during deployment of the AEP into the WAR", exception);
} catch (IOException exception) {
throw new ModuleManagementToolException(
"An IO error was encountered during deployment of the AEP into the WAR", exception);
}
}