JavaTM Platform
Standard Ed. 6

类 java.io.File
的使用

使用 File 的软件包
java.awt 包含用于创建用户界面和绘制图形图像的所有类。 
java.io 通过数据流、序列化和文件系统提供系统输入和输出。 
java.lang 提供利用 Java 编程语言进行程序设计的基础类。 
java.security 为安全框架提供类和接口。 
java.util 包含 collection 框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组)。 
java.util.jar 提供读写 JAR (Java ARchive) 文件格式的类,该格式基于具有可选清单文件的标准 ZIP 文件格式。 
java.util.zip 提供用于读写标准 ZIP 和 GZIP 文件格式的类。 
javax.activation   
javax.imageio Java Image I/O API 的主要包。 
javax.imageio.spi 包含用于 reader、writer、transcoder 和流的插件接口以及一个运行时注册表的 Java Image I/O API 包。 
javax.imageio.stream Java Image I/O API 的一个包,用来处理从文件和流中产生的低级别 I/O。 
javax.sound.midi 提供用于 MIDI(音乐乐器数字接口)数据的 I/O、序列化和合成的接口和类。 
javax.sound.midi.spi 在提供新的 MIDI 设备、MIDI 文件 reader 和 writer、或音库 reader 时提供服务提供者要实现的接口。 
javax.sound.sampled 提供用于捕获、处理和回放取样的音频数据的接口和类。 
javax.sound.sampled.spi 在提供新音频设备、声音文件 reader 和 writer,或音频格式转换器时,提供将为其创建子类的服务提供者的抽象类。 
javax.swing 提供一组“轻量级”(全部是 Java 语言)组件,尽量让这些组件在所有平台上的工作方式都相同。 
javax.swing.filechooser 包含 JFileChooser 组件使用的类和接口。 
javax.swing.plaf 提供一个接口和许多抽象类,Swing 用它们来提供自己的可插入外观功能。 
javax.swing.plaf.basic 提供了根据基本外观构建的用户界面对象。 
javax.swing.plaf.metal 提供根据 Java 外观(曾经代称为 Metal)构建的用户界面对象,Java 外观是默认外观。 
javax.swing.plaf.multi 提供了组合两个或多个外观的用户界面对象。 
javax.tools 为能够从程序(例如,编译器)中调用的工具提供接口。 
javax.xml.bind 为包含解组、编组和验证功能的客户端应用程序提供运行时绑定框架。 
javax.xml.bind.helpers 仅由 JAXB 提供者用于: 提供某些 javax.xml.bind 接口的部分默认实现。 
javax.xml.parsers 提供允许处理 XML 文档的类。 
javax.xml.transform.stream 此包实现特定于流和 URI 的转换 API。 
javax.xml.validation 此包提供了用于 XML 文档验证的 API。 
 

java.awtFile 的使用
 

参数类型为 Filejava.awt 中的方法
static Font Font.createFont(int fontFormat, File fontFile)
          返回一个使用指定字体类型和指定字体文件的新 Font
 void Desktop.edit(File file)
          启动关联编辑器应用程序并打开用于编辑的文件。
 void Desktop.open(File file)
          启动关联应用程序来打开文件。
 void Desktop.print(File file)
          使用关联应用程序的打印命令,用本机桌面打印设施来打印文件。
 

java.ioFile 的使用
 

返回 Filejava.io 中的方法
static File File.createTempFile(String prefix, String suffix)
          在默认临时文件目录中创建一个空文件,使用给定前缀和后缀生成其名称。
static File File.createTempFile(String prefix, String suffix, File directory)
           在指定目录中创建一个新的空文件,使用给定的前缀和后缀字符串生成其名称。
 File File.getAbsoluteFile()
          返回此抽象路径名的绝对路径名形式。
 File File.getCanonicalFile()
          返回此抽象路径名的规范形式。
 File File.getParentFile()
          返回此抽象路径名父目录的抽象路径名;如果此路径名没有指定父目录,则返回 null
 File[] File.listFiles()
          返回一个抽象路径名数组,这些路径名表示此抽象路径名表示的目录中的文件。
 File[] File.listFiles(FileFilter filter)
          返回抽象路径名数组,这些路径名表示此抽象路径名表示的目录中满足指定过滤器的文件和目录。
 File[] File.listFiles(FilenameFilter filter)
          返回抽象路径名数组,这些路径名表示此抽象路径名表示的目录中满足指定过滤器的文件和目录。
