com.sap.cds.ql.cqn

Interface Modifier

All Superinterfaces:

CompatibilityDefaults

All Known Subinterfaces:

CqnModifier

@Beta
public interface Modifier
extends CompatibilityDefaults

Provider interface for modifying CQN Predicates, Values and Statements copied with CQL.copy. Override the default methods to replace specific parts of the statement / predicate.

Nested Class Summary

Nested classes/interfaces inherited from interface com.sap.cds.ql.cqn.CompatibilityDefaults

CompatibilityDefaults.SPI<T>

Method Summary

Modifier and Type	Method and Description
default Predicate	booleanFunction(String name, List<Value<?>> args) Override this method to replace a predicate function call.
default Predicate	comparison(Value<?> lhs, CqnComparisonPredicate.Operator op, Value<?> rhs) Override this method to replace a comparison predicate.
default Predicate	connective(CqnConnectivePredicate.Operator op, List<Predicate> predicates) Override this method to replace a logical connection predicate, which connects multiple predicates with the given operator.
default Predicate	containment(CqnContainmentTest.Position position, CqnValue value, CqnValue term, boolean caseInsensitive) Override this method to replace a containment test predicate.
default boolean	distinct(boolean distinct) Override this method to set the distinct flag of Select statements.
default Set<String>	excluding(Set<String> excluding) Override this method to modify the exclude list of Select statements.
default Predicate	exists(Select<?> subQuery) Override this method to replace an exist subquery.
default CqnSelectListItem	expand(CqnExpand expand) Override this method to replace expand lists.
default Value<?>	expression(Value<Number> left, CqnArithmeticExpression.Operator op, Value<Number> right, String type) Override this method to replace an arithmetic expression.
default Value<?>	function(String name, List<Value<?>> args, String type) Override this method to replace a function call.
default List<CqnValue>	groupBy(List<CqnValue> values) Override this method to modify the groupBy clause of Select statements.
default CqnPredicate	having(Predicate having) Override this method to modify the having clause of Select statements.
default Predicate	in(Value<?> value, CqnValue valueSet) Override this method to replace an in predicate that check if the given value is equal to any value in a valueSet.
default CqnSelectListItem	inline(CqnInline inline) Override this method to replace inline lists.
default boolean	inlineCount(boolean inlineCount) Override this method to set the inline count flag of Select statements.
default List<CqnSelectListItem>	items(List<CqnSelectListItem> items) Override this method to modify the select list items of Select statements.
default CqnValue	list(List<Value<?>> values) Override this method to replace a list value with another CqnValue.
default CqnValue	literal(CqnLiteral<?> value) Override this method to replace a literal value with another CqnValue.
default CqnPredicate	match(CqnMatchPredicate match) Override this method to replace a match predicate.
default Predicate	negation(Predicate predicate) Override this method to replace a logical negation.
default List<CqnSortSpecification>	orderBy(List<CqnSortSpecification> sortSpecs) Override this method to modify the orderBy clause of Select statements.
default Value<?>	parameter(String name, String cdsType)
default Value<?>	plain(String plain, String cdsType)
default CqnValue	ref(CqnElementRef ref) Override this method to replace an element ref with another CqnValue.
default CqnStructuredTypeRef	ref(CqnStructuredTypeRef ref) Override this method to replace a structured type ref.
default Predicate	search(Predicate search) Override this method to set the search clause of Select statements.
default Predicate	search(String term) Override this method to replace a search predicate.
default Set<String>	searchableElements(Set<String> searchableElements) Override this method to set the searchable elements of Select statements.
default List<CqnSelectListItem>	selectAll() Override this method to replace asterisk (*) on the select list of Select statements.
default CqnSelectListItem	selectListValue(Value<?> value, String alias) Override this method to replace values on the select list of Select statements.
default long	skip(long skip) Override this method to set skip of Select statements.
default CqnSortSpecification	sort(Value<?> value, CqnSortSpecification.Order order) Override this method to replace specific sort specs in the orderBy clause of Select statements.
default long	top(long top) Override this method to set the top limit of Select statements.
default Predicate	where(Predicate where) Override this method to set the where clause of filterable statements.

Methods inherited from interface com.sap.cds.ql.cqn.CompatibilityDefaults

_mutableCopy, expand, expand, in, inline, limit, match, ref, ref, selectListItem

Method Detail

ref

default CqnStructuredTypeRef ref(CqnStructuredTypeRef ref)

Override this method to replace a structured type ref.

Specified by:

ref in interface CompatibilityDefaults

Parameters:

ref - the immutable CqnStructuredTypeRef

Returns:

the replacement ref

See Also:

CQL.to(segments).asRef() to create a new ref, CQL.copy(ref) to create a modifiable copy of the ref

ref

default CqnValue ref(CqnElementRef ref)

Override this method to replace an element ref with another CqnValue.

Specified by:

ref in interface CompatibilityDefaults

Parameters:

ref - the immutable CqnElementRef

Returns:

