com.bea.content.expression
Class Search

java.lang.Object
  com.bea.content.expression.Search

All Implemented Interfaces:

Cloneable, Serializable

public class Search

extends Object

implements Cloneable, Serializable

This represents parameters for searching for Nodes.

There are reserved system properties (not type defined) that may be part of a search. They are:

• cm_uid -> Node.id.uid
• cm_createdDate -> Node.createDate
• cm_createdBy -> Node.createdBy
• cm_modifiedDate -> Node.modifiedBy
• cm_nodeName -> Node.name
• cm_path -> Node.path
• cm_isHierarchy -> Node.type == Node.HIERARCHY
• cm_isContent -> Node.type == Node.CONTENT
• cm_objectClass -> Node.objectClass.name
• cm_contentType -> BinaryValue.contentType
• cm_binarySize -> BinaryValue.size (For Node Properties)
• cm_binaryName -> BinaryValue.name (For Node Properties)

See Also:

Serialized Form

Field Summary

protected Map	contextParams The context params.
protected Expression	expression The search expression.
protected int	maxReturn The maximum number of objects to return.
protected List	searchPaths The paths under which to search.
protected SortCriteria[]	sortCriteria The sorting criteria.

Constructor Summary

Search()
Empty constructor.

Search(Expression expr)
Constructor.

Search(int maxReturn, Expression expr)
Constructor.

Search(int maxReturn, SortCriteria[] sortCriteria, Expression expr)
Constructor.

Search(int maxReturn, SortCriteria[] sortCriteria, String expr)
Constructor.

Search(int maxReturn, String expr)
Constructor.

Search(int maxReturn, String sort, Expression expr)
Constructor.

Search(int maxReturn, String sort, String expr)
Constructor.

Search(String expr)
Constructor.

Search(String searchPath, int maxReturn, SortCriteria[] sortCriteria, Expression expr)
Constructor.

Search(String searchPath, int maxReturn, SortCriteria[] sortCriteria, String expr)
Constructor.

Search(String searchPath, int maxReturn, String sort, Expression expr)
Constructor.

Search(String searchPath, int maxReturn, String sort, String expr)
Constructor.

Method Summary

void	addSearchPath(String path) Add a search path.
void	clearSearchPaths() Clear the search paths.
Object	clone() Make a copy of this object
boolean	equals(Object o) Determine if another object is equals to this.
Object	getContextParam(Object key) Get the value of a context param.
Map	getContextParams() Get an unmodifiable copy of the context params.
Expression	getExpression() Get the search expression.
int	getMaxReturn() Get the maximum number of objects to return.
int	getNumSearchPaths() Get the number of search paths.
String[]	getSearchPaths() Get the search paths.
Iterator	getSearchPathsIterator() Get an iterator over the search paths.
SortCriteria[]	getSortCriteria() Get the sort criteria.
int	hashCode() Override hashcode to use our parts.
void	removeSearchPath(String path) Remove a search path.
Object	setContextParam(Object key, Object value) Set the value of a context param.
void	setContextParams(Map input) Set the context params based upon the objects in the input map.
void	setExpression(Expression expression) Set the search expression.
void	setMaxReturn(int maxReturn) Set the maximum number of objects to return.
void	setSearchPath(String searchPath) Set the search path to contain just this one.
void	setSearchPaths(String[] paths) Set the search paths.
void	setSortCriteria(SortCriteria[] sortCriteria) Set the sort criteria.
void	setSortCriteria(String sort) Set the sort criteria.
String	toString() Get a String representation of this.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

contextParams

protected Map contextParams

The context params.

expression

protected Expression expression

The search expression.

maxReturn

protected int maxReturn

The maximum number of objects to return.

Less than 0 signifies returning all matches.

searchPaths

protected List searchPaths

The paths under which to search.

This should be empty to search under all paths (repositories in a federeated search.) This is an OR'ed list.

In a federated search, this can begin with "/*" (e.g."/*/some/path") to denote a search path under each repository. In non-federated search, this should not be construed to contain any special characters.

