Module org.apache.jena.querybuilder

Package org.apache.jena.arq.querybuilder

Class ConstructBuilder

java.lang.Object

org.apache.jena.arq.querybuilder.AbstractQueryBuilder<ConstructBuilder>

org.apache.jena.arq.querybuilder.ConstructBuilder

All Implemented Interfaces:

Cloneable, ConstructClause<ConstructBuilder>, DatasetClause<ConstructBuilder>, PrologClause<ConstructBuilder>, SolutionModifierClause<ConstructBuilder>, ValuesClause<ConstructBuilder>, WhereClause<ConstructBuilder>

public class ConstructBuilder
extends AbstractQueryBuilder<ConstructBuilder>
implements DatasetClause<ConstructBuilder>, WhereClause<ConstructBuilder>, SolutionModifierClause<ConstructBuilder>, ConstructClause<ConstructBuilder>

Builder for SPARQL Construct Queries.

The ConstructBuilder provides chainable methods to programmatically generate SPARQL Construct Queries. The application order of the methods is not relevant for the resulting query. An ExprFactory is intended for use along with the ConstructBuilder to generate needed Expr parameter values. An ExprFactory that works with the same prefixes can be obtained with AbstractQueryBuilder.getExprFactory().

The ConstructBuilder can be used asprepared 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
• DescribeBuilder
• SelectBuilder
• UpdateBuilder

Constructor Summary

Constructors

Constructor	Description
ConstructBuilder()

Method Summary