a value replacing the ref

See Also:

CQL.get(segments) to create a new ref, CQL.copy(ref) to create a modifiable copy of the ref

literal

default CqnValue literal(CqnLiteral<?> value)

Override this method to replace a literal value with another CqnValue.

Parameters:

value - the immutable CqnLiteral value

Returns:

a value replacing the CqnLiteral

See Also:

CQL.val(T), CQL.constant(T)

parameter

@Beta
default Value<?> parameter(String name,
                                 String cdsType)

plain

@Beta
default Value<?> plain(String plain,
                             String cdsType)

list

default CqnValue list(List<Value<?>> values)

Override this method to replace a list value with another CqnValue.

Parameters:

values - the list of values

Returns:

a CqnValue replacing the CqnListValue

See Also:

CQL.list(java.util.List<? extends com.sap.cds.ql.cqn.CqnValue>)

expression

default Value<?> expression(Value<Number> left,
                            CqnArithmeticExpression.Operator op,
                            Value<Number> right,
                            String type)

Override this method to replace an arithmetic expression.

Parameters:

left - the left-hand side of the expression

op - the operator

right - the right-hand side of the expression

type - the return type of the expression

Returns:

a Value replacing the arithmetic expression

See Also:

CQL.expression(com.sap.cds.ql.cqn.CqnValue, com.sap.cds.ql.cqn.CqnArithmeticExpression.Operator, com.sap.cds.ql.cqn.CqnValue)

function

default Value<?> function(String name,
                          List<Value<?>> args,
                          String type)

Override this method to replace a function call.

Parameters:

name - the name of the function

args - the arguments of the function

type - the return type of the function call

Returns:

a Value replacing the function call

See Also:

CQL.func(java.lang.String, com.sap.cds.ql.cqn.CqnValue...)

booleanFunction

default Predicate booleanFunction(String name,
                                  List<Value<?>> args)

Override this method to replace a predicate function call.

Parameters:

name - the name of the function

args - the arguments of the function

Returns:

a Predicate replacing the Boolean function call

See Also:

CQL.booleanFunc(java.lang.String, java.util.List<? extends com.sap.cds.ql.cqn.CqnValue>)

comparison

default Predicate comparison(Value<?> lhs,
                             CqnComparisonPredicate.Operator op,
                             Value<?> rhs)

Override this method to replace a comparison predicate.

Parameters:

lhs - the left-hand side of the comparison

op - the comparison operator

rhs - the right-hand side of the comparison

Returns:

a Predicate replacing the comparison

See Also:

CQL.comparison(com.sap.cds.ql.cqn.CqnValue, com.sap.cds.ql.cqn.CqnComparisonPredicate.Operator, com.sap.cds.ql.cqn.CqnValue)

in

default Predicate in(Value<?> value,
                     CqnValue valueSet)

Override this method to replace an in predicate that check if the given value is equal to any value in a valueSet.

Specified by:

in in interface CompatibilityDefaults

Parameters:

value - the value to be checked if it's contained in the set

valueSet - the collection of values, usually a list

Returns:

a Predicate replacing the CqnInPredicate

See Also:

CQL.in(com.sap.cds.ql.cqn.CqnValue, java.util.Collection<? extends com.sap.cds.ql.cqn.CqnValue>)

connective

default Predicate connective(CqnConnectivePredicate.Operator op,
                             List<Predicate> predicates)

Override this method to replace a logical connection predicate, which connects multiple predicates with the given operator.

Parameters:

op - the connective operator (AND/OR)

predicates - the list of connected predicates

Returns:

a Predicate replacing the logical connection

See Also:

CQL.connect(com.sap.cds.ql.cqn.CqnConnectivePredicate.Operator, java.lang.Iterable<? extends com.sap.cds.ql.cqn.CqnPredicate>), CQL.and(com.sap.cds.ql.cqn.CqnPredicate, com.sap.cds.ql.cqn.CqnPredicate), CQL.or(com.sap.cds.ql.cqn.CqnPredicate, com.sap.cds.ql.cqn.CqnPredicate)

negation

default Predicate negation(Predicate predicate)

Override this method to replace a logical negation.

Parameters:

predicate - the predicate of the negation

Returns:

a Predicate replacing the negation

See Also:

CQL.not(com.sap.cds.ql.cqn.CqnPredicate)

exists

default Predicate exists(Select<?> subQuery)

Override this method to replace an exist subquery.

Parameters:

subQuery - the query of the exists predicate

Returns:

a Predicate replacing the CqnExistsSubquery

See Also:

CQL.exists(com.sap.cds.ql.cqn.CqnSelect)

match

default CqnPredicate match(CqnMatchPredicate match)

Override this method to replace a match predicate.

Specified by:

match in interface CompatibilityDefaults

Parameters:

match - the match predicate

Returns:

a CqnPredicate replacing the CqnMatchPredicate

See Also:

