CQL (cds4j:api 1.12.1 API)

```
public interface CQL
```

Method Summary

All Methods Static Methods Default Methods
Modifier and Type	Method and Description
`static Predicate`	`and(CqnPredicate p1, CqnPredicate p2)` Creates a conjunction of two given predicates
`static Predicate`	`and(Iterable<? extends CqnPredicate> predicates)` Creates a conjunction of given predicates
`static BooleanFunction`	`booleanFunc(String name, List<? extends CqnValue> args)` Creates a CDS QL function call that is send to the underlying data store.
`static Predicate`	`comparison(CqnValue lhs, CqnComparisonPredicate.Operator op, CqnValue rhs)` Creates a comparison predicate.
`static Predicate`	`connect(CqnConnectivePredicate.Operator operator, Iterable<? extends CqnPredicate> predicates)` Creates a logical connection of given predicates `CqnPredicate`.
`static Predicate`	`copy(CqnPredicate pred)` Creates a copy of the given predicate.
`static Predicate`	`copy(CqnPredicate pred, CqnModifier modifier)` Creates a modified copy of the given predicate.
`static <S extends CqnStatement> S`	`copy(S statement)` Creates a copy of the given CQN statement.
`static <S extends CqnStatement> S`	`copy(S statement, CqnModifier modifier)` Creates a modified copy of the given CQN statement.
`static Value<Long>`	`count()` Creates a count all function call.
`static Value<Long>`	`count(CqnElementRef element)` Creates a count function call on the given element.
`static StructuredType<?>`	`entity(String qualifiedName)` Creates a `StructuredType` representing a CDS entity.
`static Predicate`	`exists(CqnSelect subQuery)` Creates an exists predicate that tests if a given subquery returns any row
`static <T> FunctionCall<T>`	`func(String name, CqnValue... args)` Creates a CDS QL function call that is send to the underlying data store.
`static <T> FunctionCall<T>`	`func(String name, List<? extends CqnValue> args)` Creates a CDS QL function call that is send to the underlying data store.
`static <T> ElementRef<T>`	`get(List<? extends CqnReference.Segment> segments)` Creates an `ElementRef` representing a path from a CDS entity to an element of this or another entity.
`static <T> ElementRef<T>`	`get(String path)` Creates an `ElementRef` representing a path from a CDS entity to an element of this or another entity.
`static Predicate`	`in(CqnValue lhs, Collection<? extends CqnValue> values)` Creates an in predicate.
`static <T> Literal<T>`	`literal(T value)` Creates a CDS QL `Literal` to be used in queries.
`static Predicate`	`not(CqnPredicate predicate)` Negates a given `CqnPredicate`.
`static Value<Instant>`	`now()` Creates an `ElementRef` to be used in queries to represent $now.
`static Predicate`	`or(CqnPredicate p1, CqnPredicate p2)` Creates a disjunction of two given predicates
`static Predicate`	`or(Iterable<? extends CqnPredicate> predicates)` Creates a disjunction of given predicates
`static <T> Parameter<T>`	`param()` Creates a CDS QL positional `Parameter` to be used in queries.
`static <T> Parameter<T>`	`param(String name)` Creates a CDS QL named `Parameter` to be used in queries.
`static Value<?>`	`plain(String value)` Creates a CQN plain value, which is directly send to the underlying data store.
`static Predicate`	`search(String term)` Creates a search predicate.
`static CqnStar`	`star()`
`static StructuredType<?>`	`to(List<? extends CqnReference.Segment> segments)` Creates a `StructuredType` representing a path from a CDS entity to another entity.
`static StructuredType<?>`	`to(String path)` Creates a `StructuredType` representing a path from a CDS entity to another entity.
`static Value<String>`	`toLower(String val)` Creates a CDS QL expression for converting the given string value to lower case using the rules of the underlying data store.
`static Value<String>`	`toLower(Value<String> val)` Creates a CDS QL expression for converting the given string value to lower case using the rules of the underlying data store.
`static Value<String>`	`toUpper(String val)` Creates a CDS QL expression for converting the given string value to upper case using the rules of the underlying data store.
`static Value<String>`	`toUpper(Value<String> val)` Creates a CDS QL expression for converting the given string value to upper case using the rules of the underlying data store.
`static Value<String>`	`userId()` Creates an `ElementRef` on the available $user.id value.
`static Value<String>`	`userLocale()` Creates an `ElementRef` on the available $user.locale value.
`static Value<Instant>`	`validFrom()` Creates an `ElementRef` on the available $validFrom value.
`static Value<Instant>`	`validTo()` Creates an `ElementRef` on the available $validTo value.

- Method Detail
  - copy
```
static Predicate copy(CqnPredicate pred)
```
    Creates a copy of the given predicate.
    
    Parameters:
    
    pred - the predicate to be copied
    
    Returns:
    
    the copy
  - copy
