Класс RandomAccessFile

public RandomAccessFile(String name, String mode) throws FileNotFoundException

Создаёт поток для произвольного доступа к файлу для чтения и, необязательно, для записи, по заданному имени. Создаётся новый объект FileDescriptor для представления соединения с файлом.

Аргумент mode определяет режим доступа к файлу. Допустимые значения и их смыслы указаны для конструктора RandomAccessFile(File,String).

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

public RandomAccessFile(File file, String mode) throws FileNotFoundException

Создаёт поток для произвольного доступа к файлу, указанному в аргументе File, для чтения и, необязательно, для записи. Создаётся новый объект FileDescriptor для представления соединения с этим файлом.

Аргумент mode определяет режим доступа к файлу.

Допустимые значения режимов доступа и их смыслы

Значение	Смысл
"r"	Открытие только для чтения. Вызов любого из методов write результирующего объекта приведёт к исключению IOException.
"rw"	Открытие для чтения и записи. Если файл не существует, будет предпринята попытка его создания.
"rws"	Открытие для чтения и записи, как с "rw", и также требует, чтобы каждое обновление содержимого или метаданных файла синхронно записывалось на подлежащее устройство хранения.
"rwd"	Открытие для чтения и записи, как с "rw", и также требует, чтобы каждое обновление содержимого файла синхронно записывалось на подлежащее устройство хранения.

Режимы "rws" и "rwd" работают аналогично методу force(boolean) класса FileChannel, передавая аргументы true и false соответственно, за исключением того, что они всегда применяются ко всем операциям ввода-вывода и, следовательно, часто более эффективны. Если файл находится на локальном устройстве хранения, то по возвращении вызова метода этого класса гарантируется, что все изменения, внесённые в файл данным вызовом, были записаны на это устройство. Это полезно для обеспечения того, что критическая информация не будет потеряна в случае сбоя системы. Если файл не находится на локальном устройстве, такая гарантия не предоставляется.

Режим "rwd" может использоваться для сокращения числа операций ввода-вывода. Использование "rwd" требует записи только обновлений содержимого файла в хранилище; использование "rws" требует записи обновлений как содержимого файла, так и его метаданных, что обычно требует как минимум ещё одной операции ввода-вывода низкого уровня.

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

public final FileDescriptor getFD() throws IOException

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

public final FileChannel getChannel()

Возвращает уникальный объект FileChannel, связанный с этим файлом.

Позиция position возвращённого канала всегда равна смещению указателя файла этого объекта, возвращаемому методом getFilePointer. Изменение смещения указателя файла этого объекта, как явно, так и путём чтения или записи байтов, изменит позицию канала, и наоборот. Изменение длины файла с помощью этого объекта изменит длину, видимую через канал файла, и наоборот.

public int read() throws IOException

Читает один байт данных из этого файла. Байт возвращается в виде целого числа в диапазоне от 0 до 255 (0x00-0x0ff). Этот метод блокируется, если данные ещё недоступны.

Хотя RandomAccessFile не является подклассом InputStream, этот метод ведёт себя точно так же, как метод InputStream.read() класса InputStream.

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

Читает до len байт данных из этого файла в массив байтов. Этот метод блокируется, пока как минимум один байт данных недоступен.

Хотя RandomAccessFile не является подклассом InputStream, этот метод ведёт себя точно так же, как метод InputStream.read(byte[], int, int) класса InputStream.

public int read(byte[] b) throws IOException

Считывает до b.length байтов данных из этого файла в массив байтов. Этот метод блокируется до тех пор, пока не станет доступным хотя бы один байт ввода.

Хотя RandomAccessFile не является подклассом InputStream, этот метод ведет себя точно так же, как метод InputStream.read(byte[]) объекта InputStream.

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

Считывает b.length байтов из этого файла в массив байтов, начиная с текущей позиции указателя файла. Этот метод многократно считывает из файла, пока не будет прочитано нужное количество байтов. Этот метод блокируется до тех пор, пока не будет прочитано нужное количество байтов, не будет обнаружен конец потока или не будет брошено исключение.

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

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

public int skipBytes(int n) throws IOException

Попытка пропустить n байтов входных данных, отбрасывая пропущенные байты.

Этот метод может пропустить меньшее количество байтов, возможно, ноль. Это может произойти по различным причинам; достижение конца файла до того, как будет пропущено n байтов, — лишь один из вариантов. Этот метод никогда не выбрасывает EOFException. Возвращается фактическое количество пропущенных байтов. Если n отрицательно, байты не пропускаются.

