Интерфейс 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 из любой файловой системы.