org.apache.jackrabbit.oak.plugins.document

Class DocumentNodeStoreBuilder<T extends DocumentNodeStoreBuilder<T>>

java.lang.Object

org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreBuilder<T>

Direct Known Subclasses:

MongoDocumentNodeStoreBuilderBase, RDBDocumentNodeStoreBuilder

public class DocumentNodeStoreBuilder<T extends DocumentNodeStoreBuilder<T>>
extends Object

A generic builder for a DocumentNodeStore. By default the builder will create an in-memory DocumentNodeStore. In most cases this is only useful for tests.

Field Summary

Fields

Modifier and Type	Field and Description
protected com.google.common.base.Supplier<BlobStore>	blobStoreSupplier
static int	DEFAULT_CACHE_SEGMENT_COUNT
static int	DEFAULT_CACHE_STACK_MOVE_DISTANCE
static int	DEFAULT_CHILDREN_CACHE_PERCENTAGE
static int	DEFAULT_DIFF_CACHE_PERCENTAGE
static long	DEFAULT_MEMORY_CACHE_SIZE
static int	DEFAULT_NODE_CACHE_PERCENTAGE
static int	DEFAULT_PREV_DOC_CACHE_PERCENTAGE
static int	DEFAULT_UPDATE_LIMIT
protected com.google.common.base.Supplier<DocumentStore>	documentStoreSupplier

Constructor Summary

Constructors

Constructor and Description
DocumentNodeStoreBuilder()

Method Summary

Modifier and Type	Method and Description
DocumentNodeStore	build()
com.google.common.cache.Cache<NamePathRev,DocumentNodeState.Children>	buildChildrenCache(DocumentNodeStore store)
com.google.common.cache.Cache<CacheValue,NodeDocument>	buildDocumentCache(DocumentStore docStore)
com.google.common.cache.Cache<RevisionsKey,LocalDiffCache.Diff>	buildLocalDiffCache()
com.google.common.cache.Cache<CacheValue,StringValue>	buildMemoryDiffCache()
com.google.common.cache.Cache<PathRev,DocumentNodeState>	buildNodeCache(DocumentNodeStore store)
NodeDocumentCache	buildNodeDocumentCache(DocumentStore docStore, NodeDocumentLocks locks)
com.google.common.cache.Cache<StringValue,NodeDocument>	buildPrevDocumentsCache(DocumentStore docStore)
T	clock(Clock clock)
MissingLastRevSeeker	createMissingLastRevSeeker()
Iterable<ReferencedBlob>	createReferencedBlobs(DocumentNodeStore ns)
VersionGCSupport	createVersionGCSupport()
T	disableBranches()
int	getAsyncDelay()
BlobStore	getBlobStore()
@Nullable CacheStats	getBlobStoreCacheStats()
@Nullable BlobStoreStats	getBlobStoreStats()
long	getChildrenCacheSize()
Clock	getClock()
int	getClusterId()
int	getCommitValueCacheSize()
org.apache.jackrabbit.oak.plugins.document.DiffCache	getDiffCache(int clusterId)
long	getDiffCacheSize()
long	getDocumentCacheSize()
DocumentStore	getDocumentStore()
DocumentStoreStatsCollector	getDocumentStoreStatsCollector()
Executor	getExecutor()
GCMonitor	getGCMonitor()
long	getJournalGCMaxAge() The maximum age for journal entries in milliseconds.
JournalPropertyHandlerFactory	getJournalPropertyHandlerFactory()
boolean	getLeaseCheck() Deprecated. This method does not distinguish between LeaseCheckMode.LENIENT and LeaseCheckMode.STRICT and returns true for both modes. Use getLeaseCheckMode() instead.
LeaseFailureHandler	getLeaseFailureHandler()
long	getLocalDiffCacheSize()
boolean	getLogging()
long	getMemoryDiffCacheSize()
com.google.common.base.Predicate<Path>	getNodeCachePathPredicate()
com.google.common.base.Predicate<String>	getNodeCachePredicate() Deprecated. Use getNodeCachePathPredicate() instead.
long	getNodeCacheSize()
DocumentNodeStoreStatsCollector	getNodeStoreStatsCollector()
@NotNull Map<String,PersistentCacheStats>	getPersistenceCacheStats()
PersistentCache	getPersistentCache()
long	getPrevDocumentCacheSize()
boolean	getReadOnlyMode()
StatisticsProvider	getStatisticsProvider()
boolean	getTiming()
int	getUpdateLimit()
com.google.common.cache.Weigher<CacheValue,CacheValue>	getWeigher()
boolean	isBundlingDisabled()
boolean	isDisableBranches()
boolean	isPrefetchExternalChanges()
boolean	isUseSimpleRevision()
T	memoryCacheDistribution(int nodeCachePercentage, int prevDocCachePercentage, int childrenCachePercentage, int diffCachePercentage)
T	memoryCacheSize(long memoryCacheSize)
static DocumentNodeStoreBuilder<?>	newDocumentNodeStoreBuilder()
T	setAsyncDelay(int asyncDelay) Set the maximum delay to write the last revision to the root node.
T	setBlobStore(BlobStore blobStore) Set the blob store to use.
T	setBundlingDisabled(boolean enabled)
T	setCacheSegmentCount(int cacheSegmentCount)
T	setCacheStackMoveDistance(int cacheSegmentCount)
T	setClusterId(int clusterId) Set the cluster id to use.
T	setCommitValueCacheSize(int cacheSize)
T	setDocumentStore(DocumentStore documentStore) Set the document store to use.
T	setDocumentStoreStatsCollector(DocumentStoreStatsCollector documentStoreStatsCollector)
T	setExecutor(Executor executor)
T	setGCMonitor(@NotNull GCMonitor gcMonitor)
T	setJournalCache(String journalCache) Sets the journal cache option.
T	setJournalGCMaxAge(long maxRevisionAgeMillis)
T	setJournalPropertyHandlerFactory(JournalPropertyHandlerFactory factory)
T	setLeaseCheck(boolean leaseCheck) Deprecated. use setLeaseCheckMode(LeaseCheckMode) instead.
T	setLeaseCheckMode(LeaseCheckMode mode)
T	setLeaseFailureHandler(LeaseFailureHandler leaseFailureHandler)
T	setLogging(boolean logging)
T	setNodeCachePathPredicate(com.google.common.base.Predicate<Path> p)
T	setNodeCachePredicate(com.google.common.base.Predicate<String> p) Deprecated. Use setNodeCachePathPredicate(Predicate) instead.
T	setNodeStoreStatsCollector(DocumentNodeStoreStatsCollector statsCollector)
T	setPersistentCache(String persistentCache) Sets the persistent cache option.
T	setPrefetchExternalChanges(boolean b)
T	setReadOnlyMode()
T	setStatisticsProvider(StatisticsProvider statisticsProvider)
T	setTiming(boolean timing) Use the timing document store wrapper.
T	setUpdateLimit(int limit)
T	setUseSimpleRevision(boolean useSimpleRevision)
protected T	thisBuilder()
T	withWeigher(com.google.common.cache.Weigher<CacheValue,CacheValue> weigher)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MEMORY_CACHE_SIZE