static File[] File.listRoots()
          列出可用的文件系统根。
 

参数类型为 Filejava.io 中的方法
 boolean FileFilter.accept(File pathname)
          测试指定抽象路径名是否应该包含在某个路径名列表中。
 boolean FilenameFilter.accept(File dir, String name)
          测试指定文件是否应该包含在某一文件列表中。
 int File.compareTo(File pathname)
          按字母顺序比较两个抽象路径名。
static File File.createTempFile(String prefix, String suffix, File directory)
           在指定目录中创建一个新的空文件,使用给定的前缀和后缀字符串生成其名称。
 boolean File.renameTo(File dest)
          重新命名此抽象路径名表示的文件。
 

参数类型为 Filejava.io 中的构造方法
File(File parent, String child)
          根据 parent 抽象路径名和 child 路径名字符串创建一个新 File 实例。
FileInputStream(File file)
          通过打开一个到实际文件的连接来创建一个 FileInputStream,该文件通过文件系统中的 File 对象 file 指定。
FileOutputStream(File file)
          创建一个向指定 File 对象表示的文件中写入数据的文件输出流。
FileOutputStream(File file, boolean append)
          创建一个向指定 File 对象表示的文件中写入数据的文件输出流。
FileReader(File file)
          在给定从中读取数据的 File 的情况下创建一个新 FileReader
FileWriter(File file)
          根据给定的 File 对象构造一个 FileWriter 对象。
FileWriter(File file, boolean append)
          根据给定的 File 对象构造一个 FileWriter 对象。
PrintStream(File file)
          创建具有指定文件且不带自动行刷新的新打印流。
PrintStream(File file, String csn)
          创建具有指定文件名称和字符集且不带自动行刷新的新打印流。
PrintWriter(File file)
          使用指定文件创建不具有自动行刷新的新 PrintWriter。
PrintWriter(File file, String csn)
          创建具有指定文件和字符集且不带自动刷行新的新 PrintWriter。
RandomAccessFile(File file, String mode)
          创建从中读取和向其中写入(可选)的随机访问文件流,该文件由 File 参数指定。
 

java.langFile 的使用
 

返回 Filejava.lang 中的方法
 File ProcessBuilder.directory()
          返回此进程生成器的工作目录。
 

参数类型为 Filejava.lang 中的方法
 ProcessBuilder ProcessBuilder.directory(File directory)
          设置此进程生成器的工作目录。
 Process Runtime.exec(String[] cmdarray, String[] envp, File dir)
          在指定环境和工作目录的独立进程中执行指定的命令和变量。
 Process Runtime.exec(String command, String[] envp, File dir)
          在有指定环境和工作目录的独立进程中执行指定的字符串命令。
 

java.securityFile 的使用
 

参数类型为 Filejava.security 中的方法
static KeyStore.Builder KeyStore.Builder.newInstance(String type, Provider provider, File file, KeyStore.ProtectionParameter protection)
          返回新的 Builder 对象。
 

java.utilFile 的使用
 

参数类型为 Filejava.util 中的构造方法
Formatter(File file)
          构造一个带指定文件的新 formatter。
Formatter(File file, String csn)
          构造一个带指定文件和字符集的新 formatter。
Formatter(File file, String csn, Locale l)
          构造一个带指定文件、字符集和语言环境的新 formatter。
Scanner(File source)
          构造一个新的 Scanner,它生成的值是从指定文件扫描的。
Scanner(File source, String charsetName)
          构造一个新的 Scanner,它生成的值是从指定文件扫描的。
 

java.util.jarFile 的使用
 

参数类型为 Filejava.util.jar 中的方法
 void Pack200.Unpacker.unpack(File in, JarOutputStream out)
          读取 Pack200 存档,并将已编码的 JAR 写入 JarOutputStream。
 

