Class SubSelect

java.lang.Object

org.eclipse.rdf4j.sparqlbuilder.core.query.Query<SubSelect>

org.eclipse.rdf4j.sparqlbuilder.graphpattern.SubSelect

All Implemented Interfaces:

QueryElement, GraphPattern

public class SubSelect
extends Query<SubSelect>
implements GraphPattern

A SPARQL subquery

See Also:

• SPARQL Subquery

Field Summary

Fields inherited from class Query

bnodeCount, from, groupBy, having, limit, LIMIT, offset, OFFSET, orderBy, values, varCount, where

Modifier and Type	Field	Description
protected int	bnodeCount
protected Optional<Dataset>	from
protected Optional<GroupBy>	groupBy
protected Optional<Having>	having
protected int	limit
protected static final String	LIMIT
protected int	offset
protected static final String	OFFSET
protected Optional<OrderBy>	orderBy
protected Optional<Values>	values
protected int	varCount
protected QueryPattern	where

Constructor Summary

Constructors

Constructor	Description
SubSelect()

Method Summary

Modifier and Type	Method	Description
SubSelect	all()	Specify that this query's projection should select all in-scope expressions
SubSelect	all(boolean selectAll)	Specify if this query's projection should select all in-scope expressions or not.
SubSelect	distinct()	Specify the query's projection to be distinct
SubSelect	distinct(boolean isDistinct)	Specify if the query's projection should be distinct or not
protected String	getQueryActionString()
String	getQueryString()
boolean	isEmpty()
SubSelect	select(Projectable... projectables)	Add expressions to the query's projection
SubSelect	select(Projection select)	Set this query's projection

Methods inherited from class Query

bNode, from, from, groupBy, groupBy, having, having, limit, offset, orderBy, orderBy, values, var, where, where

Modifier and Type	Method	Description
RdfBlankNode.LabeledBlankNode	bNode()	A shortcut.
SubSelect	from(Dataset from)	Set the Dataset clause for this query
SubSelect	from(From... graphs)	Add datasets to this query
SubSelect	groupBy(Groupable... groupables)	Add grouping specifiers for the query results.
SubSelect	groupBy(GroupBy groupBy)	Set this query's Group By clause
SubSelect	having(Expression<?>... constraints)	Specify constraints for this query's Having clause.
SubSelect	having(Having having)	Set this query's Having clause
SubSelect	limit(int limit)	Set a limit on the number of results returned by this query.
SubSelect	offset(int offset)	Specify an offset in query results.
SubSelect	orderBy(Orderable... conditions)	Specify orderings for the query results
SubSelect	orderBy(OrderBy orderBy)	Set this query's Order By clause
SubSelect	values(Consumer<Values.VariablesBuilder> valuesConfigurer)
Variable	var()	A shortcut.
SubSelect	where(QueryPattern where)	Set the query pattern of this query
SubSelect	where(GraphPattern... queryPatterns)	Add graph patterns to this query's query pattern

Methods inherited from class Object

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

Methods inherited from interface GraphPattern

and, filter, filterExists, filterExists, filterNotExists, from, minus, optional, optional, union, values

Modifier and Type	Method	Description
default GraphPattern	and(GraphPattern... patterns)	Convert this graph pattern into a group graph pattern, combining this graph pattern with the given patterns:
default GraphPattern	filter(Expression<?> constraint)	Convert this graph pattern into a group graph pattern and add a filter:
default GraphPattern	filterExists(boolean exists, GraphPattern... patterns)	Create an EXISTS or NOT EXISTS filter expression with the given patterns based on the exists paramater and add it to this graph pattern (converting this to a group graph pattern in the process)
default GraphPattern	filterExists(GraphPattern... patterns)	Create an EXISTS{} filter expression with the given graph patterns and add it to this graph pattern (converting this to a group graph pattern in the process):
default GraphPattern	filterNotExists(GraphPattern... patterns)	Create a NOT EXISTS{} filter expression with the given graph patterns and add it to this graph pattern (converting this to a group graph pattern in the process):
default GraphPattern	from(GraphName name)	Convert this graph pattern into a named group graph pattern:
default GraphPattern	minus(GraphPattern... patterns)	Create a MINUS graph pattern with the given graph patterns and add it to this graph pattern (converting this to a group graph pattern in the process):
default GraphPattern	optional()	Convert this graph pattern into an optional group graph pattern:
default GraphPattern	optional(boolean isOptional)	Specify if this graph pattern should be optional.
default GraphPattern	union(GraphPattern... patterns)	Convert this graph pattern into an alternative graph pattern, combining this graph pattern with the given patterns:
default GraphPattern	values(Consumer<Values.VariablesBuilder> valuesConfigurer)

Constructor Details

SubSelect

public SubSelect()

Method Details

distinct

public SubSelect distinct()

Specify the query's projection to be distinct

Returns:

this

See Also:

• Projection.distinct()

distinct

public SubSelect distinct(boolean isDistinct)

Specify if the query's projection should be distinct or not

Parameters:

isDistinct - if this query's projection should be distinct

Returns:

this

See Also:

• Projection.distinct(boolean)

all

public SubSelect all()

Specify that this query's projection should select all in-scope expressions

NOTE: setting this takes precedence over any expressions added to the projection via select(Projectable...) when printing

Returns:

this

See Also:

• Projection.all()

all

public SubSelect all(boolean selectAll)

Specify if this query's projection should select all in-scope expressions or not.

NOTE: if called with true, this setting will take precedence over any expressions added to the projection via select(Projectable...) when printing

Parameters:

selectAll - if all in-scope expressions should be selected

Returns:

this

See Also:

• Projection.all(boolean)

select

public SubSelect select(Projectable... projectables)

Add expressions to the query's projection

NOTE: if SELECT * has been specified (by all() or calling all(boolean) with true), that will take precedence over specified expressions when converting to string via getQueryString()

Parameters:

projectables - expressions to add

Returns:

this

See Also:

• Projection.select(Projectable...)

select

public SubSelect select(Projection select)

Set this query's projection

Parameters:

select - the Projection to set

Returns:

this

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface GraphPattern

Returns:

if this pattern is a collection of GraphPatterns (ie., Group or Alternative patterns), returns if the collection contains any patterns

getQueryActionString

protected String getQueryActionString()

Specified by:

getQueryActionString in class Query<SubSelect>

getQueryString

public String getQueryString()

Specified by:

getQueryString in interface QueryElement

Overrides:

getQueryString in class Query<SubSelect>

Returns:

the String representing the SPARQL syntax of this element