compact3

javax.tools

Interface StandardJavaFileManager

All Superinterfaces:

AutoCloseable， Closeable， Flushable， JavaFileManager， OptionChecker

public interface StandardJavaFileManager
extends JavaFileManager

基于 java.io.File文件管理器。获得这个类的实例的一个常用方法是使用 getStandardFileManager，例如：

javacompiler = toolprovider getsystemjavacompiler()编译器； DiagnosticCollector<JavaFileObject>诊断=新的 DiagnosticCollector<JavaFileObject>()；standardjavafilemanager FM =编译器。getstandardfilemanager（诊断，null，null）；

这个文件管理器创建代表定期 files，文件对象 zip file entries条目，或类似的文件系统为基础的容器。任何文件返回的对象实现此接口的文件管理器必须遵守下列行为：

• 文件名不需要规范。
• 表示普通文件
  • 方法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()
  • 必须absolute（有模式），和
  • 必须有一个normalized path component可没有任何特定的上下文的过程如当前目录解决（文件名必须是绝对的）。
  返回URI

根据这些规则，以下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（路径不规范）

从以下版本开始：

一点六

Nested Class Summary

Nested classes/interfaces inherited from interface javax.tools.JavaFileManager

JavaFileManager.Location

方法摘要

Modifier and Type	Method and Description
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) 比较两个文件对象和返回真，如果他们代表相同的规范文件，压缩文件的条目，或在任何文件系统为基础的容器中的条目。
void	setLocation(JavaFileManager.Location location, Iterable<? extends File> path) 将给定的路径与给定的位置关联。

Methods inherited from interface javax.tools.JavaFileManager

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

Methods inherited from interface javax.tools.OptionChecker

isSupportedOption

方法详细信息

isSameFile

boolean isSameFile(FileObject a,
                   FileObject b)

比较两个文件对象和返回真，如果他们代表相同的规范文件，压缩文件的条目，或在任何文件系统为基础的容器中的条目。

Specified by:

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 -文件数组

结果

文件对象列表

异常

IllegalArgumentException如果文件阵列包括一个目录

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

getJavaFileObjectsFromStrings

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

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

参数

names -文件名列表

结果

文件对象列表

异常

IllegalArgumentException如果文件名列表中包括一个目录

getJavaFileObjects

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

获取表示给定文件名的文件对象。方法：

getjavafileobjectsfromstrings（Arrays.asList（地名））

相当方便

参数

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<? extends java.io.File>)