org.apache.lucene.store

Class SimpleFSDirectory.SimpleFSIndexInput

java.lang.Object

org.apache.lucene.store.DataInput

org.apache.lucene.store.IndexInput

org.apache.lucene.store.BufferedIndexInput

org.apache.lucene.store.SimpleFSDirectory.SimpleFSIndexInput

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Cloneable, RandomAccessInput

Enclosing class:

SimpleFSDirectory

static final class SimpleFSDirectory.SimpleFSIndexInput
extends BufferedIndexInput

Reads bytes with SeekableByteChannel.read(ByteBuffer)

Field Summary

Fields

Modifier and Type	Field and Description
private java.nio.ByteBuffer	byteBuf
protected java.nio.channels.SeekableByteChannel	channel the channel we will read from
private static int	CHUNK_SIZE The maximum chunk size for reads of 16384 bytes.
protected long	end end offset (start+length)
(package private) boolean	isClone is this instance a clone and hence does not own the file to close it
protected long	off start offset: non-zero in the slice case

Fields inherited from class org.apache.lucene.store.BufferedIndexInput

buffer, BUFFER_SIZE, MERGE_BUFFER_SIZE, MIN_BUFFER_SIZE

Constructor Summary

Constructors

Constructor and Description
SimpleFSIndexInput(java.lang.String resourceDesc, java.nio.channels.SeekableByteChannel channel, IOContext context)
SimpleFSIndexInput(java.lang.String resourceDesc, java.nio.channels.SeekableByteChannel channel, long off, long length, int bufferSize)

Method Summary

Modifier and Type	Method and Description
SimpleFSDirectory.SimpleFSIndexInput	clone() Returns a clone of this stream.
void	close() Closes the stream to further operations.
long	length() The number of bytes in the file.
protected void	newBuffer(byte[] newBuffer)
protected void	readInternal(byte[] b, int offset, int len) Expert: implements buffer refill.
protected void	seekInternal(long pos) Expert: implements seek.
IndexInput	slice(java.lang.String sliceDescription, long offset, long length) Creates a slice of this index input, with the given description, offset, and length.

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

bufferSize, flushBuffer, getBufferSize, getFilePointer, readByte, readByte, readBytes, readBytes, readInt, readInt, readLong, readLong, readShort, readShort, readVInt, readVLong, seek, setBufferSize, wrap

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

getFullSliceDescription, randomAccessSlice, toString

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

readLELongs, readMapOfStrings, readSetOfStrings, readString, readZInt, readZLong, skipBytes

Methods inherited from class java.lang.Object

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

Field Detail

CHUNK_SIZE

private static final int CHUNK_SIZE

The maximum chunk size for reads of 16384 bytes.

See Also:

Constant Field Values

channel

protected final java.nio.channels.SeekableByteChannel channel

the channel we will read from

isClone

boolean isClone

is this instance a clone and hence does not own the file to close it

off

protected final long off

start offset: non-zero in the slice case

end

protected final long end

end offset (start+length)

byteBuf

private java.nio.ByteBuffer byteBuf

Constructor Detail

SimpleFSIndexInput

public SimpleFSIndexInput(java.lang.String resourceDesc,
                          java.nio.channels.SeekableByteChannel channel,
                          IOContext context)
                   throws java.io.IOException

Throws:

java.io.IOException

SimpleFSIndexInput

public SimpleFSIndexInput(java.lang.String resourceDesc,
                          java.nio.channels.SeekableByteChannel channel,
                          long off,
                          long length,
                          int bufferSize)

Method Detail

close

public void close()
           throws java.io.IOException

Description copied from class: IndexInput

Closes the stream to further operations.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class IndexInput

Throws:

java.io.IOException

clone

public SimpleFSDirectory.SimpleFSIndexInput clone()

Description copied from class: IndexInput

Returns a clone of this stream.

Clones of a stream access the same data, and are positioned at the same point as the stream they were cloned from.

Expert: Subclasses must ensure that clones may be positioned at different points in the input from each other and from the stream they were cloned from.

Warning: Lucene never closes cloned IndexInputs, it will only call IndexInput.close() on the original object.

If you access the cloned IndexInput after closing the original object, any readXXX methods will throw AlreadyClosedException.

This method is NOT thread safe, so if the current IndexInput is being used by one thread while clone is called by another, disaster could strike.

Overrides:

clone in class BufferedIndexInput

slice

public IndexInput slice(java.lang.String sliceDescription,
                        long offset,
                        long length)
                 throws java.io.IOException

Description copied from class: IndexInput

Creates a slice of this index input, with the given description, offset, and length. The slice is sought to the beginning.

Overrides:

slice in class BufferedIndexInput

Throws:

java.io.IOException

length

public final long length()

Description copied from class: IndexInput

The number of bytes in the file.

Specified by:

length in class IndexInput

newBuffer

protected void newBuffer(byte[] newBuffer)

Overrides:

newBuffer in class BufferedIndexInput

readInternal

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

Description copied from class: BufferedIndexInput

Expert: implements buffer refill. Reads bytes from the current position in the input.

Specified by:

readInternal in class BufferedIndexInput

Parameters:

b - the array to read bytes into

offset - the offset in the array to start storing bytes

len - the number of bytes to read

Throws:

java.io.IOException

seekInternal

protected void seekInternal(long pos)
                     throws java.io.IOException

Description copied from class: BufferedIndexInput

Expert: implements seek. Sets current position in this file, where the next BufferedIndexInput.readInternal(byte[],int,int) will occur.

Specified by:

seekInternal in class BufferedIndexInput

Throws:

java.io.IOException

See Also:

BufferedIndexInput.readInternal(byte[],int,int)