mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-10-29 15:21:53 +00:00
6afb44e712
125606 rmunteanu: Merged 5.1.1 (5.1.1) to 5.1.N (5.1.2)
125515 slanglois: MNT-16155 Update source headers - add new Copyrights for Java and JSP source files + automatic check in the build
git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/BRANCHES/DEV/5.2.N/root@125788 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
105 lines
3.9 KiB
Java
105 lines
3.9 KiB
Java
/*
|
|
* #%L
|
|
* Alfresco Repository
|
|
* %%
|
|
* Copyright (C) 2005 - 2016 Alfresco Software Limited
|
|
* %%
|
|
* This file is part of the Alfresco software.
|
|
* If the software was purchased under a paid Alfresco license, the terms of
|
|
* the paid license agreement will prevail. Otherwise, the software is
|
|
* provided under the following open source license terms:
|
|
*
|
|
* Alfresco is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* Alfresco 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 Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
|
|
* #L%
|
|
*/
|
|
package org.alfresco.repo.admin.patch;
|
|
|
|
import java.util.Date;
|
|
import java.util.List;
|
|
|
|
/**
|
|
* Manages patches applied against the repository.
|
|
* <p>
|
|
* Patches are injected into this class and any attempted applications are recorded for later auditing.
|
|
*
|
|
* @since 1.2
|
|
* @author Derek Hulley
|
|
*/
|
|
public interface PatchService
|
|
{
|
|
/**
|
|
* Registers a patch with the service that executes them.
|
|
*
|
|
* @param patch
|
|
* the patch to register
|
|
*/
|
|
public void registerPatch(Patch patch);
|
|
|
|
/**
|
|
* Does some up-front validation on the patches, specifically to see if they all apply to the current server version
|
|
* and not some future version. This is to prevent tampering with versioning information attached to a license.
|
|
*
|
|
* @return true if validation is successful. Outputs errors and returns false otherwise.
|
|
*/
|
|
public boolean validatePatches();
|
|
|
|
/**
|
|
* Apply all outstanding patches that are relevant to the repo. If there is a failure, then the patches that were
|
|
* applied will remain so, but the process will not attempt to apply any further patches.
|
|
*
|
|
* @return Returns true if all outstanding patches were applied, or false if the process was terminated before all
|
|
* patches could be applied.
|
|
*/
|
|
public boolean applyOutstandingPatches();
|
|
|
|
/**
|
|
* Apply the specified patch that is relevant to the repo, regardless of the <b>deferred</b> flag.
|
|
*
|
|
* @param patch the patch object
|
|
* @return true if the specified patch and its dependencies were applied, or
|
|
* false if the process was terminated before all patches could be applied.
|
|
*/
|
|
public boolean applyOutstandingPatch(Patch patch);
|
|
|
|
/**
|
|
* Retrieves all applied patches between two specific times.
|
|
*
|
|
* @param fromDate
|
|
* the start date of the search, or null to get all patches from the start
|
|
* @param toDate
|
|
* the end date of the search, or null to g
|
|
* @return Returns all applied patches (successful or not)
|
|
*/
|
|
public List<AppliedPatch> getPatches(Date fromDate, Date toDate);
|
|
|
|
/**
|
|
* Retrieve an existing patch
|
|
*
|
|
* @param id the patch unique ID
|
|
* @return Returns the patch instance or <tt>null</tt> if one has not been persisted
|
|
*/
|
|
public AppliedPatch getPatch(String id);
|
|
|
|
/**
|
|
* Does some up-front validation on the specified patch, specifically to see
|
|
* if it applies to the current server version and not some future version.
|
|
* This is to prevent tampering with versioning information attached to a
|
|
* license.
|
|
*
|
|
* @param patch the patch object
|
|
* @return true if validation is successful. Outputs errors and returns false otherwise.
|
|
*/
|
|
public boolean validatePatch(Patch patch);
|
|
}
|