Lines Matching refs:file
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
26 package java.nio.file;
28 import java.nio.file.attribute.*;
29 import java.nio.file.spi.FileSystemProvider;
35 * Provides an interface to a file system and is the factory for objects to
36 * access files and other objects in the file system.
38 * <p> The default file system, obtained by invoking the {@link FileSystems#getDefault
39 * FileSystems.getDefault} method, provides access to the file system that is
41 * methods to create file systems that provide access to other types of (custom)
42 * file systems.
44 * <p> A file system is the factory for several types of objects:
49 * to locate and access a file. </p></li>
54 * over the underlying {@link FileStore file-stores}. </p></li>
63 * <p> File systems vary greatly. In some cases the file system is a single
65 * have several distinct file hierarchies, each with its own top-level root
67 * used to iterate over the root directories in the file system. A file system
68 * is typically composed of one or more underlying {@link FileStore file-stores}
69 * that provide the storage for the files. Theses file stores can also vary in
70 * the features they support, and the file attributes or <em>meta-data</em> that
73 * <p> A file system is open upon creation and can be closed by invoking its
75 * objects in the file system cause {@link ClosedFileSystemException} to be
80 * file system. Whether or not a file system provides read-only access is
82 * its {@link #isReadOnly() isReadOnly} method. Attempts to write to file stores
83 * by means of an object associated with a read-only file system throws {@link
87 * #close close} method may be invoked at any time to close a file system but
88 * whether a file system is <i>asynchronously closeable</i> is provider specific
90 * object in a file system, and another thread invokes the {@code close} method
92 * a file system causes all open channels, watch services, and other {@link
93 * Closeable closeable} objects associated with the file system to be closed.
108 * Returns the provider that created this file system.
110 * @return The provider that created this file system.
115 * Closes this file system.
117 * <p> After a file system is closed then all subsequent access to the file
119 * with this file system, throw {@link ClosedFileSystemException}. If the
120 * file system is already closed then invoking this method has no effect.
122 * <p> Closing a file system will close all open {@link
125 * with this file system. The {@link FileSystems#getDefault default} file
131 * Thrown in the case of the default file system
137 * Tells whether or not this file system is open.
141 * @return {@code true} if, and only if, this file system is open
146 * Tells whether or not this file system allows only read-only access to
147 * its file stores.
149 * @return {@code true} if, and only if, this file system provides
173 * <p> A file system provides access to a file store that may be composed
174 * of a number of distinct file hierarchies, each with its own top-level
177 * file hierarchy. The order of the elements is not defined. The file
180 * may result in the creation of a new file hierarchy with its own
195 * Returns an object to iterate over the underlying file stores.
198 * FileStore FileStores} for this file system. The order of the elements is
199 * not defined and the file stores may change during the lifetime of the
200 * Java virtual machine. When an I/O error occurs, perhaps because a file
206 * no file stores are returned by the iterator. In addition, the security
208 * check read access to the file store's <em>top-most</em> directory. If
209 * denied, the file store is not returned by the iterator. It is system
214 * Suppose we want to print the space usage for all file stores:
224 * @return An object to iterate over the backing file stores
229 * Returns the set of the {@link FileAttributeView#name names} of the file
237 * underlying {@link FileStore} supports the file attributes identified by a
238 * file attribute view.
240 * @return An unmodifiable set of the names of the supported file attribute
265 * to the file store. For example, on UNIX systems, the NUL (\u0000)
268 * allowed by any file store, and where an implementation supports a complex
273 * on the definition of paths at the platform or virtual file system level.
275 * present in a file name, but a specific underlying file store may impose
321 * <td>Matches a path that represents a file name ending in {@code .java}</td>
325 * <td>Matches file names containing a dot</td>
330 * <td>Matches file names ending with {@code .java} or {@code .class}</td>
334 * <td>Matches file names starting with {@code foo.} and a single
394 * <li><p> Leading period<tt>/</tt>dot characters in file name are
396 * the {@code "*"} glob pattern matches file name {@code ".login"}.
397 * The {@link Files#isHidden} method may be used to test whether a file
435 * Returns the {@code UserPrincipalLookupService} for this file system
440 * Suppose we want to make "joe" the owner of a file:
449 * @return The {@code UserPrincipalLookupService} for this file system
462 * If this {@code FileSystem} does not support watching file system