Package org.apache.lucene.store

Class OutputStreamIndexOutput

java.lang.Object

org.apache.lucene.store.DataOutput

org.apache.lucene.store.IndexOutput

org.apache.lucene.store.OutputStreamIndexOutput

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

FSDirectory.FSIndexOutput

public class OutputStreamIndexOutput
extends IndexOutput

Implementation class for buffered IndexOutput that writes to an OutputStream.

Field Summary

Fields

Modifier and Type	Field	Description
private long	bytesWritten
private final CRC32	crc
private boolean	flushedOnClose
private final BufferedOutputStream	os

Constructor Summary

Constructors

Constructor	Description
OutputStreamIndexOutput(String resourceDescription, String name, OutputStream out, int bufferSize)	Creates a new OutputStreamIndexOutput with the given buffer size.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this stream to further operations.
final long	getChecksum()	Returns the current checksum of bytes written so far
final long	getFilePointer()	Returns the current position in this file, where the next write will occur.
final void	writeByte(byte b)	Writes a single byte.
final void	writeBytes(byte[] b, int offset, int length)	Writes an array of bytes.

Methods inherited from class org.apache.lucene.store.IndexOutput

getName, toString

Methods inherited from class org.apache.lucene.store.DataOutput

copyBytes, writeBytes, writeInt, writeLong, writeMapOfStrings, writeSetOfStrings, writeShort, writeString, writeVInt, writeVLong, writeZInt, writeZLong

Methods inherited from class java.lang.Object

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

Field Details

crc

private final CRC32 crc

os

private final BufferedOutputStream os

bytesWritten

private long bytesWritten

flushedOnClose

private boolean flushedOnClose

Constructor Details

OutputStreamIndexOutput

public OutputStreamIndexOutput(String resourceDescription,
 String name,
 OutputStream out,
 int bufferSize)

Creates a new OutputStreamIndexOutput with the given buffer size.

Parameters:

bufferSize - the buffer size in bytes used to buffer writes internally.

Throws:

IllegalArgumentException - if the given buffer size is less or equal to 0

Method Details

writeByte

public final void writeByte(byte b)
                     throws IOException

Description copied from class: DataOutput

Writes a single byte.

The most primitive data type is an eight-bit byte. Files are accessed as sequences of bytes. All other data types are defined as sequences of bytes, so file formats are byte-order independent.

Specified by:

writeByte in class DataOutput

Throws:

IOException

See Also:

• DataInput.readByte()

writeBytes

public final void writeBytes(byte[] b,
 int offset,
 int length)
                      throws IOException

Description copied from class: DataOutput

Writes an array of bytes.

Specified by:

writeBytes in class DataOutput

Parameters:

b - the bytes to write

offset - the offset in the byte array

length - the number of bytes to write

Throws:

IOException

See Also:

• DataInput.readBytes(byte[],int,int)

close

public void close()
           throws IOException

Description copied from class: IndexOutput

Closes this stream to further operations.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in class IndexOutput

Throws:

IOException

getFilePointer

public final long getFilePointer()

Description copied from class: IndexOutput

Returns the current position in this file, where the next write will occur.

Specified by:

getFilePointer in class IndexOutput

getChecksum

public final long getChecksum()
                       throws IOException

Description copied from class: IndexOutput

Returns the current checksum of bytes written so far

Specified by:

getChecksum in class IndexOutput

Throws:

IOException