SelectBuilder (Apache Jena - Extras - Query Builder 3.17.0)

java.lang.Object
- org.apache.jena.arq.querybuilder.AbstractQueryBuilder<SelectBuilder>
- - org.apache.jena.arq.querybuilder.SelectBuilder

All Implemented Interfaces:

Cloneable, DatasetClause<SelectBuilder>, PrologClause<SelectBuilder>, SelectClause<SelectBuilder>, SolutionModifierClause<SelectBuilder>, ValuesClause<SelectBuilder>, WhereClause<SelectBuilder>
```
public class SelectBuilder
extends AbstractQueryBuilder<SelectBuilder>
implements DatasetClause<SelectBuilder>, WhereClause<SelectBuilder>, SolutionModifierClause<SelectBuilder>, SelectClause<SelectBuilder>
```
Builder for SPARQL Select Queries.
The SelectBuilder provides chainable methods to programmatically generate SPARQL Select Queries. The application order of the methods is not relevant for the resulting query. An ExprFactory is intended for use along with the SelectBuilder to generate needed Expr parameter values. An ExprFactory that works with the same prefixes can be obtained with AbstractQueryBuilder.getExprFactory().
The SelectBuilder can be used as prepared query. Values for variables in the created query can be set with AbstractQueryBuilder.setVar(Object, Object) and AbstractQueryBuilder.setVar(Var, Node). The method clearWhereValues() allows to clear the set values.

See Also:

AskBuilder, ConstructBuilder, DescribeBuilder, UpdateBuilder

Constructor Summary

Constructors
Constructor and Description

SelectBuilder()

