Класс RandomAccessFile

public RandomAccessFile(String pathname, String mode) throws FileNotFoundException

Параметры:

pathname - строка пути к файлу (зависит от системы)

mode - режим доступа режим

Исключения:

IllegalArgumentException - если аргумент режима не равен одному из "r", "rw", "rws" или "rwd"

FileNotFoundException - если режим равен "r", но указанная строка пути не обозначает существующий обычный файл, или если режим начинается с "rw", но указанная строка пути не обозначает существующий и доступный для записи обычный файл, и новый обычный файл по этому пути создать нельзя, или если произошла какая-либо другая ошибка при открытии или создании файла

public RandomAccessFile(File file, String mode) throws FileNotFoundException

Параметры:

file - объект файла

mode - режим доступа, как описано выше

Исключения:

IllegalArgumentException - если аргумент режима не равен одному из "r", "rw", "rws" или "rwd"

FileNotFoundException - если режим равен "r", но указанный объект файла не обозначает существующий обычный файл, или если режим начинается с "rw", но указанный объект файла не обозначает существующий, доступный для записи обычный файл, и новый обычный файл по этому пути создать нельзя, или если произошла какая-либо другая ошибка при открытии или создании файла

См. также:

• FileChannel.force(boolean)

public final FileDescriptor getFD() throws IOException

Возвращает:

объект дескриптора файла, связанный с этим потоком.

Исключения:

IOException - если произошла ошибка ввода-вывода.

См. также:

• FileDescriptor

public final FileChannel getChannel()

Возвращает:

канал файла, связанный с этим файлом

С момента:

1.4

public int read() throws IOException

Возвращает:

следующий байт данных или -1, если достигнут конец файла.

Исключения:

IOException - если произошла ошибка ввода-вывода. Не вызывается, если достигнут конец файла.

public int read(byte[] b, int off, int len) throws IOException

Параметры:

b - буфер, в который считываются данные.

off - начальный смещение в массиве b, где данные записываются.

len - максимальное количество считываемых байтов.

Возвращает:

общее количество считанных байтов в буфер, или -1, если больше нет данных, потому что достигнут конец файла.

Исключения:

IOException - Если первый байт не может быть прочитан по какой-либо причине, кроме конца файла, или если файл случайного доступа был закрыт, или произошла какая-либо другая ошибка ввода-вывода.

NullPointerException - Если b равно null.

IndexOutOfBoundsException - Если off отрицательно, len отрицательно или len больше b.length - off

public int read(byte[] b) throws IOException

Параметры:

b - буфер, в который считываются данные.

Возвращает:

общее количество считанных байтов в буфер, или -1, если больше нет данных, потому что достигнут конец файла.

Исключения:

IOException - Если первый байт не может быть прочитан по какой-либо причине, кроме конца файла, или если файл случайного доступа был закрыт, или произошла какая-либо другая ошибка ввода-вывода.

NullPointerException - Если b равно null.

public final void readFully(byte[] b) throws IOException

Specified by:

readFully in interface DataInput

Parameters:

b - буфер, в который считываются данные.

Throws:

NullPointerException - если b равно null.

EOFException - если этот файл достигнет конца, прежде чем будут прочитаны все байты.

IOException - если произошла ошибка ввода-вывода.

public final void readFully(byte[] b, int off, int len) throws IOException

Specified by:

readFully in interface DataInput

Parameters:

b - буфер, в который считываются данные.

off - начальный смещение в массиве данных b.

len - количество байтов для чтения.

Throws:

NullPointerException - если b равно null.

IndexOutOfBoundsException - если off отрицательно, len отрицательно или len больше, чем b.length - off.

EOFException - если этот файл достигнет конца, прежде чем будут прочитаны все байты.

IOException - если произошла ошибка ввода-вывода.

public int skipBytes(int n) throws IOException

Specified by:

skipBytes in interface DataInput

Parameters:

n - количество байтов, которые необходимо пропустить.

Returns:

фактическое количество пропущенных байтов.

Throws:

IOException - если произошла ошибка ввода-вывода.

public void write(int b) throws IOException

Specified by:

write in interface DataOutput

Parameters:

b - байт, который будет записан.

Throws:

IOException - если произошла ошибка ввода-вывода.

public void write(byte[] b) throws IOException

Specified by:

write in interface DataOutput

Parameters:

b - данные.

Throws:

IOException - если произошла ошибка ввода-вывода.

public void write(byte[] b, int off, int len) throws IOException

Specified by:

write in interface DataOutput

Parameters:

b - данные.

off - начальное смещение в данных.

len - количество байтов для записи.

Throws:

IOException - если произошла ошибка ввода-вывода.

IndexOutOfBoundsException - Если off отрицательно, len отрицательно или len больше, чем b.length - off

public long getFilePointer() throws IOException

Returns:

смещение от начала файла в байтах, в котором происходит следующий чтение или запись.

Throws:

IOException - если произошла ошибка ввода-вывода.

public void seek(long pos) throws IOException

Parameters:

pos - позиция смещения, измеренная в байтах от начала файла, в которой необходимо установить указатель файла.

Throws:

IOException - если pos меньше, чем 0 или если произошла ошибка ввода-вывода.

public long length() throws IOException

Returns:

длина этого файла, измеренная в байтах.

Throws:

IOException - если произошла ошибка ввода-вывода.

public void setLength(long newLength) throws IOException

Parameters:

newLength - Желаемая длина файла

Throws:

IOException - Если аргумент отрицательный или произошла другая ошибка ввода-вывода

Since:

1.2

public void close() throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

API Note:

Если у этого потока есть связанный канал, то этот метод закроет канал, что в свою очередь закроет этот поток. Подклассы, которые переопределяют этот метод, должны быть готовы к обработке возможного рекурсивного вызова.