CQL.match(com.sap.cds.ql.cqn.CqnStructuredTypeRef, com.sap.cds.ql.cqn.CqnPredicate, com.sap.cds.ql.cqn.CqnMatchPredicate.Quantifier)

containment

default Predicate containment(CqnContainmentTest.Position position,
                              CqnValue value,
                              CqnValue term,
                              boolean caseInsensitive)

Override this method to replace a containment test predicate.

Parameters:

position - the position

value - the string value

term - the term to test for

caseInsensitive - whether the test should be case insensitive

Returns:

a Predicate replacing the CqnContainmentTest

See Also:

CQL.containment(com.sap.cds.ql.cqn.CqnContainmentTest.Position, com.sap.cds.ql.cqn.CqnValue, com.sap.cds.ql.cqn.CqnValue, boolean)

search

default Predicate search(String term)

Override this method to replace a search predicate.

Parameters:

term - the search term

Returns:

a Predicate replacing the CqnSearchPredicate

See Also:

CQL.search(java.lang.String)

where

default Predicate where(Predicate where)

Override this method to set the where clause of filterable statements.

Parameters:

where - the where clause of the statement, or null

Returns:

a Predicate replacing the where clause

search

default Predicate search(Predicate search)

Override this method to set the search clause of Select statements.

Parameters:

search - the search clause of the statement, or null

Returns:

a Predicate replacing the search clause

searchableElements

default Set<String> searchableElements(Set<String> searchableElements)

Override this method to set the searchable elements of Select statements.

Parameters:

searchableElements - the searchable elements of the statement

Returns:

the set of searchable elements

inline

default CqnSelectListItem inline(CqnInline inline)

Override this method to replace inline lists. Use CQL.to(segments).inline(items) to create a new inline.

Specified by:

inline in interface CompatibilityDefaults

Parameters:

inline - the CqnInline

Returns:

a CqnSelectListItem replacing the inline

expand

default CqnSelectListItem expand(CqnExpand expand)

Override this method to replace expand lists. To create a new expand, use CQL.to(segments).expand(items). To create a modifiable copy of the expand, use CQL.copy(expand).

Specified by:

expand in interface CompatibilityDefaults

Parameters:

expand - the CqnExpand

Returns:

a CqnSelectListItem replacing the expand

selectListValue

@Beta
default CqnSelectListItem selectListValue(Value<?> value,
                                                String alias)

Override this method to replace values on the select list of Select statements.

Specified by:

selectListValue in interface CompatibilityDefaults

Parameters:

value - the value

alias - the alias

Returns:

a CqnSelectListItem replacing the value

selectAll

default List<CqnSelectListItem> selectAll()

Override this method to replace asterisk (*) on the select list of Select statements.

Returns:

a CqnSelectListItem replacing the asterisk

items

default List<CqnSelectListItem> items(List<CqnSelectListItem> items)

Override this method to modify the select list items of Select statements.

Parameters:

items - the list of selected items

Returns:

the new list of items

excluding

default Set<String> excluding(Set<String> excluding)

Override this method to modify the exclude list of Select statements.

Parameters:

excluding - the names of the excluded elements

Returns:

a set of names to be excluded from the Select result

groupBy

default List<CqnValue> groupBy(List<CqnValue> values)

Override this method to modify the groupBy clause of Select statements.

Parameters:

values - the groupBy list of the Select statement

Returns:

a list of values to group by

having

@Beta
default CqnPredicate having(Predicate having)

Override this method to modify the having clause of Select statements.

Parameters:

having - the having clause of the Select statement

Returns:

a Predicate replacing the having clause

orderBy

default List<CqnSortSpecification> orderBy(List<CqnSortSpecification> sortSpecs)

Override this method to modify the orderBy clause of Select statements.

Parameters:

sortSpecs - the orderBy list of the Select statement

Returns:

a list of CqnSortSpecification defining the order of the result

sort

default CqnSortSpecification sort(Value<?> value,
                                  CqnSortSpecification.Order order)

Override this method to replace specific sort specs in the orderBy clause of Select statements.

Parameters:

value - the value of the sort spec

order - the sort order

Returns:

a sort spec

See Also:

CQL.sort(com.sap.cds.ql.cqn.CqnValue, com.sap.cds.ql.cqn.CqnSortSpecification.Order)

distinct

default boolean distinct(boolean distinct)

Override this method to set the distinct flag of Select statements.

Parameters:

distinct - the distinct flag of the Select statement

Returns:

the new distinct flag

inlineCount

default boolean inlineCount(boolean inlineCount)

Override this method to set the inline count flag of Select statements.

Parameters:

inlineCount - the inline count flag of the Select statement

Returns:

the new inline count flag

top

default long top(long top)

Override this method to set the top limit of Select statements.

Parameters:

top - the top limit of the Select statement

Returns:

the new maximum number of rows to be selected or -1 for unlimited

skip

default long skip(long skip)

Override this method to set skip of Select statements.

Parameters:

skip - the skip number of the Select statement

Returns:

the new number of rows that shall be skipped