de.espirit.firstspirit.storage

Interface HistoryProvider

All Known Subinterfaces:

Body, ChannelSourceProvider, Content2, Content2Section, ContentFolder, ContentProducer, ContentStoreRoot, DataProvider, Dataset, DocumentGroup, FormatTemplate, FormatTemplateContainer, FormatTemplateFolder, FormatTemplates, GCABody, GCAFolder, GCAPage, GCASection, GlobalContentArea, GlobalStoreRoot, GomSourceProvider, IDProvider, LinkTemplate, LinkTemplateFolder, LinkTemplates, MasterTemplate, Media, MediaFolder, MediaStoreRoot, PackagePoolItem, Page, PageFolder, PageRef, PageRefFolder, PageStoreRoot, PageTemplate, PageTemplates, Previewable, PreviewImageProvider, ProjectProperties, Query, Referenceable, Schema, SchemaContainer, SchemaFolder, Schemes, Script, ScriptContainer, ScriptFolder, Scripts, Section<T>, SectionReference<T>, SectionTemplate, SectionTemplates, SiteStoreFolder, SiteStoreRoot, StartNode, Store, StyleTemplate, TableFormatTemplate, TableTemplate, Template, TemplateContainer<T>, TemplateContentProvider, TemplateFolder<T>, TemplateProvider<T>, TemplateStoreElement, TemplateStoreRoot, Workflow, WorkflowContainer, WorkflowFolder, Workflows

public interface HistoryProvider

Interface for providers of historical revision information.

Since:

4.0.42

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	HistoryProvider.RevisionProvider Wrapper on a HistoryProvider to act as ElementProvider on Revisions.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALL_REVISIONS Indicator for retrieving all revisions.
static Date	EVER_SINCE The date all others are after.
static Date	UNTIL_NOW The end of all time.

Method Summary

Methods

Modifier and Type	Method and Description
ElementProvider<Revision>	asRevisionProvider() Return an ElementProvider on this HistoryProvider.
List<Revision>	getHistory() Returns the revisions history of this storeelement, starting with the newest revision descending to the initial revision.
List<Revision>	getHistory(Date before, Date after, int maxCount, Filter<Revision> filter) Returns a list of revisions of this store element in descending order.

Field Detail

ALL_REVISIONS

static final int ALL_REVISIONS

Indicator for retrieving all revisions.

Since:

4.0.42

See Also:

getHistory(Date, Date, int, Filter), Constant Field Values

EVER_SINCE

static final Date EVER_SINCE

The date all others are after.

Since:

4.0.42

See Also:

getHistory(Date, Date, int, Filter)

UNTIL_NOW

static final Date UNTIL_NOW

The end of all time.

Since:

5.0.100

See Also:

getHistory(Date, Date, int, Filter)

Method Detail

getHistory

List<Revision> getHistory()

Returns the revisions history of this storeelement, starting with the newest revision descending to the initial revision.

Returns:

A list of revisions in descending order.

Since:

4.0.34

getHistory

@NotNull
List<Revision> getHistory(@NotNull
                                Date before,
                                @NotNull
                                Date after,
                                int maxCount,
                                @Nullable
                                Filter<Revision> filter)

Returns a list of revisions of this store element in descending order.
All returned revisions are in the specified time range. The list is sorted by time, newest first.

   after                                            before
  ---I-------------------------------------------------I---> time
                        I<---------------------------->I
                         result list containing "maxCount" entries
 

Parameters:

before - Marks upper date bound, so that revisions must be of this date or older to pass. Use UNTIL_NOW to retrieve revisions up to date. Do NOT use new Date()!

after - Marks lower date bound, so that revisions must be of this date or younger to pass. Use EVER_SINCE to retrieve revisions up to beginning of records.

maxCount - The maximum count of returned revisions. Use ALL_REVISIONS to get all revisions in specified time range.

filter - Filter to be passed. If null, accepts all elements. Useful filter implementations can be found in RevisionFilter. See Filter.Util for how to combine filters.

Returns:

A list of revisions that passed the given criteria in descending order.

Since:

4.0.40

asRevisionProvider

@NotNull
ElementProvider<Revision> asRevisionProvider()

Return an ElementProvider on this HistoryProvider.

Returns:

An ElementProvider on Revisions.

Since:

4.0.49