org.chronos.chronosphere.api.query

Class SubQuery

java.lang.Object

org.chronos.chronosphere.api.query.SubQuery

public class SubQuery
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
SubQuery()

Method Summary

Modifier and Type	Method and Description
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	allReferencingEObjects() Navigates from an EObject to all other EObjects that reference it.
static <S> QueryStepBuilder<S,S>	and(QueryStepBuilder<S,?>... subqueries)
static <S> QueryStepBuilder<S,java.lang.Boolean>	asBoolean() Converts the elements in the current result set into Booleans.
static <S> NumericQueryStepBuilder<S,java.lang.Byte>	asByte() Converts the elements in the current result set into Bytes.
static <S> QueryStepBuilder<S,java.lang.Character>	asCharacter() Converts the elements in the current result set into Characters.
static <S> NumericQueryStepBuilder<S,java.lang.Double>	asDouble() Converts the elements in the current result set into Doubles.
static <S> EObjectQueryStepBuilder<S>	asEObject() Converts the elements in the current result set into EObjects.
static <S> NumericQueryStepBuilder<S,java.lang.Float>	asFloat() Converts the elements in the current result set into Floats.
static <S> NumericQueryStepBuilder<S,java.lang.Integer>	asInteger() Converts the elements in the current result set into Integers.
static <S> NumericQueryStepBuilder<S,java.lang.Long>	asLong() Converts the elements in the current result set into Longs.
static <S> NumericQueryStepBuilder<S,java.lang.Short>	asShort() Converts the elements in the current result set into Shorts.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	eAllContents() Navigates from an EObject to its eAllContents.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	eContainer() Navigates from an EObject to its eContainer.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	eContents() Navigates from an EObject to its eContents.
static UntypedQueryStepBuilder<org.eclipse.emf.ecore.EObject,java.lang.Object>	eGet(org.eclipse.emf.ecore.EAttribute eAttribute) Performs a EObject.eGet(EStructuralFeature) operation on all EObjects in the current result and forwards the result of this method.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	eGet(org.eclipse.emf.ecore.EReference eReference) Performs a EObject.eGet(EStructuralFeature) operation on all EObjects in the current result and forwards the result of this method.
static UntypedQueryStepBuilder<org.eclipse.emf.ecore.EObject,java.lang.Object>	eGet(java.lang.String eStructuralFeatureName) Performs a EObject.eGet(EStructuralFeature) operation on all EObjects in the current result and forwards the result of this method.
static <S> UntypedQueryStepBuilder<S,S>	filter(java.util.function.Predicate<S> predicate) Applies the given filter predicate to all elements in the current result.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	has(org.eclipse.emf.ecore.EStructuralFeature eStructuralFeature, java.lang.Object value) Filters all EObjects in the result set that have the given feature set to the given value.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	has(java.lang.String eStructuralFeatureName, java.lang.Object value) Filters all EObjects in the result set that have the given feature set to the given value.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	isInstanceOf(org.eclipse.emf.ecore.EClass eClass) Filters all EObjects that are an instance of the given EClass.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	isInstanceOf(org.eclipse.emf.ecore.EClass eClass, boolean allowSubclasses) Filters all EObjects that are an instance of the given EClass.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	isInstanceOf(java.lang.String eClassName) Filters all EObjects that are a (direct or indirect) instance of an EClass with the given name.
static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject>	isInstanceOf(java.lang.String eClassName, boolean allowSubclasses) Filters all EObjects that are a (direct or indirect) instance of an EClass with the given name.
static <S,E> UntypedQueryStepBuilder<S,E>	map(java.util.function.Function<S,E> function) Uses the given function to map each element from the current result set to a new element.
static <S> QueryStepBuilder<S,S>	named(java.lang.String stepName) Assigns the given name to this QueryStepBuilder.
static <S> UntypedQueryStepBuilder<S,S>	notNull() Filters out and discards all null values from the current result set.
static <S> QueryStepBuilder<S,S>	or(QueryStepBuilder<S,?>... subqueries)
static <S> QueryStepBuilder<S,java.lang.Object>	union(QueryStepBuilder<S,?>... subqueries)

Methods inherited from class java.lang.Object

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

Constructor Detail

SubQuery

public SubQuery()

Method Detail

filter

public static <S> UntypedQueryStepBuilder<S,S> filter(java.util.function.Predicate<S> predicate)

Applies the given filter predicate to all elements in the current result.

Parameters:

predicate - The predicate to apply. Must not be null. All elements for which the predicate function returns false will be filtered out and discarded.