参数类型为 Filejava.util.jar 中的构造方法
JarFile(File file)
          创建一个要从指定的 File 对象读取的新的 JarFile
JarFile(File file, boolean verify)
          创建一个要从指定的 File 对象读取的新的 JarFile
JarFile(File file, boolean verify, int mode)
          创建一个要从指定的 File 对象中以指定模式读取的新的 JarFile
 

java.util.zipFile 的使用
 

参数类型为 Filejava.util.zip 中的构造方法
ZipFile(File file)
          打开供阅读的 ZIP 文件,由指定的 File 对象给出。
ZipFile(File file, int mode)
          打开新的 ZipFile 以使用指定模式从指定 File 对象读取。
 

javax.activationFile 的使用
 

返回 Filejavax.activation 中的方法
 File FileDataSource.getFile()
          返回与此 FileDataSource 对应的 File 对象。
 

参数类型为 Filejavax.activation 中的方法
abstract  String FileTypeMap.getContentType(File file)
          返回文件对象的类型。
 String MimetypesFileTypeMap.getContentType(File f)
          返回该文件对象的 MIME 类型。
 

参数类型为 Filejavax.activation 中的构造方法
FileDataSource(File file)
          根据 File 对象创建 FileDataSource。
 

javax.imageioFile 的使用
 

返回 Filejavax.imageio 中的方法
static File ImageIO.getCacheDirectory()
          返回由 setCacheDirectory 设置的当前值;如果没有显式设置该值,则返回 null
 

参数类型为 Filejavax.imageio 中的方法
static BufferedImage ImageIO.read(File input)
          返回一个 BufferedImage,作为使用 ImageReader(它是从当前已注册 ImageReader 中自动选择的)解码所提供 File 的结果。
static void ImageIO.setCacheDirectory(File cacheDirectory)
          设置将在其中创建缓存文件的目录。
static boolean ImageIO.write(RenderedImage im, String formatName, File output)
          使用支持给定格式的任意 ImageWriter 将一个图像写入 File
 

javax.imageio.spiFile 的使用
 

参数类型为 Filejavax.imageio.spi 中的方法
abstract  ImageInputStream ImageInputStreamSpi.createInputStreamInstance(Object input, boolean useCache, File cacheDir)
          返回与此服务提供者关联的 ImageInputStream 实现的实例。
abstract  ImageOutputStream ImageOutputStreamSpi.createOutputStreamInstance(Object output, boolean useCache, File cacheDir)
          返回与此服务提供者关联的 ImageOutputStream 实现的实例。
 

javax.imageio.streamFile 的使用
 

参数类型为 Filejavax.imageio.stream 中的构造方法
FileCacheImageInputStream(InputStream stream, File cacheDir)
          构造一个将从给定 InputStream 进行读取的 FileCacheImageInputStream
FileCacheImageOutputStream(OutputStream stream, File cacheDir)
          构造一个将向给定 outputStream 进行写入的 FileCacheImageOutputStream
FileImageInputStream(File f)
          构造一个将从给定 File 进行读取的 FileImageInputStream
FileImageOutputStream(File f)
          构造一个将向给定 File 进行写入的 FileImageOutputStream
 

javax.sound.midiFile 的使用
 

参数类型为 Filejavax.sound.midi 中的方法
static MidiFileFormat MidiSystem.getMidiFileFormat(File file)
          获得指定 File 的 MIDI 文件格式。
static Sequence MidiSystem.getSequence(File file)
          从指定的 File 获得 MIDI 序列。
static Soundbank MidiSystem.getSoundbank(File file)
          通过从指定的 File 读取来构造一个 Soundbank
static int MidiSystem.write(Sequence in, int type, File out)
          将表示所指示 MIDI 文件类型的文件的字节流写入提供的外部文件。
 

javax.sound.midi.spiFile 的使用
 

参数类型为 Filejavax.sound.midi.spi 中的方法
abstract  MidiFileFormat MidiFileReader.getMidiFileFormat(File file)
          获得提供的 File 的 MIDI 文件格式。
abstract  Sequence MidiFileReader.getSequence(File file)
          从提供的 File 获得 MIDI 序列。