Constructors
Constructor and Description
`SelectBuilder()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`SelectBuilder`	`addBind(Expr expression, Object var)` Add a bind statement to the query * http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#rGraphGraphPattern.
`SelectBuilder`	`addBind(String expression, Object var)` Add a bind statement to the query http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#rGraphGraphPattern.
`SelectBuilder`	`addFilter(Expr expr)` Adds a filter to the where clause Use ExprFactory or NodeValue static or the AbstractQueryBuilder.makeExpr methods to create the expression.
`SelectBuilder`	`addFilter(String s)` Adds a filter to the where clause
`SelectBuilder`	`addGraph(Object graph, AbstractQueryBuilder<?> subQuery)` Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
`SelectBuilder`	`addGraph(Object graph, FrontsTriple triple)` Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
`SelectBuilder`	`addGraph(Object graph, Object subject, Object predicate, Object object)` Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
`SelectBuilder`	`addGraph(Object graph, Triple triple)` Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
`SelectBuilder`	`addGraph(Object graph, TriplePath triplePath)` Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
`SelectBuilder`	`addGroupBy(Expr groupBy)` Add an expression to the group by clause.
`SelectBuilder`	`addGroupBy(Object groupBy)` Add a variable to the group by clause.
`SelectBuilder`	`addGroupBy(Object var, Expr expr)` Add var and expression to the group by clause.
`SelectBuilder`	`addGroupBy(Object var, String expr)` Add var and expression to the group by clause.
`SelectBuilder`	`addHaving(Expr expression)` Add a having expression.
`SelectBuilder`	`addHaving(Object var)` Add a having expression.
`SelectBuilder`	`addHaving(String having)` Add a having expression.
`SelectBuilder`	`addMinus(AbstractQueryBuilder<?> t)` Add a minus clause to the query.
`SelectBuilder`	`addOptional(AbstractQueryBuilder<?> t)` Adds an optional group pattern to the where clause.
`SelectBuilder`	`addOptional(FrontsTriple t)` Adds an optional triple as to the where clause.
`SelectBuilder`	`addOptional(Object s, Object p, Object o)` Adds an optional triple or triple path to the where clause.
`SelectBuilder`	`addOptional(Triple t)` Adds an optional triple to the where clause.
`SelectBuilder`	`addOptional(TriplePath t)` Adds an optional triple path to the where clause.
`SelectBuilder`	`addOrderBy(Expr orderBy)` Add an ascending order by.
`SelectBuilder`	`addOrderBy(Expr orderBy, Order order)` Add an order by with direction specified.
`SelectBuilder`	`addOrderBy(Object orderBy)` Add an ascending order by.
`SelectBuilder`	`addOrderBy(Object orderBy, Order order)` Add an order by with direction specified.
`SelectBuilder`	`addOrderBy(SortCondition orderBy)` Add an ascending order by.
`SelectBuilder`	`addSubQuery(AbstractQueryBuilder<?> subQuery)` Add a sub query.
`SelectBuilder`	`addUnion(AbstractQueryBuilder<?> subQuery)` Add a union.
`SelectBuilder`	`addVar(Expr expr, Object var)` Adds an expression as variable to the select statement.
`SelectBuilder`	`addVar(Object var)` Adds a variable to the select clause.
`SelectBuilder`	`addVar(String expression, Object var)` Adds an expression as variable to the select statement.
`SelectBuilder`	`addWhere(FrontsTriple t)` Adds a triple to the where clause.
`SelectBuilder`	`addWhere(Object s, Object p, Object o)` Adds a triple or triple path to the where clause.
`SelectBuilder`	`addWhere(Triple t)` Adds a triple to the where clause.
`SelectBuilder`	`addWhere(TriplePath t)` Adds a triple path to the where clause.
`SelectBuilder`	`addWhereValueRow(Collection<?> values)` Add a collection of objects as row of values.
`SelectBuilder`	`addWhereValueRow(Object... values)` Add objects as a row of values.
`SelectBuilder`	`addWhereValueVar(Object var)` Add a variable or variable and values to the value statement.
`SelectBuilder`	`addWhereValueVar(Object var, Object... values)` Add a variable and values to the value statement.
`<K extends Collection<?>> SelectBuilder`	`addWhereValueVars(Map<?,K> dataTable)` Add a data table to the value statement.
`SelectBuilder`	`clearWhereValues()` Reset the values table in the where clause to the initial undefined state.
`SelectBuilder`	`clone()`
`SelectBuilder`	`from(Collection<String> graphName)` Add several "FROM" graph names.
`SelectBuilder`	`from(String graphName)` Add the "FROM" graph name.
`SelectBuilder`	`fromNamed(Collection<String> graphNames)` Add several "FROM NAMED" graph names.
`SelectBuilder`	`fromNamed(String graphName)` Add the "FROM NAMED" graph name.
`DatasetHandler`	`getDatasetHandler()` Get the Dataset handler for this clause.
`HandlerBlock`	`getHandlerBlock()` Get the HandlerBlock for this query builder.
`SelectHandler`	`getSelectHandler()` Returns the select handler for this clause
`SolutionModifierHandler`	`getSolutionModifierHandler()` Get the Solution modifier for this clause.
`List<Var>`	`getVars()`
`Map<Var,List<Node>>`	`getWhereValuesMap()` Get an unmodifiable map of vars from the where clause values and their values.
`List<Var>`	`getWhereValuesVars()` Get an unmodifiable list of vars from the where clause values in the order that they appear in the values table.
`Node`	`list(Object... objs)` Create a list node from a list of objects as per RDF Collections.
`static String`	`makeString(Object o)` Converts the object to a string.
`SelectBuilder`	`setDistinct(boolean state)` Sets the distinct flag.
`SelectBuilder`	`setLimit(int limit)` Set the limit.
`SelectBuilder`	`setOffset(int offset)` Set the offset.
`SelectBuilder`	`setReduced(boolean state)` Sets the reduced flag.

Methods inherited from class org.apache.jena.arq.querybuilder.AbstractQueryBuilder
addPrefix, addPrefix, addPrefix, addPrefixes, addPrefixes, addValueRow, addValueRow, addValueVar, addValueVar, addValueVars, addWhere, asSubQuery, build, buildString, checkVar, clearValues, clone, getExprFactory, getPrologHandler, getValuesHandler, getValuesMap, getValuesVars, getWhereHandler, makeExpr, makeNode, makeNode, makeNodeOrPath, makeTriplePath, makeValueNodes, makeValueNodes, makeVar, quote, rewrite, setBase, setBase, setVar, setVar, toString

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.jena.arq.querybuilder.clauses.WhereClause
addWhere, getWhereHandler

- Constructor Detail
  - SelectBuilder
```
public SelectBuilder()
```
- Method Detail
  - getDatasetHandler
```
public DatasetHandler getDatasetHandler()
```
    Description copied from interface: DatasetClause
    
    Get the Dataset handler for this clause.
    
    Specified by:
    
    getDatasetHandler in interface DatasetClause<SelectBuilder>
    
    Returns:
    
    The DatasetHandler this clause is using.
  - getHandlerBlock
```
public HandlerBlock getHandlerBlock()
```
    Description copied from class: AbstractQueryBuilder
    
    Get the HandlerBlock for this query builder.
    
    Specified by:
    
    getHandlerBlock in class AbstractQueryBuilder<SelectBuilder>
    
    Returns:
    
    The associated handler block.
  - clone
```
public SelectBuilder clone()
```
    Overrides:
    
    clone in class Object
  - setDistinct
```
public SelectBuilder setDistinct(boolean state)
```
    Sets the distinct flag. Setting the select distinct will unset reduced if it was set.
    
    Parameters:
    
    state - if true results will be distinct.
    
    Returns:
    
    This builder for chaining.
  - setReduced
```
public SelectBuilder setReduced(boolean state)
```
    Sets the reduced flag. Setting the select reduced will unset distinct if it was set.
    
    Parameters:
    
    state - if true results will be reduced.
    
    Returns:
    
    This builder for chaining.
  - addVar
```
public SelectBuilder addVar(Object var)
```
    Description copied from interface: SelectClause
    
    Adds a variable to the select clause. A variable may only be added once. Attempting to add the same variable multiple times will be silently ignored.
    
    Specified by:
    
    addVar in interface SelectClause<SelectBuilder>
    
    Parameters:
    
    var - The variable to add.
    
    Returns:
    
    This builder for chaining.
  - addVar
```
public SelectBuilder addVar(String expression,
                            Object var)
                     throws ParseException