public static final long DEFAULT_MEMORY_CACHE_SIZE

See Also:

Constant Field Values

DEFAULT_NODE_CACHE_PERCENTAGE

public static final int DEFAULT_NODE_CACHE_PERCENTAGE

See Also:

Constant Field Values

DEFAULT_PREV_DOC_CACHE_PERCENTAGE

public static final int DEFAULT_PREV_DOC_CACHE_PERCENTAGE

See Also:

Constant Field Values

DEFAULT_CHILDREN_CACHE_PERCENTAGE

public static final int DEFAULT_CHILDREN_CACHE_PERCENTAGE

See Also:

Constant Field Values

DEFAULT_DIFF_CACHE_PERCENTAGE

public static final int DEFAULT_DIFF_CACHE_PERCENTAGE

See Also:

Constant Field Values

DEFAULT_CACHE_SEGMENT_COUNT

public static final int DEFAULT_CACHE_SEGMENT_COUNT

See Also:

Constant Field Values

DEFAULT_CACHE_STACK_MOVE_DISTANCE

public static final int DEFAULT_CACHE_STACK_MOVE_DISTANCE

See Also:

Constant Field Values

DEFAULT_UPDATE_LIMIT

public static final int DEFAULT_UPDATE_LIMIT

See Also:

Constant Field Values

documentStoreSupplier

protected com.google.common.base.Supplier<DocumentStore> documentStoreSupplier

blobStoreSupplier

protected com.google.common.base.Supplier<BlobStore> blobStoreSupplier

Constructor Detail

DocumentNodeStoreBuilder

public DocumentNodeStoreBuilder()

Method Detail

newDocumentNodeStoreBuilder

