com.atlassian.crowd.search.builder
Class QueryBuilder

java.lang.Object
  com.atlassian.crowd.search.builder.QueryBuilder

public class QueryBuilder
extends java.lang.Object

Recommended convenience class to build queries.

Examples are presented below.

1. Find all users, return results indexed from 0 to 99 or less:

    QueryBuilder.queryFor(EntityDescriptor.user()).returningAtMost(100)
    

   This is the minimum required structure for a query.

2. Find all users with the username matching b*, return results indexed from 100 to 109 or less:

    QueryBuilder.queryFor(EntityDescriptor.user()).with(
         Restriction.on(UserTermKeys.USERNAME).startingWith("b")
     ).startingAt(100).returningAtMost(10)
    

3. Find all users that have an attribute color with a value that matches red* OR scarlet OR crimson, returning results indexed from 0 to 49 or less:

    QueryBuilder.queryFor(EntityDescriptor.user()).with(
    Combine.anyOf(
         Restriction.on("color").startingWith("red"),
         Restriction.on("color").exactlyMatching("scarlet"),
         Restriction.on("color").exactlyMatching("crimson")
     )
    ).returningAtMost(50)
    

4. Find all users that like the color red AND blue, returning results indexed from 0 to 49:

    QueryBuilder.queryFor(EntityDescriptor.user()).with(
    Combine.allOf(
         Restriction.on("color").exactlyMatching("red"),
         Restriction.on("color").exactlyMatching("blue")
     )
    ).returningAtMost(50)
    

5. Find all users that like the color red and have a name starting "r" or like blue and have a name starting with "b", returning results indexed from 0 to 9 or less:

    QueryBuilder.queryFor(EntityDescriptor.user()).with(
     Combine.anyOf(
         Combine.allOf(
             Restriction.on("color").ex`actlyMatching("red"),
             Restriction.on(UserTermKeys.USERNAME).startingWith("r")
         ),
         Combine.allOf(
             Restriction.on("color").exactlyMatching("blue"),
             Restriction.on(UserTermKeys.USERNAME).startingWith("b")
         )
     )
    ).returningAtMost(10)
    

   This is equivalent to verbosely constructing the same query as so:

    TermRestriction colorRed = new TermRestriction("color", EXACTLY_MATCHES, "red");
    TermRestriction colorBlue = new TermRestriction("color", EXACTLY_MATCHES, "blue");
    TermRestriction userNameR = new TermRestriction(UserTermKeys.USERNAME, STARTS_WITH, "r");
    TermRestriction userNameB = new TermRestriction(UserTermKeys.USERNAME, STARTS_WITH, "b");
    MultiTermRestriction conjuction1 = new MultiTermRestriction(BooleanLogic.AND, colorRed, userNameR);
    MultiTermRestriction conjuction2 = new MultiTermRestriction(BooleanLogic.AND, colorBlue, userNameB);
    MultiTermRestriction disjunction = new MultiTermRestriction(BooleanLogic.OR,  conjuction1, conjuction2);
    EntityQuery query = new EntityQuery(USER, disjunction, 0, 10);
    

Membership Queries

1. Find first 10 members of a group:

    QueryBuilder.queryFor(EntityDescriptor.user()).membersOf(GROUP).withName("crowd-administrators").returningAtMost(10);
    

Nested Class Summary

static class	QueryBuilder.PartialEntityQuery<T>
static class	QueryBuilder.PartialEntityQueryWithRestriction<T>
static class	QueryBuilder.PartialEntityQueryWithStartIndex<T>
static class	QueryBuilder.PartialMembershipQueryWithEntityToMatch<T>
static class	QueryBuilder.PartialMembershipQueryWithNameToMatch<T>
static class	QueryBuilder.PartialMembershipQueryWithStartIndex<T>

Constructor Summary

QueryBuilder()

Method Summary

static <T> MembershipQuery<T>	createMembershipQuery(int maxResults, int startIndex, boolean findMembers, EntityDescriptor entityToReturn, java.lang.Class<T> returnType, EntityDescriptor entityToMatch, java.lang.String nameToMatch)
static <T> QueryBuilder.PartialEntityQuery<T>	queryFor(java.lang.Class<T> returnType, EntityDescriptor entity)
static <T> EntityQuery<T>	queryFor(java.lang.Class<T> returnType, EntityDescriptor entity, SearchRestriction searchRestriction, int startIndex, int maxResults)

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryBuilder

public QueryBuilder()

Method Detail

queryFor

public static <T> QueryBuilder.PartialEntityQuery<T> queryFor(java.lang.Class<T> returnType,
                                                              EntityDescriptor entity)

queryFor

public static <T> EntityQuery<T> queryFor(java.lang.Class<T> returnType,
                                          EntityDescriptor entity,
                                          SearchRestriction searchRestriction,
                                          int startIndex,
                                          int maxResults)

createMembershipQuery

public static <T> MembershipQuery<T> createMembershipQuery(int maxResults,
                                                           int startIndex,
                                                           boolean findMembers,
                                                           EntityDescriptor entityToReturn,
                                                           java.lang.Class<T> returnType,
                                                           EntityDescriptor entityToMatch,
                                                           java.lang.String nameToMatch)