```
    Description copied from interface: SelectClause
    
    Adds an expression as variable to the select statement. Creates an '(Expression as Var)' to the select statement. A variable may only be added once. Attempting to add the same variable multiple times will be silently ignored.
    
    Specified by:
    
    addVar in interface SelectClause<SelectBuilder>
    
    Parameters:
    
    expression - The expression to be added
    
    var - The variable to add.
    
    Returns:
    
    This builder for chaining.
    
    Throws:
    
    ParseException - If the expression can not be parsed.
  - addVar
```
public SelectBuilder addVar(Expr expr,
                            Object var)
```
    Description copied from interface: SelectClause
    
    Adds an expression as variable to the select statement. Creates an '(Expression as Var)' to the select statement. A variable may only be added once. Attempting to add the same variable multiple times will be silently ignored.
    
    Specified by:
    
    addVar in interface SelectClause<SelectBuilder>
    
    Parameters:
    
    expr - The expression to be added
    
    var - The variable to add.
    
    Returns:
    
    This builder for chaining.
  - getVars
```
public List<Var> getVars()
```
    Specified by:
    
    getVars in interface SelectClause<SelectBuilder>
    
    Returns:
    
    A list of all the variables that have been added.
  - fromNamed
```
public SelectBuilder fromNamed(String graphName)
```
    Description copied from interface: DatasetClause
    
    Add the "FROM NAMED" graph name.
    
    Specified by:
    
    fromNamed in interface DatasetClause<SelectBuilder>
    
    Parameters:
    
    graphName - the graph name to add.
    
    Returns:
    
    This builder for chaining.
  - fromNamed
```
public SelectBuilder fromNamed(Collection<String> graphNames)
```
    Description copied from interface: DatasetClause
    
    Add several "FROM NAMED" graph names.
    
    Specified by:
    
    fromNamed in interface DatasetClause<SelectBuilder>
    
    Parameters:
    
    graphNames - the collection graph names to add.
    
    Returns:
    
    This builder for chaining.
  - from
```
public SelectBuilder from(String graphName)
```
    Description copied from interface: DatasetClause
    
    Add the "FROM" graph name.
    
    Specified by:
    
    from in interface DatasetClause<SelectBuilder>
    
    Parameters:
    
    graphName - the graph name to add.
    
    Returns:
    
    This builder for chaining.
  - from
```
public SelectBuilder from(Collection<String> graphName)
```
    Description copied from interface: DatasetClause
    
    Add several "FROM" graph names.
    
    Specified by:
    
    from in interface DatasetClause<SelectBuilder>
    
    Parameters:
    
    graphName - the collection graph names to add.
    
    Returns:
    
    This builder for chaining.
  - addOrderBy
```
public SelectBuilder addOrderBy(Expr orderBy)
```
    Description copied from interface: SolutionModifierClause
    
    Add an ascending order by. Use ExprFactory or NodeValue static or the AbstractQueryBuilder.makeExpr methods to create the expression.
    
    Specified by:
    
    addOrderBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    orderBy - The expression to order by.
    
    Returns:
    
    This builder for chaining.
    
    See Also:
    
    ExprFactory, NodeValue, AbstractQueryBuilder.makeExpr(String)
  - addOrderBy
```
public SelectBuilder addOrderBy(Object orderBy)
```
    Description copied from interface: SolutionModifierClause
    
    Add an ascending order by.
    
    Specified by:
    
    addOrderBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    orderBy - The object to order by.
    
    Returns:
    
    This builder for chaining.
  - addOrderBy
```
public SelectBuilder addOrderBy(SortCondition orderBy)
```
    Description copied from interface: SolutionModifierClause
    
    Add an ascending order by.
    
    Specified by:
    
    addOrderBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    orderBy - The SortCondition to order by.
    
    Returns:
    
    This builder for chaining.
  - addOrderBy
```
public SelectBuilder addOrderBy(Expr orderBy,
                                Order order)
