org.lenskit.util.table.writer

Interface TableWriter

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

All Known Implementing Classes:

AbstractTableWriter, CSVWriter, DevNullTableWriter, MultiplexedTableWriter, TableBuilder

@ThreadSafe
public interface TableWriter
extends java.io.Closeable

Write rows to a table.

Instances of this class are used to actually write rows to a table. Once the table has finished, call close() to finish the table and close the underlying output.

Method Summary

Modifier and Type	Method and Description
void	close() Finish the table.
void	flush() Flush the writer, causing all currently-written rows to be flushed to output.
TableLayout	getLayout() Get the layout of this table.
void	writeRow(java.util.List<?> row) Write a row to the table.
void	writeRow(java.lang.Object... row) Write a row to the table.

Method Detail

getLayout

TableLayout getLayout()

Get the layout of this table.

Returns:

The table’s layout.

writeRow

void writeRow(java.lang.Object... row)
       throws java.io.IOException

Write a row to the table. This method is thread-safe.

Parameters:

row - A row of values. If the table requires more columns, the remaining columns are empty. The row is copied if necessary; the caller is free to re-use the same array for returnValue calls.

Throws:

java.io.IOException - if an error occurs writing the row.

java.lang.IllegalArgumentException - if row has the incorrect number of columns.

writeRow

void writeRow(java.util.List<?> row)
       throws java.io.IOException

Write a row to the table. This method is thread-safe.

Parameters:

row - A row of values. If the table requires more columns, the remaining columns are empty. The row is copied if necessary; the caller is free to re-use the same array for returnValue calls.

Throws:

java.io.IOException - if an error occurs writing the row.

java.lang.IllegalArgumentException - if row has the incorrect number of columns.

Since:

1.1

flush

void flush()
    throws java.io.IOException

Flush the writer, causing all currently-written rows to be flushed to output.

Throws:

java.io.IOException - if an error occurs while flushing output.

close

void close()
    throws java.io.IOException

Finish the table. Depending on how it was constructed, some underlying resource may be closed.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException