org.alfresco.repo.content.cleanup

Class EagerContentStoreCleaner

java.lang.Object

org.alfresco.repo.transaction.TransactionListenerAdapter

org.alfresco.repo.content.cleanup.EagerContentStoreCleaner

All Implemented Interfaces:

org.alfresco.util.transaction.TransactionListener

public class EagerContentStoreCleaner
extends TransactionListenerAdapter

This component is responsible cleaning up orphaned content.

Clean-up happens at two levels.

Eager cleanup: (since 3.2)

If eager cleanup is activated, then this component listens to all content property change events and recorded for post-transaction processing. All orphaned content is deleted from the registered store(s). Note that any listeners are called as normal; backup or scrubbing procedures should be plugged in as listeners if this is required.

Lazy cleanup:

This is triggered by means of a Quartz job. This is a heavy-weight process that effectively compares the database metadata with the content URLs controlled by the various stores. Once again, the listeners are called appropriately.

How backup policies are affected:

When restoring the system from a backup, the type of restore required is dictated by the cleanup policy being enforced. If eager cleanup is active, the system must
(a) have a listeners configured to backup the deleted content e.g. DeletedContentBackupCleanerListener, or
(b) ensure consistent backups across the database and content stores: backup when the system is not running; use a DB-based content store. This is the recommended route when running with eager cleanup.

Lazy cleanup protects the content for a given period (e.g. 7 days) giving plenty of time for a backup to be taken; this allows hot backup without needing metadata-content consistency to be enforced.

Author:

Derek Hulley

Constructor Summary

Constructors

Constructor and Description
EagerContentStoreCleaner()

Method Summary

Modifier and Type	Method and Description
void	afterCommit() Cleans up all newly-orphaned content
void	afterRollback() Invoked after transaction rollback.
protected boolean	deleteFromStore(String contentUrl, org.alfresco.repo.content.ContentStore store) Attempts to delete the URL from the store, catching and reporing errors.
boolean	deleteFromStores(String contentUrl) Delete the content URL from all stores Note that listeners are called for this process.
void	init() Initializes the cleaner based on the eagerCleanup flag.
void	registerNewContentUrl(String contentUrl) Queues orphaned content for post-transaction removal
boolean	registerOrphanedContentUrl(String contentUrl) Queues orphaned content for post-transaction removal NB: Any content registered will be deleted if the current transaction commits and if 'eager' cleanup is turned on.
boolean	registerOrphanedContentUrl(String contentUrl, boolean force) Queues orphaned content for post-transaction removal NB: Any content registered will be deleted if the current transaction commits and if 'eager' cleanup is turned on OR if 'force' is true.
void	setEagerOrphanCleanup(boolean eagerOrphanCleanup)
void	setListeners(List<ContentStoreCleanerListener> listeners)
void	setStores(List<org.alfresco.repo.content.ContentStore> stores)

Methods inherited from class org.alfresco.repo.transaction.TransactionListenerAdapter

beforeCommit, beforeCompletion, flush

Methods inherited from class java.lang.Object

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

Constructor Detail

EagerContentStoreCleaner

public EagerContentStoreCleaner()

Method Detail

setEagerOrphanCleanup

public void setEagerOrphanCleanup(boolean eagerOrphanCleanup)

Parameters:

eagerOrphanCleanup - true to enable this component, otherwise false

setStores

public void setStores(List<org.alfresco.repo.content.ContentStore> stores)

Parameters:

stores - the content stores to clean

setListeners

public void setListeners(List<ContentStoreCleanerListener> listeners)

Parameters:

listeners - the listeners that can react to deletions

init

public void init()

Initializes the cleaner based on the eagerCleanup flag.

registerNewContentUrl

public void registerNewContentUrl(String contentUrl)

Queues orphaned content for post-transaction removal

registerOrphanedContentUrl

public boolean registerOrphanedContentUrl(String contentUrl)

Queues orphaned content for post-transaction removal

NB: Any content registered will be deleted if the current transaction commits and if 'eager' cleanup is turned on.

Note that listeners are not called for this process.

Returns:

Returns true if the content was scheduled for post-transaction deletion. If the return value is true then the calling code must delete the row entry for the content URL provided BEFORE THE TRANSACTION COMMITS!

registerOrphanedContentUrl

public boolean registerOrphanedContentUrl(String contentUrl,
                                          boolean force)

Queues orphaned content for post-transaction removal

NB: Any content registered will be deleted if the current transaction commits and if 'eager' cleanup is turned on OR if 'force' is true.

Note that listeners are not called for this process.

Parameters:

force - true for force the post-commit URL deletion regardless of the setting setEagerOrphanCleanup(boolean).

Returns:

Returns true if the content was scheduled for post-transaction deletion. If the return value is true then the calling code must delete the row entry for the content URL provided BEFORE THE TRANSACTION COMMITS!

afterCommit

public void afterCommit()

Cleans up all newly-orphaned content

Specified by:

afterCommit in interface org.alfresco.util.transaction.TransactionListener

Overrides:

afterCommit in class TransactionListenerAdapter

afterRollback

public void afterRollback()

Description copied from class: TransactionListenerAdapter

Invoked after transaction rollback.

Any exceptions generated here will only be logged and will have no effect on the state of the transaction.

Although all transaction resources are still available, this method should be used only for cleaning up resources after a rollback has occured.

Specified by:

afterRollback in interface org.alfresco.util.transaction.TransactionListener

Overrides:

afterRollback in class TransactionListenerAdapter

deleteFromStores

public boolean deleteFromStores(String contentUrl)

Delete the content URL from all stores

Note that listeners are called for this process.

Parameters:

contentUrl - the URL to delete

Returns:

Returns true if all deletes were successful

deleteFromStore

protected boolean deleteFromStore(String contentUrl,
                                  org.alfresco.repo.content.ContentStore store)

Attempts to delete the URL from the store, catching and reporing errors.