```
    Description copied from interface: SolutionModifierClause
    
    Add an order by with direction specified.
    
    Specified by:
    
    addOrderBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    orderBy - The expression to order by.
    
    order - The direction to order.
    
    Returns:
    
    This builder for chaining.
  - addOrderBy
```
public SelectBuilder addOrderBy(Object orderBy,
                                Order order)
```
    Description copied from interface: SolutionModifierClause
    
    Add an order by with direction specified.
    
    Specified by:
    
    addOrderBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    orderBy - The object to order by.
    
    order - The direction to order.
    
    Returns:
    
    This builder for chaining.
  - addGroupBy
```
public SelectBuilder addGroupBy(Object groupBy)
```
    Description copied from interface: SolutionModifierClause
    
    Add a variable to the group by clause.
    
    Specified by:
    
    addGroupBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    groupBy - The object to group by.
    
    Returns:
    
    This builder for chaining.
  - addGroupBy
```
public SelectBuilder addGroupBy(Expr groupBy)
```
    Description copied from interface: SolutionModifierClause
    
    Add an expression to the group by clause. The expression may be created from a string using the makeExpr() method.
    
    Specified by:
    
    addGroupBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    groupBy - The expression to add.
  - addGroupBy
```
public SelectBuilder addGroupBy(Object var,
                                Expr expr)
```
    Description copied from interface: SolutionModifierClause
    
    Add var and expression to the group by clause.
    
    Specified by:
    
    addGroupBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    var - The variable to add.
    
    expr - The expression to add.
  - addGroupBy
```
public SelectBuilder addGroupBy(Object var,
                                String expr)
```
    Description copied from interface: SolutionModifierClause
    
    Add var and expression to the group by clause.
    
    Specified by:
    
    addGroupBy in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    var - The variable to add.
    
    expr - The expression to add.
  - getSolutionModifierHandler
```
public SolutionModifierHandler getSolutionModifierHandler()
```
    Description copied from interface: SolutionModifierClause
    
    Get the Solution modifier for this clause.
    
    Specified by:
    
    getSolutionModifierHandler in interface SolutionModifierClause<SelectBuilder>
    
    Returns:
    
    The SolutionModifierHandler the clause is using.
  - addHaving
```
public SelectBuilder addHaving(String having)
                        throws ParseException
```
    Description copied from interface: SolutionModifierClause
    
    Add a having expression.
    
    Specified by:
    
    addHaving in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    having - Expression to evaluate for the having.
    
    Returns:
    
    This builder for chaining.
    
    Throws:
    
    ParseException
  - addHaving
```
public SelectBuilder addHaving(Expr expression)
                        throws ParseException
