前言
本章内容dalvik.system.DexFile章节,版本为Android 4.0 r1,翻译来自:"阿年",欢迎访问他的博客:"http://blog.csdn.net/mtding",再次感谢"阿年" !期待你一起参与翻译Android的相关资料,联系我over140@gmail.com。
DexFile
译者署名:阿年
译者链接:http://blog.csdn.net/mtding
版本: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异常,一般不会发生。
补充
文章精选