org.lenskit.util.table.writer

Class CSVWriter

java.lang.Object

org.lenskit.util.table.writer.AbstractTableWriter

org.lenskit.util.table.writer.CSVWriter

All Implemented Interfaces:

Closeable, AutoCloseable, TableWriter

public class CSVWriter
extends AbstractTableWriter

Implementation of TableWriter for CSV files.

Constructor Summary

Constructors

Constructor and Description
CSVWriter(Writer w, TableLayout l) Construct a new CSV writer.

Method Summary

Modifier and Type	Method and Description
void	close() No-op close implementaiton.
TableLayout	getLayout() Get the layout of this table.
static CSVWriter	open(File file, TableLayout layout) Open a CSV writer to write to an auto-compressed file.
static CSVWriter	open(File file, TableLayout layout, CompressionMode compression) Open a CSV writer to write to a file.
void	writeRow(List<?> row) Write a row to the table.

Methods inherited from class org.lenskit.util.table.writer.AbstractTableWriter

checkRowWidth, writeRow

Methods inherited from class java.lang.Object

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

Constructor Detail

CSVWriter

public CSVWriter(@WillCloseWhenClosed @Nonnull
                 Writer w,
                 @Nullable
                 TableLayout l)
          throws IOException

Construct a new CSV writer.

Parameters:

w - The underlying writer to output to.

l - The table layout, or null if the table has no headers.

Throws:

IOException - if there is an error writing the column headers.

Method Detail

close

public void close()
           throws IOException

Description copied from class: AbstractTableWriter

No-op close implementaiton.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface TableWriter

Overrides:

close in class AbstractTableWriter

Throws:

IOException

writeRow

public void writeRow(List<?> row)
              throws IOException

Description copied from interface: TableWriter

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:

IOException - if an error occurs writing the row.

getLayout

public TableLayout getLayout()

Description copied from interface: TableWriter

Get the layout of this table.

Returns:

The table’s layout.

open

public static CSVWriter open(File file,
                             TableLayout layout,
                             CompressionMode compression)
                      throws IOException

Open a CSV writer to write to a file.

Parameters:

file - The file to write to.

layout - The layout of the table.

compression - What compression, if any, to use.

Returns:

A CSV writer outputting to file.

Throws:

IOException - if there is an error opening the file or writing the column header.

open

public static CSVWriter open(File file,
                             @Nullable
                             TableLayout layout)
                      throws IOException

Open a CSV writer to write to an auto-compressed file. The file will be compressed if its name ends in “.gz”.

Parameters:

file - The file.

layout - The table layout.

Returns:

The CSV writer.

Throws:

IOException - if there is an error opening the file or writing the column header.

See Also:

open(File, TableLayout, CompressionMode)