FileBytes (Atomix API Reference (2.0.1))

java.lang.Object
- io.atomix.storage.buffer.AbstractBytes
- - io.atomix.storage.buffer.FileBytes

All Implemented Interfaces:

Bytes, BytesInput<Bytes>, BytesOutput<Bytes>, AutoCloseable
```
public class FileBytes
extends AbstractBytes
```
File bytes.
File bytes wrap a simple RandomAccessFile instance to provide random access to a randomAccessFile on local disk. All operations are delegated directly to the RandomAccessFile interface, and limitations are dependent on the semantics of the underlying randomAccessFile.
Bytes are always stored in the underlying randomAccessFile in ByteOrder.BIG_ENDIAN order. To flip the byte order to read or write to/from a randomAccessFile in ByteOrder.LITTLE_ENDIAN order use Bytes.order(ByteOrder).

Author:

Jordan Halterman

Field Summary
- Fields inherited from interface io.atomix.storage.buffer.Bytes
  BOOLEAN, BYTE, CHARACTER, DOUBLE, FLOAT, INTEGER, LONG, MEDIUM, SHORT

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static FileBytes`	`allocate(File file)` Allocates a randomAccessFile buffer of unlimited count.
`static FileBytes`	`allocate(File file, int size)` Allocates a randomAccessFile buffer.
`static FileBytes`	`allocate(File file, String mode, int size)` Allocates a randomAccessFile buffer.
`void`	`close()`
`void`	`delete()` Deletes the underlying file.
`File`	`file()` Returns the underlying file object.
`Bytes`	`flush()` Flushes the bytes to the underlying persistence layer.
`boolean`	`isFile()` Returns a boolean value indicating whether the bytes are backed by a file.
`MappedBytes`	`map(int offset, int size)` Maps a portion of the randomAccessFile into memory in `FileChannel.MapMode#READ_WRITE` mode and returns a `UnsafeMappedBytes` instance.
`MappedBytes`	`map(int offset, int size, FileChannel.MapMode mode)` Maps a portion of the randomAccessFile into memory and returns a `UnsafeMappedBytes` instance.
`String`	`mode()` Returns the file mode.
`ByteOrder`	`order()` Returns the byte order.
`Bytes`	`read(int position, byte[] bytes, int offset, int length)` Reads bytes into the given byte array starting at the given offset up to the given length.
`Bytes`	`read(int position, Bytes bytes, int offset, int length)` Reads bytes into the given byte array starting at the given offset up to the given length.
`int`	`readByte(int offset)` Reads a byte from the buffer at the given offset.
`char`	`readChar(int offset)` Reads a 16-bit character from the buffer at the given offset.
`double`	`readDouble(int offset)` Reads a double-precision 64-bit floating point number from the buffer at the given offset.
`float`	`readFloat(int offset)` Reads a single-precision 32-bit floating point number from the buffer at the given offset.
`int`	`readInt(int offset)` Reads a 32-bit signed integer from the buffer at the given offset.
`long`	`readLong(int offset)` Reads a 64-bit signed integer from the buffer at the given offset.
`short`	`readShort(int offset)` Reads a 16-bit signed integer from the buffer at the given offset.
`Bytes`	`resize(int newSize)` Resizes the bytes.
`int`	`size()` Returns the count of the bytes.
`Bytes`	`write(int position, byte[] bytes, int offset, int length)` Writes an array of bytes to the buffer.
`Bytes`	`write(int position, Bytes bytes, int offset, int length)` Writes an array of bytes to the buffer.
`Bytes`	`writeByte(int offset, int b)` Writes a byte to the buffer at the given offset.
`Bytes`	`writeChar(int offset, char c)` Writes a 16-bit character to the buffer at the given offset.
`Bytes`	`writeDouble(int offset, double d)` Writes a double-precision 64-bit floating point number to the buffer at the given offset.
`Bytes`	`writeFloat(int offset, float f)` Writes a single-precision 32-bit floating point number to the buffer at the given offset.
`Bytes`	`writeInt(int offset, int i)` Writes a 32-bit signed integer to the buffer at the given offset.
`Bytes`	`writeLong(int offset, long l)` Writes a 64-bit signed integer to the buffer at the given offset.
`Bytes`	`writeShort(int offset, short s)` Writes a 16-bit signed integer to the buffer at the given offset.
`Bytes`	`zero()` Zeros out all bytes in the array.
`Bytes`	`zero(int offset)` Zeros out all bytes starting at the given offset in the array.
`Bytes`	`zero(int offset, int length)` Zeros out bytes starting at the given offset up to the given length.