public void write(int b) throws IOException

Записывает указанный байт в этот файл. Запись начинается с текущей позиции указателя файла.

public void write(byte[] b) throws IOException

Записывает b.length байтов из указанного массива байтов в этот файл, начиная с текущей позиции указателя файла.

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

Записывает len байтов из указанного массива байтов, начиная со смещения off в этот файл.

public long getFilePointer() throws IOException

Возвращает текущее смещение в этом файле.

public void seek(long pos) throws IOException

Устанавливает смещение указателя файла, измеренное от начала этого файла, в котором произойдет следующее считывание или запись. Смещение может быть установлено за пределами конца файла. Установка смещения за пределами конца файла не изменяет длину файла. Длина файла изменится только при записи после того, как смещение было установлено за пределами конца файла.

public long length() throws IOException

Возвращает длину этого файла.

public void setLength(long newLength) throws IOException

Устанавливает длину этого файла.

Если текущая длина файла, возвращаемая методом length, больше, чем аргумент newLength, то файл будет укорочен. В этом случае, если смещение файла, возвращаемое методом getFilePointer, больше, чем newLength, то после возврата этого метода смещение будет равно newLength.

Если текущая длина файла, возвращаемая методом length, меньше, чем аргумент newLength, то файл будет расширен. В этом случае содержимое расширенной части файла не определено.

public void close() throws IOException

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

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

public final boolean readBoolean() throws IOException

Считывает boolean из этого файла. Этот метод считывает один байт из файла, начиная с текущей позиции указателя файла. Значение 0 представляет false. Любое другое значение представляет true. Этот метод блокируется до тех пор, пока байт не будет прочитан, не будет обнаружен конец потока или не будет брошено исключение.

public final byte readByte() throws IOException

Считывает знаковое значение с восемью битами из этого файла. Этот метод считывает байт из файла, начиная с текущей позиции указателя файла. Если прочитанный байт равен b, где 0 <= b <= 255, то результат:

     (byte)(b)
 

Этот метод блокируется до тех пор, пока байт не будет прочитан, не будет обнаружен конец потока или не будет брошено исключение.

public final int readUnsignedByte() throws IOException

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

Этот метод блокируется до тех пор, пока байт не будет прочитан, не будет обнаружен конец потока или не будет брошено исключение.

public final short readShort() throws IOException

Считывает целое число со знаком 16 бит из этого файла. Метод считывает два байта из этого файла, начиная с текущей позиции указателя файла. Если два прочитанных байта в порядке следования являются b1 и b2, где каждое из двух значений находится в диапазоне от 0 до 255 включительно, то результат равен:

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

Этот метод блокируется до тех пор, пока не будут прочитаны два байта, не будет обнаружен конец потока или не будет брошено исключение.

public final int readUnsignedShort() throws IOException

Считывает целое число без знака 16 бит из этого файла. Этот метод считывает два байта из файла, начиная с текущей позиции указателя. Если прочитанные байты в порядке следования являются b1 и b2, где 0 <= b1, b2 <= 255, то результат равен:

     (b1 << 8) | b2
 

Этот метод блокируется до тех пор, пока не будут прочитаны два байта, не будет обнаружен конец потока или не будет брошено исключение.

public final char readChar() throws IOException

Считывает символ из этого файла. Этот метод считывает два байта из файла, начиная с текущей позиции указателя. Если прочитанные байты в порядке следования являются b1 и b2, где 0 <= b1, b2 <= 255, то результат равен:

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

Этот метод блокируется до тех пор, пока не будут прочитаны два байта, не будет обнаружен конец потока или не будет брошено исключение.

public final int readInt() throws IOException

Считывает целое число со знаком 32 бит из этого файла. Этот метод считывает 4 байта из файла, начиная с текущей позиции указателя. Если прочитанные байты в порядке следования являются b1, b2, b3, и b4, где 0 <= b1, b2, b3, b4 <= 255, то результат равен:

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

Этот метод блокируется до тех пор, пока не будут прочитаны четыре байта, не будет обнаружен конец потока или не будет брошено исключение.

public final long readLong() throws IOException

Считывает целое число со знаком 64 бит из этого файла. Этот метод считывает восемь байтов из файла, начиная с текущей позиции указателя. Если прочитанные байты в порядке следования являются b1, b2, b3, b4, b5, b6, b7, и b8, где:

     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
 

