到顶部
Android API
公众的

文件

延伸对象
实施可序列化 可比<T>
java.lang.Object(java.lang.对象)
java.io.文件

课程概述

路径名。路径名可以是绝对的(相对于根目录或相对于程序所在的当前目录正在运行。

文件可能存在也可能不存在。也许吧而且,尽管名字文件,是目录或其他非常规文件。

此类为获取/设置文件提供了有限的功能权限、文件类型和上次修改时间。

在Android上,当向发送文件名时,字符串被转换为UTF-8字节序列操作系统和操作系统返回的字节序列(来自各种各样的列表方法)通过将其解码为UTF-8来转换为字符串字节序列。

另请参见

总结

领域
公众的静止的最终的字符串 路径分隔符 用于分隔搜索路径中组件的系统相关字符串(“:”)。
公众的静止的最终的烧焦 路径分隔符字符 用于分隔搜索路径中组件的系统相关字符(“:”)。
公众的静止的最终的字符串 分离器 用于分隔文件名中组件的系统相关字符串(“/”)。
公众的静止的最终的烧焦 分隔符字符 用于分隔文件名中组件的系统相关字符(“/”)。
公共建筑商
文件(文件目录,字符串名称)
使用指定的目录和名称构造新文件。
文件(字符串路径)
使用指定的路径构造新文件。
文件(字符串目录路径,字符串名称)
使用指定的目录路径和文件名构造一个新文件,在两者之间放置一个路径分隔符。
文件(URI(URI)uri)
使用指定URI的路径构造新文件。
公共方法
布尔值 可以执行()
测试是否允许此进程执行此文件。
布尔值 可以读取()
指示是否允许从该文件读取当前上下文。
布尔值 can写入()
指示是否允许当前上下文写入此文件。
整数 比较函数(文件另一个)
返回此文件和文件另一个
布尔值 创建新文件()
根据路径在文件系统上创建新的空文件存储在此文件中的信息。
静止的文件 创建模板文件(字符串前缀,字符串后缀,文件目录)
使用给定的前缀和后缀作为文件名的一部分。
静止的文件 创建模板文件(字符串前缀,字符串后缀)
使用给定的前缀和后缀创建空临时文件文件名的。
布尔值 删除()
删除此文件。
空隙 退出时删除()
计划在VM正常终止时自动删除此文件。
布尔值 等于(对象对象)
比较对象并返回真的如果他们代表相同的对象使用特定于路径的比较。
布尔值 存在()
返回一个布尔值,指示是否可以在底层文件系统。
文件 获取绝对文件()
返回使用此文件的绝对路径构造的新文件。
字符串 获取绝对路径()
返回此文件的绝对路径。
文件 获取规范文件()
返回使用此文件的规范路径创建的新文件。
字符串 获取规范路径()
返回此文件的规范路径。
长的 获取可用空间()
返回包含此路径的分区上的可用字节数。
字符串 获取名称()
返回此文件表示的文件或目录的名称。
字符串 获取父级()
返回此文件父级的路径名。
文件 获取家长文件()
返回根据此文件父级的路径名创建的新文件。
字符串 获取路径()
返回此文件的路径。
长的 获取总空间()
返回包含此路径的分区的总大小(以字节为单位)。
长的 获取可用空间()
返回包含此路径的分区上可用的可用字节数。
整数 哈希代码()
返回接收器的整数哈希代码。
布尔值 是绝对的()
指示此文件的路径名是否为绝对路径名。
布尔值 是目录()
指示此文件是否表示目录底层文件系统。
布尔值 是文件()
指示此文件是否表示文件关于基础文件系统。
布尔值 是隐藏的()
返回此文件是否是由操作系统。
长的 最后修改日期()
返回上次修改此文件的时间,单位为自1970年1月1日午夜以来的毫秒数。
长的 长度()
返回此文件的长度(以字节为单位)。
字符串[] 列表()
返回目录中包含文件名的字符串数组由该文件表示。
字符串[] 列表(文件名筛选器过滤器)
获取此文件表示的目录中的文件列表。
文件[] 列表文件()
返回包含在由文件。
文件[] 列表文件(文件名筛选器过滤器)
获取此文件表示的目录中的文件列表。
文件[] 列表文件(文件筛选器过滤器)
获取此文件表示的目录中的文件列表。
静止的文件[] 列表根()
返回文件系统根目录。
布尔值 mkdir公司()
创建由该文件命名的目录,假定其父目录存在。
布尔值 mkdirs(mkdir)()
创建此文件命名的目录,创建缺少的父目录目录。
布尔值 重命名为(文件新路径)
将此文件重命名为新路径
布尔值 设置可执行文件(布尔可执行文件)
等效于setExecutable(可执行文件,true)。
布尔值 设置可执行文件(布尔可执行文件,布尔所有者专用)
操作由指定的抽象路径的执行权限这个文件。
布尔值 设置上次修改时间(长时间)
设置上次修改此文件的时间,以毫秒为单位1970年1月1日午夜。
布尔值 设置只读()
等效于setWritable(false,false)。
布尔值 设置可读(布尔值可读)
相当于setReadable(可读,true)。
布尔值 设置可读(布尔可读,布尔所有者专用)
操作由此指定的抽象路径的读取权限文件。
布尔值 设置可写(布尔值可写,布尔值所有者专用)
操作由此指定的抽象路径的写入权限文件。
布尔值 设置可写(布尔值可写)
等效于setWritable(可写,true)。
字符串 到字符串()
返回一个字符串,该字符串包含此文件。
URI(URI) toURI(目标URI)()
返回此文件的统一资源标识符。
统一资源定位地址 到URL()
此方法已弃用API级别9。使用toURI()到URL()正确转义非法字符。
[展开]
继承的方法
来自班级java.lang.Object(java.lang.对象)
来自接口java.lang.可比较

领域

公众静态的最终的字符串 路径分隔符

已在中添加API级别1

用于分隔搜索路径中组件的系统相关字符串(“:”)。请参见路径分隔符字符

公众静态的最终烧焦路径分隔符字符

已在中添加API级别1

用于分隔搜索路径中组件的系统相关字符(“:”)。这用于分割PATH环境变量和类路径等内容要搜索的目录列表中的系统属性。

此字段由系统属性“path.seleparator”初始化。以后对该属性的更改不会影响此字段或此类。

公众静态的最终的字符串 分离器

已在中添加API级别1

用于分隔文件名中组件的系统相关字符串(“/”)。请参见分隔符字符

公众静态的最终烧焦分隔符字符

已在中添加API级别1

用于在文件名(“/”)中分隔组件的系统相关字符。使用这个(而不是硬编码“/”)有助于移植到其他操作系统。

此字段由系统属性“file.seleparator”初始化。以后对该属性的更改将不会对此字段或此类产生任何影响。

公共建筑商

公众的 文件 (文件目录,字符串名称)

已在中添加API级别1

使用指定的目录和名称构造新文件。

参数
目录 存储文件的目录。
名称 文件的名称。
投掷
空指针异常 如果名称无效的

公众的 文件 (字符串路径)

已在中添加API级别1

使用指定的路径构造新文件。

参数
路径 用于文件的路径。

公众的 文件 (字符串目录路径,字符串名称)

已在中添加API级别1

使用指定的目录路径和文件名构造一个新文件,在两者之间放置一个路径分隔符。

参数
目录路径 存储文件的目录的路径。
名称 文件的名称。
投掷
空指针异常 如果名称==空

公众的 文件 (URI(URI)uri)

已在中添加API级别1

使用指定URI的路径构造新文件。uri(用户界面)需要是具有文件方案和非空路径组件,但具有未定义的权限,查询或分割组件。

参数
uri(用户界面) 用于构造此文件。
投掷
非法数据异常 如果uri(用户界面)不符合上述条件。

公共方法

公众布尔值 可以执行 ()

已在中添加API级别9

测试是否允许此进程执行此文件。请注意,这是一个最努力的结果;唯一可以确定的方法是实际尝试操作。

退换商品
  • 真的如果可以执行此文件,否则。

公众布尔值 可以读取 ()

已在中添加API级别1

指示是否允许从该文件读取当前上下文。

退换商品
  • 真的如果可以读取此文件,否则。

公众布尔值 can写入 ()

已在中添加API级别1

指示是否允许当前上下文写入此文件。

退换商品
  • 真的如果可以写入此文件,否则。

公众整数 比较函数 (文件另一个)

已在中添加API级别1

返回此文件和文件另一个。订购取决于平台。

参数
另一个 要与此文件进行比较的文件
退换商品
  • 通过比较两条路径确定的int。可能的值为可比较界面中描述。
另请参见

公众布尔值 创建新文件 ()

已在中添加API级别1

根据路径在文件系统上创建新的空文件存储在此文件中的信息。如果此方法创建一个文件,如果该文件已经存在,则返回false。请注意,它返回false即使文件不是文件(例如,因为它是一个目录)。

这种方法通常没有用处。要创建临时文件,使用createTempFile(字符串,字符串)而不是。要读取/写入文件,请使用文件输入流类,文件输出流,或随机访问文件,所有这些都可以创建文件。

请注意,此方法可以IO异常如果文件已经存在,即使它不是常规文件。呼叫者应始终检查返回值,并且可能还想调用是文件()

退换商品
  • 如果已创建文件,则为true;如果已创建,则为false已经存在。
投掷
IO异常 如果无法创建文件。

公众静止的文件 创建模板文件 (字符串前缀,字符串后缀,文件目录)

已在中添加API级别1

使用给定的前缀和后缀作为文件名的一部分。如果后缀为空,.tmp文件使用。

请注意,此方法可以呼叫退出时删除(),但请参阅在手动调用该方法之前,请先提供该方法的文档。

参数
前缀 临时文件名的前缀。
后缀 临时文件名的后缀。
目录 临时文件要写入的位置,或者无效的对于临时文件的默认位置,它取自“java.io.tmpdir”系统属性。可能需要将此属性设置为现有的可写属性目录以使此方法正常工作。
退换商品
  • 临时文件。
投掷
非法数据异常 如果长度为前缀小于3。
IO异常 如果在写入文件时发生错误。

公众静止的文件 创建模板文件 (字符串前缀,字符串后缀)

已在中添加API级别1

使用给定的前缀和后缀创建空临时文件文件名的。如果后缀为空,.tmp文件使用。这个方法是调用createTempFile(字符串,字符串,文件)第三个参数存在无效的

参数
前缀 临时文件名的前缀。
后缀 临时文件名的后缀。
退换商品
  • 临时文件。
投掷
IO异常 如果写入文件时发生错误。

公众布尔值 删除 ()

已在中添加API级别1

删除此文件。目录必须为空才能被删除。

请注意,此方法可以IO异常失败时。调用方必须检查返回值。

退换商品
  • 真的如果此文件被删除,否则。

公众空隙 退出时删除 ()

已在中添加API级别1

计划在VM正常终止时自动删除此文件。

注意,在Android上,应用程序生命周期不包括VM终止,因此调用此方法不会确保删除文件相反,你应该使用以下最合适的选项:

  • 使用最后要手动调用的子句删除()
  • 维护要删除的一组文件,并在适当的时候对其进行处理在应用程序的生命周期中。
  • 使用Unix技巧,在所有读写器都有后立即删除文件打开了它。没有新的读者/作者能够访问该文件,但所有现有的在最后一个关闭文件之前,用户仍然可以访问。

公众布尔值 等于 (对象对象)

已在中添加API级别1

比较对象并返回真的如果他们代表相同的对象使用特定于路径的比较。

参数
对象 要与此文件进行比较的对象。
退换商品
  • 真的如果对象与此对象相同,否则。

公众布尔值 存在 ()

已在中添加API级别1

返回一个布尔值,指示是否可以在底层文件系统。

退换商品
  • 真的如果此文件存在,否则。

公众的文件 获取绝对文件 ()

已在中添加API级别1

返回使用此文件的绝对路径构造的新文件。相当于新文件(this.getAbsolutePath())

公众的字符串 获取绝对路径 ()

已在中添加API级别1

返回此文件的绝对路径。绝对路径是从根开始的路径文件系统的。在Android上,只有一个根:/

绝对路径的常见用法是将路径传递给过程作为命令行参数,以删除相对路径隐含的要求子级必须与其父级具有相同的工作目录。

公众的文件 获取规范文件 ()

已在中添加API级别1

返回使用此文件的规范路径创建的新文件。相当于新文件(this.getCanonicalPath())

退换商品
  • 根据此文件的规范路径构造的新文件。
投掷
IO异常 如果发生I/O错误。

公众的字符串 获取规范路径 ()

已在中添加API级别1

返回此文件的规范路径。绝对的路径是从文件系统的根目录开始的路径。A类规范的path是带有符号链接的绝对路径并解决了对“.”或“..”的引用。如果路径元素不存在(或不可搜索),解释规范化之间存在冲突作为文本操作(其中“a/../b”是“b”,即使“a”不存在)。

大多数呼叫者应该使用获取绝对路径()而不是。规范路径是计算成本明显更高,而且通常不实用。主要用于规范路径是通过以下方式确定两个路径是否指向同一文件比较规范化路径。

使用规范路径可能非常有害,特别是因为规范化删除符号链接。明智的做法是假设一个象征性的联系存在是有原因的,而这个原因是因为链接可能需要更改。规范化删除了这一层间接寻址。好的代码通常应该避免缓存规范路径。

退换商品
  • 此文件的规范路径。
投掷
IO异常 如果发生I/O错误。

公众长的 获取可用空间 ()

已在中添加API级别9

返回包含此路径的分区上的可用字节数。如果此路径不存在,则返回0。

请注意,这可能是一个乐观的过高估计,不应该可以保证您的应用程序可以实际写入这么多字节。

公众的字符串 获取名称 ()

已在中添加API级别1

返回此文件表示的文件或目录的名称。

退换商品
  • 此文件的名称或空字符串(如果中没有名称部分)文件的路径。

公众的字符串 获取父级 ()

已在中添加API级别1

返回此文件父级的路径名。这是通往但不包括姓氏。无效的如果没有,则返回家长。

退换商品
  • 此文件的父路径名或无效的

公众的文件 获取家长文件 ()

已在中添加API级别1

返回根据此文件父级的路径名创建的新文件。这是指向但不包括姓氏的路径。无效的当没有父级时返回。

退换商品
  • 表示此文件的父级的新文件或无效的

公众的字符串 获取路径 ()

已在中添加API级别1

返回此文件的路径。

公众长的 获取总空间 ()

已在中添加API级别9

返回包含此路径的分区的总大小(以字节为单位)。如果此路径不存在,则返回0。

公众长的 获取可用空间 ()

已在中添加API级别9

返回包含此路径的分区上可用的可用字节数。如果此路径不存在,则返回0。

请注意,这可能是一个乐观的过高估计,不应该可以保证您的应用程序可以实际写入这么多字节。在Android(和其他基于Unix的系统)上,此方法返回可用字节数可供非root用户使用,无论您是否实际以root身份运行,并且与可能应用于用户的任何配额或其他限制无关。获取可用空间方法返回root可能可用的字节数。)

