org.apache.poi.xssf.streaming

Class StreamingSheetWriter

java.lang.Object

org.apache.poi.xssf.streaming.SheetDataWriter

org.apache.poi.xssf.streaming.StreamingSheetWriter

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

@Beta
public class StreamingSheetWriter
extends SheetDataWriter

Unlike SheetDataWriter, this writer does not create a temporary file, it writes data directly to the provided OutputStream.

Since:

5.0.0

Field Summary

Fields inherited from class org.apache.poi.xssf.streaming.SheetDataWriter

_out

Constructor Summary

Constructors

Constructor and Description
StreamingSheetWriter()
StreamingSheetWriter(java.io.OutputStream out)

Method Summary

Modifier and Type	Method and Description
void	close() flush and close the temp data writer.
java.io.File	createTempFile() Create a temp file to write sheet data.
java.io.Writer	createWriter(java.io.File fd) Create a writer for the sheet data.
protected static java.io.Writer	createWriter(java.io.OutputStream out) Create a writer for the sheet data.
java.io.InputStream	getWorksheetXMLInputStream()

Methods inherited from class org.apache.poi.xssf.streaming.SheetDataWriter

decorateInputStream, decorateOutputStream, finalize, getLastFlushedRow, getLowestIndexOfFlushedRows, getNumberOfCellsOfLastFlushedRow, getNumberOfFlushedRows, getTempFile, outputEscapedString, writeCell, writeRow

Methods inherited from class java.lang.Object

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

Constructor Detail

StreamingSheetWriter

public StreamingSheetWriter()
                     throws java.io.IOException

Throws:

java.io.IOException

StreamingSheetWriter

public StreamingSheetWriter(java.io.OutputStream out)
                     throws java.io.IOException

Throws:

java.io.IOException

Method Detail

createTempFile

public java.io.File createTempFile()
                            throws java.io.IOException

Description copied from class: SheetDataWriter

Create a temp file to write sheet data. By default, temp files are created in the default temporary-file directory with a prefix "poi-sxssf-sheet" and suffix ".xml". Subclasses can override it and specify a different temp directory or filename or suffix, e.g. .gz

Overrides:

createTempFile in class SheetDataWriter

Returns:

temp file to write sheet data

Throws:

java.io.IOException

createWriter

public java.io.Writer createWriter(java.io.File fd)
                            throws java.io.IOException

Description copied from class: SheetDataWriter

Create a writer for the sheet data.

Overrides:

createWriter in class SheetDataWriter

Parameters:

fd - the file to write to

Throws:

java.io.IOException

createWriter

protected static java.io.Writer createWriter(java.io.OutputStream out)
                                      throws java.io.IOException

Create a writer for the sheet data.

Parameters:

out - the output stream to write to

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Description copied from class: SheetDataWriter

flush and close the temp data writer. This method must be invoked before calling SheetDataWriter.getWorksheetXMLInputStream()

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class SheetDataWriter

Throws:

java.io.IOException

getWorksheetXMLInputStream

public java.io.InputStream getWorksheetXMLInputStream()
                                               throws java.io.IOException

Overrides:

getWorksheetXMLInputStream in class SheetDataWriter

Returns:

a stream to read temp file with the sheet data

Throws:

java.io.IOException