Этот метод блокируется до тех пор, пока не будут прочитаны восемь байтов, не будет обнаружен конец потока или не будет брошено исключение.

public final float readFloat() throws IOException

Считывает float из этого файла. Этот метод считывает значение int, начиная с текущей позиции указателя файла, как если бы это делал метод readInt, а затем преобразует это значение int в float с помощью метода intBitsToFloat в классе Float.

Этот метод блокируется до тех пор, пока не будут прочитаны четыре байта, не будет обнаружен конец потока или не будет брошено исключение.

public final double readDouble() throws IOException

Считывает double из этого файла. Этот метод считывает значение long, начиная с текущей позиции указателя файла, как если бы это делал метод readLong, а затем преобразует это значение long в double с помощью метода longBitsToDouble в классе Double.

Этот метод блокируется до тех пор, пока не будут прочитаны восемь байтов, не будет обнаружен конец потока или не будет брошено исключение.

public final String readLine() throws IOException

Считывает следующую строку текста из этого файла. Этот метод последовательно считывает байты из файла, начиная с текущей позиции указателя, до тех пор, пока не встретит символ конца строки или конец файла. Каждый байт преобразуется в символ, взяв значение байта для младших восьми бит символа и установив старшие восемь битов символа в ноль. Таким образом, этот метод не поддерживает весь набор символов Unicode.

Строка текста завершается символом возврата каретки ('\r'), символом новой строки ('\n'), символом возврата каретки, немедленно за которым следует символ новой строки, или концом файла. Символы конца строки отбрасываются и не включаются в состав возвращаемой строки.

Этот метод блокируется до тех пор, пока не будет прочитан символ новой строки, не будут прочитаны символ возврата каретки и байт, следующий за ним (для проверки, является ли это символом новой строки), не будет достигнут конец файла или не будет брошено исключение.

public final String readUTF() throws IOException

Считывает строку из этого файла. Строка была закодирована в формате изменённого UTF-8.

Первые два байта считываются, начиная с текущей позиции указателя файла, как если бы это делал метод readUnsignedShort. Это значение даёт количество следующих байтов, которые находятся в закодированной строке, а не длину результирующей строки. Затем последующие байты интерпретируются как байты, кодирующие символы в формате изменённого UTF-8, и преобразуются в символы.

Этот метод блокируется до тех пор, пока не будут прочитаны все байты, не будет обнаружен конец потока или не будет брошено исключение.

public final void writeBoolean(boolean v) throws IOException

Записывает boolean в файл в виде значения одного байта. Значение true записывается как значение (byte)1; значение false записывается как значение (byte)0. Запись начинается с текущей позиции указателя файла.

public final void writeByte(int v) throws IOException

Записывает byte в файл в виде значения одного байта. Запись начинается с текущей позиции указателя файла.

public final void writeShort(int v) throws IOException

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

public final void writeChar(int v) throws IOException

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

public final void writeInt(int v) throws IOException

Записывает int в файл в виде четырёх байтов, старший байт первым. Запись начинается с текущей позиции указателя файла.

public final void writeLong(long v) throws IOException

Записывает long в файл в виде восьми байтов, старший байт первым. Запись начинается с текущей позиции указателя файла.

public final void writeFloat(float v) throws IOException

Преобразует аргумент float в int с помощью метода floatToIntBits в классе Float, а затем записывает это значение int в файл в виде четырёхбайтового значения, старший байт первым. Запись начинается с текущей позиции указателя файла.

public final void writeDouble(double v) throws IOException

Преобразует аргумент double в long с помощью метода doubleToLongBits в классе Double, а затем записывает это значение long в файл в виде восьмибайтового значения, старший байт первым. Запись начинается с текущей позиции указателя файла.

public final void writeBytes(String s) throws IOException

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

public final void writeChars(String s) throws IOException

Записывает строку в файл как последовательность символов. Каждый символ записывается в поток данных вывода, как если бы методом writeChar. Запись начинается с текущей позиции указателя файла.

public final void writeUTF(String str) throws IOException

Записывает строку в файл, используя кодировку модифицированный UTF-8 для машинонезависимого представления.

Сначала в файл, начиная с текущей позиции указателя файла, записываются два байта, как если бы методом writeShort было передано число следующих байтов. Это значение представляет количество байтов, фактически записанных, а не длину строки. После длины последовательно выводятся каждый символ строки, используя кодировку модифицированного UTF-8 для каждого символа.