Интерфейс FileObject

Все известные подинтерфейсы:: JavaFileObject

Все известные реализующие классы:: ForwardingFileObject, ForwardingJavaFileObject, SimpleJavaFileObject

public interface FileObject

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

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

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

С момента:: 1.6

Методы

Модификатор и тип	Метод	Описание
`boolean`	`delete()`	Удаляет этот объект файла.
`CharSequence`	`getCharContent(boolean ignoreEncodingErrors)`	Возвращает текстовое содержимое этого объекта файла, если доступно.
`long`	`getLastModified()`	Возвращает время последнего изменения этого объекта файла.
`String`	`getName()`	Возвращает удобочитаемое имя для этого объекта файла.
`InputStream`	`openInputStream()`	Возвращает InputStream для этого объекта файла.
`OutputStream`	`openOutputStream()`	Возвращает OutputStream для этого объекта файла.
`Reader`	`openReader(boolean ignoreEncodingErrors)`	Возвращает ридер для этого объекта.
`Writer`	`openWriter()`	Возвращает Writer для этого объекта файла.
`URI`	`toUri()`	Возвращает URI, идентифицирующий этот объект файла.

Методы

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 в противном случае