compact3

javax.tools

Интерфейс StandardJavaFileManager

Все Суперинтерфейсы:

AutoCloseable, Closeable, Flushable, JavaFileManager, OptionChecker

public interface StandardJavaFileManager
extends JavaFileManager

Файловый менеджер, основанный на java.io. Файл. Распространенный способ получить экземпляр этого class использует getStandardFileManager, например:

   JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
    DiagnosticCollector<JavaFileObject> diagnostics =
       new  DiagnosticCollector<JavaFileObject>();
   StandardJavaFileManager fm = compiler.getStandardFileManager(diagnostics, null, null);
 

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

• Имена файлов не должны быть каноническими.
• Для объектов файла, представляющих регулярные файлы
  • метод FileObject.delete() эквивалентно File.delete(),
  • метод FileObject.getLastModified() эквивалентно File.lastModified(),
  • методы FileObject.getCharContent(boolean), FileObject.openInputStream(), и FileObject.openReader(boolean) должен успешно выполниться, если следующее успешно выполнилось бы (игнорирующий кодирующие проблемы):

    new FileInputStream(new File(fileObject.toUri()))

  • и методы FileObject.openOutputStream(), и FileObject.openWriter() должен успешно выполниться, если следующее успешно выполнилось бы (игнорирующий кодирующие проблемы):

    new FileOutputStream(new File(fileObject.toUri()))

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

Согласно этим правилам, позволяются следующие URI, например:

• file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java
• jar:///C:/Documents%20and%20Settings/UncleBob/lib/vendorA.jar!com/vendora/LibraryClass.class

Принимая во внимание, что они не (причина в круглых скобках):

• file:BobsApp/Test.java (имя файла относительно, и зависьте от текущего каталога),
• jar:lib/vendorA.jar!com/vendora/LibraryClass.class (первая половина пути зависит от текущего каталога, тогда как компонент после! является законным),
• Test.java (этот URI зависит от текущего каталога и не имеет схемы),
• jar:///C:/Documents%20and%20Settings/UncleBob/BobsApp/../lib/vendorA.jar!com/vendora/LibraryClass.class (путь не нормализуется),

С тех пор:

1.6

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от интерфейса javax.tools. JavaFileManager

JavaFileManager. Расположение

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

Модификатор и Тип	Метод и Описание
Iterable<? extends JavaFileObject>	getJavaFileObjects(File... files) Получает объекты файла, представляющие данные файлы.
Iterable<? extends JavaFileObject>	getJavaFileObjects(String... names) Получает объекты файла, представляющие данные имена файлов.
Iterable<? extends JavaFileObject>	getJavaFileObjectsFromFiles(Iterable<? extends File> files) Получает объекты файла, представляющие данные файлы.
Iterable<? extends JavaFileObject>	getJavaFileObjectsFromStrings(Iterable<String> names) Получает объекты файла, представляющие данные имена файлов.
Iterable<? extends File>	getLocation(JavaFileManager.Location location) Связали путь с данным расположением.
boolean	isSameFile(FileObject a, FileObject b) Сравнивает два объекта файла, и возвратите true, если они представляют тот же самый канонический файл, архивируют запись файла, или запись в какой-либо файловой системе базируемый контейнер.
void	setLocation(JavaFileManager.Location location, Iterable<? extends File> path) Связывает данный путь с данным расположением.

Методы, наследованные от интерфейса javax.tools. JavaFileManager

close, flush, getClassLoader, getFileForInput, getFileForOutput, getJavaFileForInput, getJavaFileForOutput, handleOption, hasLocation, inferBinaryName, list

Методы, наследованные от интерфейса javax.tools. OptionChecker

isSupportedOption

Деталь метода

isSameFile

boolean isSameFile(FileObject a,
                   FileObject b)

Сравнивает два объекта файла, и возвратите true, если они представляют тот же самый канонический файл, архивируют запись файла, или запись в какой-либо файловой системе базируемый контейнер.

Определенный:

isSameFile в интерфейсе JavaFileManager

Параметры:

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

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

Возвраты:

истина, если данные объекты файла представляют тот же самый канонический файл или архивируют запись файла; ложь иначе

Броски:

IllegalArgumentException - если любой из параметров создавался с другой реализацией файлового менеджера

getJavaFileObjectsFromFiles

Iterable<? extends JavaFileObject> getJavaFileObjectsFromFiles(Iterable<? extends File> files)

Получает объекты файла, представляющие данные файлы.

Параметры:

files - список файлов

Возвраты:

список объектов файла

Броски:

IllegalArgumentException - если список файлов включает каталог

getJavaFileObjects

Iterable<? extends JavaFileObject> getJavaFileObjects(File... files)

Получает объекты файла, представляющие данные файлы. Метод удобства, эквивалентный:

     getJavaFileObjectsFromFiles(Arrays.asList(files))
 

Параметры:

files - массив файлов

Возвраты:

список объектов файла

Броски:

IllegalArgumentException - если массив файлов включает каталог

NullPointerException - если данный массив содержит нулевые элементы

getJavaFileObjectsFromStrings

Iterable<? extends JavaFileObject> getJavaFileObjectsFromStrings(Iterable<String> names)

Получает объекты файла, представляющие данные имена файлов.

Параметры:

names - список имен файлов

Возвраты:

список объектов файла

Броски:

IllegalArgumentException - если список имен файлов включает каталог

getJavaFileObjects

Iterable<? extends JavaFileObject> getJavaFileObjects(String... names)

Получает объекты файла, представляющие данные имена файлов. Метод удобства, эквивалентный:

     getJavaFileObjectsFromStrings(Arrays.asList(names))
 

Параметры:

names - список имен файлов

Возвраты:

список объектов файла

Броски:

IllegalArgumentException - если массив имен файлов включает каталог

NullPointerException - если данный массив содержит нулевые элементы

setLocation

void setLocation(JavaFileManager.Location location,
                 Iterable<? extends File> path)
          throws IOException

Связывает данный путь с данным расположением. Любое предыдущее значение будет отброшено.

Параметры:

location - расположение

path - список файлов, если null используйте путь значения по умолчанию для этого расположения

Броски:

IllegalArgumentException - если расположение является выходным расположением, и путь не содержит точно один элемент

IOException - если расположение является выходным расположением, и путь не представляет существующий каталог

См. Также:

getLocation(javax.tools.JavaFileManager.Location)

getLocation

Iterable<? extends File> getLocation(JavaFileManager.Location location)

Связали путь с данным расположением.

Параметры:

location - расположение

Возвраты:

список файлов или null если у этого расположения нет никакого связанного пути

См. Также:

setLocation(javax.tools.JavaFileManager.Location, java.lang.Iterable<? extends java.io.File>)