Package org.nuxeo.ecm.core.trash

Class AbstractTrashService

java.lang.Object

org.nuxeo.ecm.core.trash.AbstractTrashService

All Implemented Interfaces:

TrashService

Direct Known Subclasses:

PropertyTrashService

public abstract class AbstractTrashService
extends Object
implements TrashService

Basic implementation of TrashService.

Since:

10.1

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	AbstractTrashService.PathComparator	Path-based comparator used to put folders before their children.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final Pattern	COLLISION_PATTERN	Matches names resulting from a collision, suffixed with a time in milliseconds, created by DuplicatedNameFixer.
static final String	LEGAL_HOLD_QUERY	Deprecated. since 2023
protected static final String	PATH_SEPARATOR
static final String	RETENTION_QUERY	Deprecated. since 2023
protected static final Pattern	TRASHED_PATTERN	Matches names of documents in the trash, created by TrashService.trashDocuments(List).
static final String	TRASHED_QUERY

Fields inherited from interface org.nuxeo.ecm.core.api.trash.TrashService

ABOUT_TO_TRASH, ABOUT_TO_UNTRASH, DISABLE_TRASH_RENAMING, DOCUMENT_TRASHED, DOCUMENT_UNTRASHED

Constructor Summary

Constructors

Constructor	Description
AbstractTrashService()

Method Summary

Modifier and Type	Method	Description
boolean	canPurgeOrUntrash(List<DocumentModel> docs, NuxeoPrincipal principal)	Are all documents purgeable/undeletable?
protected void	checkCanTrash(DocumentModel model)	Deprecated. since 2023, AbstractSession.canRemoveDocument(DocumentRef) does this check
protected DocumentModel	getAboveDocument(DocumentModel doc, Set<Path> rootPaths)
DocumentModel	getAboveDocument(DocumentModel doc, NuxeoPrincipal principal)	Gets the first non trashed ancestor.
protected static String	getDocumentLocker(DocumentModel doc)
DocumentModelList	getDocuments(DocumentModel parent)	Get all documents from the trash of the current document.
protected String	getFirstGroup(Pattern pattern, String name)
protected TrashInfo	getInfo(List<DocumentModel> docs, NuxeoPrincipal principal, boolean checkProxies, boolean checkDeleted)
protected TrashInfo	getTrashInfo(List<DocumentModel> docs, NuxeoPrincipal principal, boolean checkProxies, boolean checkDeleted)
boolean	isMangledName(String docName)
String	mangleName(DocumentModel doc)	Mangles the name of a document to avoid collisions with non-trashed documents when it's in the trash.
protected void	notifyEvent(CoreSession session, String eventId, DocumentModel doc)
protected void	notifyEvent(CoreSession session, String eventId, DocumentModel doc, boolean immediate)
protected void	notifyEvent(CoreSession session, String eventId, DocumentModel doc, boolean immediate, boolean inline)
void	purgeDocuments(CoreSession session, List<DocumentRef> docRefs)	Purges (completely deletes) documents.
void	purgeDocumentsUnder(DocumentModel parent)	Purges (completely deletes) trashed documents under the given parent.
protected static boolean	underOneOf(Path testedPath, Set<Path> paths)
String	unmangleName(CoreSession session, DocumentRef parentRef, String docName)	Unmangles the name of a document in the trash to find its un-trashed name.
String	unmangleName(DocumentModel doc)	Unmangles the name of a document in the trash to find its un-trashed name.
abstract void	untrashDocuments(List<DocumentModel> docs)	Unmoves documents from the trash.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.nuxeo.ecm.core.api.trash.TrashService

canPurgeOrUntrash, isTrashed, trashDocument, trashDocuments, untrashDocument

Field Details

TRASHED_QUERY

public static final String TRASHED_QUERY

See Also:

• Constant Field Values

RETENTION_QUERY

@Deprecated
public static final String RETENTION_QUERY

Deprecated.

since 2023

See Also:

• Constant Field Values

LEGAL_HOLD_QUERY

@Deprecated
public static final String LEGAL_HOLD_QUERY

Deprecated.

since 2023

See Also:

• Constant Field Values

PATH_SEPARATOR

protected static final String PATH_SEPARATOR

Since:

11.1

See Also:

• Constant Field Values

TRASHED_PATTERN

protected static final Pattern TRASHED_PATTERN

Matches names of documents in the trash, created by TrashService.trashDocuments(List).

COLLISION_PATTERN

protected static final Pattern COLLISION_PATTERN

Matches names resulting from a collision, suffixed with a time in milliseconds, created by DuplicatedNameFixer. We also attempt to remove this when getting a doc out of the trash.