公众整数 哈希代码 ()

已在中添加API级别1

返回接收器的整数哈希代码。其中的任意两个对象等于收益真的必须返回相同的哈希代码。

退换商品
  • 此文件的哈希值。
另请参见

公众布尔值 是绝对的 ()

已在中添加API级别1

指示此文件的路径名是否为绝对路径名。路径名是否为绝对值是特定于平台的。在Android上,绝对路径以字符“/”。

退换商品
  • 真的如果此文件的路径名是绝对的,否则。
另请参见

公众布尔值 是目录 ()

已在中添加API级别1

指示此文件是否表示目录底层文件系统。

退换商品
  • 真的如果此文件是一个目录,否则。

公众布尔值 是文件 ()

已在中添加API级别1

指示此文件是否表示文件关于基础文件系统。

退换商品
  • 真的如果此文件是文件,否则。

公众布尔值 是隐藏的 ()

已在中添加API级别1

返回此文件是否是由操作系统。“隐藏”的概念是与系统相关的。对于Unix如果文件名以“.”开头,则认为该文件是隐藏的。对于Windows系统文件系统中对此有一个显式标志目的。

退换商品
  • 真的如果文件被隐藏,否则。

公众长的 最后修改日期 ()

已在中添加API级别1

返回上次修改此文件的时间,单位为自1970年1月1日午夜以来的毫秒数。如果文件不存在,则返回0。

