程序包 javax.tools

接口 StandardJavaFileManager

所有超级接口:

AutoCloseable, Closeable, Flushable, JavaFileManager, OptionChecker

public interface StandardJavaFileManager
extends JavaFileManager

File manager based on java.io.File. A common way to obtain an instance of this class is using getStandardFileManager, for example:

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

This file manager creates file objects representing regular files, zip file entries, or entries in similar file system based containers. Any file object returned from a file manager implementing this interface must observe the following behavior:

• File names need not be canonical.
• For file objects representing regular files
  • the method FileObject.delete() is equivalent to File.delete(),
  • the method FileObject.getLastModified() is equivalent to File.lastModified(),
  • the methods FileObject.getCharContent(boolean), FileObject.openInputStream(), and FileObject.openReader(boolean) must succeed if the following would succeed (ignoring encoding issues):

    new FileInputStream(new File(fileObject.toUri()))

  • and the methods FileObject.openOutputStream(), and FileObject.openWriter() must succeed if the following would succeed (ignoring encoding issues):

    new FileOutputStream(new File(fileObject.toUri()))

• The URI returned from FileObject.toUri()
  • must be absolute (have a schema), and
  • must have a normalized path component which can be resolved without any process-specific context such as the current directory (file names must be absolute).

According to these rules, the following URIs, for example, are allowed:

• file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java
• jar:///C:/Documents%20and%20Settings/UncleBob/lib/vendorA.jar!com/vendora/LibraryClass.class

Whereas these are not (reason in parentheses):

• file:BobsApp/Test.java (the file name is relative and depend on the current directory)
• jar:lib/vendorA.jar!com/vendora/LibraryClass.class (the first half of the path depends on the current directory, whereas the component after ! is legal)
• Test.java (this URI depends on the current directory and does not have a schema)
• jar:///C:/Documents%20and%20Settings/UncleBob/BobsApp/../lib/vendorA.jar!com/vendora/LibraryClass.class (the path is not normalized)

从以下版本开始:

1.6

嵌套类概要

从接口继承的嵌套类/接口 javax.tools.JavaFileManager

JavaFileManager.Location

方法概要

限定符和类型	方法	说明
Iterable<? extends JavaFileObject>	getJavaFileObjects(File... files)	Gets file objects representing the given files.
Iterable<? extends JavaFileObject>	getJavaFileObjects(String... names)	Gets file objects representing the given file names.
Iterable<? extends JavaFileObject>	getJavaFileObjectsFromFiles(Iterable<? extends File> files)	Gets file objects representing the given files.
Iterable<? extends JavaFileObject>	getJavaFileObjectsFromStrings(Iterable<String> names)	Gets file objects representing the given file names.
Iterable<? extends File>	getLocation(JavaFileManager.Location location)	Gets the path associated with the given location.
boolean	isSameFile(FileObject a, FileObject b)	Compares two file objects and return true if they represent the same canonical file, zip file entry, or entry in any file system based container.
void	setLocation(JavaFileManager.Location location, Iterable<? extends File> path)	Associates the given path with the given location.

从接口继承的方法 javax.tools.JavaFileManager

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

从接口继承的方法 javax.tools.OptionChecker

isSupportedOption

方法详细资料

isSameFile

boolean isSameFile(FileObject a,
                   FileObject b)

Compares two file objects and return true if they represent the same canonical file, zip file entry, or entry in any file system based container.

指定者:

isSameFile 在接口中 JavaFileManager

参数:

a - a file object

b - a file object

返回:

true if the given file objects represent the same canonical file or zip file entry; false otherwise

抛出:

IllegalArgumentException - if either of the arguments were created with another file manager implementation

getJavaFileObjectsFromFiles

Iterable<? extends JavaFileObject> getJavaFileObjectsFromFiles(Iterable<? extends File> files)

Gets file objects representing the given files.

参数:

files - a list of files

返回:

a list of file objects

抛出:

IllegalArgumentException - if the list of files includes a directory

getJavaFileObjects

Iterable<? extends JavaFileObject> getJavaFileObjects(File... files)

Gets file objects representing the given files. Convenience method equivalent to:

     getJavaFileObjectsFromFiles(Arrays.asList(files))
 

参数:

files - an array of files

返回:

a list of file objects

抛出:

IllegalArgumentException - if the array of files includes a directory

NullPointerException - if the given array contains null elements

getJavaFileObjectsFromStrings

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

Gets file objects representing the given file names.

参数:

names - a list of file names

返回:

a list of file objects

抛出:

IllegalArgumentException - if the list of file names includes a directory

getJavaFileObjects

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

Gets file objects representing the given file names. Convenience method equivalent to:

     getJavaFileObjectsFromStrings(Arrays.asList(names))
 

参数:

names - a list of file names

返回:

a list of file objects

抛出:

IllegalArgumentException - if the array of file names includes a directory

NullPointerException - if the given array contains null elements

setLocation

void setLocation(JavaFileManager.Location location,
                 Iterable<? extends File> path)
          throws IOException

Associates the given path with the given location. Any previous value will be discarded.

参数:

location - a location

path - a list of files, if null use the default path for this location

抛出:

IllegalArgumentException - if location is an output location and path does not contain exactly one element

IOException - if location is an output location and path does not represent an existing directory

另请参阅:

getLocation(javax.tools.JavaFileManager.Location)

getLocation

Iterable<? extends File> getLocation(JavaFileManager.Location location)

Gets the path associated with the given location.

参数:

location - a location

返回:

a list of files or null if this location has no associated path

另请参阅:

setLocation(javax.tools.JavaFileManager.Location, java.lang.Iterable<? extends java.io.File>)