com.illumon.iris.binarystore

Interface TableWriter

All Superinterfaces:

Entry, Record, Row

All Known Implementing Classes:

DiskTableWriter, LocalTableWriter

public interface TableWriter
extends Entry

Interface for writing table data out.

Nested Class Summary

Nested classes/interfaces inherited from interface com.illumon.iris.binarystore.Row

Row.Flags

Nested classes/interfaces inherited from interface com.illumon.iris.binarystore.Record

Record.RecordSetter<T extends RecordData>

Field Summary

Fields

Modifier and Type	Field and Description
static RowSetter	NULL_SETTER

Method Summary

Modifier and Type	Method and Description
void	close() Closes the writer.
void	flush() Flushes data out.
String[]	getColumnNames() Gets the column names for the table.
Class[]	getColumnTypes() Gets the column types for the table.
default Record.RecordSetter<RecordData>	getRecordSetter() Gets a record setter for an entry.
default <T extends RecordData> Record.RecordSetter<T>	getRecordSetter(Class<T> tClass) Gets a typed record setter for an entry.
default Record	getRecordWriter() Get new writer for Record entries.
Row	getRowWriter() Get a writer for a Row entries.
RowSetter	getSetter(String name) Gets a setter for a column.
default <T> RowSetter<T>	getSetter(String name, Class<T> tClass) Gets a typed setter for a column.
void	setFlags(Row.Flags flags)
boolean	supportAllTypes() True if all data types can be written out; false otherwise.
default void	writeRecord() Write a record entry out.
void	writeRow() Writes out a new row (values set using setters).

Methods inherited from interface com.illumon.iris.binarystore.Row

size

Field Detail

NULL_SETTER

static final RowSetter NULL_SETTER

Method Detail

getSetter

RowSetter getSetter(String name)

Gets a setter for a column.

The implementation is likely to delegate to Row.getSetter(String) in a default Row instance.

Specified by:

getSetter in interface Row

Parameters:

name - column name

Returns:

setter for the column.

getSetter

default <T> RowSetter<T> getSetter(@NotNull
                                   String name,
                                   @NotNull
                                   Class<T> tClass)

Gets a typed setter for a column.

The implementation is likely to delegate to Row.getSetter(String, Class) in a default Row instance.

Specified by:

getSetter in interface Row

Parameters:

name - column name

tClass - the type for the typed RowSetter

Returns:

setter for the column.

setFlags

void setFlags(Row.Flags flags)

The implementation is likely to delegate to Row.setFlags(Flags) in a default Row instance.

Specified by:

setFlags in interface Row

getRowWriter

Row getRowWriter()

Get a writer for a Row entries. This is likely to be newly created, so callers should cache this value. In practice, TableWriter implementations generally cache the result of the first call to this method as a primary writer.

Returns:

a Row, likely newly created

writeRow

void writeRow()
       throws IOException

Writes out a new row (values set using setters).

The implementation is likely to delegate to Row.writeRow() in a default Row instance.

Specified by:

writeRow in interface Row

Throws:

IOException - problem writing the row

getRecordWriter

default Record getRecordWriter()

Get new writer for Record entries. This is likely to be newly created, so callers should cache this value. In practice, implementers generally cache the result of the first call to this method as a primary writer.

Returns:

a Record, likely newly created

getRecordSetter

default Record.RecordSetter<RecordData> getRecordSetter()

Gets a record setter for an entry.

The implementation is likely to delegate to Record.getRecordSetter() in a default Record instance.

Specified by:

getRecordSetter in interface Record

Returns:

setter for the record.

getRecordSetter

default <T extends RecordData> Record.RecordSetter<T> getRecordSetter(Class<T> tClass)

Gets a typed record setter for an entry.

The implementation is likely to delegate to Record.getRecordSetter(Class) in a default Record instance.

Specified by:

getRecordSetter in interface Record

Returns:

setter for the record.

writeRecord

default void writeRecord()
                  throws IOException

Write a record entry out. The implementor is responsible for providing the output channel and data buffer.

The TableWriter implementation is likely to delegate to Record.writeRecord() in a default Record instance.

Specified by:

writeRecord in interface Record

Throws:

IOException

close

void close()
    throws IOException

Closes the writer.

Throws:

IOException - problem closing the writer.

getColumnTypes

Class[] getColumnTypes()

Gets the column types for the table.

Returns:

column types for the table.

getColumnNames

String[] getColumnNames()

Gets the column names for the table.

Returns:

column names for the table.

flush

void flush()
    throws IOException

Flushes data out.

Throws:

IOException - problem flushing data out.

supportAllTypes

boolean supportAllTypes()

True if all data types can be written out; false otherwise.

Returns:

true if all data types can be written out; false otherwise.