Класс RandomAccessFile

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

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

Аргумент mode определяет режим доступа к файлу. Допустимые значения и их значения:

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

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

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

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

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

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

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

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

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

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

    (byte)(b)

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

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

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

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

    (b1 << 8) | b2

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

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

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

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

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

    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

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

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

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

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

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

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

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

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