Constructor Details

AbstractTrashService

public AbstractTrashService()

Method Details

canPurgeOrUntrash

public boolean canPurgeOrUntrash(List<DocumentModel> docs,
 NuxeoPrincipal principal)

Description copied from interface: TrashService

Are all documents purgeable/undeletable?

Documents need to be in the trash for this to be true, in addition to the standard permission checks.

Specified by:

canPurgeOrUntrash in interface TrashService

Parameters:

docs - the documents

principal - the current user (to check locks)

Returns:

true if the documents are purgeable/undeletable

getInfo

protected TrashInfo getInfo(List<DocumentModel> docs,
 NuxeoPrincipal principal,
 boolean checkProxies,
 boolean checkDeleted)

getDocumentLocker

protected static String getDocumentLocker(DocumentModel doc)

getTrashInfo

protected TrashInfo getTrashInfo(List<DocumentModel> docs,
 NuxeoPrincipal principal,
 boolean checkProxies,
 boolean checkDeleted)

getAboveDocument

protected DocumentModel getAboveDocument(DocumentModel doc,
 Set<Path> rootPaths)

getAboveDocument

public DocumentModel getAboveDocument(DocumentModel doc,
 NuxeoPrincipal principal)

Description copied from interface: TrashService

Gets the first non trashed ancestor.

This is used to find what safe document to redirect to when deleting one.

Specified by:

getAboveDocument in interface TrashService

Parameters:

doc - the trashed document

principal - the current user

Returns:

the first non trashed ancestor

underOneOf

protected static boolean underOneOf(Path testedPath,
 Set<Path> paths)

purgeDocuments

public void purgeDocuments(CoreSession session,
 List<DocumentRef> docRefs)

Description copied from interface: TrashService

Purges (completely deletes) documents.

Specified by:

purgeDocuments in interface TrashService

Parameters:

session - the session

docRefs - the documents to purge

purgeDocumentsUnder

public void purgeDocumentsUnder(DocumentModel parent)

Description copied from interface: TrashService

Purges (completely deletes) trashed documents under the given parent.

Specified by:

purgeDocumentsUnder in interface TrashService

Parameters:

parent - The parent document of trashed documents.

notifyEvent

protected void notifyEvent(CoreSession session,
 String eventId,
 DocumentModel doc)

notifyEvent

protected void notifyEvent(CoreSession session,
 String eventId,
 DocumentModel doc,
 boolean immediate)

notifyEvent

protected void notifyEvent(CoreSession session,
 String eventId,
 DocumentModel doc,
 boolean immediate,
 boolean inline)

getDocuments

public DocumentModelList getDocuments(DocumentModel parent)

Description copied from interface: TrashService

Get all documents from the trash of the current document.

Specified by:

getDocuments in interface TrashService

Parameters:

parent - The parent document of trash document.

Returns:

All documents in the trash of the current document.

untrashDocuments

public abstract void untrashDocuments(List<DocumentModel> docs)

Description copied from interface: TrashService

Unmoves documents from the trash.

Also fires async events to untrash the children.

Specified by:

untrashDocuments in interface TrashService

Parameters:

docs - the documents to untrash

isMangledName

public boolean isMangledName(String docName)

Specified by:

isMangledName in interface TrashService

Parameters:

docName - the document's name

Returns:

true if the document's name is mangled, false otherwise

mangleName

public String mangleName(DocumentModel doc)

Description copied from interface: TrashService

Mangles the name of a document to avoid collisions with non-trashed documents when it's in the trash.

Specified by:

mangleName in interface TrashService

Parameters:

doc - the document

unmangleName

public String unmangleName(DocumentModel doc)

Description copied from interface: TrashService

Unmangles the name of a document in the trash to find its un-trashed name.

Specified by:

unmangleName in interface TrashService

Parameters:

doc - the trashed document

Returns:

the unmangled name

unmangleName

public String unmangleName(CoreSession session,
 DocumentRef parentRef,
 String docName)

Description copied from interface: TrashService

Unmangles the name of a document in the trash to find its un-trashed name.

Specified by:

unmangleName in interface TrashService

Parameters:

session - the session used for collisions check

parentRef - the parent document ref

docName - the document name

Returns:

the unmangled name

getFirstGroup

protected String getFirstGroup(Pattern pattern,
 String name)

checkCanTrash

@Deprecated
protected void checkCanTrash(DocumentModel model)

Deprecated.

since 2023, AbstractSession.canRemoveDocument(DocumentRef) does this check

Throws a DocumentExistsException if a descendant document cannot be trashed.

Since:

2021.14