```
    Description copied from interface: SolutionModifierClause
    
    Add a having expression. Use ExprFactory or NodeValue static or the AbstractQueryBuilder.makeExpr methods to create the expression.
    
    Specified by:
    
    addHaving in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    expression - Expression to evaluate for the having.
    
    Returns:
    
    This builder for chaining.
    
    Throws:
    
    ParseException
    
    See Also:
    
    ExprFactory, NodeValue, AbstractQueryBuilder.makeExpr(String)
  - addHaving
```
public SelectBuilder addHaving(Object var)
                        throws ParseException
```
    Description copied from interface: SolutionModifierClause
    
    Add a having expression.
    
    Specified by:
    
    addHaving in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    var - the variable to have.
    
    Returns:
    
    This builder for chaining.
    
    Throws:
    
    ParseException
  - setLimit
```
public SelectBuilder setLimit(int limit)
```
    Description copied from interface: SolutionModifierClause
    
    Set the limit. Setting the limit to 0 (zero) sets no limit.
    
    Specified by:
    
    setLimit in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    limit - the maximum number of results to return.
    
    Returns:
    
    This builder for chaining.
  - setOffset
```
public SelectBuilder setOffset(int offset)
```
    Description copied from interface: SolutionModifierClause
    
    Set the offset. Setting the offset to 0 (zero) sets no offset.
    
    Specified by:
    
    setOffset in interface SolutionModifierClause<SelectBuilder>
    
    Parameters:
    
    offset - the number of results to skip before returning results..
    
    Returns:
    
    This builder for chaining.
  - makeString
```
public static String makeString(Object o)
```
    Converts the object to a string. If the object is a node or fronts a node then
    - If the node is a literal return the literal value.
    - If the node is a URI return the URI enclosed with < and >
    - If the node is a variable return the name preceded by '?'
    otherwise return the toString() method of the object.
    Parameters:
    
    o - the Object to convert.
    
    Returns:
    
    The string representation of the object.
  - addWhere
```
public SelectBuilder addWhere(TriplePath t)
```
    Description copied from interface: WhereClause
    
    Adds a triple path to the where clause.
    
    Specified by:
    
    addWhere in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The triple path to add
    
    Returns:
    
    This Builder for chaining.
  - addWhere
```
public SelectBuilder addWhere(Triple t)
```
    Description copied from interface: WhereClause
    
    Adds a triple to the where clause.
    
    Specified by:
    
    addWhere in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The triple path to add
    
    Returns:
    
    This Builder for chaining.
  - addWhere
```
public SelectBuilder addWhere(FrontsTriple t)
```
    Description copied from interface: WhereClause
    
    Adds a triple to the where clause.
    
    Specified by:
    
    addWhere in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The triple to add
    
    Returns:
    
    This Builder for chaining.
  - addWhere
```
public SelectBuilder addWhere(Object s,
                              Object p,
                              Object o)
```
    Description copied from interface: WhereClause
    
    Adds a triple or triple path to the where clause. See AbstractQueryBuilder.makeTriplePath(java.lang.Object, java.lang.Object, java.lang.Object) for conversion of the param values.
    
    Specified by:
    
    addWhere in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    s - The subject.
    
    p - The predicate.
    
    o - The object.
    
    Returns:
    
    This Builder for chaining.
  - addWhereValueVar
```
public SelectBuilder addWhereValueVar(Object var)
```
    Description copied from interface: WhereClause
    
    Add a variable or variable and values to the value statement. The first var (or first item in a collection) is converted to a variable using the makeVar strategy. A variable may be added multiple times, doing so will append values to the list of variable values. The order in which variables are added to the values table is preserved. Adding a collection as the var will use the first object in the collection as the var and the remaining objects as values. Values are created using makeNode() strategy except that null values are converted to UNDEF.
    
    Specified by:
    
    addWhereValueVar in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    var - The variable or collection to add.
    
    Returns:
    
    The builder for chaining.
    
    See Also:
    
    AbstractQueryBuilder.makeNode(Object), Converters.makeVar(Object)
  - addWhereValueVar
```
public SelectBuilder addWhereValueVar(Object var,
                                      Object... values)