退换商品
  • 上次修改此文件的时间。

公众长的 长度 ()

已在中添加API级别1

返回此文件的长度(以字节为单位)。如果文件不存在,则返回0。未定义目录的结果。

退换商品
  • 此文件中的字节数。

公众的字符串[] 列表 ()

已在中添加API级别1

返回目录中包含文件名的字符串数组由该文件表示。结果是无效的如果此文件不是目录。

条目..表示当前和父级目录不会作为列表的一部分返回。

退换商品
  • 包含文件名或无效的

公众的字符串[] 列表 (文件名筛选器过滤器)

已在中添加API级别1

获取此文件表示的目录中的文件列表。这个然后通过FilenameFilter和文件名筛选列表与匹配的名称一起作为字符串数组返回。退换商品无效的如果此文件不是目录。如果滤波器无效的然后所有文件名都匹配。

条目..表示当前和父级目录不会作为列表的一部分返回。

参数
滤波器 用于匹配名称的筛选器可以是无效的
退换商品
  • 文件数组或无效的

公众的文件[] 列表文件 ()

已在中添加API级别1

返回包含在此表示的目录中的文件数组文件。结果是无效的如果此文件不是目录。这个如果此文件的路径为绝对的,否则它们是相对的。

退换商品
  • 文件数组或无效的