```
static Predicate copy(CqnPredicate pred,
                      CqnModifier modifier)
```
    Creates a modified copy of the given predicate.
    
    Parameters:
    
    pred - the predicate to be copied
    
    modifier - the modifier for altering the copy
    
    Returns:
    
    the modified copy
  - copy
```
static <S extends CqnStatement> S copy(S statement)
```
    Creates a copy of the given CQN statement.
    
    Type Parameters:
    
    S - the type of CqnStatement
    
    Parameters:
    
    statement - the CQN statement to be copied
    
    Returns:
    
    the copy
  - copy
```
static <S extends CqnStatement> S copy(S statement,
                                       CqnModifier modifier)
```
    Creates a modified copy of the given CQN statement.
    
    Type Parameters:
    
    S - the type of CqnStatement
    
    Parameters:
    
    statement - the CQN statement to be copied
    
    modifier - the modifier for altering the copy
    
    Returns:
    
    the modified copy
  - func
```
static <T> FunctionCall<T> func(String name,
                                CqnValue... args)
```
    Creates a CDS QL function call that is send to the underlying data store.
    
    Type Parameters:
    
    T - the return type of the function call
    
    Parameters:
    
    name - the name of the function to be called
    
    args - the arguments of the function
    
    Returns:
    
    the CDS QL function call
  - func
```
static <T> FunctionCall<T> func(String name,
                                List<? extends CqnValue> args)
```
    Creates a CDS QL function call that is send to the underlying data store.
    
    Type Parameters:
    
    T - the return type of the function call
    
    Parameters:
    
    name - the name of the function to be called
    
    args - the arguments of the function
    
    Returns:
    
    the CDS QL function call
  - booleanFunc
```
static BooleanFunction booleanFunc(String name,
                                   List<? extends CqnValue> args)
```
    Creates a CDS QL function call that is send to the underlying data store.
    
    Parameters:
    
    name - the name of the function to be called
    
    args - the arguments of the function
    
    Returns:
    
    the CDS QL function call
  - literal
```
static <T> Literal<T> literal(T value)
```
    Creates a CDS QL Literal to be used in queries.
    
    Type Parameters:
    
    T - the type of the literal
    
    Parameters:
    
    value - the value of the literal
    
    Returns:
    
    the literal
  - not
```
static Predicate not(CqnPredicate predicate)
```
    Negates a given CqnPredicate.
    
    Parameters:
    
    predicate - the CqnPredicate to be negated
    
    Returns:
    
    the negated predicate
  - and
```
static Predicate and(CqnPredicate p1,
                     CqnPredicate p2)
```
    Creates a conjunction of two given predicates
    
    Parameters:
    
    p1 - 1st operand of the conjunction
    
    p2 - 2nd operand of the conjunction
    
    Returns:
    
    the conjunction
  - or
```
static Predicate or(CqnPredicate p1,
                    CqnPredicate p2)
```
    Creates a disjunction of two given predicates
    
    Parameters:
    
    p1 - 1st operand of the disjunction
    
    p2 - 2nd operand of the disjunction
    
    Returns:
    
    the disjunction
  - and
```
static Predicate and(Iterable<? extends CqnPredicate> predicates)
```
    Creates a conjunction of given predicates
    
    Parameters:
    
    predicates - the predicates to connect
    
    Returns:
    
    the conjunction
  - or
```
static Predicate or(Iterable<? extends CqnPredicate> predicates)
```
    Creates a disjunction of given predicates
    
    Parameters:
    
    predicates - the predicates to connect
    
    Returns:
    
    the disjunction
  - connect
```
static Predicate connect(CqnConnectivePredicate.Operator operator,
                         Iterable<? extends CqnPredicate> predicates)
```
    Creates a logical connection of given predicates CqnPredicate.
    
    Parameters:
    
    operator - operator to connect the predicates with
    
    predicates - the predicates to connect
    
    Returns:
    
    the logical connection
  - param
```
static <T> Parameter<T> param()
```
    Creates a CDS QL positional Parameter to be used in queries.
    
    Type Parameters:
    
    T - the type of the parameter
    
    Returns:
    
    the parameter
  - param
```
static <T> Parameter<T> param(String name)
```
    Creates a CDS QL named Parameter to be used in queries.
    
    Type Parameters:
    
    T - the type of the parameter
    
    Parameters:
    
    name - the parameter name
    
    Returns:
    
    the parameter
  - plain
```
static Value<?> plain(String value)
```
    Creates a CQN plain value, which is directly send to the underlying data store.
    
    Parameters:
    
    value - the value content
    
    Returns:
    
    the plain value
  - count
```
static Value<Long> count()
```
    Creates a count all function call.
    
    Returns:
    
    the count value
  - count