public static DocumentNodeStoreBuilder<?> newDocumentNodeStoreBuilder()

Returns:

a new DocumentNodeStoreBuilder.

build

public DocumentNodeStore build()

thisBuilder

protected final T thisBuilder()

setPersistentCache

public T setPersistentCache(String persistentCache)

Sets the persistent cache option.

Returns:

this

setJournalCache

public T setJournalCache(String journalCache)

Sets the journal cache option.

Returns:

this

setTiming

public T setTiming(boolean timing)

Use the timing document store wrapper.

Parameters:

timing - whether to use the timing wrapper.

Returns:

this

getTiming

public boolean getTiming()

setLogging

public T setLogging(boolean logging)

getLogging

public boolean getLogging()

setLeaseCheck

@Deprecated
public T setLeaseCheck(boolean leaseCheck)

Deprecated. use setLeaseCheckMode(LeaseCheckMode) instead.

If true, sets lease check mode to LeaseCheckMode.LENIENT, otherwise sets the mode to LeaseCheckMode.DISABLED. This method is only kept for backward compatibility with the behaviour before OAK-7626. The new default lease check mode is LeaseCheckMode.STRICT, but existing code may rely on the previous behaviour, when enabling the lease check corresponded with a LeaseCheckMode.LENIENT behaviour.

getLeaseCheck

@Deprecated
public boolean getLeaseCheck()

Deprecated. This method does not distinguish between LeaseCheckMode.LENIENT and LeaseCheckMode.STRICT and returns true for both modes. Use getLeaseCheckMode() instead.

setLeaseCheckMode

public T setLeaseCheckMode(LeaseCheckMode mode)

setReadOnlyMode

public T setReadOnlyMode()

getReadOnlyMode

public boolean getReadOnlyMode()

setLeaseFailureHandler

public T setLeaseFailureHandler(LeaseFailureHandler leaseFailureHandler)

getLeaseFailureHandler

public LeaseFailureHandler getLeaseFailureHandler()

setDocumentStore

public T setDocumentStore(DocumentStore documentStore)

Set the document store to use. By default an in-memory store is used.

Parameters:

documentStore - the document store

Returns:

this

getDocumentStore

public DocumentStore getDocumentStore()

getDiffCache

public org.apache.jackrabbit.oak.plugins.document.DiffCache getDiffCache(int clusterId)

setBlobStore

public T setBlobStore(BlobStore blobStore)

Set the blob store to use. By default an in-memory store is used.

Parameters:

blobStore - the blob store

Returns:

this

getBlobStore

public BlobStore getBlobStore()

setClusterId

public T setClusterId(int clusterId)

Set the cluster id to use. By default, 0 is used, meaning the cluster id is automatically generated.

Parameters:

clusterId - the cluster id

Returns:

this

setCacheSegmentCount

public T setCacheSegmentCount(int cacheSegmentCount)

setCacheStackMoveDistance

public T setCacheStackMoveDistance(int cacheSegmentCount)

getClusterId

public int getClusterId()

setAsyncDelay

public T setAsyncDelay(int asyncDelay)

Set the maximum delay to write the last revision to the root node. By default 1000 (meaning 1 second) is used.

Parameters:

asyncDelay - in milliseconds

Returns:

this

getAsyncDelay

public int getAsyncDelay()

getWeigher

public com.google.common.cache.Weigher<CacheValue,CacheValue> getWeigher()

withWeigher

public T withWeigher(com.google.common.cache.Weigher<CacheValue,CacheValue> weigher)

memoryCacheSize

public T memoryCacheSize(long memoryCacheSize)

memoryCacheDistribution

public T memoryCacheDistribution(int nodeCachePercentage,
                                 int prevDocCachePercentage,
                                 int childrenCachePercentage,
                                 int diffCachePercentage)

getNodeCacheSize

public long getNodeCacheSize()

getPrevDocumentCacheSize

public long getPrevDocumentCacheSize()

getChildrenCacheSize

public long getChildrenCacheSize()

getDocumentCacheSize

public long getDocumentCacheSize()

getDiffCacheSize

public long getDiffCacheSize()

getMemoryDiffCacheSize

public long getMemoryDiffCacheSize()

getLocalDiffCacheSize

public long getLocalDiffCacheSize()

setUseSimpleRevision

public T setUseSimpleRevision(boolean useSimpleRevision)

isUseSimpleRevision

public boolean isUseSimpleRevision()

getExecutor

public Executor getExecutor()

setExecutor

public T setExecutor(Executor executor)

