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