Modifier and Type	Method	Description
ConstructBuilder	addBind(String expression, Object var)	Add a bind statement to the query http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#rGraphGraphPattern.
ConstructBuilder	addBind(org.apache.jena.sparql.expr.Expr expression, Object var)	Add a bind statement to the query * http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#rGraphGraphPattern.
ConstructBuilder	addConstruct(Object s, Object p, Object o)	Add a construct triple.
ConstructBuilder	addConstruct(org.apache.jena.graph.FrontsTriple t)	Add a construct triple.
ConstructBuilder	addConstruct(org.apache.jena.graph.Triple t)	Add a construct triple.
ConstructBuilder	addFilter(String s)	Adds a filter to the where clause
ConstructBuilder	addFilter(org.apache.jena.sparql.expr.Expr expr)	Adds a filter to the where clause Use ExprFactory or NodeValue static or the AbstractQueryBuilder.makeExpr methods to create the expression.
ConstructBuilder	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.
ConstructBuilder	addGraph(Object graph, Collection<org.apache.jena.sparql.core.TriplePath> collection)	Adds a collection of triple paths as the optional clauses.
ConstructBuilder	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.
ConstructBuilder	addGraph(Object graph, org.apache.jena.graph.FrontsTriple triple)	Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
ConstructBuilder	addGraph(Object graph, org.apache.jena.graph.Triple triple)	Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
ConstructBuilder	addGraph(Object graph, org.apache.jena.sparql.core.TriplePath triplePath)	Add a graph statement to the query as per http://www.w3.org/TR/2013/REC-sparql11 -query-20130321/#rGraphGraphPattern.
ConstructBuilder	addGroupBy(Object groupBy)	Add a variable to the group by clause.
ConstructBuilder	addGroupBy(Object var, String expr)	Add var and expression to the group by clause.
ConstructBuilder	addGroupBy(Object var, org.apache.jena.sparql.expr.Expr expr)	Add var and expression to the group by clause.
ConstructBuilder	addGroupBy(org.apache.jena.sparql.expr.Expr groupBy)	Add an expression to the group by clause.
ConstructBuilder	addHaving(Object var)	Add a having expression.
ConstructBuilder	addHaving(String having)	Add a having expression.
ConstructBuilder	addHaving(org.apache.jena.sparql.expr.Expr expression)	Add a having expression.
ConstructBuilder	addMinus(AbstractQueryBuilder<?> t)	Add a minus clause to the query.
ConstructBuilder	addOptional(Object s, Object p, Object o)	Adds an optional triple or triple path to the where clause.
ConstructBuilder	addOptional(Collection<org.apache.jena.sparql.core.TriplePath> collection)	Adds a collection of triple paths as the optional clauses.
ConstructBuilder	addOptional(AbstractQueryBuilder<?> t)	Adds an optional group pattern to the where clause.
ConstructBuilder	addOptional(org.apache.jena.graph.FrontsTriple t)	Adds an optional triple as to the where clause.
ConstructBuilder	addOptional(org.apache.jena.graph.Triple t)	Adds an optional triple to the where clause.
ConstructBuilder	addOptional(org.apache.jena.sparql.core.TriplePath t)	Adds an optional triple path to the where clause.
ConstructBuilder	addOrderBy(Object orderBy)	Add an ascending order by.
ConstructBuilder	addOrderBy(Object orderBy, Order order)	Add an order by with direction specified.
ConstructBuilder	addOrderBy(org.apache.jena.query.SortCondition orderBy)	Add an ascending order by.
ConstructBuilder	addOrderBy(org.apache.jena.sparql.expr.Expr orderBy)	Add an ascending order by.
ConstructBuilder	addOrderBy(org.apache.jena.sparql.expr.Expr orderBy, Order order)	Add an order by with direction specified.
ConstructBuilder	addSubQuery(AbstractQueryBuilder<?> subQuery)	Add a sub query.
ConstructBuilder	addUnion(AbstractQueryBuilder<?> subQuery)	Add a union.
ConstructBuilder	addWhere(Object s, Object p, Object o)	Adds a triple or triple path to the where clause.
ConstructBuilder	addWhere(Collection<org.apache.jena.sparql.core.TriplePath> collection)	Adds a collections of triple paths to the where clause.
ConstructBuilder	addWhere(org.apache.jena.graph.FrontsTriple t)	Adds a triple to the where clause.
ConstructBuilder	addWhere(org.apache.jena.graph.Triple t)	Adds a triple to the where clause.
ConstructBuilder	addWhere(org.apache.jena.sparql.core.TriplePath t)	Adds a triple path to the where clause.
ConstructBuilder	addWhereValueRow(Object... values)	Add objects as a row of values.
ConstructBuilder	addWhereValueRow(Collection<?> values)	Add a collection of objects as row of values.
ConstructBuilder	addWhereValueVar(Object var)	Add a variable or variable and values to the value statement.
ConstructBuilder	addWhereValueVar(Object var, Object... values)	Add a variable and values to the value statement.
<K extends Collection<?>> ConstructBuilder	addWhereValueVars(Map<?,K> dataTable)	Add a data table to the value statement.
ConstructBuilder	clearWhereValues()	Reset the values table in the where clause to the initial undefined state.
ConstructBuilder	clone()
ConstructBuilder	from(Object graphName)	Add the "FROM" graph name.
ConstructBuilder	fromNamed(Object graphName)	Add the "FROM NAMED" graph name.
ConstructHandler	getConstructHandler()	Get the Construct handler for this construct clause.
DatasetHandler	getDatasetHandler()	Get the Dataset handler for this clause.
HandlerBlock	getHandlerBlock()	Get the HandlerBlock for this query builder.
SolutionModifierHandler	getSolutionModifierHandler()	Get the Solution modifier for this clause.
Map<org.apache.jena.sparql.core.Var,List<org.apache.jena.graph.Node>>	getWhereValuesMap()	Get an unmodifiable map of vars from the where clause values and their values.
List<org.apache.jena.sparql.core.Var>	getWhereValuesVars()	Get an unmodifiable list of vars from the where clause values in the order that they appear in the values table.
org.apache.jena.graph.Node	list(Object... objs)	Deprecated.
ConstructBuilder	setLimit(int limit)	Set the limit.
ConstructBuilder	setOffset(int offset)	Set the offset.

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, makeTriplePaths, 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 Details

ConstructBuilder

public ConstructBuilder()

Method Details

getDatasetHandler

public DatasetHandler getDatasetHandler()

Description copied from interface: DatasetClause

Get the Dataset handler for this clause.

Specified by:

getDatasetHandler in interface DatasetClause<ConstructBuilder>

Returns:

The DatasetHandler this clause is using.

getConstructHandler

public ConstructHandler getConstructHandler()

Description copied from interface: ConstructClause

Get the Construct handler for this construct clause.

Specified by:

getConstructHandler in interface ConstructClause<ConstructBuilder>

Returns:

the construct handler used by this builder.

getSolutionModifierHandler

public SolutionModifierHandler getSolutionModifierHandler()

Description copied from interface: SolutionModifierClause

Get the Solution modifier for this clause.

Specified by:

getSolutionModifierHandler in interface SolutionModifierClause<ConstructBuilder>

Returns:

The SolutionModifierHandler the 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<ConstructBuilder>

Returns:

The associated handler block.

clone

public ConstructBuilder clone()

fromNamed

public ConstructBuilder fromNamed(Object graphName)

Description copied from interface: DatasetClause

