org.apache.jackrabbit.api.security.user.QueryBuilder Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.jackrabbit.api.security.user;
import javax.jcr.Value;
public interface QueryBuilder {
/**
* The sort order of the result set of a query.
*/
enum Direction {
ASCENDING("ascending"),
DESCENDING("descending");
private final String direction;
Direction(String direction) {
this.direction = direction;
}
public String getDirection() {
return direction;
}
}
/**
* Set the selector for the query. The selector determines whether the query
* returns all {@link Authorizable}s or just {@link User}s respectively {@link Group}s.
*
* @param selector The selector for the query
*/
void setSelector(Class selector);
/**
* Set the scope for the query. If set, the query will only return members of a specific group.
*
* @param groupName Name of the group to restrict the query to.
* @param declaredOnly If true only declared members of the groups are returned.
* Otherwise indirect memberships are also considered.
*/
void setScope(String groupName, boolean declaredOnly);
/**
* Set the condition for the query. The query only includes {@link Authorizable}s
* for which this condition holds.
*
* @param condition Condition upon which Authorizables are included in the query result
*/
void setCondition(T condition);
/**
* Set the sort order of the {@link Authorizable}s returned by the query.
* The format of the propertyName is the same as in XPath:
* @propertyName sorts on a property of the current node.
* relative/path/@propertyName sorts on a property of a
* descendant node.
*
* @param propertyName The name of the property to sort on
* @param direction Direction to sort. Either {@link Direction#ASCENDING} or {@link Direction#DESCENDING}
* @param ignoreCase Ignore character case in sort if true. Note: For false
* sorting is done lexicographically even for non string properties.
*/
void setSortOrder(String propertyName, Direction direction, boolean ignoreCase);
/**
* Set the sort order of the {@link Authorizable}s returned by the query.
* The format of the propertyName is the same as in XPath:
* @propertyName sorts on a property of the current node.
* relative/path/@propertyName sorts on a property of a
* descendant node. Character case is taken into account for the sort order.
*
* @param propertyName The name of the property to sort on
* @param direction Direction to sort. Either {@link Direction#ASCENDING} or {@link Direction#DESCENDING}
*/
void setSortOrder(String propertyName, Direction direction);
/**
* Set limits for the query. The limits consists of a bound and a maximal
* number of results. The bound refers to the value of the
* {@link #setSortOrder(String, Direction) sort order} property. The
* query returns at most maxCount {@link Authorizable}s whose
* values of the sort order property follow bound in the sort
* direction. This method has no effect if the sort order is not specified.
*
* @param bound Bound from where to start returning results. null
* for no bound
* @param maxCount Maximal number of results to return. -1 for no limit.
*/
void setLimit(Value bound, long maxCount);
/**
* Set limits for the query. The limits consists of an offset and a maximal
* number of results. offset refers to the offset within the full
* result set at which the returned result set should start expressed in terms
* of the number of {@link Authorizable}s to skip. maxCount sets the
* maximum size of the result set expressed in terms of the number of authorizables
* to return.
*
* @param offset Offset from where to start returning results. 0 for no offset.
* @param maxCount Maximal number of results to return. -1 for no limit.
*/
void setLimit(long offset, long maxCount);
/**
* Create a condition which holds if the name of the {@link Authorizable}
* matches a pattern.
* The percent character "%" represents any string of zero or more characters and the
* underscore character "_" represents any single character. Any literal use of these characters
* and the backslash character "\" must be escaped with a backslash character.
* The pattern is matched against the {@link Authorizable#getID() id} and the
* {@link Authorizable#getPrincipal() principal}.
*
* @param pattern Pattern to match the name of an authorizable.
* @return A condition
*/
T nameMatches(String pattern);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath which is not equal to value.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @param value Value to compare the property at relPath to
* @return A condition
*/
T neq(String relPath, Value value);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath which is equal to value.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @param value Value to compare the property at relPath to
* @return A condition
*/
T eq(String relPath, Value value);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath which is smaller than value.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @param value Value to compare the property at relPath to
* @return A condition
*/
T lt(String relPath, Value value);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath which is smaller than or equal to value.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @param value Value to compare the property at relPath to
* @return A condition
*/
T le(String relPath, Value value);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath which is greater than value.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @param value Value to compare the property at relPath to
* @return A condition
*/
T gt(String relPath, Value value);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath which is greater than or equal to value.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @param value Value to compare the property at relPath to
* @return A condition
*/
T ge(String relPath, Value value);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @return A condition
*/
T exists(String relPath);
/**
* Create a condition which holds if the node of an {@link Authorizable} has a
* property at relPath which matches the pattern in pattern.
* The percent character "%" represents any string of zero or more characters and the
* underscore character "_" represents any single character. Any literal use of these characters
* and the backslash character "\" must be escaped with a backslash character.
* The format of the relPath argument is the same as in XPath:
* @attributeName for an attribute on this node and
* relative/path/@attributeName for an attribute of a descendant node.
*
* @param relPath Relative path from the authorizable's node to the property
* @param pattern Pattern to match the property at relPath against
* @return A condition
*/
T like(String relPath, String pattern);
/**
* Create a full text search condition. The condition holds if the node of an
* {@link Authorizable} has a property at relPath for which
* searchExpr yields results.
* The format of the relPath argument is the same as in XPath:
* . searches all properties of the current node, @attributeName
* searches the attributeName property of the current node, relative/path/.
* searches all properties of the descendant node at relative/path and
* relative/path/@attributeName searches the attributeName property
* of the descendant node at relative/path.
* The syntax of searchExpr is [-]value { [OR] [-]value }.
*
* @param relPath Relative path from the authorizable's node to the property
* @param searchExpr A full text search expression
* @return A condition
*/
T contains(String relPath, String searchExpr);
/**
* Create a condition which holds for {@link Authorizable}s which can impersonate as
* name.
*
* @param name Name of an authorizable
* @return A condition
*/
T impersonates(String name);
/**
* Return a condition which holds if condition does not hold.
*
* @param condition Condition to negate
* @return A condition
*/
T not(T condition);
/**
* Return a condition which holds if both sub conditions hold.
*
* @param condition1 first sub condition
* @param condition2 second sub condition
* @return A condition
*/
T and(T condition1, T condition2);
/**
* Return a condition which holds if any of the two sub conditions hold.
*
* @param condition1 first sub condition
* @param condition2 second sub condition
* @return A condition
*/
T or(T condition1, T condition2);
}