```
    Description copied from interface: WhereClause
    
    Add a variable and values to the value statement. The var is converted to a variable using the makeVar strategy. A variable may be added multiple times, doing so will append values to the list of variable values. The order in which variables are added to the values table is preserved. Values are created using makeNode() strategy except that null values are converted to UNDEF.
    
    Specified by:
    
    addWhereValueVar in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    var - The variable to add.
    
    values - The values for the variable
    
    Returns:
    
    The builder for chaining.
    
    See Also:
    
    AbstractQueryBuilder.makeNode(Object), Converters.makeVar(Object)
  - addWhereValueVars
```
public <K extends Collection<?>> SelectBuilder addWhereValueVars(Map<?,K> dataTable)
```
    Description copied from interface: WhereClause
    
    Add a data table to the value statement. Each key in the map is used converted into a variable using the makeVar strategy. The order in which variables are added to the values table is preserved. Variables are added in the iteration order for the map. It may be advisable to use a LinkedHashMap to preserver the insert order.
    Specified by:
    
    addWhereValueVars in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    dataTable - The data table to add.
    
    Returns:
    
    The builder for chaining.
    
    See Also:
    Each item in the value collection is converted into a node using makeNode() strategy except that null values are converted to UNDEF. If there are already values in the value statement the data table is adds as follows: If the variable already exists in the table the map values are appended to the list of values If the variable does not exist in the table and there are other variables defined, an appropriate number of nulls is added to the front of the map values to create UNDEF entries for the existing rows If there are variables in the value statement that are not specified in the map additional UNDEF entries are appended to them to account for new rows that are added., AbstractQueryBuilder.makeNode(Object), Converters.makeVar(Object)
  - addWhereValueRow
```
public SelectBuilder addWhereValueRow(Object... values)
```
    Description copied from interface: WhereClause
    
    Add objects as a row of values. This method is different from the other methods in that the values are appended to each of the variables in the clause. There must be sufficient entries in the list to provide data for each variable in the table. Values objects are converted to nodes using the makeNode strategy. Variables will always be in the order added to the values table.
    
    Specified by:
    
    addWhereValueRow in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    values - the collection of values to add.
    
    Returns:
    
    The builder for chaining.
    
    See Also:
    
    AbstractQueryBuilder.makeNode(Object)
  - addWhereValueRow
```
public SelectBuilder addWhereValueRow(Collection<?> values)
```
    Description copied from interface: WhereClause
    
    Add a collection of objects as row of values. This method is different from the other methods in that the values are appended to each of the variables in the clause. There must be sufficient entries in the list to provide data for each variable in the table. Values objects are converted to nodes using the makeNode strategy. Variables will always be in the order added to the values table.
    
    Specified by:
    
    addWhereValueRow in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    values - the collection of values to add.
    
    Returns:
    
    The builder for chaining.
    
    See Also:
    
    AbstractQueryBuilder.makeNode(Object)
  - getWhereValuesVars
```
public List<Var> getWhereValuesVars()
```
    Description copied from interface: WhereClause
    
    Get an unmodifiable list of vars from the where clause values in the order that they appear in the values table.
    
    Specified by:
    
    getWhereValuesVars in interface WhereClause<SelectBuilder>
    
    Returns:
    
    an unmodifiable list of vars.
  - getWhereValuesMap
```
public Map<Var,List<Node>> getWhereValuesMap()
```
    Description copied from interface: WhereClause
    
    Get an unmodifiable map of vars from the where clause values and their values. Null values are considered as UNDEF values.
    
    Specified by:
    
    getWhereValuesMap in interface WhereClause<SelectBuilder>
    
    Returns:
    
    an unmodifiable map of vars and their values.
  - clearWhereValues
```
public SelectBuilder clearWhereValues()
```
    Description copied from interface: WhereClause
    
    Reset the values table in the where clause to the initial undefined state. Used primarily to reset the builder values table to a known state.
    
    Specified by:
    
    clearWhereValues in interface WhereClause<SelectBuilder>
  - addOptional
```
public SelectBuilder addOptional(TriplePath t)
```
    Description copied from interface: WhereClause
    
    Adds an optional triple path to the where clause.
    
    Specified by:
    
    addOptional in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The triple path to add
    
    Returns:
    
    This Builder for chaining.
  - addOptional
```
public SelectBuilder addOptional(Triple t)
```
    Description copied from interface: WhereClause
    
    Adds an optional triple to the where clause.
    
    Specified by:
    
    addOptional in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The triple to add
    
    Returns:
    
    This Builder for chaining.
  - addOptional
```
public SelectBuilder addOptional(FrontsTriple t)
```
    Description copied from interface: WhereClause
    
    Adds an optional triple as to the where clause.
    
    Specified by:
    
    addOptional in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The triple to add
    
    Returns:
    
    This Builder for chaining.
  - addOptional
```
public SelectBuilder addOptional(Object s,
                                 Object p,
                                 Object o)