abstract  Soundbank SoundbankReader.getSoundbank(File file)
          从提供的 File 获得音库对象。
abstract  int MidiFileWriter.write(Sequence in, int fileType, File out)
          写入表示指示为所提供外部文件的文件类型的 MIDI 文件的字节流。
 

javax.sound.sampledFile 的使用
 

参数类型为 Filejavax.sound.sampled 中的方法
static AudioFileFormat AudioSystem.getAudioFileFormat(File file)
          获得指定 File 的音频文件格式。
static AudioInputStream AudioSystem.getAudioInputStream(File file)
          从提供的 File 获得音频输入流。
static int AudioSystem.write(AudioInputStream stream, AudioFileFormat.Type fileType, File out)
          将表示指定文件类型的音频文件的字节流写入所提供的外部文件。
 

javax.sound.sampled.spiFile 的使用
 

参数类型为 Filejavax.sound.sampled.spi 中的方法
abstract  AudioFileFormat AudioFileReader.getAudioFileFormat(File file)
          获得所提供 File 的音频文件格式。
abstract  AudioInputStream AudioFileReader.getAudioInputStream(File file)
          从所提供的 File 获得音频输入流。
abstract  int AudioFileWriter.write(AudioInputStream stream, AudioFileFormat.Type fileType, File out)
          将表示所指示文件格式的音频文件的字节流写入所提供的外部文件。
 

javax.swingFile 的使用
 

返回 Filejavax.swing 中的方法
 File JFileChooser.getCurrentDirectory()
          返回当前目录。
 File JFileChooser.getSelectedFile()
          返回选中的文件。
 File[] JFileChooser.getSelectedFiles()
          如果将文件选择器设置为允许选择多个文件,则返回选中文件的列表。
 

参数类型为 Filejavax.swing 中的方法
 boolean JFileChooser.accept(File f)
          如果应该显示该文件,则返回 true。
 void JFileChooser.ensureFileIsVisible(File f)
          确保指定的文件是可见的,不是隐藏的。
 String JFileChooser.getDescription(File f)
          返回文件描述。
 Icon JFileChooser.getIcon(File f)
          返回此文件或文件类型的图标,这取决于系统。
 String JFileChooser.getName(File f)
          返回文件名。
 String JFileChooser.getTypeDescription(File f)
          返回文件类型。
 boolean JFileChooser.isTraversable(File f)
          如果可以返回该文件(目录),则返回 true。
 void JFileChooser.setCurrentDirectory(File dir)
          设置当前目录。
 void JFileChooser.setSelectedFile(File file)
          设置选中的文件。
 void JFileChooser.setSelectedFiles(File[] selectedFiles)
          如果将文件选择器设置为允许选择多个文件,则设置选中文件的列表。
 

参数类型为 Filejavax.swing 中的构造方法
JFileChooser(File currentDirectory)
          使用给定的 File 作为路径来构造一个 JFileChooser
JFileChooser(File currentDirectory, FileSystemView fsv)
          使用给定的当前目录和 FileSystemView 构造一个 JFileChooser
 

javax.swing.filechooserFile 的使用
 

返回 Filejavax.swing.filechooser 中的方法
 File FileSystemView.createFileObject(File dir, String filename)
          返回根据给定的 filename 在 dir 中构造的 File 对象。
 File FileSystemView.createFileObject(String path)
          返回根据给定路径字符串构造的 File 对象。
protected  File FileSystemView.createFileSystemRoot(File f)
          创建针对 f 的新 File 对象,使其对于文件系统根目录而言具有正确的行为。
abstract  File FileSystemView.createNewFolder(File containingDir)
          创建具有默认文件夹名称的新文件夹。
 File FileSystemView.getChild(File parent, String fileName)
           
 File FileSystemView.getDefaultDirectory()
          返回文件选择器的用户默认起始目录。
 File[] FileSystemView.getFiles(File dir, boolean useFileHiding)
          获取显示的(即未隐藏)文件的列表。
 File FileSystemView.getHomeDirectory()
           
 File FileSystemView.getParentDirectory(File dir)
          返回 dir 的父目录。
 File[] FileSystemView.getRoots()
          返回此系统的所有根分区。
 

