Package com.atlassian.crowd.search.query.membership

Class MembershipQuery<T>

java.lang.Object

com.atlassian.crowd.search.query.membership.MembershipQuery<T>

All Implemented Interfaces:

Query<T>

Direct Known Subclasses:

GroupMembershipQuery, GroupMembersOfGroupQuery, UserMembershipQuery, UserMembersOfGroupQuery

public class MembershipQuery<T>
extends Object
implements Query<T>

Constructor Summary

Constructors

Constructor	Description
MembershipQuery(MembershipQuery<?> query, Class<T> returnType)
MembershipQuery(MembershipQuery<T> query, int startIndex, int maxResults)
MembershipQuery(Class<T> returnType, boolean findChildren, EntityDescriptor entityToMatch, EntityDescriptor entityToReturn, int startIndex, int maxResults, SearchRestriction searchRestriction, String... entityNamesToMatch)
MembershipQuery(Class<T> returnType, boolean findChildren, EntityDescriptor entityToMatch, EntityDescriptor entityToReturn, int startIndex, int maxResults, SearchRestriction searchRestriction, Collection<String> entityNamesToMatch)
MembershipQuery(Class<T> returnType, boolean findChildren, EntityDescriptor entityToMatch, String entityNameToMatch, EntityDescriptor entityToReturn, int startIndex, int maxResults)	Deprecated. Use MembershipQuery(Class, boolean, EntityDescriptor, String, EntityDescriptor, int, int, SearchRestriction)} instead.
MembershipQuery(Class<T> returnType, boolean findChildren, EntityDescriptor entityToMatch, String entityNameToMatch, EntityDescriptor entityToReturn, int startIndex, int maxResults, SearchRestriction searchRestriction)

Method Summary

Modifier and Type	Method	Description
MembershipQuery<T>	addToMaxResults(int add)
MembershipQuery<T>	baseSplitQuery()	Returned queries will have": startIndex equal to 0 and maxResults equal to original startIndex + maxResults.
boolean	equals(Object o)
Set<String>	getEntityNamesToMatch()
String	getEntityNameToMatch()	Deprecated. Use getEntityNamesToMatch() instead.
EntityDescriptor	getEntityToMatch()
EntityDescriptor	getEntityToReturn()
int	getMaxResults()	The maximum number of elements to return.
Class<T>	getReturnType()	The type of elements to return.
SearchRestriction	getSearchRestriction()	Restrictions to apply to the query.
int	getStartIndex()	The index of the first element to return.
int	hashCode()
boolean	isFindChildren()
boolean	isWithAllResults()
List<MembershipQuery<T>>	splitEntityNamesToMatch()	Splits query with multiple getEntityNamesToMatch() into separate queries with single entity name to match.
List<MembershipQuery<T>>	splitEntityNamesToMatch(int batchSize)	Splits query with multiple getEntityNamesToMatch() into separate queries with provided number of entity names to match.
String	toString()
MembershipQuery<T>	withAllResults()
MembershipQuery<T>	withEntityNames(String... entityNameToMatch)
MembershipQuery<T>	withEntityNames(Collection<String> entityNamesToMatch)
MembershipQuery<T>	withEntityToReturn(EntityDescriptor entityToReturn)
MembershipQuery<T>	withMaxResults(int maxResults)
<Q> MembershipQuery<Q>	withReturnType(Class<Q> returnType)
MembershipQuery<T>	withSearchRestriction(SearchRestriction searchRestriction)
MembershipQuery<T>	withStartIndex(int startIndex)
MembershipQuery<T>	withStartIndexAndMaxResult(int startIndex, int maxResults)

Methods inherited from class java.lang.Object

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

Constructor Details

MembershipQuery

@Deprecated
public MembershipQuery(Class<T> returnType,
 boolean findChildren,
 EntityDescriptor entityToMatch,
 String entityNameToMatch,
 EntityDescriptor entityToReturn,
 int startIndex,
 int maxResults)

Deprecated.

Use MembershipQuery(Class, boolean, EntityDescriptor, String, EntityDescriptor, int, int, SearchRestriction)} instead. Since v2.9.

MembershipQuery

public MembershipQuery(Class<T> returnType,
 boolean findChildren,
 EntityDescriptor entityToMatch,
 String entityNameToMatch,
 EntityDescriptor entityToReturn,
 int startIndex,
 int maxResults,
 SearchRestriction searchRestriction)

