javax.tools
接口 StandardJavaFileManager

所有超级接口：

Closeable, Flushable, JavaFileManager, OptionChecker

public interface StandardJavaFileManager
extends JavaFileManager

基于 java.io.File 的文件管理器。获取此类实例的一般方法是使用 getStandardFileManager，例如：

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

• 文件名称不需要规范。
• 对于表示常规文件的文件对象
  • 方法 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()))

• 从 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

isSameFile

boolean isSameFile(FileObject a,
                   FileObject b)

比较两个文件对象，如果它们表示相同的规范文件、zip 文件条目或者基于任何文件系统的容器中的条目，则返回 true。

指定者：

接口 JavaFileManager 中的 isSameFile

参数：

a - 文件对象

b - 文件对象

返回：

如果给定的文件对象表示相同的规范文件或 zip 文件条目，则返回 true；否则返回 false。

抛出：

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 - 如果给定数组包含 null 元素

getJavaFileObjectsFromStrings

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

获取表示给定文件名称的文件对象。

参数：

names - 文件名称列表

返回：

文件对象列表

抛出：

IllegalArgumentException - 如果文件名称列表包含目录

getJavaFileObjects

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

获取表示给定文件名称的文件对象。一个便捷方法，等效于：

getJavaFileObjectsFromStrings(Arrays.asList(names))
 

参数：

names - 文件名称列表

返回：

文件对象列表

抛出：

IllegalArgumentException - 如果文件名称数组包含目录

NullPointerException - 如果给定数组包含 null 元素

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)

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。