Class ByteBuffersIndexInput
- All Implemented Interfaces:
Closeable,AutoCloseable,Cloneable,RandomAccessInput
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionclone()Returns a clone of this stream.voidclose()Closes the stream to further operations.longReturns the current position in this file, where the next read will occur.longlength()The number of bytes in the file.randomAccessSlice(long offset, long length) Creates a random-access slice of this index input, with the given offset and length.bytereadByte()Reads and returns a single byte.bytereadByte(long pos) Reads a byte at the given position in the filevoidreadBytes(byte[] b, int offset, int len) Reads a specified number of bytes into an array at the specified offset.voidreadBytes(byte[] b, int offset, int len, boolean useBuffer) Reads a specified number of bytes into an array at the specified offset with control over whether the read should be buffered (callers who have their own buffer should pass in "false" for useBuffer).voidreadBytes(long pos, byte[] bytes, int offset, int length) Reads a specified number of bytes starting at a given position into an array at the specified offset.voidreadFloats(float[] floats, int offset, int len) Reads a specified number of floats into an array at the specified offset.voidreadGroupVInt(int[] dst, int offset) Override if you have an efficient implementation.intreadInt()Reads four bytes and returns an int (LE byte order).intreadInt(long pos) Reads an integer (LE byte order) at the given position in the filelongreadLong()Reads eight bytes and returns a long (LE byte order).longreadLong(long pos) Reads a long (LE byte order) at the given position in the filevoidreadLongs(long[] dst, int offset, int length) Read a specified number of longs.Reads a Map<String,String> previously written withDataOutput.writeMapOfStrings(Map).Reads a Set<String> previously written withDataOutput.writeSetOfStrings(Set).shortReads two bytes and returns a short (LE byte order).shortreadShort(long pos) Reads a short (LE byte order) at the given position in the fileReads a string.intreadVInt()Reads an int stored in variable-length format.longReads a long stored in variable-length format.intreadZInt()Read azig-zag-encodedvariable-lengthinteger.longRead azig-zag-encodedvariable-lengthinteger.voidseek(long pos) Sets current position in this file, where the next read will occur.voidskipBytes(long numBytes) Skip overnumBytesbytes.Creates a slice of this index input, with the given description, offset, and length.Methods inherited from class org.apache.lucene.store.IndexInput
getFullSliceDescription, isLoaded, prefetch, slice, toString, updateReadAdviceMethods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface org.apache.lucene.store.RandomAccessInput
isLoaded, prefetch
-
Constructor Details
-
ByteBuffersIndexInput
-
-
Method Details
-
close
Description copied from class:IndexInputCloses the stream to further operations.- Specified by:
closein interfaceAutoCloseable- Specified by:
closein interfaceCloseable- Specified by:
closein classIndexInput- Throws:
IOException
-
getFilePointer
public long getFilePointer()Description copied from class:IndexInputReturns the current position in this file, where the next read will occur.- Specified by:
getFilePointerin classIndexInput- See Also:
-
seek
Description copied from class:IndexInputSets current position in this file, where the next read will occur. If this is beyond the end of the file then this will throwEOFExceptionand then the stream is in an undetermined state.- Specified by:
seekin classIndexInput- Throws:
IOException- See Also:
-
length
public long length()Description copied from class:IndexInputThe number of bytes in the file.- Specified by:
lengthin interfaceRandomAccessInput- Specified by:
lengthin classIndexInput
-
slice
public ByteBuffersIndexInput slice(String sliceDescription, long offset, long length) throws IOException Description copied from class:IndexInputCreates a slice of this index input, with the given description, offset, and length. The slice is sought to the beginning.- Specified by:
slicein classIndexInput- Throws:
IOException
-
readByte
Description copied from class:DataInputReads and returns a single byte.- Specified by:
readBytein classDataInput- Throws:
IOException- See Also:
-
readBytes
Description copied from class:DataInputReads a specified number of bytes into an array at the specified offset.- Specified by:
readBytesin classDataInput- Parameters:
b- the array to read bytes intooffset- the offset in the array to start storing byteslen- the number of bytes to read- Throws:
IOException- See Also:
-
randomAccessSlice
Description copied from class:IndexInputCreates a random-access slice of this index input, with the given offset and length.The default implementation calls
IndexInput.slice(java.lang.String, long, long), and it doesn't support random access, it implements absolute reads as seek+read.- Overrides:
randomAccessSlicein classIndexInput- Throws:
IOException
-
readBytes
Description copied from class:DataInputReads a specified number of bytes into an array at the specified offset with control over whether the read should be buffered (callers who have their own buffer should pass in "false" for useBuffer). Currently onlyBufferedIndexInputrespects this parameter.- Overrides:
readBytesin classDataInput- Parameters:
b- the array to read bytes intooffset- the offset in the array to start storing byteslen- the number of bytes to readuseBuffer- set to false if the caller will handle buffering.- Throws:
IOException- See Also:
-
readShort
Description copied from class:DataInputReads two bytes and returns a short (LE byte order).- Overrides:
readShortin classDataInput- Throws:
IOException- See Also:
-
readInt
Description copied from class:DataInputReads four bytes and returns an int (LE byte order).- Overrides:
readIntin classDataInput- Throws:
IOException- See Also:
-
readVInt
Description copied from class:DataInputReads an int stored in variable-length format. Reads between one and five bytes. Smaller values take fewer bytes. Negative numbers are supported, but should be avoided.The format is described further in
DataOutput.writeVInt(int).- Overrides:
readVIntin classDataInput- Throws:
IOException- See Also:
-
readZInt
Description copied from class:DataInputRead azig-zag-encodedvariable-lengthinteger.- Overrides:
readZIntin classDataInput- Throws:
IOException- See Also:
-
readLong
Description copied from class:DataInputReads eight bytes and returns a long (LE byte order).- Overrides:
readLongin classDataInput- Throws:
IOException- See Also:
-
readVLong
Description copied from class:DataInputReads a long stored in variable-length format. Reads between one and nine bytes. Smaller values take fewer bytes. Negative numbers are not supported.The format is described further in
DataOutput.writeVInt(int).- Overrides:
readVLongin classDataInput- Throws:
IOException- See Also:
-
readZLong
Description copied from class:DataInputRead azig-zag-encodedvariable-lengthinteger. Reads between one and ten bytes.- Overrides:
readZLongin classDataInput- Throws:
IOException- See Also:
-
readString
Description copied from class:DataInputReads a string.- Overrides:
readStringin classDataInput- Throws:
IOException- See Also:
-
readMapOfStrings
Description copied from class:DataInputReads a Map<String,String> previously written withDataOutput.writeMapOfStrings(Map).- Overrides:
readMapOfStringsin classDataInput- Returns:
- An immutable map containing the written contents.
- Throws:
IOException
-
readSetOfStrings
Description copied from class:DataInputReads a Set<String> previously written withDataOutput.writeSetOfStrings(Set).- Overrides:
readSetOfStringsin classDataInput- Returns:
- An immutable set containing the written contents.
- Throws:
IOException
-
skipBytes
Description copied from class:IndexInputSkip overnumBytesbytes. This method may skip bytes in whatever way is most optimal, and may not have the same behavior as reading the skipped bytes. In general, negativenumBytesare not supported.Behavior is functionally equivalent to seeking to
getFilePointer() + numBytes.- Overrides:
skipBytesin classIndexInput- Throws:
IOException- See Also:
-
readByte
Description copied from interface:RandomAccessInputReads a byte at the given position in the file- Specified by:
readBytein interfaceRandomAccessInput- Throws:
IOException- See Also:
-
readBytes
Description copied from interface:RandomAccessInputReads a specified number of bytes starting at a given position into an array at the specified offset.- Specified by:
readBytesin interfaceRandomAccessInput- Throws:
IOException- See Also:
-
readShort
Description copied from interface:RandomAccessInputReads a short (LE byte order) at the given position in the file- Specified by:
readShortin interfaceRandomAccessInput- Throws:
IOException- See Also:
-
readInt
Description copied from interface:RandomAccessInputReads an integer (LE byte order) at the given position in the file- Specified by:
readIntin interfaceRandomAccessInput- Throws:
IOException- See Also:
-
readLong
Description copied from interface:RandomAccessInputReads a long (LE byte order) at the given position in the file- Specified by:
readLongin interfaceRandomAccessInput- Throws:
IOException- See Also:
-
readFloats
Description copied from class:DataInputReads a specified number of floats into an array at the specified offset.- Overrides:
readFloatsin classDataInput- Parameters:
floats- the array to read bytes intooffset- the offset in the array to start storing floatslen- the number of floats to read- Throws:
IOException
-
readLongs
Description copied from class:DataInputRead a specified number of longs.- Overrides:
readLongsin classDataInput- Throws:
IOException
-
readGroupVInt
Description copied from class:DataInputOverride if you have an efficient implementation. In general this is when the input supports random access.- Overrides:
readGroupVIntin classDataInput- Throws:
IOException
-
clone
Description copied from class:IndexInputReturns 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 callIndexInput.close()on the original object.If you access the cloned IndexInput after closing the original object, any
readXXXmethods will throwAlreadyClosedException.This method is NOT thread safe, so if the current
IndexInputis being used by one thread whilecloneis called by another, disaster could strike.- Overrides:
clonein classIndexInput
-