MembershipQuery

public MembershipQuery(Class<T> returnType,
 boolean findChildren,
 EntityDescriptor entityToMatch,
 EntityDescriptor entityToReturn,
 int startIndex,
 int maxResults,
 SearchRestriction searchRestriction,
 String... entityNamesToMatch)

MembershipQuery

public MembershipQuery(Class<T> returnType,
 boolean findChildren,
 EntityDescriptor entityToMatch,
 EntityDescriptor entityToReturn,
 int startIndex,
 int maxResults,
 SearchRestriction searchRestriction,
 Collection<String> entityNamesToMatch)

MembershipQuery

public MembershipQuery(MembershipQuery<T> query,
 int startIndex,
 int maxResults)

MembershipQuery

public MembershipQuery(MembershipQuery<?> query,
 Class<T> returnType)

Method Details

getEntityToReturn

public EntityDescriptor getEntityToReturn()

getEntityToMatch

public EntityDescriptor getEntityToMatch()

isFindChildren

public boolean isFindChildren()

getEntityNamesToMatch

public Set<String> getEntityNamesToMatch()

getEntityNameToMatch

@Deprecated
@Nullable
public String getEntityNameToMatch()

Deprecated.

Use getEntityNamesToMatch() instead. Since v2.9

This will return the entity name to match if getEntityNamesToMatch() contains a single value or null.

Returns:

the entity name to match if getEntityNamesToMatch() contains a single value or null.

Throws:

IllegalArgumentException - if getEntityNamesToMatch() has a size greater than one.

getStartIndex

public int getStartIndex()

Description copied from interface: Query

The index of the first element to return.

Specified by:

getStartIndex in interface Query<T>

Returns:

a positive index value.

getMaxResults

public int getMaxResults()

Description copied from interface: Query

The maximum number of elements to return.

Specified by:

getMaxResults in interface Query<T>

Returns:

a number of elements.

getReturnType

public Class<T> getReturnType()

Description copied from interface: Query

The type of elements to return.

Specified by:

getReturnType in interface Query<T>

Returns:

the expected type of elements to be returned by the search.

getSearchRestriction

public SearchRestriction getSearchRestriction()

Description copied from interface: Query

Restrictions to apply to the query. Typically finding users of a given name, etc.

Specified by:

getSearchRestriction in interface Query<T>

Returns:

the search restriction to apply to this query.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

withEntityNames

public MembershipQuery<T> withEntityNames(Collection<String> entityNamesToMatch)

withEntityNames

public MembershipQuery<T> withEntityNames(String... entityNameToMatch)

splitEntityNamesToMatch

public List<MembershipQuery<T>> splitEntityNamesToMatch()

Splits query with multiple getEntityNamesToMatch() into separate queries with single entity name to match. Returned queries will have: startIndex equal to 0 and maxResults equal to original startIndex + maxResults. This is required to correctly merge and produce results of original query.

splitEntityNamesToMatch

public List<MembershipQuery<T>> splitEntityNamesToMatch(int batchSize)

Splits query with multiple getEntityNamesToMatch() into separate queries with provided number of entity names to match. Returned queries will have: startIndex equal to 0 and maxResults equal to original startIndex + maxResults. This is required to correctly merge and produce results of original query.

withAllResults

public MembershipQuery<T> withAllResults()

withStartIndex

public MembershipQuery<T> withStartIndex(int startIndex)

withMaxResults

public MembershipQuery<T> withMaxResults(int maxResults)

withReturnType

public <Q> MembershipQuery<Q> withReturnType(Class<Q> returnType)

withEntityToReturn

public MembershipQuery<T> withEntityToReturn(EntityDescriptor entityToReturn)

baseSplitQuery

public MembershipQuery<T> baseSplitQuery()

Returned queries will have": startIndex equal to 0 and maxResults equal to original startIndex + maxResults. This is required to correctly merge and produce results of original query.

addToMaxResults

public MembershipQuery<T> addToMaxResults(int add)

withStartIndexAndMaxResult

public MembershipQuery<T> withStartIndexAndMaxResult(int startIndex,
 int maxResults)

withSearchRestriction

public MembershipQuery<T> withSearchRestriction(SearchRestriction searchRestriction)

isWithAllResults

public boolean isWithAllResults()