Интерфейс FileObject

public interface FileObject

Абстракция файла для инструментов. В данном контексте файл означает абстракцию обычных файлов и других источников данных. Например, объект файла может использоваться для представления обычных файлов, кэша памяти или данных в базах данных.

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

Если явно не разрешено, все методы в этом интерфейсе могут выбросить NullPointerException, если им будет передан null аргумент.

Методы

toUri

URI toUri()

Возвращает URI, идентифицирующий этот объект файла.

Возвращает:

URI

getName

String getName()

Получает удобочитаемое имя для этого объекта файла. Точное значение, возвращаемое, не указано, но реализации должны позаботиться о сохранении имен, предоставленных пользователем. Например, если пользователь вводит имя файла "BobsApp\Test.java" в командной строке, этот метод должен вернуть "BobsApp\Test.java", в то время как метод toUri может вернуть file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java.

Возвращает:

удобочитаемое имя

openInputStream

InputStream openInputStream()
                     throws IOException

Получает InputStream для этого объекта файла.

Возвращает:

InputStream

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

IllegalStateException - если этот объект файла был открыт для записи и не поддерживает чтение

UnsupportedOperationException - если этот тип объекта файла не поддерживает доступ по байтам

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

openOutputStream

OutputStream openOutputStream()
                       throws IOException

Получает OutputStream для этого объекта файла.

Возвращает:

OutputStream

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

IllegalStateException - если этот объект файла был открыт для чтения и не поддерживает запись

UnsupportedOperationException - если этот тип объекта файла не поддерживает доступ по байтам

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

openReader

Reader openReader(boolean ignoreEncodingErrors)
           throws IOException

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

Параметры:

ignoreEncodingErrors - игнорировать ошибки кодировки, если true

Возвращает:

ридер

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

IllegalStateException - если этот объект файла был открыт для записи и не поддерживает чтение

UnsupportedOperationException - если этот тип объекта файла не поддерживает доступ по символам

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

getCharContent

CharSequence getCharContent(boolean ignoreEncodingErrors)
                     throws IOException

Получает текстовое содержимое этого объекта файла, если доступно. Любой байт, который не может быть декодирован, будет заменён символом по умолчанию. Кроме того, может быть сообщено диагностическое сообщение, если ignoreEncodingErrors не равно true.

Параметры:

ignoreEncodingErrors - игнорировать ошибки кодировки, если true

Возвращает:

CharSequence, если доступно; null в противном случае

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

IllegalStateException - если этот объект файла был открыт для записи и не поддерживает чтение

UnsupportedOperationException - если этот тип объекта файла не поддерживает доступ по символам

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

openWriter

Writer openWriter()
           throws IOException

Получает Writer для этого объекта файла.

Возвращает:

Writer

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

IllegalStateException - если этот объект файла был открыт для чтения и не поддерживает запись

UnsupportedOperationException - если этот тип объекта файла не поддерживает доступ по символам

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

getLastModified

long getLastModified()

Получает время последнего изменения этого объекта файла. Время измеряется в миллисекундах с начала эпохи (00:00:00 GMT, 1 января 1970 г.).

Возвращает:

время последнего изменения объекта файла; или 0, если объект файла не существует, если произошла ошибка ввода-вывода или операция не поддерживается

delete

boolean delete()

Удаляет этот объект файла. В случае ошибок возвращает false.

Возвращает:

true, если и только если объект файла был успешно удалён; иначе false