Throws:

IOException - если произошла ошибка ввода-вывода.

public final boolean readBoolean() throws IOException

Specified by:

readBoolean in interface DataInput

Returns:

прочитанное значение boolean.

Throws:

EOFException - если этот файл достиг конца.

IOException - если произошла ошибка ввода-вывода.

public final byte readByte() throws IOException

    (byte)(b)

Specified by:

readByte in interface DataInput

Returns:

следующий байт этого файла как знаковое восьмиразрядное byte.

Throws:

EOFException - если этот файл достиг конца.

IOException - если произошла ошибка ввода-вывода.

public final int readUnsignedByte() throws IOException

Указано в:

readUnsignedByte в интерфейсе DataInput

Возвращает:

следующий байт этого файла, интерпретированный как беззнаковое целое число 8 бит.

Бросает:

EOFException - если этот файл достиг конца.

IOException - если произошла ошибка ввода-вывода.

public final short readShort() throws IOException

    (short)((b1 << 8) | b2)

Указано в:

readShort в интерфейсе DataInput

Возвращает:

следующие два байта этого файла, интерпретированные как знаковое целое число 16 бит.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны два байта.

IOException - если произошла ошибка ввода-вывода.

public final int readUnsignedShort() throws IOException

    (b1 << 8) | b2

Указано в:

readUnsignedShort в интерфейсе DataInput

Возвращает:

следующие два байта этого файла, интерпретированные как беззнаковое целое число 16 бит.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны два байта.

IOException - если произошла ошибка ввода-вывода.

public final char readChar() throws IOException

    (char)((b1 << 8) | b2)

Указано в:

readChar в интерфейсе DataInput

Возвращает:

следующие два байта этого файла, интерпретированные как char.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны два байта.

IOException - если произошла ошибка ввода-вывода.

public final int readInt() throws IOException

    (b1 << 24) | (b2 << 16) + (b3 << 8) + b4

Указано в:

readInt в интерфейсе DataInput

Возвращает:

следующие четыре байта этого файла, интерпретированные как int.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны четыре байта.

IOException - если произошла ошибка ввода-вывода.

public final long readLong() throws IOException

    0 <= b1, b2, b3, b4, b5, b6, b7, b8 <= 255

    ((long)b1 << 56) + ((long)b2 << 48)
        + ((long)b3 << 40) + ((long)b4 << 32)
        + ((long)b5 << 24) + ((long)b6 << 16)
        + ((long)b7 << 8) + b8

Указано в:

readLong в интерфейсе DataInput

Возвращает:

следующие восемь байтов этого файла, интерпретированные как long.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны восемь байтов.

IOException - если произошла ошибка ввода-вывода.

public final float readFloat() throws IOException

Указано в:

readFloat в интерфейсе DataInput

Возвращает:

следующие четыре байта этого файла, интерпретированные как float.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны четыре байта.

IOException - если произошла ошибка ввода-вывода.

См. также:

• readInt()
• Float.intBitsToFloat(int)

public final double readDouble() throws IOException

Указано в:

readDouble в интерфейсе DataInput

Возвращает:

следующие восемь байтов этого файла, интерпретированные как double.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны восемь байтов.

IOException - если произошла ошибка ввода-вывода.

См. также:

• readLong()
• Double.longBitsToDouble(long)

public final String readLine() throws IOException

Указано в:

readLine в интерфейсе DataInput

Возвращает:

следующую строку текста из этого файла или null, если конец файла был обнаружен до прочтения хотя бы одного байта.

Бросает:

IOException - если произошла ошибка ввода-вывода.

public final String readUTF() throws IOException

Указано в:

readUTF в интерфейсе DataInput

Возвращает:

строка Юникод.

Бросает:

EOFException - если файл достигнет конца, прежде чем будут прочитаны все байты.

IOException - если произошла ошибка ввода-вывода.

UTFDataFormatException - если байты не представляют собой правильную кодировку изменённого UTF-8 строки Юникод.

См. также:

• readUnsignedShort()

public final void writeBoolean(boolean v) throws IOException

Указано:

writeBoolean в интерфейсе DataOutput

Параметры:

v - значение типа boolean, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final void writeByte(int v) throws IOException

Указано:

writeByte в интерфейсе DataOutput

Параметры:

v - значение типа byte, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final void writeShort(int v) throws IOException

Указано:

writeShort в интерфейсе DataOutput

Параметры:

v - значение типа short, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final void writeChar(int v) throws IOException

Указано:

writeChar в интерфейсе DataOutput

Параметры:

v - значение типа char, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final void writeInt(int v) throws IOException

Указано:

writeInt в интерфейсе DataOutput

Параметры:

v - значение типа int, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final void writeLong(long v) throws IOException

Указано:

writeLong в интерфейсе DataOutput

Параметры:

v - значение типа long, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final void writeFloat(float v) throws IOException

Указано:

writeFloat в интерфейсе DataOutput

Параметры:

v - значение типа float, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

См. также:

• Float.floatToIntBits(float)

public final void writeDouble(double v) throws IOException

Указано:

writeDouble в интерфейсе DataOutput

Параметры:

v - значение типа double, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

См. также:

• Double.doubleToLongBits(double)

public final void writeBytes(String s) throws IOException

Указано:

writeBytes в интерфейсе DataOutput

Параметры:

s - строка байтов, которые нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final void writeChars(String s) throws IOException

Указано:

writeChars в интерфейсе DataOutput

Параметры:

s - значение типа String, которое нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.

См. также:

• writeChar(int)

public final void writeUTF(String str) throws IOException

Указано:

writeUTF в интерфейсе DataOutput

Параметры:

str - строка, которую нужно записать.

Исключения:

IOException - если произошла ошибка ввода-вывода.