Methods inherited from class io.atomix.storage.buffer.AbstractBytes
isDirect, order, readBoolean, readMedium, readString, readString, readUnsignedByte, readUnsignedInt, readUnsignedMedium, readUnsignedShort, readUTF8, writeBoolean, writeMedium, writeString, writeString, writeUnsignedByte, writeUnsignedInt, writeUnsignedMedium, writeUnsignedShort, writeUTF8

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.atomix.storage.buffer.Bytes
array, hasArray

- Method Detail
  - allocate
```
public static FileBytes allocate(File file)
```
    Allocates a randomAccessFile buffer of unlimited count.
    The buffer will be allocated with Long.MAX_VALUE bytes. As bytes are written to the buffer, the underlying RandomAccessFile will expand.
    
    Parameters:
    
    file - The randomAccessFile to allocate.
    
    Returns:
    
    The allocated buffer.
  - allocate
```
public static FileBytes allocate(File file,
                                 int size)
```
    Allocates a randomAccessFile buffer.
    If the underlying randomAccessFile is empty, the randomAccessFile count will expand dynamically as bytes are written to the randomAccessFile.
    
    Parameters:
    
    file - The randomAccessFile to allocate.
    
    size - The count of the bytes to allocate.
    
    Returns:
    
    The allocated buffer.
  - allocate
```
public static FileBytes allocate(File file,
                                 String mode,
                                 int size)
```
    Allocates a randomAccessFile buffer.
    If the underlying randomAccessFile is empty, the randomAccessFile count will expand dynamically as bytes are written to the randomAccessFile.
    
    Parameters:
    
    file - The randomAccessFile to allocate.
    
    mode - The mode in which to open the underlying RandomAccessFile.
    
    size - The count of the bytes to allocate.
    
    Returns:
    
    The allocated buffer.
  - file
```
public File file()
```
    Returns the underlying file object.
    
    Returns:
    
    The underlying file.
  - mode
```
public String mode()
```
    Returns the file mode.
    
    Returns:
    
    The file mode.
  - size
```
public int size()
```
    Description copied from interface: Bytes
    
    Returns the count of the bytes.
    
    Returns:
    
    The count of the bytes.
  - resize
```
public Bytes resize(int newSize)
```
    Description copied from interface: Bytes
    
    Resizes the bytes.
    When the bytes are resized, underlying memory addresses in copies of this instance may no longer be valid. Additionally, if the newSize is smaller than the current count then some data may be lost during the resize. Use with caution.
    
    Parameters:
    
    newSize - The count to which to resize this instance.
    
    Returns:
    
    The resized bytes.
  - isFile
```
public boolean isFile()
```
    Description copied from interface: Bytes
    
    Returns a boolean value indicating whether the bytes are backed by a file.
    
    Specified by:
    
    isFile in interface Bytes
    
    Overrides:
    
    isFile in class AbstractBytes
    
    Returns:
    
    Indicates whether the bytes are backed by a file.
  - map
```
public MappedBytes map(int offset,
                       int size)
```
    Maps a portion of the randomAccessFile into memory in FileChannel.MapMode#READ_WRITE mode and returns a UnsafeMappedBytes instance.
    
    Parameters:
    
    offset - The offset from which to map the randomAccessFile into memory.
    
    size - The count of the bytes to map into memory.
    
    Returns:
    
    The mapped bytes.
    
    Throws:
    
    IllegalArgumentException - If count is greater than the maximum allowed MappedByteBuffer count: Integer.MAX_VALUE
  - map
