org.apache.jackrabbit.oak

Class Oak

java.lang.Object

org.apache.jackrabbit.oak.Oak

public class Oak
extends Object

Builder class for constructing ContentRepository instances with a set of specified plugin components. This class acts as a public facade that hides the internal implementation classes and the details of how they get instantiated and wired together.

Since:

Oak 0.6

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Oak.OakDefaultComponents

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_WORKSPACE_NAME Constant for the default workspace name

Constructor Summary

Constructors

Constructor and Description
Oak()
Oak(NodeStore store)

Method Summary

Modifier and Type	Method and Description
ContentRepository	createContentRepository() Returns the content repository instance created with the given configuration.
ContentSession	createContentSession() Creates a content repository with the given configuration and logs in to the default workspace with no credentials, returning the resulting content session.
Root	createRoot() Creates a content repository with the given configuration and returns a Root instance after logging in to the default workspace with no credentials.
static ExecutorService	defaultExecutorService() Default ExecutorService used for scheduling concurrent tasks.
static ScheduledExecutorService	defaultScheduledExecutor() Default ScheduledExecutorService used for scheduling background tasks.
Whiteboard	getWhiteboard()
Oak	with(Clusterable c) Define the current repository as being a Clusterable one.
Oak	with(CommitHook hook) Associates the given commit hook with the repository to be created.
Oak	with(ConflictHandler conflictHandler) Deprecated. Use with(ThreeWayConflictHandler) instead
Oak	with(Editor editor) Associates the given editor with the repository to be created.
Oak	with(EditorProvider provider) Associates the given editor provider with the repository to be created.
Oak	with(Executor executor)
Oak	with(IndexEditorProvider provider) Associates the given index hook provider with the repository to be created.
Oak	with(MBeanServer mbeanServer)
Oak	with(Observer observer)
Oak	with(QueryIndexProvider provider) Associates the given query index provider with the repository to be created.
Oak	with(QueryLimits settings)
Oak	with(RepositoryInitializer initializer)
Oak	with(ScheduledExecutorService scheduledExecutor)
Oak	with(SecurityProvider securityProvider)
Oak	with(String defaultWorkspaceName) Sets the default workspace name that should be used in case of login with null workspace name.
Oak	with(ThreeWayConflictHandler conflictHandler)
Oak	with(Whiteboard whiteboard)
Oak	withAsyncIndexing() Deprecated. Use withAsyncIndexing(String, long) instead
Oak	withAsyncIndexing(String name, long delayInSeconds) Enable the asynchronous (background) indexing behavior for the provided task name.
Oak	withAtomicCounter()
Oak	withFailOnMissingIndexProvider()

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_WORKSPACE_NAME

public static final String DEFAULT_WORKSPACE_NAME

Constant for the default workspace name

See Also:

Constant Field Values

Constructor Detail

Oak

public Oak(NodeStore store)

Oak

public Oak()

Method Detail

defaultScheduledExecutor

public static ScheduledExecutorService defaultScheduledExecutor()

Default ScheduledExecutorService used for scheduling background tasks. This default spawns up to 32 background thread on an as need basis. Idle threads are pruned after one minute.

Returns:

fresh ScheduledExecutorService

defaultExecutorService

public static ExecutorService defaultExecutorService()

Default ExecutorService used for scheduling concurrent tasks. This default spawns as many threads as required with a priority of Thread.MIN_PRIORITY. Idle threads are pruned after one minute.

Returns:

fresh ExecutorService

with

@Nonnull
public Oak with(@Nonnull
                          Clusterable c)

Define the current repository as being a Clusterable one.

Parameters:

c -

Returns:

with

@Nonnull
public Oak with(@Nonnull
                          String defaultWorkspaceName)

Sets the default workspace name that should be used in case of login with null workspace name. If this method has not been called some internal default value will be used.

Parameters:

defaultWorkspaceName - The name of the default workspace.

Returns:

this builder.

with