```
    Description copied from interface: WhereClause
    
    Adds an optional triple or triple path to the where clause. See AbstractQueryBuilder.makeTriplePath(java.lang.Object, java.lang.Object, java.lang.Object) for conversion of the param values.
    
    Specified by:
    
    addOptional in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    s - The subject.
    
    p - The predicate.
    
    o - The object.
    
    Returns:
    
    This Builder for chaining.
  - addOptional
```
public SelectBuilder addOptional(AbstractQueryBuilder<?> t)
```
    Description copied from interface: WhereClause
    
    Adds an optional group pattern to the where clause.
    
    Specified by:
    
    addOptional in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The select builder to add as an optional pattern
    
    Returns:
    
    This Builder for chaining.
  - addFilter
```
public SelectBuilder addFilter(Expr expr)
```
    Description copied from interface: WhereClause
    
    Adds a filter to the where clause Use ExprFactory or NodeValue static or the AbstractQueryBuilder.makeExpr methods to create the expression.
    
    Specified by:
    
    addFilter in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    expr - the expression to evaluate for the filter.
    
    Returns:
    
    @return This Builder for chaining.
    
    See Also:
    
    ExprFactory, NodeValue, AbstractQueryBuilder.makeExpr(String)
  - addFilter
```
public SelectBuilder addFilter(String s)
                        throws ParseException
```
    Description copied from interface: WhereClause
    
    Adds a filter to the where clause
    
    Specified by:
    
    addFilter in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    s - the expression to evaluate for the filter.
    
    Returns:
    
    @return This Builder for chaining.
    
    Throws:
    
    ParseException - If the expression can not be parsed.
  - addSubQuery
```
public SelectBuilder addSubQuery(AbstractQueryBuilder<?> subQuery)
```
    Description copied from interface: WhereClause
    
    Add a sub query.
    
    Specified by:
    
    addSubQuery in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    subQuery - The subquery as defined by a SelectBuilder.
    
    Returns:
    
    This builder for chaining.
  - addUnion
```
public SelectBuilder addUnion(AbstractQueryBuilder<?> subQuery)
```
    Description copied from interface: WhereClause
    
    Add a union.
    
    Specified by:
    
    addUnion in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    subQuery - The union as defined by a SelectBuilder.
    
    Returns:
    
    This builder for chaining.
  - addGraph
```
public SelectBuilder addGraph(Object graph,
                              AbstractQueryBuilder<?> subQuery)
```
    Description copied from interface: WhereClause
    
    Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern. See AbstractQueryBuilder.makeNode(java.lang.Object) for conversion of the graph param.
    
    Specified by:
    
    addGraph in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    graph - The iri or variable identifying the graph.
    
    subQuery - The graph to add.
    
    Returns:
    
    This builder for chaining.
  - addGraph
```
public SelectBuilder addGraph(Object graph,
                              FrontsTriple triple)
```
    Description copied from interface: WhereClause
    
    Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern. See AbstractQueryBuilder.makeNode(java.lang.Object) for conversion of the graph param.
    
    Specified by:
    
    addGraph in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    graph - The iri or variable identifying the graph.
    
    triple - a single s, p, o triple for the query.
    
    Returns:
    
    This builder for chaining.
  - addGraph
```
public SelectBuilder addGraph(Object graph,
                              Object subject,
                              Object predicate,
                              Object object)
```
    Description copied from interface: WhereClause
    
    Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern. See AbstractQueryBuilder.makeNode(java.lang.Object) for conversion of the graph param.
    
    Specified by:
    
    addGraph in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    graph - The iri or variable identifying the graph.
    
    subject - The subject for the graph query
    
    predicate - The predicate for the graph query.
    
    object - The object for the graph query.
    
    Returns:
    
    This builder for chaining.
  - addGraph
```
public SelectBuilder addGraph(Object graph,
                              Triple triple)