```
public MappedBytes map(int offset,
                       int size,
                       FileChannel.MapMode mode)
```
    Maps a portion of the randomAccessFile into memory and returns a UnsafeMappedBytes instance.
    
    Parameters:
    
    offset - The offset from which to map the randomAccessFile into memory.
    
    size - The count of the bytes to map into memory.
    
    mode - The mode in which to map the randomAccessFile into memory.
    
    Returns:
    
    The mapped bytes.
    
    Throws:
    
    IllegalArgumentException - If count is greater than the maximum allowed MappedByteBuffer count: Integer.MAX_VALUE
  - order
```
public ByteOrder order()
```
    Description copied from interface: Bytes
    
    Returns the byte order.
    For consistency with ByteBuffer, all bytes implementations are initially in ByteOrder.BIG_ENDIAN order.
    
    Specified by:
    
    order in interface Bytes
    
    Overrides:
    
    order in class AbstractBytes
    
    Returns:
    
    The byte order.
  - zero
```
public Bytes zero()
```
    Description copied from interface: BytesOutput
    
    Zeros out all bytes in the array.
    
    Returns:
    
    The written bytes.
  - zero
```
public Bytes zero(int offset)
```
    Description copied from interface: BytesOutput
    
    Zeros out all bytes starting at the given offset in the array.
    
    Parameters:
    
    offset - The offset at which to start zeroing out bytes.
    
    Returns:
    
    The written bytes.
  - zero
```
public Bytes zero(int offset,
                  int length)
```
    Description copied from interface: BytesOutput
    
    Zeros out bytes starting at the given offset up to the given length.
    
    Parameters:
    
    offset - The offset at which to start zeroing out bytes.
    
    length - THe total number of bytes to zero out.
    
    Returns:
    
    The written bytes.
  - read
```
public Bytes read(int position,
                  Bytes bytes,
                  int offset,
                  int length)
```
    Description copied from interface: BytesInput
    
    Reads bytes into the given byte array starting at the given offset up to the given length.
    
    Parameters:
    
    position - The offset from which to start reading bytes.
    
    bytes - The byte array into which to read bytes.
    
    offset - The offset at which to write bytes into the given buffer.
    
    length - The total number of bytes to read.
    
    Returns:
    
    The buffer.
  - read
```
public Bytes read(int position,
                  byte[] bytes,
                  int offset,
                  int length)
```
    Description copied from interface: BytesInput
    
    Reads bytes into the given byte array starting at the given offset up to the given length.
    
    Parameters:
    
    position - The offset from which to start reading bytes.
    
    bytes - The byte array into which to read bytes.
    
    offset - The offset at which to write bytes into the given buffer
    
    length - The total number of bytes to read.
    
    Returns:
    
    The buffer.
  - readByte
```
public int readByte(int offset)
```
    Description copied from interface: BytesInput
    
    Reads a byte from the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to read the byte.
    
    Returns:
    
    The read byte.
  - readChar
```
public char readChar(int offset)
```
    Description copied from interface: BytesInput
    
    Reads a 16-bit character from the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to read the character.
    
    Returns:
    
    The read character.
  - readShort
```
public short readShort(int offset)
```
    Description copied from interface: BytesInput
    
    Reads a 16-bit signed integer from the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to read the short.
    
    Returns:
    
    The read short.
  - readInt
```
public int readInt(int offset)
```
    Description copied from interface: BytesInput
    
    Reads a 32-bit signed integer from the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to read the integer.
    
    Returns:
    
    The read integer.
  - readLong
```
public long readLong(int offset)
```
    Description copied from interface: BytesInput
    
    Reads a 64-bit signed integer from the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to read the long.
    
    Returns:
    
    The read long.
  - readFloat
```
public float readFloat(int offset)
```
    Description copied from interface: BytesInput
    
    Reads a single-precision 32-bit floating point number from the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to read the float.
    
    Returns:
    
    The read float.
  - readDouble
```
public double readDouble(int offset)
```
    Description copied from interface: BytesInput
    
    Reads a double-precision 64-bit floating point number from the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to read the double.
    
    Returns:
    
    The read double.
  - write
