Package org.apache.druid.frame.key

Class FrameComparisonWidgetImpl

java.lang.Object

org.apache.druid.frame.key.FrameComparisonWidgetImpl

All Implemented Interfaces:

FrameComparisonWidget

public class FrameComparisonWidgetImpl
extends Object
implements FrameComparisonWidget

Implementation of FrameComparisonWidget for pairs of FrameType.ROW_BASED frames. Comparison logic in this class is very similar to RowKeyComparator, but is different because it works on Frames instead of byte[].

Method Summary

Modifier and Type	Method	Description
int	compare(int row, FrameComparisonWidget otherWidget, int otherRow)	Compare a specific row of this frame to a specific row of another frame.
int	compare(int row, RowKey key)	Compare a specific row of this frame to the provided key.
static FrameComparisonWidgetImpl	create(Frame frame, RowSignature signature, List<KeyColumn> keyColumns, List<FieldReader> keyColumnReaders)	Create a FrameComparisonWidget for the given frame.
boolean	isCompletelyNonNullKey(int row)	Whether a particular row has no null fields in its comparison key.
RowKey	readKey(int row)	Returns the RowKey corresponding to a particular row.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static FrameComparisonWidgetImpl create(Frame frame,
                                               RowSignature signature,
                                               List<KeyColumn> keyColumns,
                                               List<FieldReader> keyColumnReaders)

Create a FrameComparisonWidget for the given frame. Only possible for frames of type FrameType.ROW_BASED. The provided keyColumns must be a prefix of FrameReader.signature().

Parameters:

frame - frame, must be FrameType.ROW_BASED

signature - signature for the frame

keyColumns - columns to sort by

keyColumnReaders - readers for key columns

readKey

public RowKey readKey(int row)

Description copied from interface: FrameComparisonWidget

Returns the RowKey corresponding to a particular row. The returned key is a copy that does not reference memory of the underlying Frame.

Specified by:

readKey in interface FrameComparisonWidget

isCompletelyNonNullKey

public boolean isCompletelyNonNullKey(int row)

Description copied from interface: FrameComparisonWidget

Whether a particular row has no null fields in its comparison key. When NullHandling.replaceWithDefault(), default values (like empty strings and numeric zeroes) are considered null for purposes of this method. This behavior is inherited from FieldReader.isNull(Memory, long) and enables join code to behave similarly in MSQ and native queries.

Specified by:

isCompletelyNonNullKey in interface FrameComparisonWidget

compare

public int compare(int row,
                   RowKey key)

Description copied from interface: FrameComparisonWidget

Compare a specific row of this frame to the provided key. The key must have been created with sortColumns that match the ones used to create this widget, or else results are undefined.

Specified by:

compare in interface FrameComparisonWidget

compare

public int compare(int row,
                   FrameComparisonWidget otherWidget,
                   int otherRow)

Description copied from interface: FrameComparisonWidget

Compare a specific row of this frame to a specific row of another frame. The other frame must have the same sort key, or else results are undefined. The other frame may be the same object as this frame; for example, this is used by FrameSort to sort frames in-place.

Specified by:

compare in interface FrameComparisonWidget