Add the "FROM NAMED" graph name.

Specified by:

fromNamed in interface DatasetClause<ConstructBuilder>

Parameters:

graphName - the graph name to add.

Returns:

This builder for chaining.

from

public ConstructBuilder from(Object graphName)

Description copied from interface: DatasetClause

Add the "FROM" graph name.

Specified by:

from in interface DatasetClause<ConstructBuilder>

Parameters:

graphName - the graph name to add.

Returns:

This builder for chaining.

addOrderBy

public ConstructBuilder addOrderBy(org.apache.jena.sparql.expr.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<ConstructBuilder>

Parameters:

orderBy - The expression to order by.

Returns:

This builder for chaining.

See Also:

• ExprFactory
• NodeValue
• AbstractQueryBuilder.makeExpr(String)

addOrderBy

public ConstructBuilder addOrderBy(Object orderBy)

Description copied from interface: SolutionModifierClause

Add an ascending order by.

Specified by:

addOrderBy in interface SolutionModifierClause<ConstructBuilder>

Parameters:

orderBy - The object to order by.

Returns:

This builder for chaining.

addOrderBy

public ConstructBuilder addOrderBy(org.apache.jena.query.SortCondition orderBy)

Description copied from interface: SolutionModifierClause

Add an ascending order by.

Specified by:

addOrderBy in interface SolutionModifierClause<ConstructBuilder>

Parameters:

orderBy - The SortCondition to order by.

Returns:

This builder for chaining.

addOrderBy

public ConstructBuilder addOrderBy(org.apache.jena.sparql.expr.Expr orderBy,
 Order order)

Description copied from interface: SolutionModifierClause

Add an order by with direction specified.

Specified by:

addOrderBy in interface SolutionModifierClause<ConstructBuilder>

Parameters:

orderBy - The expression to order by.

order - The direction to order.

Returns:

This builder for chaining.

addOrderBy

public ConstructBuilder addOrderBy(Object orderBy,
 Order order)

Description copied from interface: SolutionModifierClause

Add an order by with direction specified.

Specified by:

addOrderBy in interface SolutionModifierClause<ConstructBuilder>

Parameters:

orderBy - The object to order by.

order - The direction to order.

Returns:

This builder for chaining.

addGroupBy

public ConstructBuilder addGroupBy(Object groupBy)

Description copied from interface: SolutionModifierClause

Add a variable to the group by clause.

Specified by:

addGroupBy in interface SolutionModifierClause<ConstructBuilder>

Parameters:

groupBy - The object to group by.

Returns:

This builder for chaining.

addGroupBy

public ConstructBuilder addGroupBy(org.apache.jena.sparql.expr.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<ConstructBuilder>

Parameters:

groupBy - The expression to add.

addGroupBy

public ConstructBuilder addGroupBy(Object var,
 org.apache.jena.sparql.expr.Expr expr)

Description copied from interface: SolutionModifierClause

Add var and expression to the group by clause.

Specified by:

addGroupBy in interface SolutionModifierClause<ConstructBuilder>

Parameters:

var - The variable to add.

expr - The expression to add.

addGroupBy

public ConstructBuilder 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<ConstructBuilder>

Parameters:

var - The variable to add.

expr - The expression to add.

addHaving

public ConstructBuilder addHaving(String having)

Description copied from interface: SolutionModifierClause

Add a having expression.

Specified by:

addHaving in interface SolutionModifierClause<ConstructBuilder>

Parameters:

having - Expression to evaluate for the having.

Returns:

This builder for chaining.

addHaving

public ConstructBuilder addHaving(org.apache.jena.sparql.expr.Expr expression)

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<ConstructBuilder>

Parameters:

expression - Expression to evaluate for the having.

Returns:

This builder for chaining.

See Also:

• ExprFactory
• NodeValue
• AbstractQueryBuilder.makeExpr(String)

addHaving

public ConstructBuilder addHaving(Object var)

Description copied from interface: SolutionModifierClause

Add a having expression.

Specified by:

addHaving in interface SolutionModifierClause<ConstructBuilder>

Parameters:

var - the variable to have.

Returns:

This builder for chaining.

setLimit

public ConstructBuilder 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<ConstructBuilder>

Parameters:

limit - the maximum number of results to return.

Returns:

This builder for chaining.

setOffset

public ConstructBuilder 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<ConstructBuilder>

Parameters:

offset - the number of results to skip before returning results..

Returns:

This builder for chaining.

addWhere

public ConstructBuilder addWhere(org.apache.jena.sparql.core.TriplePath t)

Description copied from interface: WhereClause

Adds a triple path to the where clause.

Specified by:

addWhere in interface WhereClause<ConstructBuilder>

Parameters:

t - The triple path to add

Returns:

This Builder for chaining.

addWhere

public ConstructBuilder addWhere(Collection<org.apache.jena.sparql.core.TriplePath> collection)

Description copied from interface: WhereClause

Adds a collections of triple paths to the where clause.

Specified by:

addWhere in interface WhereClause<ConstructBuilder>

Parameters:

collection - The collection of triple paths to add

Returns:

This Builder for chaining.

addWhere

public ConstructBuilder addWhere(org.apache.jena.graph.Triple t)

Description copied from interface: WhereClause

Adds a triple to the where clause.

Specified by:

addWhere in interface WhereClause<ConstructBuilder>

Parameters:

t - The triple to add

Returns:

This Builder for chaining.

addWhere

public ConstructBuilder addWhere(org.apache.jena.graph.FrontsTriple t)

Description copied from interface: WhereClause

Adds a triple to the where clause.

Specified by:

addWhere in interface WhereClause<ConstructBuilder>

Parameters:

t - The triple to add

Returns:

This Builder for chaining.

addWhere

public ConstructBuilder 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<ConstructBuilder>

Parameters:

s - The subject.

p - The predicate.

o - The object.

Returns:

This Builder for chaining.

addWhereValueVar

public ConstructBuilder 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<ConstructBuilder>

Parameters:

var - The variable or collection to add.

Returns:

The builder for chaining.

See Also:

• AbstractQueryBuilder.makeNode(Object)
• Converters.makeVar(Object)

addWhereValueVar

public ConstructBuilder 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<ConstructBuilder>

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<?>> ConstructBuilder 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<ConstructBuilder>

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 ConstructBuilder 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<ConstructBuilder>

Parameters:

values - the collection of values to add.

Returns:

The builder for chaining.

See Also:

• AbstractQueryBuilder.makeNode(Object)

addWhereValueRow

public ConstructBuilder 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<ConstructBuilder>

Parameters:

values - the collection of values to add.

Returns:

The builder for chaining.

See Also:

• AbstractQueryBuilder.makeNode(Object)

getWhereValuesVars

public List<org.apache.jena.sparql.core.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<ConstructBuilder>

Returns:

an unmodifiable list of vars.

getWhereValuesMap

public Map<org.apache.jena.sparql.core.Var,List<org.apache.jena.graph.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<ConstructBuilder>

Returns:

an unmodifiable map of vars and their values.

clearWhereValues

public ConstructBuilder 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<ConstructBuilder>

addOptional

public ConstructBuilder addOptional(org.apache.jena.sparql.core.TriplePath t)

Description copied from interface: WhereClause

Adds an optional triple path to the where clause.

Specified by:

addOptional in interface WhereClause<ConstructBuilder>

Parameters:

t - The triple path to add

Returns:

This Builder for chaining.

addOptional

public ConstructBuilder addOptional(Collection<org.apache.jena.sparql.core.TriplePath> collection)

Description copied from interface: WhereClause

Adds a collection of triple paths as the optional clauses.

Specified by:

addOptional in interface WhereClause<ConstructBuilder>

Parameters:

collection - The collection of triple paths to add

Returns:

This Builder for chaining.

addOptional

public ConstructBuilder addOptional(org.apache.jena.graph.Triple t)

Description copied from interface: WhereClause

Adds an optional triple to the where clause.

Specified by:

addOptional in interface WhereClause<ConstructBuilder>

Parameters:

t - The triple to add

Returns:

This Builder for chaining.

addOptional

public ConstructBuilder addOptional(AbstractQueryBuilder<?> t)

Description copied from interface: WhereClause

Adds an optional group pattern to the where clause.

Specified by:

addOptional in interface WhereClause<ConstructBuilder>

Parameters:

t - The select builder to add as an optional pattern

Returns:

This Builder for chaining.

addOptional

public ConstructBuilder addOptional(org.apache.jena.graph.FrontsTriple t)

Description copied from interface: WhereClause

Adds an optional triple as to the where clause.

Specified by:

addOptional in interface WhereClause<ConstructBuilder>

Parameters:

t - The triple to add

Returns:

This Builder for chaining.

addOptional

public ConstructBuilder 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<ConstructBuilder>

Parameters:

s - The subject.

p - The predicate.

o - The object.

Returns:

This Builder for chaining.

addFilter

public ConstructBuilder addFilter(org.apache.jena.sparql.expr.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<ConstructBuilder>

Parameters:

expr - the expression to evaluate for the filter.

Returns:

This Builder for chaining.

See Also:

• ExprFactory
• NodeValue
• AbstractQueryBuilder.makeExpr(String)

addFilter

public ConstructBuilder addFilter(String s)

Description copied from interface: WhereClause

Adds a filter to the where clause

Specified by:

addFilter in interface WhereClause<ConstructBuilder>

Parameters:

s - the expression to evaluate for the filter.

Returns:

This Builder for chaining.

addSubQuery

public ConstructBuilder addSubQuery(AbstractQueryBuilder<?> subQuery)

Description copied from interface: WhereClause

Add a sub query.

Specified by:

addSubQuery in interface WhereClause<ConstructBuilder>

Parameters:

subQuery - The subquery as defined by a SelectBuilder.

Returns:

This builder for chaining.

addUnion

public ConstructBuilder addUnion(AbstractQueryBuilder<?> subQuery)

Description copied from interface: WhereClause

Add a union.

Specified by:

addUnion in interface WhereClause<ConstructBuilder>

Parameters:

subQuery - The union as defined by a SelectBuilder.

Returns:

This builder for chaining.

addGraph

public ConstructBuilder 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<ConstructBuilder>

Parameters:

graph - The iri or variable identifying the graph.

subQuery - The graph to add.

Returns:

This builder for chaining.

addGraph

public ConstructBuilder addGraph(Object graph,
 org.apache.jena.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<ConstructBuilder>

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 ConstructBuilder 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<ConstructBuilder>

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 ConstructBuilder addGraph(Object graph,
 org.apache.jena.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<ConstructBuilder>

Parameters:

graph - The iri or variable identifying the graph.

triple - a single triple for the query.

Returns:

This builder for chaining.

addGraph

public ConstructBuilder addGraph(Object graph,
 org.apache.jena.sparql.core.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<ConstructBuilder>

Parameters:

graph - The iri or variable identifying the graph.

triplePath - a single triple path for the query.

Returns:

This builder for chaining.

addGraph

public ConstructBuilder addGraph(Object graph,
 Collection<org.apache.jena.sparql.core.TriplePath> collection)

Description copied from interface: WhereClause

Adds a collection of triple paths as the optional clauses.

Specified by:

addGraph in interface WhereClause<ConstructBuilder>

Parameters:

graph - The iri or variable identifying the graph.

collection - The collection of triple paths to add

Returns:

This Builder for chaining.

addBind

public ConstructBuilder addBind(org.apache.jena.sparql.expr.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<ConstructBuilder>

Parameters:

expression - The expression to bind to the var.

var - The variable to bind to.

Returns:

This builder for chaining.

addBind

public ConstructBuilder addBind(String 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<ConstructBuilder>

Parameters:

expression - The expression to bind to the var.

var - The variable to bind to.

Returns:

This builder for chaining.

addConstruct

public ConstructBuilder addConstruct(org.apache.jena.graph.Triple t)

Description copied from interface: ConstructClause

Add a construct triple.

Specified by:

addConstruct in interface ConstructClause<ConstructBuilder>

Parameters:

t - The triple to add.

Returns:

The builder for chaining.

addConstruct

public ConstructBuilder addConstruct(org.apache.jena.graph.FrontsTriple t)

Description copied from interface: ConstructClause

Add a construct triple.

Specified by:

addConstruct in interface ConstructClause<ConstructBuilder>

Parameters:

t - The triple to add.

Returns:

The builder for chaining.

addConstruct

public ConstructBuilder addConstruct(Object s,
 Object p,
 Object o)

Description copied from interface: ConstructClause

Add a construct triple. See AbstractQueryBuilder.makeNode(java.lang.Object) for conversion of the param values.

Specified by:

addConstruct in interface ConstructClause<ConstructBuilder>

Parameters:

s - The subject of the triple,

p - The predicate of the triple.

o - The object of the triple.

Returns:

the builder for chaining.

list

@Deprecated(since="5.0.0")
public org.apache.jena.graph.Node list(Object... objs)

Deprecated.

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<ConstructBuilder>

Parameters:

objs - the list of objects for the list.

Returns:

the first blank node in the list.

addMinus

public ConstructBuilder 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<ConstructBuilder>

Parameters:

t - The select builder to add as a minus pattern

Returns:

this builder for chaining