javax.tools

Интерфейсный FileObject

Все Известные Подынтерфейсы:

JavaFileObject

Все Известные Классы с реализацией:

ForwardingFileObject, ForwardingJavaFileObject, SimpleJavaFileObject

public interface FileObject

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

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

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

С тех пор:

1.6

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	delete() Удаляет этот объект файла.
CharSequence	getCharContent(boolean ignoreEncodingErrors) Получает символьный контент этого объекта файла, при наличии.
long	getLastModified() Получает время, этот объект файла был последний измененный.
Строка	getName() Получает удобное для пользователя имя для этого объекта файла.
InputStream	openInputStream() Получает InputStream для этого объекта файла.
OutputStream	openOutputStream() Получает OutputStream для этого объекта файла.
Читатель	openReader(boolean ignoreEncodingErrors) Получает читателя для этого объекта.
Писатель	openWriter() Получает Писателя для этого объекта файла.
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 истина.

Параметры:

ignoreEncodingErrors - проигнорируйте ошибки кодирования если истина

Возвраты:

Читатель

Броски:

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

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

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

getCharContent

CharSequence getCharContent(boolean ignoreEncodingErrors)
                            throws IOException

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

Параметры:

ignoreEncodingErrors - проигнорируйте ошибки кодирования если истина

Возвраты:

CharSequence при наличии; null иначе

Броски:

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

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

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

openWriter

Writer openWriter()
                  throws IOException

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

Возвраты:

Писатель

Броски:

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

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

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

getLastModified

long getLastModified()

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

Возвраты:

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

удалить

boolean delete()

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

Возвраты:

истина, если и только если этот объект файла успешно удаляется; ложь иначе