Интерфейс StandardJavaFileManager

public interface StandardJavaFileManager
extends JavaFileManager

Менеджер файлов, основанный на java.io.File и java.nio.file.Path. Общий способ получения экземпляра этого класса — использование 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 (путь не нормализован)

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