mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-10-08 14:51:49 +00:00
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
118 lines
3.6 KiB
Java
118 lines
3.6 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.transfer;
|
|
|
|
import org.alfresco.service.cmr.repository.NodeRef;
|
|
import org.alfresco.service.cmr.transfer.TransferException;
|
|
import org.alfresco.service.cmr.transfer.TransferProgress;
|
|
|
|
/**
|
|
* Used to log relevant changes to transfered files into a summary report of the
|
|
* entire replication job;
|
|
*
|
|
* It should log: created files, deleted, moved, *modified files and relevant
|
|
* errors while handling the files;
|
|
*
|
|
* *modified: each implementation would chose the definition of modified(actual
|
|
* content modification/ new version/ some properties updated)
|
|
*
|
|
*/
|
|
public interface TransferSummaryReport
|
|
{
|
|
|
|
/**
|
|
* Log the creation of a new node
|
|
*
|
|
* @param sourceNode NodeRef
|
|
* @param destNode NodeRef
|
|
* @param newParent NodeRef
|
|
* @param newPath String
|
|
* @param orphan boolean
|
|
*/
|
|
void logSummaryCreated(NodeRef sourceNode, NodeRef destNode, NodeRef newParent, String newPath, boolean orphan);
|
|
|
|
/**
|
|
* Log the creation of a new node
|
|
*
|
|
* @param sourceNode NodeRef
|
|
* @param destNode NodeRef
|
|
* @param path The path of the updated node
|
|
*/
|
|
void logSummaryUpdated(NodeRef sourceNode, NodeRef destNode, String path);
|
|
|
|
/**
|
|
* Log the deletion of a node
|
|
*
|
|
* @param sourceNode NodeRef
|
|
* @param destNode NodeRef
|
|
* @param path The path of the updated node
|
|
*/
|
|
void logSummaryDeleted(NodeRef sourceNode, NodeRef destNode, String path);
|
|
|
|
/**
|
|
* After the transfer has completed this method reads the log.
|
|
*
|
|
* @param sourceNodeRef NodeRef
|
|
* @param destNodeRef NodeRef
|
|
* @param oldPath String
|
|
* @param newParent NodeRef
|
|
* @param newPath String
|
|
*
|
|
*/
|
|
void logSummaryMoved(NodeRef sourceNodeRef, NodeRef destNodeRef, String oldPath, NodeRef newParent, String newPath);
|
|
|
|
/**
|
|
* log an ad-hoc message
|
|
*
|
|
* @param obj Object
|
|
* @throws TransferException
|
|
*/
|
|
void logSummaryComment(Object obj) throws TransferException;
|
|
|
|
/**
|
|
* log an ad-hoc message and an exception
|
|
*
|
|
* @param obj Object
|
|
* @param ex Throwable
|
|
* @throws TransferException
|
|
*/
|
|
void logSummaryException(Object obj, Throwable ex) throws TransferException;
|
|
|
|
/**
|
|
* update the status of the transfer
|
|
*
|
|
* @param status TransferProgress.Status
|
|
* @throws TransferException
|
|
*/
|
|
void logSummaryUpdateStatus(TransferProgress.Status status) throws TransferException;
|
|
|
|
/**
|
|
* called to close the report file
|
|
*/
|
|
void finishSummaryReport();
|
|
|
|
}
|