©
This document uses PHP Chinese website manual Release
DexFile
版本：Android 4.0 r1
结构
继承关系
public final class DexFile extends Object
java.lang.Object
dalvik.system.DexFile
类概述
操作DEX文件。这个类原理上和ZipFile相似。主要在类装载器里被使用。
注意，我们不直接打开和读取DEX文件。它们被虚拟机以只读方式映射到内存了。
构造函数
public DexFile (File file)
通过指定的File对象打开DEX文件。指定的文件通常是一个ZIP/JAR文件，里面包含一个”classes.dex”。虚拟机将在目录/data/dalvik-cache下生成对应的文件名字并打开它，如果系统权限允许的话会首先创建或更新它。不要传目录/data/dalvik-cache下的文件名给它，因为这个文件被认为处于初始状态（DEX被优化之前）。
参数
File 引用实际DEX文件的File对象
异常
IOException 发生I/O异常，例如文件不存在或者没有权限访问。
public DexFile (String fileName)
打开指定文件名的DEX文件。指定的文件通常是一个ZIP/JAR文件，里面包含一个”classes.dex”。虚拟机将在目录/data/dalvik-cache下生成对应的文件名字并打开它，如果系统权限允许的话会首先创建或更新它。不要传目录/data/dalvik-cache下的文件名给它，因为这个文件被认为处于初始状态（DEX被优化之前）。
参数
fileName DEX文件名。
异常
IOException 发生I/O异常，例如文件不存在或者没有权限访问。
公共方法
public void close ()
关闭DEX文件。
有可能无法释放任何资源。如果来自DEX文件的类还存活着的话，DEX文件不能被取消映射。
异常
IOException 在关闭文件的过程中可能发生I/O异常，一般不会发生。
public Enumeration<String> entries ()
枚举DEX文件里面的类名。
返回值
DEX文件所包含类名的枚举，类名的类型是一般内部格式（像java/lang/String）。
public String getName ()
获取（已打开）DEX文件名。
返回值
文件名
public static boolean isDexOptNeeded (String fileName)
如果虚拟机认为apk/jar文件已经过期返回true，并且应该再次通过”dexopt”传递。（译者注：dexopt是apk优化工具）
参数
fileName 被检查apk/jar文件的绝对路径名。
返回值
如果应该调用dexopt处理文件返回true；否则false。
异常
FileNotFoundException 文件不可读、不是一个文件或者文件不存在。
IOException fileName不是有效的apk/jar文件，或者在解析文件时出现问题。
NullPointerException fileName是空的。
StaleDexCacheError 优化过的DEX文件已过期且位于只读分区。
public Class loadClass (String name, ClassLoader loader)
装载一个类。返回成功装载的类，失败返回空。
如果在类装载器之外调用它，往往不会得到你想要的结果，这时请使用forName(String)。
该方法不会在找不到类的时候抛出ClassNotFoundException异常，因为每次在我们看到的第一个DEX文件里找不到类就粗暴地抛出异常是不合理的。
参数
name 类名，应该是一个"java/lang/String"
loader 试图装载类的类装载器（大多数情况下就是该方法的调用者）
返回值
类名对应的对象，装载失败时返回空。
public static DexFile loadDex (String sourcePathName, String outputPathName, int flags)
打开一个DEX文件，并提供一个文件来保存优化过的DEX数据。如果优化过的格式已存在并且是最新的，就直接使用它。如果不是，虚拟机将试图重新创建一个。该方法主要用于应用希望在通常的应用安装机制之外下载和执行DEX文件。不能在应用里直接调用该方法，而应该通过一个类装载器例如dalvik.system.DexClassLoader.
参数
sourcePathName 包含”classes.dex”的Jar或者APK文件。(将来可能会扩展支持"raw DEX"。)
outputPathName 保存优化过的DEX数据的文件。
flags 打开可选功能（目前什么也没定义）
返回值
一个新的，或者先前已经打开的DexFile。
异常
IOException 无法打开输入或输出文件。
受保护方法
protected void finalize ()
类结束时调用。确保DEX文件被关闭。
异常
IOException 关闭文件时发生I/O异常，一般不会发生。
补充
文章精选
Dalvik 分析 - Class加载篇
启用另一个程序某些方法
Android类动态加载技术