参数类型为 Filejavax.swing.filechooser 中的方法
 boolean FileNameExtensionFilter.accept(File f)
          测试指定的文件,如果该文件被接受,则返回 true,否则返回 false。
abstract  boolean FileFilter.accept(File f)
          此过滤器是否接受给定的文件。
 File FileSystemView.createFileObject(File dir, String filename)
          返回根据给定的 filename 在 dir 中构造的 File 对象。
protected  File FileSystemView.createFileSystemRoot(File f)
          创建针对 f 的新 File 对象,使其对于文件系统根目录而言具有正确的行为。
abstract  File FileSystemView.createNewFolder(File containingDir)
          创建具有默认文件夹名称的新文件夹。
 File FileSystemView.getChild(File parent, String fileName)
           
 String FileView.getDescription(File f)
          文件的可读描述。
 File[] FileSystemView.getFiles(File dir, boolean useFileHiding)
          获取显示的(即未隐藏)文件的列表。
 Icon FileView.getIcon(File f)
          表示 JFileChooser 中此文件的图标。
 String FileView.getName(File f)
          文件名称。
 File FileSystemView.getParentDirectory(File dir)
          返回 dir 的父目录。
 String FileSystemView.getSystemDisplayName(File f)
          在系统文件浏览器中显示的文件、目录或文件夹名。
 Icon FileSystemView.getSystemIcon(File f)
          在系统文件浏览器中显示的文件、目录或文件夹的图标。
 String FileSystemView.getSystemTypeDescription(File f)
          在系统文件浏览器中显示的文件、目录或文件夹类型描述。
 String FileView.getTypeDescription(File f)
          文件类型的可读描述。
 boolean FileSystemView.isComputerNode(File dir)
          UI 类使用此方法来决定是否为计算机节点显示特殊图标,例如,“我的电脑”或网络服务器。
 boolean FileSystemView.isDrive(File dir)
          UI 类使用此方法来决定是否为驱动器或分区显示特殊图标,例如,“硬盘”图标。
 boolean FileSystemView.isFileSystem(File f)
          检查 f 是否表示一个相对于特殊文件夹(如 "Desktop")的实际目录或文件。
 boolean FileSystemView.isFileSystemRoot(File dir)
          判断 dir 是否是文件系统(如驱动器或分区)中的树的根。
 boolean FileSystemView.isFloppyDrive(File dir)
          UI 类使用此方法来决定是否为软盘显示特殊图标。
 boolean FileSystemView.isHiddenFile(File f)
          返回某个文件是否被隐藏。
 boolean FileSystemView.isParent(File folder, File file)
          在 Windows 中,一个文件可以出现在多个文件夹,但在文件系统中的父目录中除外。
 boolean FileSystemView.isRoot(File f)
          确定给定文件是否是导航树中的根。
 Boolean FileSystemView.isTraversable(File f)
          如果可以访问文件(目录),则返回 true。
 Boolean FileView.isTraversable(File f)
          目录是否是可遍历的。
 

javax.swing.plafFile 的使用
 

参数类型为 Filejavax.swing.plaf 中的方法
abstract  void FileChooserUI.ensureFileIsVisible(JFileChooser fc, File f)
           
 

javax.swing.plaf.basicFile 的使用
 

类型参数类型为 Filejavax.swing.plaf.basic 中的字段
protected  Hashtable<File,Icon> BasicFileChooserUI.BasicFileView.iconCache
           
 

返回 Filejavax.swing.plaf.basic 中的方法
protected  File BasicFileChooserUI.getDirectory()
          记忆当前在 UI 中选择的目录的属性。
 

返回变量类型为 File 的类型的 javax.swing.plaf.basic 中的方法
 Vector<File> BasicDirectoryModel.getDirectories()
           
 Vector<File> BasicDirectoryModel.getFiles()
           
 

