org.apache.jackrabbit.core
Class SearchManager

java.lang.Object
  org.apache.jackrabbit.core.SearchManager

All Implemented Interfaces:

javax.jcr.observation.EventListener, SynchronousEventListener

public class SearchManager
extends java.lang.Object
implements SynchronousEventListener

Acts as a global entry point to execute queries and index nodes.

Field Summary

static java.lang.String	NS_FN_OLD_URI
static java.lang.String	NS_FN_URI
static java.lang.String	NS_XS_URI

Constructor Summary

SearchManager(SearchConfig config, NamespaceRegistryImpl nsReg, NodeTypeRegistry ntReg, ItemStateManager itemMgr, PersistenceManager pm, NodeId rootNodeId, SearchManager parentMgr, NodeId excludedNodeId)
Creates a new SearchManager.

Method Summary

void	close() Closes this SearchManager and also closes the FileSystem configured in SearchConfig.
javax.jcr.query.Query	createQuery(SessionImpl session, ItemManager itemMgr, javax.jcr.Node node) Creates a query object from a node that can be executed on the workspace.
javax.jcr.query.Query	createQuery(SessionImpl session, ItemManager itemMgr, java.lang.String statement, java.lang.String language) Creates a query object that can be executed on the workspace.
protected AbstractQueryImpl	createQueryInstance() Creates a new instance of an AbstractQueryImpl which is not initialized.
QueryObjectModel	createQueryObjectModel(SessionImpl session, QueryObjectModelTree qomTree, java.lang.String langugage) Creates a query object model that can be executed on the workspace.
QueryHandler	getQueryHandler()
void	onEvent(javax.jcr.observation.EventIterator events)

Methods inherited from class java.lang.Object

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

Field Detail

NS_FN_URI

public static final java.lang.String NS_FN_URI

See Also:

Constant Field Values

NS_FN_OLD_URI

public static final java.lang.String NS_FN_OLD_URI

See Also:

Constant Field Values

NS_XS_URI

public static final java.lang.String NS_XS_URI

See Also:

Constant Field Values

Constructor Detail

SearchManager

public SearchManager(SearchConfig config,
                     NamespaceRegistryImpl nsReg,
                     NodeTypeRegistry ntReg,
                     ItemStateManager itemMgr,
                     PersistenceManager pm,
                     NodeId rootNodeId,
                     SearchManager parentMgr,
                     NodeId excludedNodeId)
              throws javax.jcr.RepositoryException

Creates a new SearchManager.

Parameters:

config - the search configuration.

nsReg - the namespace registry.

ntReg - the node type registry.

itemMgr - the shared item state manager.

pm - the underlying persistence manager.

rootNodeId - the id of the root node.

parentMgr - the parent search manager or null if there is no parent search manager.

excludedNodeId - id of the node that should be excluded from indexing. Any descendant of that node will also be excluded from indexing.

Throws:

javax.jcr.RepositoryException - if the search manager cannot be initialized

Method Detail

close

public void close()

Closes this SearchManager and also closes the FileSystem configured in SearchConfig.

createQuery

public javax.jcr.query.Query createQuery(SessionImpl session,
                                         ItemManager itemMgr,
                                         java.lang.String statement,
                                         java.lang.String language)
                                  throws javax.jcr.query.InvalidQueryException,
                                         javax.jcr.RepositoryException

Creates a query object that can be executed on the workspace.

Parameters:

session - the session of the user executing the query.

itemMgr - the item manager of the user executing the query. Needed to return Node instances in the result set.

statement - the actual query statement.

language - the syntax of the query statement.

Returns:

a Query instance to execute.

Throws:

javax.jcr.query.InvalidQueryException - if the query is malformed or the language is unknown.

javax.jcr.RepositoryException - if any other error occurs.

createQueryObjectModel

public QueryObjectModel createQueryObjectModel(SessionImpl session,
                                               QueryObjectModelTree qomTree,
                                               java.lang.String langugage)
                                        throws javax.jcr.query.InvalidQueryException,
                                               javax.jcr.RepositoryException

Creates a query object model that can be executed on the workspace.

Parameters:

session - the session of the user executing the query.

qomTree - the query object model tree, representing the query.

langugage - the original language of the query statement.

Returns:

the query object model for the query.

Throws:

javax.jcr.query.InvalidQueryException - the the query object model tree is considered invalid by the query handler implementation.

javax.jcr.RepositoryException - if any other error occurs.

createQuery

public javax.jcr.query.Query createQuery(SessionImpl session,
                                         ItemManager itemMgr,
                                         javax.jcr.Node node)
                                  throws javax.jcr.query.InvalidQueryException,
                                         javax.jcr.RepositoryException

Creates a query object from a node that can be executed on the workspace.

Parameters:

session - the session of the user executing the query.

itemMgr - the item manager of the user executing the query. Needed to return Node instances in the result set.

node - a node of type nt:query.

Returns:

a Query instance to execute.

Throws:

javax.jcr.query.InvalidQueryException - if absPath is not a valid persisted query (that is, a node of type nt:query)

javax.jcr.RepositoryException - if any other error occurs.

getQueryHandler

public QueryHandler getQueryHandler()

Returns:

the query handler implementation.

onEvent

public void onEvent(javax.jcr.observation.EventIterator events)

Specified by:

onEvent in interface javax.jcr.observation.EventListener

createQueryInstance

protected AbstractQueryImpl createQueryInstance()
                                         throws javax.jcr.RepositoryException

Creates a new instance of an AbstractQueryImpl which is not initialized.

Returns:

an new query instance.

Throws:

javax.jcr.RepositoryException - if an error occurs while creating a new query instance.