公众的文件[] 列表文件 (文件名筛选器过滤器)

已在中添加API级别1

获取此文件表示的目录中的文件列表。这个然后通过FilenameFilter和匹配名称以文件数组的形式返回。退换商品无效的如果是这样文件不是目录。如果滤波器无效的然后全部文件名匹配。

条目..表示当前和父级目录不会作为列表的一部分返回。

参数
滤波器 用于匹配名称的筛选器可以是无效的
退换商品
  • 文件数组或无效的

公众的文件[] 列表文件 (文件筛选器过滤器)

已在中添加API级别1

获取此文件表示的目录中的文件列表。这个然后通过FileFilter筛选列表,匹配的文件如下作为文件数组返回。退换商品无效的如果此文件不是目录。如果滤波器无效的然后所有文件都匹配。

条目..表示当前和父级目录不会作为列表的一部分返回。

参数
滤波器 用于匹配名称的筛选器可以是无效的
退换商品
  • 文件数组或无效的

公众静止的文件[] 列表根 ()

已在中添加API级别1

返回文件系统根目录。在Android和其他Unix系统上,有一个根,/

公众布尔值 mkdir公司 ()

已在中添加API级别1

创建由该文件命名的目录,假定其父目录存在。使用mkdirs()如果您还想创建缺失的父对象。

