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();
   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)
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 interface JavaFileManager
    
    Parameters:
    a - a file object
    b - 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 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.
    
    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 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.
    
    Parameters:
    location - a location
    path - a list of files, if null use the default path for this location
    
    Throws:
    
    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
    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>)

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

29/11/2024 01:14:35 Cette version de la page est en cache (à la date du 29/11/2024 01:14:35) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 11/06/2005, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/tools/standardjavafilemanager.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : https://docs.oracle.com

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut

Interface StandardJavaFileManager

Nested Class Summary

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

Method Summary

Methods inherited from interface javax.tools.JavaFileManager

Methods inherited from interface javax.tools.OptionChecker

Method Detail

isSameFile

getJavaFileObjectsFromFiles

getJavaFileObjects

getJavaFileObjectsFromStrings

getJavaFileObjects

setLocation

getLocation

Références