org.apache.arrow.vector.complex

Class AbstractMapVector

java.lang.Object

org.apache.arrow.vector.complex.AbstractContainerVector

org.apache.arrow.vector.complex.AbstractMapVector

All Implemented Interfaces:

Closeable, AutoCloseable, Iterable<ValueVector>, ValueVector

Direct Known Subclasses:

MapVector

public abstract class AbstractMapVector
extends AbstractContainerVector

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.arrow.vector.ValueVector

ValueVector.Accessor, ValueVector.Mutator

Field Summary

Fields inherited from class org.apache.arrow.vector.complex.AbstractContainerVector

allocator, callBack, name

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractMapVector(String name, BufferAllocator allocator, CallBack callBack)

Method Summary

Methods

Modifier and Type	Method and Description
protected ValueVector	add(String name, Types.MinorType minorType, int... precisionScale)
<T extends FieldVector> T	addOrGet(String name, Types.MinorType minorType, Class<T> clazz, int... precisionScale) Adds a new field with the given parameters or replaces the existing one and consequently returns the resultant ValueVector.
boolean	allocateNewSafe() Allocates new buffers.
void	close() Clears out all underlying child vectors.
ArrowBuf[]	getBuffers(boolean clear) Return the underlying buffers associated with this vector.
int	getBufferSize() Returns the number of bytes that is used by this vector instance.
<T extends FieldVector> T	getChild(String name, Class<T> clazz) Returns a ValueVector instance of subtype of corresponding to the given field name if exists or null.
ValueVector	getChildByOrdinal(int id) Returns a ValueVector corresponding to the given ordinal identifier.
protected List<String>	getChildFieldNames()
protected List<FieldVector>	getChildren() Returns a sequence of underlying child vectors.
VectorWithOrdinal	getChildVectorWithOrdinal(String name) Returns a vector with its corresponding ordinal mapping if field exists or null.
List<ValueVector>	getPrimitiveVectors() Returns a list of scalar child vectors recursing the entire vector hierarchy.
Iterator<ValueVector>	iterator()
protected void	putChild(String name, FieldVector vector) Inserts the vector with the given name if it does not exist else replaces it with the new value.
protected void	putVector(String name, FieldVector vector) Inserts the input vector into the map if it does not exist, replaces if it exists already
int	size() Returns the number of underlying child vectors.

Methods inherited from class org.apache.arrow.vector.complex.AbstractContainerVector

allocateNew, getAllocator, getChild, supportsDirectRead, typeify

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.arrow.vector.ValueVector

clear, getAccessor, getBufferSizeFor, getField, getMinorType, getMutator, getReader, getTransferPair, getTransferPair, getValueCapacity, makeTransferPair, setInitialCapacity

Constructor Detail

AbstractMapVector

protected AbstractMapVector(String name,
                 BufferAllocator allocator,
                 CallBack callBack)

Method Detail

close

public void close()

Description copied from class: AbstractContainerVector

Clears out all underlying child vectors.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface ValueVector

Overrides:

close in class AbstractContainerVector

allocateNewSafe

public boolean allocateNewSafe()

Description copied from interface: ValueVector

Allocates new buffers. ValueVector implements logic to determine how much to allocate.

Returns:

Returns true if allocation was successful.

addOrGet

public <T extends FieldVector> T addOrGet(String name,
                                 Types.MinorType minorType,
                                 Class<T> clazz,
                                 int... precisionScale)

Adds a new field with the given parameters or replaces the existing one and consequently returns the resultant ValueVector. Execution takes place in the following order:

• if field is new, create and insert a new vector of desired type.
• if field exists and existing vector is of desired vector type, return the vector.
• if field exists and null filled, clear the existing vector; create and insert a new vector of desired type.
• otherwise, throw an IllegalStateException

Specified by:

addOrGet in class AbstractContainerVector

Type Parameters:

T - class type of expected vector type

Parameters:

name - the name of the field

minorType - the minorType for the vector

clazz - class of expected vector type

Returns:

resultant ValueVector

Throws:

IllegalStateException - raised if there is a hard schema change

getChildByOrdinal

public ValueVector getChildByOrdinal(int id)

Returns a ValueVector corresponding to the given ordinal identifier.

getChild

public <T extends FieldVector> T getChild(String name,
                                 Class<T> clazz)

Returns a ValueVector instance of subtype of corresponding to the given field name if exists or null.

Specified by:

getChild in class AbstractContainerVector

add

protected ValueVector add(String name,
              Types.MinorType minorType,
              int... precisionScale)

putChild

protected void putChild(String name,
            FieldVector vector)

Inserts the vector with the given name if it does not exist else replaces it with the new value. Note that this method does not enforce any vector type check nor throws a schema change exception.

putVector

protected void putVector(String name,
             FieldVector vector)

Inserts the input vector into the map if it does not exist, replaces if it exists already

Parameters:

name - field name

vector - vector to be inserted

getChildren

protected List<FieldVector> getChildren()

Returns a sequence of underlying child vectors.

getChildFieldNames

protected List<String> getChildFieldNames()

size

public int size()

Returns the number of underlying child vectors.

Specified by:

size in class AbstractContainerVector

iterator

public Iterator<ValueVector> iterator()

getPrimitiveVectors

public List<ValueVector> getPrimitiveVectors()

Returns a list of scalar child vectors recursing the entire vector hierarchy.

getChildVectorWithOrdinal

public VectorWithOrdinal getChildVectorWithOrdinal(String name)

Returns a vector with its corresponding ordinal mapping if field exists or null.

Specified by:

getChildVectorWithOrdinal in class AbstractContainerVector

getBuffers

public ArrowBuf[] getBuffers(boolean clear)

Description copied from interface: ValueVector

Return the underlying buffers associated with this vector. Note that this doesn't impact the reference counts for this buffer so it only should be used for in-context access. Also note that this buffer changes regularly thus external classes shouldn't hold a reference to it (unless they change it).

Parameters:

clear - Whether to clear vector before returning; the buffers will still be refcounted; but the returned array will be the only reference to them

Returns:

The underlying buffers that is used by this vector instance.

getBufferSize

public int getBufferSize()

Description copied from interface: ValueVector

Returns the number of bytes that is used by this vector instance.