参数类型为 Filejavax.swing.plaf.basic 中的方法
 boolean BasicFileChooserUI.AcceptAllFileFilter.accept(File f)
           
 void BasicFileChooserUI.BasicFileView.cacheIcon(File f, Icon i)
           
 void BasicFileChooserUI.ensureFileIsVisible(JFileChooser fc, File f)
           
 Icon BasicFileChooserUI.BasicFileView.getCachedIcon(File f)
           
 String BasicFileChooserUI.BasicFileView.getDescription(File f)
           
 Icon BasicFileChooserUI.BasicFileView.getIcon(File f)
           
 String BasicFileChooserUI.BasicFileView.getName(File f)
           
 String BasicFileChooserUI.BasicFileView.getTypeDescription(File f)
           
 Boolean BasicFileChooserUI.BasicFileView.isHidden(File f)
           
protected  boolean BasicDirectoryModel.lt(File a, File b)
           
 boolean BasicDirectoryModel.renameFile(File oldFile, File newFile)
          重命名底层文件系统中的文件。
protected  void BasicFileChooserUI.setDirectory(File f)
          记忆当前在 UI 中选择的目录的属性。
 

类型变量类型为 Filejavax.swing.plaf.basic 中的方法参数
protected  void BasicDirectoryModel.sort(Vector<? extends File> v)
           
 

javax.swing.plaf.metalFile 的使用
 

参数类型为 Filejavax.swing.plaf.metal 中的方法
 void MetalFileChooserUI.ensureFileIsVisible(JFileChooser fc, File f)
           
 

javax.swing.plaf.multiFile 的使用
 

参数类型为 Filejavax.swing.plaf.multi 中的方法
 void MultiFileChooserUI.ensureFileIsVisible(JFileChooser a, File b)
          在由此对象处理的每个 UI 上调用 ensureFileIsVisible 方法。
 

javax.toolsFile 的使用
 

返回变量类型为 File 的类型的 javax.tools 中的方法
 Iterable<? extends File> StandardJavaFileManager.getLocation(JavaFileManager.Location location)
          获取与给定位置关联的路径。
 

参数类型为 Filejavax.tools 中的方法
 Iterable<? extends JavaFileObject> StandardJavaFileManager.getJavaFileObjects(File... files)
          获取表示给定文件的文件对象。
 

类型变量类型为 Filejavax.tools 中的方法参数
 Iterable<? extends JavaFileObject> StandardJavaFileManager.getJavaFileObjectsFromFiles(Iterable<? extends File> files)
          获取表示给定文件的文件对象。
 void StandardJavaFileManager.setLocation(JavaFileManager.Location location, Iterable<? extends File> path)
          将给定路径与给定位置关联。
 

javax.xml.bindFile 的使用
 

参数类型为 Filejavax.xml.bind 中的方法
 Object Unmarshaller.unmarshal(File f)
          从指定的文件解组 XML 数据并返回得到的内容树。
 

javax.xml.bind.helpersFile 的使用
 

参数类型为 Filejavax.xml.bind.helpers 中的方法
 Object AbstractUnmarshallerImpl.unmarshal(File f)
           
 

javax.xml.parsersFile 的使用
 

参数类型为 Filejavax.xml.parsers 中的方法
 Document DocumentBuilder.parse(File f)
          将给定文件的内容解析为一个 XML 文档,并且返回一个新的 DOM Document 对象。
 void SAXParser.parse(File f, DefaultHandler dh)
          使用指定的 DefaultHandler 将指定文件的内容解析为 XML。
 void SAXParser.parse(File f, HandlerBase hb)
          使用指定的 HandlerBase 将指定文件的内容解析为 XML。
 

javax.xml.transform.streamFile 的使用
 

参数类型为 Filejavax.xml.transform.stream 中的方法
 void StreamResult.setSystemId(File f)
          设置来自 File 引用的系统 ID。
 void StreamSource.setSystemId(File f)
          设置来自 File 引用的系统 ID。
 

参数类型为 Filejavax.xml.transform.stream 中的构造方法
StreamResult(File f)
          从 File 构造 StreamResult。
StreamSource(File f)
          从 File 构造 StreamSource。
 

javax.xml.validationFile 的使用
 

参数类型为 Filejavax.xml.validation 中的方法
 Schema SchemaFactory.newSchema(File schema)
          解析作为模式的指定 File 并以 Schema 的形式返回它。
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策