Returns:

The query builder, for method chaining. Never null.

map

public static <S,E> UntypedQueryStepBuilder<S,E> map(java.util.function.Function<S,E> function)

Uses the given function to map each element from the current result set to a new element.

Parameters:

function - The mapping function to apply. Must not be null. Should be idempotent and side-effect free.

Returns:

The query step builder, for method chaining. Never null.

notNull

public static <S> UntypedQueryStepBuilder<S,S> notNull()

Filters out and discards all null values from the current result set.

This is the same as:

 query.filter(element -> element != null)
 

Returns:

The query step builder, for method chaining. Never null.

See Also:

filter(Predicate)

asEObject

public static <S> EObjectQueryStepBuilder<S> asEObject()

Converts the elements in the current result set into EObjects.

This method first checks if the element in question is an instance of EObject. If it is an EObject, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-EObjects will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asBoolean

public static <S> QueryStepBuilder<S,java.lang.Boolean> asBoolean()

Converts the elements in the current result set into Booleans.

This method first checks if the element in question is an instance of Boolean. If it is a Boolean, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Booleans will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asByte

public static <S> NumericQueryStepBuilder<S,java.lang.Byte> asByte()

Converts the elements in the current result set into Bytes.

This method first checks if the element in question is an instance of Byte. If it is a Byte, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Bytes will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asShort

public static <S> NumericQueryStepBuilder<S,java.lang.Short> asShort()

Converts the elements in the current result set into Shorts.

This method first checks if the element in question is an instance of Short. If it is a Short, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Shorts will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asCharacter

public static <S> QueryStepBuilder<S,java.lang.Character> asCharacter()

Converts the elements in the current result set into Characters.

This method first checks if the element in question is an instance of Character. If it is a Character, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Characters will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asInteger

public static <S> NumericQueryStepBuilder<S,java.lang.Integer> asInteger()

Converts the elements in the current result set into Integers.

This method first checks if the element in question is an instance of Integer. If it is a Integer, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Integers will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asLong

public static <S> NumericQueryStepBuilder<S,java.lang.Long> asLong()

Converts the elements in the current result set into Longs.

This method first checks if the element in question is an instance of Long. If it is a Long, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Longs will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asFloat

public static <S> NumericQueryStepBuilder<S,java.lang.Float> asFloat()

Converts the elements in the current result set into Floats.

This method first checks if the element in question is an instance of Float. If it is a Float, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Floats will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

asDouble

public static <S> NumericQueryStepBuilder<S,java.lang.Double> asDouble()

Converts the elements in the current result set into Doubles.

This method first checks if the element in question is an instance of Double. If it is a Double, it is cast down and forwarded. Otherwise, it is discarded, i.e. all non-Doubles will be filtered out. All null values will also be filtered out.

Returns:

The step builder, for method chaining. Never null.

named

public static <S> QueryStepBuilder<S,S> named(java.lang.String stepName)

Assigns the given name to this QueryStepBuilder.

Note that only the step is named. When coming back to this step, the query result may be different than it was when it was first reached, depending on the traversal.

Parameters:

stepName - The name of the step. Must not be null. Must be unique within the query.

Returns:

The named step, for method chaining. Never null.

union

@SafeVarargs
public static <S> QueryStepBuilder<S,java.lang.Object> union(QueryStepBuilder<S,?>... subqueries)

and

@SafeVarargs
public static <S> QueryStepBuilder<S,S> and(QueryStepBuilder<S,?>... subqueries)

or

@SafeVarargs
public static <S> QueryStepBuilder<S,S> or(QueryStepBuilder<S,?>... subqueries)

has

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> has(java.lang.String eStructuralFeatureName,
                                                                         java.lang.Object value)

Filters all EObjects in the result set that have the given feature set to the given value.

Any EObject that is an instance of an EClass which does not define any EAttribute or EReference with the given name will be discarded and filtered out.

For determining the feature, EClass.getEStructuralFeature(String) is used per EObject individually.

The value will be compared via Objects.equals(Object, Object).

Parameters:

eStructuralFeatureName - The name of the EStructuralFeature to filter by. Must not be null.

value - The value to filter by. May be null.

Returns:

The query builder, for method chaining. Never null.

has

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> has(org.eclipse.emf.ecore.EStructuralFeature eStructuralFeature,
                                                                         java.lang.Object value)

Filters all EObjects in the result set that have the given feature set to the given value.

Any EObject that belongs to an EClass that does not support the given feature will be discarded and filtered out.

