8  * particular file as subject to the "Classpath" exception as provided
9  * by Oracle in the LICENSE file that accompanied this code.
14  * version 2 for more details (a copy is included in the LICENSE file that
37  * source and class files.  In this context, <em>file</em> means an
40  * <p>When constructing new JavaFileObjects, the file manager must
41  * determine where to create them.  For example, if a file manager
42  * manages regular files on a file system, it would most likely have a
44  * or finding files.  A number of hints can be provided to a file
45  * manager as to where to create files.  Any file manager might choose
65  * as case-sensitive.  For example, some file systems have
66  * case-insensitive, case-aware file names.  File objects representing
69  * not case-aware, file objects must use other means to preserve case.
86  * support concurrent access to different file objects created by this
108      * Interface for locations of file objects.  Used by file managers
109      * to determine where to place or search for file objects.
143      * and this file manager cannot be reopened
148      * Lists all file objects matching the given criteria in the given
149      * location.  List file objects in "subpackages" if recurse is
152      * <p>Note: even if the given location is unknown to this file
160      * @return an Iterable of file objects matching the given criteria
162      * #close} has been called and this file manager cannot be
165      * and this file manager cannot be reopened
174      * Infers a binary name of a file object based on a location.  The
179      * @param file a file object
180      * @return a binary name or {@code null} the file object is not
183      * and this file manager cannot be reopened
185     String inferBinaryName(Location location, JavaFileObject file);
188      * Compares two file objects and return true if they represent the
191      * @param a a file object
192      * @param b a file object
193      * @return true if the given file objects represent the same
197      * were created with another file manager and this file manager
198      * does not support foreign file objects
204      * file manager it will consume any arguments to that option from
209      * @return true if this option was handled by this file manager,
211      * @throws IllegalArgumentException if this option to this file
214      * and this file manager cannot be reopened
219      * Determines if a location is known to this file manager.
227      * Gets a {@linkplain JavaFileObject file object} for input
233      * @param kind the kind of file, must be one of {@link
236      * @return a file object, might return {@code null} if the
237      * file does not exist
239      * to this file manager and the file manager does not support
242      * #close} has been called and this file manager cannot be
245      * and this file manager cannot be reopened
253      * Gets a {@linkplain JavaFileObject file object} for output
257      * <p>Optionally, this file manager might consider the sibling as
261      * originating source files unless a class file output directory
263      * the originating source file as sibling when calling this
268      * @param kind the kind of file, must be one of {@link
271      * @param sibling a file object to be used as hint for placement;
273      * @return a file object for output
275      * this file manager, or if the location is not known to this file
276      * manager and the file manager does not support unknown
279      * #close} has been called and this file manager cannot be
282      * and this file manager cannot be reopened
291      * Gets a {@linkplain FileObject file object} for input
297      * JavaFileObject.Kind#CLASS class} file, it must be an instance
300      * <p>Informally, the file object returned by this method is
302      * relative name.  For example, to locate the properties file
312      * a valid result would be a file object representing the file
318      * @return a file object, might return {@code null} if the file
321      * to this file manager and the file manager does not support
324      * #close} has been called and this file manager cannot be
327      * and this file manager cannot be reopened
335      * Gets a {@linkplain FileObject file object} for output
339      * <p>Optionally, this file manager might consider the sibling as
343      * originating source files unless a class file output directory
345      * the originating source file as sibling when calling this
350      * JavaFileObject.Kind#CLASS class} file, it must be an instance
353      * <p>Informally, the file object returned by this method is
361      * @param sibling a file object to be used as hint for placement;
363      * @return a file object
365      * this file manager, or if the location is not known to this file
366      * manager and the file manager does not support unknown
369      * #close} has been called and this file manager cannot be
372      * and this file manager cannot be reopened
381      * Flushes any resources opened for output by this file manager
382      * directly or indirectly.  Flushing a closed file manager has no
391      * Releases any resources opened by this file manager directly or
392      * indirectly.  This might render this file manager useless and
395      * explicitly allowed.  However, closing a file manager which has

Indexes created Tue Jul 24 14:28:13 CEST 2018