Класс RandomAccessFile

Экземпляры этого класса поддерживают чтение и запись в файле произвольного доступа. Файл произвольного доступа ведет себя как большой массив байтов, хранящихся в файловой системе. Существует указатель, или индекс в неявном массиве, называемый указателем файла; операции ввода считывают байты, начиная с указателя файла, и продвигают указатель файла за прочитанные байты. Если файл произвольного доступа создан в режиме чтения/записи, то доступны и операции вывода; операции вывода записывают байты, начиная с указателя файла, и продвигают указатель файла за записанные байты. Операции вывода, записывающие за текущий конец неявного массива, приводят к расширению массива. Указатель файла можно прочитать с помощью метода getFilePointer и установить с помощью метода seek.

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

Конструкторы

RandomAccessFile

public RandomAccessFile(String name,
                        String mode)
                 throws FileNotFoundException

Параметры:

name - имя файла (зависит от системы)

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

Исключения:

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

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

SecurityException - если менеджер безопасности существует и его метод checkRead запрещает чтение файла или режим равен "rw", и метод менеджера безопасности checkWrite запрещает запись в файл

См. также:

SecurityException, SecurityManager.checkRead(java.lang.String), SecurityManager.checkWrite(java.lang.String)

RandomAccessFile

public RandomAccessFile(File file,
                        String mode)
                 throws FileNotFoundException

Параметры:

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

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

Исключения:

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

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

SecurityException - если менеджер безопасности существует и его метод checkRead запрещает чтение файла или режим равен "rw", и метод менеджера безопасности checkWrite запрещает запись в файл

См. также:

SecurityManager.checkRead(java.lang.String), SecurityManager.checkWrite(java.lang.String), FileChannel.force(boolean)

Методы

getFD

public final FileDescriptor getFD()
                           throws IOException

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

Возвращает:

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

Исключения:

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

См. также:

FileDescriptor

getChannel

public final FileChannel getChannel()

Возвращает:

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

С:

1.4

read

public int read()
         throws IOException

Возвращает:

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

Исключения:

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

read

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.

read

public int read(byte[] b)
         throws IOException

Параметры:

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

Возвращает:

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

Исключения:

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

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

readFully

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

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

Указано в:

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

Параметры:

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

Исключения:

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

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

readFully

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

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

Указано в:

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

Параметры:

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

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

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

Исключения:

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

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

skipBytes

public int skipBytes(int n)
              throws IOException

Указано в:

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

Параметры:

n - количество байтов для пропуска.

Возвращает:

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

Исключения:

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

write

public void write(int b)
           throws IOException

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

Указано в:

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

Параметры:

b - byte для записи.

Исключения:

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

write

public void write(byte[] b)
           throws IOException

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

Указано в:

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

Параметры:

b - данные.

Исключения:

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

write

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

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

Указано в:

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

Параметры:

b - данные.

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

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

Исключения:

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

getFilePointer

public long getFilePointer()
                    throws IOException

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

Возвращает:

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

Исключения:

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

seek

public void seek(long pos)
          throws IOException

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

Параметры:

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

Исключения:

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

length

public long length()
            throws IOException

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

Возвращает:

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

Исключения:

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

setLength

public void setLength(long newLength)
               throws IOException

Параметры:

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

Исключения:

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

С:

1.2

close

public void close()
           throws IOException

Указано в:

close в интерфейсе Closeable

Указано в:

close в интерфейсе AutoCloseable

Исключения:

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

readBoolean

public final boolean readBoolean()
                          throws IOException

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

Указано в:

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

Возвращает:

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

Исключения:

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

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

readByte

public final byte readByte()
                    throws IOException

(byte)(b)

Указано в:

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

Возвращает:

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

Исключения:

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

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

readUnsignedByte

public final int readUnsignedByte()
                           throws IOException

Указано в:

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

Возвращает:

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

Исключения:

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

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

readShort

public final short readShort()
                      throws IOException

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

Указано в:

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

Возвращает:

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

Исключения:

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

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

readUnsignedShort

public final int readUnsignedShort()
                            throws IOException

(b1 << 8) | b2

Указано в:

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

Возвращает:

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

Исключения:

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

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

readChar

public final char readChar()
                    throws IOException

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

Указано в:

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

Возвращает:

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

Исключения:

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

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

readInt

public final int readInt()
                  throws IOException

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

Указано:

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

Возвращает:

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

Выбрасывает:

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

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

readLong

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 - если произошла ошибка ввода-вывода.

readFloat

public final float readFloat()
                      throws IOException

Указано:

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

Возвращает:

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

Выбрасывает:

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

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

См. также:

readInt(), Float.intBitsToFloat(int)

readDouble

public final double readDouble()
                        throws IOException

Указано:

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

Возвращает:

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

Выбрасывает:

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

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

См. также:

readLong(), Double.longBitsToDouble(long)

readLine

public final String readLine()
                      throws IOException

Указано:

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

Возвращает:

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

Выбрасывает:

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

readUTF

public final String readUTF()
                     throws IOException

Указано:

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

Возвращает:

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

Выбрасывает:

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

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

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

См. также:

readUnsignedShort()

writeBoolean

public final void writeBoolean(boolean v)
                        throws IOException

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

Указано:

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

Параметры:

v - значение boolean для записи.

Выбрасывает:

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

writeByte

public final void writeByte(int v)
                     throws IOException

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

Указано:

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

Параметры:

v - значение byte для записи.

Выбрасывает:

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

writeShort

public final void writeShort(int v)
                      throws IOException

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

Указано:

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

Параметры:

v - значение short для записи.

Выбрасывает:

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

writeChar

public final void writeChar(int v)
                     throws IOException

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

Указано:

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

Параметры:

v - значение char для записи.

Выбрасывает:

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

writeInt

public final void writeInt(int v)
                    throws IOException

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

Указано:

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

Параметры:

v - значение int для записи.

Выбрасывает:

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

writeLong

public final void writeLong(long v)
                     throws IOException

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

Указано:

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

Параметры:

v - значение long для записи.

Выбрасывает:

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

writeFloat

public final void writeFloat(float v)
                      throws IOException

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

Указано:

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

Параметры:

v - значение float для записи.

Выбрасывает:

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

См. также:

Float.floatToIntBits(float)

writeDouble

public final void writeDouble(double v)
                       throws IOException

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

Указано:

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

Параметры:

v - значение double для записи.

Выбрасывает:

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

См. также:

Double.doubleToLongBits(double)

writeBytes

public final void writeBytes(String s)
                      throws IOException

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

Определяется:

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

Параметры:

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

Исключения:

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

writeChars

public final void writeChars(String s)
                      throws IOException

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

Определяется:

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

Параметры:

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

Исключения:

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

См. также:

writeChar(int)

writeUTF

public final void writeUTF(String str)
                    throws IOException

Определяется:

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

Параметры:

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

Исключения:

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