/* * 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.linkvalidation; import java.util.List; import org.alfresco.config.JNDIConstants; import org.alfresco.repo.action.ParameterDefinitionImpl; import org.alfresco.repo.action.executer.ActionExecuterAbstractBase; import org.alfresco.repo.avm.AVMNodeConverter; import org.alfresco.repo.domain.PropertyValue; import org.alfresco.sandbox.SandboxConstants; import org.alfresco.service.cmr.action.Action; import org.alfresco.service.cmr.action.ParameterDefinition; import org.alfresco.service.cmr.avm.AVMService; import org.alfresco.service.cmr.avmsync.AVMSyncException; import org.alfresco.service.cmr.dictionary.DataTypeDefinition; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.util.Pair; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; /** * Performs a link validation check. * * @author gavinc */ public class LinkValidationAction extends ActionExecuterAbstractBase { public static final String NAME = "avm-link-validation"; public static final String PARAM_COMPARE_TO_STAGING = "compare-to-staging"; public static final String PARAM_MONITOR = "monitor"; private LinkValidationService linkValidationService; private AVMService avmService; private int maxNumberLinksInReport = -1; private static Log logger = LogFactory.getLog(LinkValidationAction.class); /** * Sets the LinkValidationService instance to use * * @param service The LinkValidationService instance */ public void setLinkValidationService(LinkValidationService service) { this.linkValidationService = service; } /** * Sets the AVMService instance to use * * @param service The AVMService instance */ public void setAvmService(AVMService service) { this.avmService = service; } /** * Sets the maximum number of links to show in a report * * @param maxLinks The maximum number of links to store in the report, * -1 will store all links but this must be used with * extreme caution as the report is stored as a BLOB * in the underlying database and these have different * maximum sizes */ public void setMaxNumberLinksInReport(int maxLinks) { this.maxNumberLinksInReport = maxLinks; } @Override protected void addParameterDefinitions(List paramList) { paramList.add(new ParameterDefinitionImpl(PARAM_COMPARE_TO_STAGING, DataTypeDefinition.BOOLEAN, false, getParamDisplayLabel(PARAM_COMPARE_TO_STAGING))); paramList.add(new ParameterDefinitionImpl(PARAM_MONITOR, DataTypeDefinition.ANY, false, getParamDisplayLabel(PARAM_MONITOR))); } @Override protected void executeImpl(Action action, NodeRef actionedUponNodeRef) { // get the webapp path to check the links for (is represented by the actioned upon node) Pair avmVersionPath = AVMNodeConverter.ToAVMVersionPath(actionedUponNodeRef); String webappPath = avmVersionPath.getSecond(); // get store name and path parts. String [] webappParts = webappPath.split(":"); if (webappParts.length != 2) { throw new AVMSyncException("Malformed source path: " + webappPath); } // extract the store name String storeName = actionedUponNodeRef.getStoreRef().getIdentifier(); // extract the webapp name String webappName = webappPath.substring(webappPath.lastIndexOf("/")+1); // get the compare to staging flag String destWebappPath = null; Boolean compareToStaging = (Boolean)action.getParameterValue(PARAM_COMPARE_TO_STAGING); if (compareToStaging != null) { if (compareToStaging.booleanValue()) { // get the corresponding path in the staging area for the given source PropertyValue val = this.avmService.getStoreProperty(storeName, SandboxConstants.PROP_WEBSITE_NAME); if (val != null) { String stagingStoreName = val.getStringValue(); destWebappPath = stagingStoreName + ":/" + JNDIConstants.DIR_DEFAULT_WWW + "/" + JNDIConstants.DIR_DEFAULT_APPBASE + "/" + webappName; } } } // get the monitor object HrefValidationProgress monitor = (HrefValidationProgress)action.getParameterValue(PARAM_MONITOR); if (logger.isDebugEnabled()) { if (destWebappPath == null) { logger.debug("Performing link validation check for webapp '" + webappPath + "', storing a maximum of " + this.maxNumberLinksInReport + " broken links"); } else { logger.debug("Performing link validation check for webapp '" + webappPath + "', comparing against '" + destWebappPath + "', storing a maximum of " + this.maxNumberLinksInReport + " broken links"); } } LinkValidationReport report = null; try { // determine which API to call depending on whether there is a destination webapp present if (destWebappPath != null) { // get the object to represent the broken files HrefDifference hdiff = this.linkValidationService.getHrefDifference( webappPath, destWebappPath, monitor); // get the broken files created due to deletions and new/modified files HrefManifest manifest = this.linkValidationService.getBrokenHrefManifest(hdiff); // create the report object using the 2 sets of results report = new LinkValidationReport(storeName, webappName, manifest, monitor.getFileUpdateCount(), monitor.getUrlUpdateCount(), this.maxNumberLinksInReport); } else { // retrieve the manifest of all the broken links and files for the webapp HrefManifest manifest = this.linkValidationService.getBrokenHrefManifest(webappPath); // Create the report object using the link check results report = new LinkValidationReport(storeName, webappName, manifest, manifest.getBaseFileCount(), manifest.getBaseLinkCount(), this.maxNumberLinksInReport); // the monitor object is not used here so manually set // the done status so the client can retrieve the report. monitor.setDone( true ); } } catch (Throwable err) { // capture the error in the report if (report != null) { report.setError(err); } else { report = new LinkValidationReport(storeName, webappName, err); } // set the monitor object as completed if (monitor != null) { monitor.setDone(true); } logger.error("Link Validation Error: ", err); } // store the report as a store property on the store we ran the link check on this.avmService.deleteStoreProperty(storeName, SandboxConstants.PROP_LINK_VALIDATION_REPORT); this.avmService.setStoreProperty(storeName, SandboxConstants.PROP_LINK_VALIDATION_REPORT, new PropertyValue(DataTypeDefinition.ANY, report)); } }