clock

public T clock(Clock clock)

setStatisticsProvider

public T setStatisticsProvider(StatisticsProvider statisticsProvider)

getStatisticsProvider

public StatisticsProvider getStatisticsProvider()

getDocumentStoreStatsCollector

public DocumentStoreStatsCollector getDocumentStoreStatsCollector()

setDocumentStoreStatsCollector

public T setDocumentStoreStatsCollector(DocumentStoreStatsCollector documentStoreStatsCollector)

getNodeStoreStatsCollector

public DocumentNodeStoreStatsCollector getNodeStoreStatsCollector()

setNodeStoreStatsCollector

public T setNodeStoreStatsCollector(DocumentNodeStoreStatsCollector statsCollector)

getPersistenceCacheStats

@NotNull
public @NotNull Map<String,PersistentCacheStats> getPersistenceCacheStats()

getBlobStoreStats

@Nullable
public @Nullable BlobStoreStats getBlobStoreStats()

getBlobStoreCacheStats

@Nullable
public @Nullable CacheStats getBlobStoreCacheStats()

getClock

public Clock getClock()

disableBranches

public T disableBranches()

isDisableBranches

public boolean isDisableBranches()

setBundlingDisabled

public T setBundlingDisabled(boolean enabled)

isBundlingDisabled

public boolean isBundlingDisabled()

setPrefetchExternalChanges

public T setPrefetchExternalChanges(boolean b)

isPrefetchExternalChanges

public boolean isPrefetchExternalChanges()

setJournalPropertyHandlerFactory

public T setJournalPropertyHandlerFactory(JournalPropertyHandlerFactory factory)

getJournalPropertyHandlerFactory

public JournalPropertyHandlerFactory getJournalPropertyHandlerFactory()

setUpdateLimit

public T setUpdateLimit(int limit)

getUpdateLimit

public int getUpdateLimit()

setCommitValueCacheSize

public T setCommitValueCacheSize(int cacheSize)

getCommitValueCacheSize

public int getCommitValueCacheSize()

setJournalGCMaxAge

public T setJournalGCMaxAge(long maxRevisionAgeMillis)

getJournalGCMaxAge

public long getJournalGCMaxAge()

The maximum age for journal entries in milliseconds. Older entries are candidates for GC.

Returns:

maximum age for journal entries in milliseconds.

setGCMonitor

public T setGCMonitor(@NotNull
                      @NotNull GCMonitor gcMonitor)

getGCMonitor

public GCMonitor getGCMonitor()

createVersionGCSupport

public VersionGCSupport createVersionGCSupport()

createReferencedBlobs

public Iterable<ReferencedBlob> createReferencedBlobs(DocumentNodeStore ns)

createMissingLastRevSeeker

public MissingLastRevSeeker createMissingLastRevSeeker()

buildNodeCache

public com.google.common.cache.Cache<PathRev,DocumentNodeState> buildNodeCache(DocumentNodeStore store)

buildChildrenCache

public com.google.common.cache.Cache<NamePathRev,DocumentNodeState.Children> buildChildrenCache(DocumentNodeStore store)

buildMemoryDiffCache

public com.google.common.cache.Cache<CacheValue,StringValue> buildMemoryDiffCache()

buildLocalDiffCache

public com.google.common.cache.Cache<RevisionsKey,LocalDiffCache.Diff> buildLocalDiffCache()

buildDocumentCache

public com.google.common.cache.Cache<CacheValue,NodeDocument> buildDocumentCache(DocumentStore docStore)

buildPrevDocumentsCache

public com.google.common.cache.Cache<StringValue,NodeDocument> buildPrevDocumentsCache(DocumentStore docStore)

buildNodeDocumentCache

public NodeDocumentCache buildNodeDocumentCache(DocumentStore docStore,
                                                NodeDocumentLocks locks)

setNodeCachePredicate

@Deprecated
public T setNodeCachePredicate(com.google.common.base.Predicate<String> p)

Deprecated. Use setNodeCachePathPredicate(Predicate) instead.

getNodeCachePredicate

@Deprecated
public com.google.common.base.Predicate<String> getNodeCachePredicate()

Deprecated. Use getNodeCachePathPredicate() instead.

setNodeCachePathPredicate

public T setNodeCachePathPredicate(com.google.common.base.Predicate<Path> p)

getNodeCachePathPredicate

public com.google.common.base.Predicate<Path> getNodeCachePathPredicate()

getPersistentCache

public PersistentCache getPersistentCache()