-
- All Superinterfaces:
- 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();
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:DiagnosticCollector<JavaFileObject>
diagnostics = newDiagnosticCollector<JavaFileObject>()
; StandardJavaFileManager fm = compiler.getStandardFileManager(diagnostics, null, null);- File names need not be canonical.
-
For file objects representing regular files
-
the method
FileObject.delete()
is equivalent toFile.delete()
, -
the method
FileObject.getLastModified()
is equivalent toFile.lastModified()
, -
the methods
FileObject.getCharContent(boolean)
,FileObject.openInputStream()
, andFileObject.openReader(boolean)
must succeed if the following would succeed (ignoring encoding issues):new FileInputStream(new File(fileObject.toUri()))
-
and the methods
FileObject.openOutputStream()
, andFileObject.openWriter()
must succeed if the following would succeed (ignoring encoding issues):new FileOutputStream(new File(fileObject.toUri()))
-
the method
-
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).
-
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
(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)
- Since:
- 1.6
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface javax.tools.JavaFileManager
JavaFileManager.Location
-
-
Method Summary
Methods Modifier and Type Method and Description 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.-
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
-
-
-
-
Method Detail
-
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.- Specified by:
isSameFile
in interfaceJavaFileManager
- Parameters:
a
- a file objectb
- a file object- Returns:
- true if the given file objects represent the same canonical file or zip file entry; false otherwise
- Throws:
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.- Parameters:
files
- a list of files- Returns:
- a list of file objects
- Throws:
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))
- Parameters:
files
- an array of files- Returns:
- a list of file objects
- Throws:
IllegalArgumentException
- if the array of files includes a directoryNullPointerException
- if the given array contains null elements
-
getJavaFileObjectsFromStrings
Iterable<? extends JavaFileObject> getJavaFileObjectsFromStrings(Iterable<String> names)
Gets file objects representing the given file names.- Parameters:
names
- a list of file names- Returns:
- a list of file objects
- Throws:
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))
- Parameters:
names
- a list of file names- Returns:
- a list of file objects
- Throws:
IllegalArgumentException
- if the array of file names includes a directoryNullPointerException
- 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.- Parameters:
location
- a locationpath
- a list of files, ifnull
use the default path for this location- Throws:
IllegalArgumentException
- if location is an output location and path does not contain exactly one elementIOException
- if location is an output location and path does not represent an existing directory- See Also:
getLocation(javax.tools.JavaFileManager.Location)
-
getLocation
Iterable<? extends File> getLocation(JavaFileManager.Location location)
Gets the path associated with the given location.- Parameters:
location
- a location- Returns:
- a list of files or
null
if this location has no associated path - See Also:
setLocation(javax.tools.JavaFileManager.Location, java.lang.Iterable<? extends java.io.File>)
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/tools/standardjavafilemanager.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.