```
    Description copied from interface: WhereClause
    
    Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern. See AbstractQueryBuilder.makeNode(java.lang.Object) for conversion of the graph param.
    
    Specified by:
    
    addGraph in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    graph - The iri or variable identifying the graph.
    
    triple - a single triple for the query.
    
    Returns:
    
    This builder for chaining.
  - addGraph
```
public SelectBuilder addGraph(Object graph,
                              TriplePath triplePath)
```
    Description copied from interface: WhereClause
    
    Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern. See AbstractQueryBuilder.makeNode(java.lang.Object) for conversion of the graph param.
    
    Specified by:
    
    addGraph in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    graph - The iri or variable identifying the graph.
    
    triplePath - a single triple path for the query.
    
    Returns:
    
    This builder for chaining.
  - addBind
```
public SelectBuilder addBind(Expr expression,
                             Object var)
```
    Description copied from interface: WhereClause
    
    Add a bind statement to the query * http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#rGraphGraphPattern.
    
    Specified by:
    
    addBind in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    expression - The expression to bind to the var.
    
    var - The variable to bind to.
    
    Returns:
    
    This builder for chaining.
  - addBind
```
public SelectBuilder addBind(String expression,
                             Object var)
                      throws ParseException
```
    Description copied from interface: WhereClause
    
    Add a bind statement to the query http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#rGraphGraphPattern.
    
    Specified by:
    
    addBind in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    expression - The expression to bind to the var.
    
    var - The variable to bind to.
    
    Returns:
    
    This builder for chaining.
    
    Throws:
    
    ParseException
  - getSelectHandler
```
public SelectHandler getSelectHandler()
```
    Description copied from interface: SelectClause
    
    Returns the select handler for this clause
    
    Specified by:
    
    getSelectHandler in interface SelectClause<SelectBuilder>
    
    Returns:
    
    The SelectHandler that the clause is using
  - list
```
public Node list(Object... objs)
```
    Description copied from interface: WhereClause
    Create a list node from a list of objects as per RDF Collections. http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#collections See AbstractQueryBuilder.makeNode(java.lang.Object) for conversion of the param values.
    usage:
    - list( param1, param2, param3, ... )
    - addWhere( list( param1, param2, param3, ... ), p, o )
    - addOptional( list( param1, param2, param3, ... ), p, o )
    Specified by:
    
    list in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    objs - the list of objects for the list.
    
    Returns:
    
    the first blank node in the list.
  - addMinus
```
public SelectBuilder addMinus(AbstractQueryBuilder<?> t)
```
    Description copied from interface: WhereClause
    
    Add a minus clause to the query. https://www.w3.org/TR/2013/REC-sparql11-query-20130321/#rMinusGraphPattern
    
    Specified by:
    
    addMinus in interface WhereClause<SelectBuilder>
    
    Parameters:
    
    t - The select builder to add as a minus pattern
    
    Returns:
    
    this builder for chaining

Class SelectBuilder

Constructor Summary

Method Summary

Methods inherited from class org.apache.jena.arq.querybuilder.AbstractQueryBuilder

Methods inherited from class java.lang.Object

Methods inherited from interface org.apache.jena.arq.querybuilder.clauses.WhereClause

Constructor Detail

SelectBuilder

Method Detail

getDatasetHandler

getHandlerBlock

clone

setDistinct

setReduced

addVar

addVar

addVar

getVars

fromNamed

fromNamed

from

from

addOrderBy

addOrderBy

addOrderBy

addOrderBy

addOrderBy

addGroupBy

addGroupBy

addGroupBy

addGroupBy

getSolutionModifierHandler

addHaving

addHaving

addHaving

setLimit

setOffset

makeString

addWhere

addWhere

addWhere

addWhere

addWhereValueVar

addWhereValueVar

addWhereValueVars

addWhereValueRow

addWhereValueRow

getWhereValuesVars

getWhereValuesMap

clearWhereValues

addOptional

addOptional

addOptional

addOptional

addOptional

addFilter

addFilter

addSubQuery

addUnion

addGraph

addGraph

addGraph

addGraph

addGraph

addBind

addBind

getSelectHandler

list

addMinus