请注意,此方法可以IO异常失败时。调用方必须检查返回值。还要注意,此方法返回如果目录已经存在,则返回false。如果您想知道目录在返回时存在,请使用(f.mkdir()||f.isDirectory())或者忽略此方法的返回值并简单地调用是目录()

退换商品
  • 真的如果创建了目录,失败或目录已存在。

公众布尔值 mkdirs(mkdir) ()

已在中添加API级别1

创建此文件命名的目录,创建缺少的父目录目录。使用mkdir()如果你不想让父母失踪。

请注意,此方法可以IO异常失败时。调用方必须检查返回值。还要注意,此方法返回如果目录已经存在,则返回false。如果您想知道目录在返回时存在,请使用(f.mkdirs()||f.isDirectory())或者忽略此方法的返回值并简单地调用是目录()

退换商品
  • 真的如果目录已创建,失败或目录已存在。

公众布尔值 重命名为 (文件新路径)

已在中添加API级别1

将此文件重命名为新路径。这两种操作都支持文件和目录。

可能出现许多故障。一些更可能发生的故障包括:

  • 同时包含源和的目录需要写入权限目标路径。
  • 两个路径的所有父路径都需要搜索权限。
  • 两个路径都在同一个装载点上。在Android上,应用程序最有可能受到影响尝试在内部存储器和SD卡之间进行复制时存在此限制。