sortCriteria

protected SortCriteria[] sortCriteria

The sorting criteria. The BEA Repository is only able to sort on system properties as defined above in the class javadoc.

Constructor Detail

Search

public Search()

Empty constructor.

Search

public Search(Expression expr)

Constructor.

Search

public Search(int maxReturn,
              Expression expr)

Constructor.

Search

public Search(int maxReturn,
              SortCriteria[] sortCriteria,
              Expression expr)

Constructor.

Search

public Search(int maxReturn,
              SortCriteria[] sortCriteria,
              String expr)
       throws IllegalArgumentException

Constructor.

Search

public Search(int maxReturn,
              String expr)
       throws IllegalArgumentException

Constructor.

Search

public Search(int maxReturn,
              String sort,
              Expression expr)
       throws IllegalArgumentException

Constructor.

Search

public Search(int maxReturn,
              String sort,
              String expr)
       throws IllegalArgumentException

Constructor.

Search

public Search(String expr)
       throws IllegalArgumentException

Constructor.

Search

public Search(String searchPath,
              int maxReturn,
              SortCriteria[] sortCriteria,
              Expression expr)

Constructor.

Search

public Search(String searchPath,
              int maxReturn,
              SortCriteria[] sortCriteria,
              String expr)
       throws IllegalArgumentException

Constructor.

Search

public Search(String searchPath,
              int maxReturn,
              String sort,
              Expression expr)
       throws IllegalArgumentException

Constructor.

Search

public Search(String searchPath,
              int maxReturn,
              String sort,
              String expr)
       throws IllegalArgumentException

Constructor.

Method Detail

addSearchPath

public void addSearchPath(String path)

Add a search path.

See searchPaths for details about what this can be.

clearSearchPaths

public void clearSearchPaths()

Clear the search paths.

clone

public Object clone()

Make a copy of this object

equals

public boolean equals(Object o)

Determine if another object is equals to this.

getContextParam

public Object getContextParam(Object key)

Get the value of a context param.

getContextParams

public Map getContextParams()

Get an unmodifiable copy of the context params.

getExpression

public Expression getExpression()

Get the search expression.

getMaxReturn

public int getMaxReturn()

Get the maximum number of objects to return.

Use less than 0 to signify returning all matches.

getNumSearchPaths

public int getNumSearchPaths()

Get the number of search paths.

getSearchPaths

public String[] getSearchPaths()

Get the search paths.

See searchPaths for details about what this can be.

getSearchPathsIterator

public Iterator getSearchPathsIterator()

Get an iterator over the search paths.

See searchPaths for details about what this can be.

getSortCriteria

public SortCriteria[] getSortCriteria()

Get the sort criteria.

hashCode

public int hashCode()

Override hashcode to use our parts.

removeSearchPath

public void removeSearchPath(String path)

Remove a search path.

setContextParam

public Object setContextParam(Object key,
                              Object value)

Set the value of a context param.

The key and value must be Serializable.

Parameters:

key - the context param key.

value - the context param value.

Returns:

the old context param value or null if none.

setContextParams

public void setContextParams(Map input)

Set the context params based upon the objects in the input map.

setExpression

public void setExpression(Expression expression)

Set the search expression.

setMaxReturn

public void setMaxReturn(int maxReturn)

Set the maximum number of objects to return.

Use less than 0 to signify returning all matches.

setSearchPath

public void setSearchPath(String searchPath)

Set the search path to contain just this one.

See searchPaths for details about what this can be.

setSearchPaths

public void setSearchPaths(String[] paths)

Set the search paths.

setSortCriteria

public void setSortCriteria(SortCriteria[] sortCriteria)

Set the sort criteria.

setSortCriteria

public void setSortCriteria(String sort)
                     throws IllegalArgumentException

Set the sort criteria.

Throws:

IllegalArgumentException - if the str string isn't valid occurred to SortCriteria.getSortCriteria(java.lang.String).

toString

public String toString()

Get a String representation of this.