com.atlassian.confluence.core
Class ListQuery

java.lang.Object
  com.atlassian.confluence.core.ListQuery

All Implemented Interfaces:

Cloneable

public class ListQuery

extends Object

implements Cloneable

A Query for the SmartListManager

Field Summary

static List	ALL_TYPES
static String	ALL_VERSIONS
static String	LATEST_VERSIONS
static String	SORT_BY_TIME_CREATED
static String	SORT_BY_TIME_MODIFIED
static int	UNLIMITED_TIMESPAN

Constructor Summary

ListQuery()

ListQuery(ListQuery query)

Method Summary

ListQuery	addLabel(String name) Adds a single label to the list of labels
ListQuery	addSpace(Space space) Adds a single Space to the list of Spaces to include
ListQuery	addStatus(String str) Adds a single status type to the query
ListQuery	addType(String type) Adds a content type to the query
String	getDescription() Return a string which can be used as a description of the RSS feed defined by this query
List	getLabelList() Returns the list of labels that the query will restrict by
int	getMaxResults() Retrieves the maximum number of results that will be returned by the Query
String	getName() Retrieves the name given to the query
String	getSortBy()
List	getSpaceList() Retrieves a List of Space objects that this query is being performed over
List	getSpaceScopes()
List	getStatusList() Retrieves a list of status types to be included with the query
float	getTimeSpan() Retrieves the time span (in days) that the query should cover
List	getTypeList() Retrieves a List of content types that this query is being performed over
User	getUser() The user the query is being performed for
void	setLabelList(List labelList) Set the list of labels that the query will be restricted to
void	setMaxResults(int maxResults) Sets the maximum number of results that will be returned by the query
void	setName(String name) Sets the name of the query
void	setSortBy(String sortBy)
void	setSpaceList(List spaceList)
void	setSpaceScopes(List spaceScopes)
void	setStatusList(List statusList) Sets the status types to be included with the query Can be any of: "created" "modified" ALL_VERSIONS LATEST_VERSION TODO Split off the type of content to include (All vs LATEST) into a separate field
void	setTimeSpan(float timeSpan) Sets the amount of time to include before the current date If a time span of "1" is specified, the query will include content from 1 day ago until the current time A time span of "0" means there is no limit
void	setTypeList(List typeList) Sets the type of content to be included
void	setUser(User user) Set the user this query will be performed for

Methods inherited from class java.lang.Object

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

Field Detail

UNLIMITED_TIMESPAN

public static final int UNLIMITED_TIMESPAN

See Also:

Constant Field Values

SORT_BY_TIME_CREATED

public static final String SORT_BY_TIME_CREATED

See Also:

Constant Field Values

SORT_BY_TIME_MODIFIED

public static final String SORT_BY_TIME_MODIFIED

See Also:

Constant Field Values

ALL_VERSIONS

public static final String ALL_VERSIONS

See Also:

Constant Field Values

ALL_TYPES

public static final List ALL_TYPES

LATEST_VERSIONS

public static final String LATEST_VERSIONS

See Also:

Constant Field Values

Constructor Detail

ListQuery

public ListQuery()

ListQuery

public ListQuery(ListQuery query)

Method Detail

getUser

public User getUser()

The user the query is being performed for

Returns:

User object

getSpaceList

public List getSpaceList()

Retrieves a List of Space objects that this query is being performed over

Returns:

List of Space objects

getTypeList

public List getTypeList()

Retrieves a List of content types that this query is being performed over

Returns:

List of ContentEntityObject content types

setUser

public void setUser(User user)

Set the user this query will be performed for

Parameters:

user - User object

setSpaceList

public void setSpaceList(List spaceList)

addType

public ListQuery addType(String type)

Adds a content type to the query

Parameters:

type - the content type to include

Returns:

this ListQuery object

getName

public String getName()

Retrieves the name given to the query

Returns:

the name

setName

public void setName(String name)

Sets the name of the query

Parameters:

name - the name

getMaxResults

public int getMaxResults()

Retrieves the maximum number of results that will be returned by the Query

Returns:

int representing the maximum number of results

setMaxResults

public void setMaxResults(int maxResults)

Sets the maximum number of results that will be returned by the query

Parameters:

maxResults - the maximum number of results

getTimeSpan

public float getTimeSpan()

Retrieves the time span (in days) that the query should cover

Returns:

the time span (in days) before the current time to be included

setTimeSpan

public void setTimeSpan(float timeSpan)

Sets the amount of time to include before the current date

If a time span of "1" is specified, the query will include content from 1 day ago until the current time A time span of "0" means there is no limit

Parameters:

timeSpan - the number of days to include before the current date

setTypeList

public void setTypeList(List typeList)

Sets the type of content to be included

Parameters:

typeList - List of content types (Strings)

getStatusList

public List getStatusList()

Retrieves a list of status types to be included with the query

Returns:

List of status types

setStatusList

public void setStatusList(List statusList)

Sets the status types to be included with the query Can be any of: "created" "modified" ALL_VERSIONS LATEST_VERSION TODO Split off the type of content to include (All vs LATEST) into a separate field

Parameters:

statusList - the List of status types to include

addStatus

public ListQuery addStatus(String str)

Adds a single status type to the query

Parameters:

str - the status type to add

Returns:

this list query

getDescription

public String getDescription()

Return a string which can be used as a description of the RSS feed defined by this query

getLabelList

public List getLabelList()

Returns the list of labels that the query will restrict by

Returns:

List of Label objects

setLabelList

public void setLabelList(List labelList)

Set the list of labels that the query will be restricted to

Parameters:

labelList - List of Label objects

addLabel

public ListQuery addLabel(String name)

Adds a single label to the list of labels

Parameters:

name - the label name to add

Returns:

this list query

addSpace

public ListQuery addSpace(Space space)

Adds a single Space to the list of Spaces to include

Parameters:

space - the Space to add

Returns:

this list query

getSpaceScopes

public List getSpaceScopes()

setSpaceScopes

public void setSpaceScopes(List spaceScopes)

getSortBy

public String getSortBy()

setSortBy

public void setSortBy(String sortBy)