Package org.apache.druid.segment.data

Class FixedIndexedWriter<T>

java.lang.Object

org.apache.druid.segment.data.FixedIndexedWriter<T>

All Implemented Interfaces:

DictionaryWriter<T>, Serializer

public class FixedIndexedWriter<T>
extends Object
implements DictionaryWriter<T>

Writer for a FixedIndexed

Constructor Summary

Constructors

Constructor	Description
FixedIndexedWriter(SegmentWriteOutMedium segmentWriteOutMedium, TypeStrategy<T> typeStrategy, ByteOrder byteOrder, int width, boolean isSorted)

Method Summary

Modifier and Type	Method	Description
T	get(int index)	Returns an object that has already been written via the DictionaryWriter.write(T) method.
int	getCardinality()	Returns the number of items that have been written so far in this dictionary.
Iterator<T>	getIterator()
long	getSerializedSize()	Returns the number of bytes, that this Serializer will write to the output _channel_ (not smoosher) on a Serializer.writeTo(java.nio.channels.WritableByteChannel, org.apache.druid.segment.file.SegmentFileBuilder) call.
boolean	isSorted()
void	open()	Prepares the writer for writing
int	write(T objectToWrite)	Writes an object to the dictionary.
void	writeTo(WritableByteChannel channel, SegmentFileBuilder fileBuilder)	Writes the serialized form of this object.

Methods inherited from class java.lang.Object

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

Constructor Details

FixedIndexedWriter

public FixedIndexedWriter(SegmentWriteOutMedium segmentWriteOutMedium,
 TypeStrategy<T> typeStrategy,
 ByteOrder byteOrder,
 int width,
 boolean isSorted)

Method Details

isSorted

public boolean isSorted()

Specified by:

isSorted in interface DictionaryWriter<T>

open

public void open()
          throws IOException

Description copied from interface: DictionaryWriter

Prepares the writer for writing

Specified by:

open in interface DictionaryWriter<T>

Throws:

IOException - if there is a problem with IO

getCardinality

public int getCardinality()

Description copied from interface: DictionaryWriter

Returns the number of items that have been written so far in this dictionary. Any number lower than this cardinality can be passed into DictionaryWriter.get(int) and a value will be returned. If a value greater than or equal to the cardinality is passed into DictionaryWriter.get(int) all sorts of things could happen, but likely none of them are good.

Specified by:

getCardinality in interface DictionaryWriter<T>

Returns:

the number of items that have been written so far

getSerializedSize

public long getSerializedSize()

Description copied from interface: Serializer

Returns the number of bytes, that this Serializer will write to the output _channel_ (not smoosher) on a Serializer.writeTo(java.nio.channels.WritableByteChannel, org.apache.druid.segment.file.SegmentFileBuilder) call.

Specified by:

getSerializedSize in interface Serializer

write

public int write(@Nullable
 T objectToWrite)
          throws IOException

Description copied from interface: DictionaryWriter

Writes an object to the dictionary.

Returns the index of the value that was just written. This is defined as the `int` value that can be passed into DictionaryWriter.get(int) such that it will return the same value back.

Specified by:

write in interface DictionaryWriter<T>

Parameters:

objectToWrite - object to be written to the dictionary

Returns:

index of the value that was just written

Throws:

IOException - if there is a problem with IO

writeTo

public void writeTo(WritableByteChannel channel,
 SegmentFileBuilder fileBuilder)
             throws IOException

Description copied from interface: Serializer

Writes the serialized form of this object. The entire object may be written to the provided channel, or the object may be split over the provided channel and files added to the {@link SegmentFileBuilder], where additional channels can be created via SegmentFileBuilder.addWithChannel(String, long). The latter approach is useful when the serialized form of the object is too large for a single smoosh container. At the time this javadoc was written, the max smoosh container size is limit to the max ByteBuffer size.

Specified by:

writeTo in interface Serializer

Throws:

IOException

get

@Nullable
public T get(int index)
      throws IOException

Description copied from interface: DictionaryWriter

Returns an object that has already been written via the DictionaryWriter.write(T) method.

Specified by:

get in interface DictionaryWriter<T>

Parameters:

index - index of the object to return

Returns:

the object identified by the given index

Throws:

IOException - if there is a problem with IO

getIterator

public Iterator<T> getIterator()