The value will be compared via Objects.equals(Object, Object).

Parameters:

eStructuralFeature - The feature to filter by. Must not be null.

value - The value to filter by. Must not be null.

Returns:

The query builder, for method chaining. Never null.

isInstanceOf

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> isInstanceOf(org.eclipse.emf.ecore.EClass eClass)

Filters all EObjects that are an instance of the given EClass.

This method also considers polymorphism, i.e. instances of Sub-EClasses will pass this filter as well.

This operation is null-safe. Any null values will be discarded and filtered out.

Parameters:

eClass - The EClass to filter by. Must not be null.

Returns:

The query builder, for method chaining. Never null.

isInstanceOf

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> isInstanceOf(org.eclipse.emf.ecore.EClass eClass,
                                                                                  boolean allowSubclasses)

Filters all EObjects that are an instance of the given EClass.

This operation is null-safe. Any null values will be discarded and filtered out.

Parameters:

eClass - The EClass to filter by. Must not be null.

allowSubclasses - Whether or not to allow subclasses of the given class.

Returns:

The query builder, for method chaining. Never null.

isInstanceOf

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> isInstanceOf(java.lang.String eClassName)

Filters all EObjects that are a (direct or indirect) instance of an EClass with the given name.

This method also considers polymorphism, i.e. instances of Sub-EClasses will pass this filter as well.

This operation is null-safe. Any null values will be discarded and filtered out.

Parameters:

eClassName - The name of the EClass to search for. Must not be null.

Returns:

The query builder, for method chaining. Never null.

isInstanceOf

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> isInstanceOf(java.lang.String eClassName,
                                                                                  boolean allowSubclasses)

Filters all EObjects that are a (direct or indirect) instance of an EClass with the given name.

This operation is null-safe. Any null values will be discarded and filtered out.

Parameters:

eClassName - The name of the EClass to search for. Must not be null.

allowSubclasses - Whether or not to allow subclasses of the given class.

Returns:

The query builder, for method chaining. Never null.

eGet

public static UntypedQueryStepBuilder<org.eclipse.emf.ecore.EObject,java.lang.Object> eGet(java.lang.String eStructuralFeatureName)

Performs a EObject.eGet(EStructuralFeature) operation on all EObjects in the current result and forwards the result of this method.

If a given EObject does not have the EStructuralFeature set (i.e. EObject.eIsSet(EStructuralFeature) returns false), then no value will be passed onwards. In any other case, the returned value is passed onwards, even if that value is null.

Parameters:

eStructuralFeatureName - The name of the EStructuralFeature to get the value(s) for. Must not be null.

Returns:

The query builder, for method chaining. Never null.

eGet

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> eGet(org.eclipse.emf.ecore.EReference eReference)

Performs a EObject.eGet(EStructuralFeature) operation on all EObjects in the current result and forwards the result of this method.

If a given EObject does not have the EStructuralFeature set (i.e. EObject.eIsSet(EStructuralFeature) returns false), then no value will be passed onwards. In any other case, the returned value is passed onwards, even if that value is null.

Parameters:

eReference - The EReference to get the value(s) for. Must not be null.

Returns:

The query builder, for method chaining. Never null.

eGet

public static UntypedQueryStepBuilder<org.eclipse.emf.ecore.EObject,java.lang.Object> eGet(org.eclipse.emf.ecore.EAttribute eAttribute)

Performs a EObject.eGet(EStructuralFeature) operation on all EObjects in the current result and forwards the result of this method.

If a given EObject does not have the EStructuralFeature set (i.e. EObject.eIsSet(EStructuralFeature) returns false), then no value will be passed onwards. In any other case, the returned value is passed onwards, even if that value is null.

Parameters:

eAttribute - The EAttribute to get the value(s) for. Must not be null.

Returns:

The query builder, for method chaining. Never null.

eContainer

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> eContainer()

Navigates from an EObject to its eContainer.

Returns:

The query builder, for method chaining. Never null.

eContents

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> eContents()

Navigates from an EObject to its eContents.

Returns:

The query builder, for method chaining. Never null.

eAllContents

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> eAllContents()

Navigates from an EObject to its eAllContents.

Returns:

The query builder, for method chaining. Never null.

allReferencingEObjects

public static EObjectQueryStepBuilder<org.eclipse.emf.ecore.EObject> allReferencingEObjects()

Navigates from an EObject to all other EObjects that reference it.

This means walking backwards all EReference instances that have the current EObject as target. This method will include the eContainer.

Returns:

The query builder, for method chaining. Never null.