Package org.apache.lucene.store

Class RAMOutputStream

java.lang.Object

org.apache.lucene.store.DataOutput

org.apache.lucene.store.IndexOutput

org.apache.lucene.store.RAMOutputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, Accountable

@Deprecated
public class RAMOutputStream
extends IndexOutput
implements Accountable

Deprecated.

This class uses inefficient synchronization and is discouraged in favor of MMapDirectory. It will be removed in future versions of Lucene.

A memory-resident IndexOutput implementation.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static int	BUFFER_SIZE	Deprecated.
private int	bufferLength	Deprecated.
private int	bufferPosition	Deprecated.
private long	bufferStart	Deprecated.
private java.util.zip.Checksum	crc	Deprecated.
private byte[]	currentBuffer	Deprecated.
private int	currentBufferIndex	Deprecated.
private RAMFile	file	Deprecated.

Fields inherited from interface org.apache.lucene.util.Accountable

NULL_ACCOUNTABLE

Constructor Summary

Constructors

Constructor	Description
RAMOutputStream()	Deprecated. Construct an empty output buffer.
RAMOutputStream(java.lang.String name, RAMFile f, boolean checksum)	Deprecated. Creates this, with specified name.
RAMOutputStream(RAMFile f, boolean checksum)	Deprecated. Creates this, with no name.

Method Summary

Modifier and Type	Method	Description
void	close()	Deprecated. Closes this stream to further operations.
protected void	flush()	Deprecated. Forces any buffered output to be written.
long	getChecksum()	Deprecated. Returns the current checksum of bytes written so far
java.util.Collection<Accountable>	getChildResources()	Deprecated. Returns nested resources of this class.
long	getFilePointer()	Deprecated. Returns the current position in this file, where the next write will occur.
long	ramBytesUsed()	Deprecated. Returns byte usage of all buffers.
void	reset()	Deprecated. Resets this to an empty file.
private void	setFileLength()	Deprecated.
private void	switchCurrentBuffer()	Deprecated.
void	writeByte(byte b)	Deprecated. Writes a single byte.
void	writeBytes(byte[] b, int offset, int len)	Deprecated. Writes an array of bytes.
void	writeTo(byte[] bytes, int offset)	Deprecated. Copy the current contents of this buffer to output byte array
void	writeTo(DataOutput out)	Deprecated. Copy the current contents of this buffer to the provided DataOutput.

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 Detail

BUFFER_SIZE

static final int BUFFER_SIZE

Deprecated.

See Also:

Constant Field Values

file

private final RAMFile file

Deprecated.

currentBuffer

private byte[] currentBuffer

Deprecated.

currentBufferIndex

private int currentBufferIndex

Deprecated.

bufferPosition

private int bufferPosition

Deprecated.

bufferStart

private long bufferStart

Deprecated.

bufferLength

private int bufferLength

Deprecated.

crc

private final java.util.zip.Checksum crc

Deprecated.

Constructor Detail

RAMOutputStream

public RAMOutputStream()

Deprecated.

Construct an empty output buffer.

RAMOutputStream

public RAMOutputStream(RAMFile f,
                       boolean checksum)

Deprecated.

Creates this, with no name.

RAMOutputStream

public RAMOutputStream(java.lang.String name,
                       RAMFile f,
                       boolean checksum)

Deprecated.

Creates this, with specified name.

Method Detail

writeTo

public void writeTo(DataOutput out)
             throws java.io.IOException

Deprecated.

Copy the current contents of this buffer to the provided DataOutput.

Throws:

java.io.IOException

writeTo

public void writeTo(byte[] bytes,
                    int offset)
             throws java.io.IOException

Deprecated.

Copy the current contents of this buffer to output byte array

Throws:

java.io.IOException

reset

public void reset()

Deprecated.

Resets this to an empty file.

close

public void close()
           throws java.io.IOException

Deprecated.

Description copied from class: IndexOutput

Closes this stream to further operations.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Specified by:

close in class IndexOutput

Throws:

java.io.IOException

writeByte

public void writeByte(byte b)
               throws java.io.IOException

Deprecated.

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:

java.io.IOException

See Also:

DataInput.readByte()

writeBytes

public void writeBytes(byte[] b,
                       int offset,
                       int len)
                throws java.io.IOException

Deprecated.

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

len - the number of bytes to write

Throws:

java.io.IOException

See Also:

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

switchCurrentBuffer

private final void switchCurrentBuffer()

Deprecated.

setFileLength

private void setFileLength()

Deprecated.

flush

protected void flush()
              throws java.io.IOException

Deprecated.

Forces any buffered output to be written.

Throws:

java.io.IOException

getFilePointer

public long getFilePointer()

Deprecated.

Description copied from class: IndexOutput

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

Specified by:

getFilePointer in class IndexOutput

ramBytesUsed

public long ramBytesUsed()

Deprecated.

Returns byte usage of all buffers.

Specified by:

ramBytesUsed in interface Accountable

getChildResources

public java.util.Collection<Accountable> getChildResources()

Deprecated.

Description copied from interface: Accountable

Returns nested resources of this class. The result should be a point-in-time snapshot (to avoid race conditions).

Specified by:

getChildResources in interface Accountable

See Also:

Accountables

getChecksum

public long getChecksum()
                 throws java.io.IOException

Deprecated.

Description copied from class: IndexOutput

Returns the current checksum of bytes written so far

Specified by:

getChecksum in class IndexOutput

Throws:

java.io.IOException