Package io.deephaven.engine.table.impl.select

Class DisjunctiveFilter

java.lang.Object

io.deephaven.util.referencecounting.ReferenceCounted

io.deephaven.engine.liveness.ReferenceCountedLivenessReferent

io.deephaven.engine.liveness.ReferenceCountedLivenessNode

io.deephaven.engine.liveness.LivenessArtifact

io.deephaven.engine.table.impl.select.WhereFilterLivenessArtifactImpl

io.deephaven.engine.table.impl.select.ComposedFilter

io.deephaven.engine.table.impl.select.DisjunctiveFilter

All Implemented Interfaces:

ConcurrencyControl<Filter>, Expression, Filter, LogOutputAppendable, LivenessManager, LivenessNode, LivenessReferent, DependencyStreamProvider, WhereFilter, Serializable

public class DisjunctiveFilter
extends ComposedFilter

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface io.deephaven.engine.table.impl.select.WhereFilter

WhereFilter.PreviousFilteringNotSupported, WhereFilter.RecomputeListener, WhereFilter.Visitor<T>

Field Summary

Fields inherited from class io.deephaven.engine.table.impl.select.WhereFilterLivenessArtifactImpl

updateGraph

Fields inherited from interface io.deephaven.engine.table.impl.select.WhereFilter

ZERO_LENGTH_WHERE_FILTER_ARRAY

Method Summary

Modifier and Type	Method	Description
DisjunctiveFilter	copy()	Create a copy of this WhereFilter.
@NotNull WritableRowSet	filter(@NotNull RowSet selection, @NotNull RowSet fullSet, @NotNull Table table, boolean usePrev)	Filter selection to only matching rows.
@NotNull WritableRowSet	filterInverse(@NotNull RowSet selection, @NotNull RowSet fullSet, @NotNull Table table, boolean usePrev)	Filter selection to only non-matching rows.
static WhereFilter	makeDisjunctiveFilter(WhereFilter... componentFilters)
static WhereFilter	of(FilterOr ors)
static WhereFilter	of(WhereFilter... filters)
String	toString()
final <T> T	walk(WhereFilter.Visitor<T> visitor)	This method calls the appropriate visitor method based on the type of this WhereFilter.

Methods inherited from class io.deephaven.engine.table.impl.select.ComposedFilter

beginOperation, canMemoize, equals, getColumnArrays, getColumns, getComponentFilters, getDependencyStream, getFilters, hashCode, init, init, isRefreshing, isSerial, isSimpleFilter, permitParallelization, setRecomputeListener, validateSafeForRefresh

Methods inherited from class io.deephaven.engine.table.impl.select.WhereFilterLivenessArtifactImpl

isAutomatedFilter, setAutomatedFilter

Methods inherited from class io.deephaven.engine.liveness.LivenessArtifact

manageWithCurrentScope

Methods inherited from class io.deephaven.engine.liveness.ReferenceCountedLivenessNode

ensureCleanupOnGC, findAnyManagedReferent, forEachManagedReference, getWeakReference, initializeTransientFieldsForLiveness, onReferenceCountAtZero, tryManage, tryUnmanage, tryUnmanage

Methods inherited from class io.deephaven.engine.liveness.ReferenceCountedLivenessReferent

destroy, dropReference, tryRetainReference

Methods inherited from class io.deephaven.util.referencecounting.ReferenceCounted

append, decrementReferenceCount, forceReferenceCountToZero, getReferenceCountDebug, incrementReferenceCount, resetReferenceCount, tryDecrementReferenceCount, tryIncrementReferenceCount

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.deephaven.engine.liveness.LivenessManager

manage, unmanage, unmanage

Methods inherited from interface io.deephaven.engine.liveness.LivenessReferent

dropReference, getReferentDescription, retainReference, tryRetainReference

Methods inherited from interface io.deephaven.engine.table.impl.select.WhereFilter

filter, hasVirtualRowVariables, invert, walk, walk, withDeclaredBarriers, withRespectedBarriers, withSerial

Method Details

of

public static WhereFilter of(FilterOr ors)

of

public static WhereFilter of(WhereFilter... filters)

makeDisjunctiveFilter

public static WhereFilter makeDisjunctiveFilter(WhereFilter... componentFilters)

filter

@NotNull
public @NotNull WritableRowSet filter(@NotNull
 @NotNull RowSet selection,
 @NotNull
 @NotNull RowSet fullSet,
 @NotNull
 @NotNull Table table,
 boolean usePrev)

Description copied from interface: WhereFilter

Filter selection to only matching rows.

Parameters:

selection - the indices that should be filtered. The selection must be a subset of fullSet, and may include rows that the engine determines need not be evaluated to produce the result. Implementations may not mutate or close selection.

fullSet - the complete RowSet of the table to filter. The fullSet is used for calculating variables like "i" or "ii". Implementations may not mutate or close fullSet.

table - the table to filter

usePrev - true if previous values should be used. Implementing previous value filtering is optional, and a WhereFilter.PreviousFilteringNotSupported exception may be thrown. If a PreviousFiltering exception is thrown, then the caller must acquire the PeriodicUpdateGraph lock.

Returns:

The subset of selection accepted by this filter; ownership passes to the caller

filterInverse

@NotNull
public @NotNull WritableRowSet filterInverse(@NotNull
 @NotNull RowSet selection,
 @NotNull
 @NotNull RowSet fullSet,
 @NotNull
 @NotNull Table table,
 boolean usePrev)

Description copied from interface: WhereFilter

Filter selection to only non-matching rows.

Defaults to

 
 try (final WritableRowSet regular = filter(selection, fullSet, table, usePrev)) {
     return selection.minus(regular);
 }
 
 

Implementations are encouraged to override this when they can provide more efficient implementations.

Parameters:

selection - the indices that should be filtered. The selection must be a subset of fullSet, and may include rows that the engine determines need not be evaluated to produce the result. Implementations may not mutate or close selection.

fullSet - the complete RowSet of the table to filter. The fullSet is used for calculating variables like "i" or "ii". Implementations may not mutate or close fullSet.

table - the table to filter

usePrev - true if previous values should be used. Implementing previous value filtering is optional, and a WhereFilter.PreviousFilteringNotSupported exception may be thrown. If a PreviousFiltering exception is thrown, then the caller must acquire the PeriodicUpdateGraph lock.

Returns:

The subset of selection not accepted by this filter; ownership passes to the caller

copy

public DisjunctiveFilter copy()

Description copied from interface: WhereFilter

Create a copy of this WhereFilter.

Returns:

an independent copy of this WhereFilter.

toString

public String toString()

Overrides:

toString in class ReferenceCounted

walk

public final <T> T walk(WhereFilter.Visitor<T> visitor)

Description copied from interface: WhereFilter

This method calls the appropriate visitor method based on the type of this WhereFilter. This will invoke the most specific WhereFilter.Visitor method available.

Type Parameters:

T - the return value type

Parameters:

visitor - the visitor

Returns:

the value