请注意,此方法可以IO异常失败时。调用方必须检查返回值。

参数
新路径 新路径。
退换商品
  • 对成功来说是正确的。

公众布尔值 设置可执行文件 (布尔可执行文件)

已在中添加API级别9

等效于setExecutable(可执行文件,true)。

公众布尔值 设置可执行文件 (布尔可执行文件,布尔所有者专用)

已在中添加API级别9

操作指定的抽象路径的执行权限这个文件。

请注意,此方法可以IO异常失败时。调用方必须检查返回值。

参数
可执行文件 如果为true,则允许执行权限,否则不允许
仅所有者 若要操作仅所有者的执行权限(如果为true),否则对每个人来说都是如此。该操作适用于如果底层系统不区分所有者和其他用户。
退换商品
  • 如果且仅当操作成功时为true。如果用户没有具有更改此摘要的访问权限的权限pathname操作将失败。如果底层文件系统不支持执行权限和可执行文件的值为false,则此操作将失败。

公众布尔值 设置上次修改时间 (长时间)

已在中添加API级别1

设置上次修改此文件的时间,以毫秒为单位1970年1月1日午夜。

请注意,此方法确实IO异常失败时。调用方必须检查返回值。

参数
时间 此文件的上次修改时间。
退换商品
  • 真的如果操作成功,否则。
投掷
非法数据异常 如果时间<0

公众布尔值 设置只读 ()

已在中添加API级别1

等效于setWritable(false,false)。

公众布尔值 设置可读 (布尔值可读)

已在中添加API级别9

相当于setReadable(可读,true)。

公众布尔值 设置可读 (布尔可读,布尔所有者专用)

已在中添加API级别9

操作由此指定的抽象路径的读取权限文件。

参数
可读的 如果为true,则允许读取权限,否则不允许
仅所有者 若要仅为所有者操纵读取权限(如果为true),否则对每个人来说都是如此。该操作适用于如果底层系统不区分所有者和其他用户。
退换商品
  • 如果且仅当操作成功时为true。如果用户没有具有更改此摘要的访问权限的权限pathname操作将失败。如果底层文件系统不支持读取权限,readable的值为false,此操作将失败。

公众布尔值 设置可写 (布尔值可写,布尔值所有者专用)

已在中添加API级别9

操作由此指定的抽象路径的写入权限文件。

参数
可写的 如果为true,则允许写入权限,否则不允许
仅限所有者 若要仅为所有者操作写权限(如果为true),否则对每个人来说都是如此。操纵将适用于如果底层系统不区分所有者和其他用户。
退换商品
  • 如果且仅当操作成功时为true。如果用户没有具有更改此摘要的访问权限的权限pathname操作将失败。

公众布尔值 设置可写 (布尔值可写)

已在中添加API级别9

等效于setWritable(可写,true)。

公众的字符串 到字符串 ()

已在中添加API级别1

返回一个字符串,该字符串包含此文件。

退换商品
  • 此文件的可打印表示。

公众的URI(URI) toURI(目标URI) ()

已在中添加API级别1

返回此文件的统一资源标识符。URI是系统依赖于不同的操作/文件,且不可在不同操作/文件之间转移系统。

退换商品
  • 此文件的URI。

公众的统一资源定位地址 到URL ()

已在中添加API级别1

此方法已弃用API级别9。
使用toURI()到URL()正确转义非法字符。

返回此文件的统一资源定位器。URL是系统依赖于不同的操作/文件,且不可在不同操作/文件之间转移系统。

退换商品
  • 此文件的URL。
投掷
畸形URL异常 如果路径无法转换为URL。