```
public Bytes write(int position,
                   Bytes bytes,
                   int offset,
                   int length)
```
    Description copied from interface: BytesOutput
    
    Writes an array of bytes to the buffer.
    
    Parameters:
    
    position - The offset at which to start writing the bytes.
    
    bytes - The array of bytes to write.
    
    offset - The offset at which to start reading bytes from the given source.
    
    length - The number of bytes from the provided byte array to write to the buffer.
    
    Returns:
    
    The written buffer.
  - write
```
public Bytes write(int position,
                   byte[] bytes,
                   int offset,
                   int length)
```
    Description copied from interface: BytesOutput
    
    Writes an array of bytes to the buffer.
    
    Parameters:
    
    position - The offset at which to start writing the bytes.
    
    bytes - The array of bytes to write.
    
    offset - The offset at which to start reading bytes from the given source.
    
    length - The number of bytes from the provided byte array to write to the buffer.
    
    Returns:
    
    The written buffer.
  - writeByte
```
public Bytes writeByte(int offset,
                       int b)
```
    Description copied from interface: BytesOutput
    
    Writes a byte to the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to write the byte.
    
    b - The byte to write.
    
    Returns:
    
    The written buffer.
  - writeChar
```
public Bytes writeChar(int offset,
                       char c)
```
    Description copied from interface: BytesOutput
    
    Writes a 16-bit character to the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to write the character.
    
    c - The character to write.
    
    Returns:
    
    The written buffer.
  - writeShort
```
public Bytes writeShort(int offset,
                        short s)
```
    Description copied from interface: BytesOutput
    
    Writes a 16-bit signed integer to the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to write the short.
    
    s - The short to write.
    
    Returns:
    
    The written buffer.
  - writeInt
```
public Bytes writeInt(int offset,
                      int i)
```
    Description copied from interface: BytesOutput
    
    Writes a 32-bit signed integer to the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to write the integer.
    
    i - The integer to write.
    
    Returns:
    
    The written buffer.
  - writeLong
```
public Bytes writeLong(int offset,
                       long l)
```
    Description copied from interface: BytesOutput
    
    Writes a 64-bit signed integer to the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to write the long.
    
    l - The long to write.
    
    Returns:
    
    The written buffer.
  - writeFloat
```
public Bytes writeFloat(int offset,
                        float f)
```
    Description copied from interface: BytesOutput
    
    Writes a single-precision 32-bit floating point number to the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to write the float.
    
    f - The float to write.
    
    Returns:
    
    The written buffer.
  - writeDouble
```
public Bytes writeDouble(int offset,
                         double d)
```
    Description copied from interface: BytesOutput
    
    Writes a double-precision 64-bit floating point number to the buffer at the given offset.
    
    Parameters:
    
    offset - The offset at which to write the double.
    
    d - The double to write.
    
    Returns:
    
    The written buffer.
  - flush
```
public Bytes flush()
```
    Description copied from interface: BytesOutput
    
    Flushes the bytes to the underlying persistence layer.
    
    Specified by:
    
    flush in interface BytesOutput<Bytes>
    
    Overrides:
    
    flush in class AbstractBytes
    
    Returns:
    
    The flushed buffer.
  - close
```
public void close()
```
    Specified by:
    
    close in interface Bytes
    
    Specified by:
    
    close in interface AutoCloseable
    
    Overrides:
    
    close in class AbstractBytes
  - delete
```
public void delete()
```
    Deletes the underlying file.

Class FileBytes

Field Summary

Fields inherited from interface io.atomix.storage.buffer.Bytes

Method Summary

Methods inherited from class io.atomix.storage.buffer.AbstractBytes

Methods inherited from class java.lang.Object

Methods inherited from interface io.atomix.storage.buffer.Bytes

Method Detail

allocate

allocate

allocate

file

mode

size

resize

isFile

map

map

order

zero

zero

zero

read

read

readByte

readChar

readShort

readInt

readLong

readFloat

readDouble

write

write

writeByte

writeChar

writeShort

writeInt

writeLong

writeFloat

writeDouble

flush

close

delete