@Nonnull
public Oak with(@Nonnull
                          RepositoryInitializer initializer)

with

@Nonnull
public Oak with(@Nonnull
                          QueryLimits settings)

with

@Nonnull
public Oak with(@Nonnull
                          QueryIndexProvider provider)

Associates the given query index provider with the repository to be created.

Parameters:

provider - query index provider

Returns:

this builder

with

@Nonnull
public Oak with(@Nonnull
                          IndexEditorProvider provider)

Associates the given index hook provider with the repository to be created.

Parameters:

provider - index hook provider

Returns:

this builder

with

@Nonnull
public Oak with(@Nonnull
                          CommitHook hook)

Associates the given commit hook with the repository to be created.

Parameters:

hook - commit hook

Returns:

this builder

with

@Nonnull
public Oak with(@Nonnull
                          EditorProvider provider)

Associates the given editor provider with the repository to be created.

Parameters:

provider - editor provider

Returns:

this builder

with

@Nonnull
public Oak with(@Nonnull
                          Editor editor)

Associates the given editor with the repository to be created.

Parameters:

editor - editor

Returns:

this builder

with

@Nonnull
public Oak with(@Nonnull
                          SecurityProvider securityProvider)

with

@Deprecated
 @Nonnull
public Oak with(@Nonnull
                                        ConflictHandler conflictHandler)

Deprecated. Use with(ThreeWayConflictHandler) instead

Associates the given conflict handler with the repository to be created.

Parameters:

conflictHandler - conflict handler

Returns:

this builder

with

@Nonnull
public Oak with(@Nonnull
                          ThreeWayConflictHandler conflictHandler)

with

@Nonnull
public Oak with(@Nonnull
                          ScheduledExecutorService scheduledExecutor)

with

@Nonnull
public Oak with(@Nonnull
                          Executor executor)

with

@Nonnull
public Oak with(@Nonnull
                          MBeanServer mbeanServer)

with

@Nonnull
public Oak with(@Nonnull
                          Whiteboard whiteboard)

with

@Nonnull
public Oak with(@Nonnull
                          Observer observer)

withAsyncIndexing

@Deprecated
public Oak withAsyncIndexing()

Deprecated. Use withAsyncIndexing(String, long) instead

Enable the asynchronous (background) indexing behavior.

Please note that when enabling the background indexer, you need to take care of calling #shutdown on the executor provided for this Oak instance.

withFailOnMissingIndexProvider

public Oak withFailOnMissingIndexProvider()

withAtomicCounter

public Oak withAtomicCounter()

withAsyncIndexing

public Oak withAsyncIndexing(@Nonnull
                             String name,
                             long delayInSeconds)

Enable the asynchronous (background) indexing behavior for the provided task name.

Please note that when enabling the background indexer, you need to take care of calling #shutdown on the executor provided for this Oak instance.

getWhiteboard

@Nonnull
public Whiteboard getWhiteboard()

createContentRepository

public ContentRepository createContentRepository()

Returns the content repository instance created with the given configuration. If the repository doesn't exist yet, a new instance will be created and returned for each subsequent call of this method.

Returns:

content repository

createContentSession

public ContentSession createContentSession()

Creates a content repository with the given configuration and logs in to the default workspace with no credentials, returning the resulting content session.

This method exists mostly as a convenience for one-off tests, as there's no way to create other sessions for accessing the same repository.

There is typically no need to explicitly close the returned session unless the repository has explicitly been configured to reserve some resources until all sessions have been closed. The repository will be garbage collected once the session is no longer used.

Returns:

content session

createRoot

public Root createRoot()

Creates a content repository with the given configuration and returns a Root instance after logging in to the default workspace with no credentials.

This method exists mostly as a convenience for one-off tests, as the returned root is the only way to access the session or the repository.

Note that since there is no way to close the underlying content session, this method should only be used when no components that require sessions to be closed have been configured. The repository and the session will be garbage collected once the root is no longer used.

Returns:

root instance