```
static Value<Long> count(CqnElementRef element)
```
    Creates a count function call on the given element.
    
    Parameters:
    
    element - the ref to the element to be counted
    
    Returns:
    
    the count value
  - toLower
```
static Value<String> toLower(Value<String> val)
```
    Creates a CDS QL expression for converting the given string value to lower case using the rules of the underlying data store.
    
    Parameters:
    
    val - the String value to be converted
    
    Returns:
    
    the CDS QL expression for lower case conversion
  - toLower
```
static Value<String> toLower(String val)
```
    Creates a CDS QL expression for converting the given string value to lower case using the rules of the underlying data store.
    
    Parameters:
    
    val - the String value to be converted
    
    Returns:
    
    the CDS QL expression for lower case conversion
  - toUpper
```
static Value<String> toUpper(Value<String> val)
```
    Creates a CDS QL expression for converting the given string value to upper case using the rules of the underlying data store.
    
    Parameters:
    
    val - the String value to be converted
    
    Returns:
    
    the CDS QL expression for upper case conversion
  - toUpper
```
static Value<String> toUpper(String val)
```
    Creates a CDS QL expression for converting the given string value to upper case using the rules of the underlying data store.
    
    Parameters:
    
    val - the String value to be converted
    
    Returns:
    
    the CDS QL expression for upper case conversion
  - entity
```
static StructuredType<?> entity(String qualifiedName)
```
    Creates a StructuredType representing a CDS entity.
    
    Parameters:
    
    qualifiedName - the qualified name of the CDS entity
    
    Returns:
    
    the StructuredType representing the CDS entity
  - to
```
static StructuredType<?> to(String path)
```
    Creates a StructuredType representing a path from a CDS entity to another entity.
    
    Parameters:
    
    path - a String of association element names separated by '.'
    
    Returns:
    
    the StructuredType representing the path to a CDS entity
  - to
```
static StructuredType<?> to(List<? extends CqnReference.Segment> segments)
```
    Creates a StructuredType representing a path from a CDS entity to another entity.
    
    Parameters:
    
    segments - the segments of the path
    
    Returns:
    
    the StructuredType representing the path to a CDS entity
  - get
```
static <T> ElementRef<T> get(String path)
```
    Creates an ElementRef representing a path from a CDS entity to an element of this or another entity.
    
    Type Parameters:
    
    T - the type of the element
    
    Parameters:
    
    path - a String of element names separated by '.', where all except the last segment represent association elements.
    
    Returns:
    
    the ElementRef representing the path to the CDS element
  - get
```
static <T> ElementRef<T> get(List<? extends CqnReference.Segment> segments)
```
    Creates an ElementRef representing a path from a CDS entity to an element of this or another entity.
    
    Type Parameters:
    
    T - the type of the element
    
    Parameters:
    
    segments - the segments of the path
    
    Returns:
    
    the ElementRef representing the path to the CDS element
  - comparison
```
static Predicate comparison(CqnValue lhs,
                            CqnComparisonPredicate.Operator op,
                            CqnValue rhs)
```
    Creates 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:
    
    the comparison predicate
  - in
```
static Predicate in(CqnValue lhs,
                    Collection<? extends CqnValue> values)
```
    Creates an in predicate.
    
    Parameters:
    
    lhs - the value to be checked if it's contained in the collection
    
    values - the collection of values
    
    Returns:
    
    the in predicate
  - search
```
static Predicate search(String term)
```
    Creates a search predicate.
    
    Parameters:
    
    term - the search term
    
    Returns:
    
    the search predicate
  - exists
```
static Predicate exists(CqnSelect subQuery)
```
    Creates an exists predicate that tests if a given subquery returns any row
    
    Parameters:
    
    subQuery - the subquery that performs the existence test
    
    Returns:
    
    the exists predicate
  - now
```
static Value<Instant> now()
```
    Creates an ElementRef to be used in queries to represent $now.
    
    Returns:
    
    the now value
  - validFrom
```
static Value<Instant> validFrom()
```
    Creates an ElementRef on the available $validFrom value.
    
    Returns:
    
    the validFrom value
  - validTo
```
static Value<Instant> validTo()
```
    Creates an ElementRef on the available $validTo value.
    
    Returns:
    
    the validTo value
  - userLocale
```
static Value<String> userLocale()
```
    Creates an ElementRef on the available $user.locale value.
    
    Returns:
    
    the locale string value
  - userId
```
static Value<String> userId()
```
    Creates an ElementRef on the available $user.id value.
    
    Returns:
    
    the user.id value
  - star
```
static CqnStar star()
```

Interface CQL

Method Summary

Method Detail

copy

copy

copy

copy

func

func

booleanFunc

literal

not

and

or

and

or

connect

param

param

plain

count

count

toLower

toLower

toUpper

toUpper

entity

to

to

get

get

comparison

in

search

exists

now

validFrom

validTo

userLocale

userId

star