Android API翻译,DexClassLoader类的API中文翻译

最近流行动态加载技术,自己有兴趣也去看看,主要涉及几个类

DexClassLoader

PathClassLoader

DexFile

由于不太懂这些类的一些方法,所以就去看了一下API,索性翻译了一下,放到博客上与大家分享,(DexFile)有人翻译过的,所以直接贴上来

DexClassLoader

extends ClassLoader



继承关系:

java.lang.Object

java.lang.ClassLoader

dalvik.system.DexClassLoader





类概述:

提供一个可以操作目录中包含有jar或者apk文件的简单的类加载器的实现.保留这些文件的目录是要明确指定的,可以不作为应用的一部分安装而执行这些代码.放置这些

DEX文件的目录最好是应用的专属目录,因为在卸载这个APP的时候会自动的移除这些DEX文件,如果用在其他的存储空间(例如SD卡里).这个APP可能没有机会去移除他们





构造函数:

public DexClassLoader(String dexPath,String dexOutputDir,String libPath,ClassLoader parent)

创建一个 DexClassLoader 来解析本地的代码。解析的类是从包含DEX文件的Jar或者APK文件中获取,路径列表是使用系统属性"path.separator"指定的字符分开,默认值是":"。



参数:

dexPath
一个包含一些类和资源jar或者apk文件路径

dexOutputDir 优化的DEX文件写入的路径

libPath
包含本地库的目录列表;可以为空

parent
父类装载器





受保护方法



protected Class<?> findClass(String name)

发现一个类,由loadClass()方法调用,在父类加载器不能找到一个相同命名的加载的类的时候。



参数:

name
需要搜索的类名,以这种形式"java.lang.String" or "java.net.URLClassLoader$3$1".

返回值:

这个类的Class对象

异常

ClassNotFoundException
如果类不能找到







protected String findLibrary(String libname)

发现一个本地库,在父类加载器不能找到一个相同名字的本地库之后调用此方法



参数:

libname
要发现的库的名字

返回值:

库的完整路径,当没找到时返回"null"







protected URL findResource (String name)

发现一个资源,由getResource()方法调用,在父类加载器不能找到一个相同命名资源的时候。



参数:

name
需要发现资源的名称

返回值:

资源作为URL的位置,如果找不到返回"null"





protected Package getPackage (String name)

返回给定包的包信息,不幸的是,DexClassLoader不能真正的拥有这些信息,

而且作为一个不安全的类加载器,它甚至不需要根据规范的需要,但是,我们想

提供这些信息为了方便myClass.getPackage().getName()的调用,因此我们

构造了一个包对象并且用一些虚拟的值填充了这些域.然后这些包对象被放进

了ClassLoader的包缓存中,所以我们会下次会看到相同的一个,我们没有为了

"null"参数或默认的包创建包对象.

以多个包对象代表同一个包会有很多限制:它可以发生当一个包分散在不同的

Jar文件里被不同的类加载器加载,而不太可能,考虑到这整件事或多或少是一个

解决方案,可能不值得付出努力。

参数:

name 类名

返回值:

此类的包信息,如果没有可用的包信息则返回"null"

代码版:

//  		DexClassLoader 
//  				extends ClassLoader
//  
//  		继承关系:
//    java.lang.Object 
//    	 java.lang.ClassLoader 
//      		dalvik.system.DexClassLoader
//  
//  	
//  		类概述:
//  		提供一个可以操作目录中包含有jar或者apk文件的简单的类加载器的实现.保留这些文件的
//	目录是要明确指定的,可以不作为应用的一部分安装而执行这些代码.放置这些
// 		 DEX文件的目录最好是应用的专属目录,因为在卸载这个APP的时候会自动的移除这些DEX文
//	件,如果用在其他的存储空间(例如SD卡里).这个APP可能没有机会去移除他们
//  
//  
//  		构造函数:
//  		public DexClassLoader(String dexPath,String dexOutputDir,String libPath,ClassLoader parent)
//  		创建一个 DexClassLoader 来解析本地的代码。解析的类是从包含DEX文件的Jar或者APK文件中获取,
//	路径列表是使用系统属性"path.separator"指定的字符分开,默认值是":"。
//  		
//  		参数:
//  			dexPath    			一个包含一些类和资源jar或者apk文件路径
//  			dexOutputDir    	优化的DEX文件写入的路径
//  			libPath					包含本地库的目录列表;可以为空
//  			parent					父类装载器
//  
//  
//  		受保护方法
//  
//  		protected Class<?> findClass(String name)
//  		发现一个类,由loadClass()方法调用,在父类加载器不能找到一个相同命名的加载的类的时候。
//  
//  		参数:
//  			name					需要搜索的类名,以这种形式"java.lang.String" or "java.net.URLClassLoader$3$1".
//  		返回值:
//  			这个类的Class对象
//  		异常
//  			ClassNotFoundException 		如果类不能找到
//  
//  
//  
//  		protected String findLibrary(String libname)
//  		发现一个本地库,在父类加载器不能找到一个相同名字的本地库之后调用此方法
//  	
//  		参数:
//  			libname				要发现的库的名字
//  		返回值:
//  			库的完整路径,当没找到时返回"null"
//  
//  
//  
//  		protected URL findResource (String name)
//  		发现一个资源,由getResource()方法调用,在父类加载器不能找到一个相同命名资源的时候。
//  
//  		参数:
//  			name					需要发现资源的名称
//  		返回值:
//  			资源作为URL的位置,如果找不到返回"null"
//  
//  
//  
//  		protected Package getPackage (String name)
//			返回给定包的包信息,不幸的是,DexClassLoader不能真正的拥有这些信息,而且作为一个不安全的类加载器,
//	它甚至不需要根据规范的需要,但是,我们想提供这些信息为了方便myClass.getPackage().getName()的调用,因此
//	我们构造了一个包对象并且用一些虚拟的值填充了这些域.然后这些包对象被放进了ClassLoader的包缓存中,所以
//	我们会下次会看到相同的一个,我们没有为了"null"参数或默认的包创建包对象.
//			以多个包对象代表同一个包会有很多限制:它可以发生当一个包分散在不同的Jar文件里被不同的类加载器加
//	载,而不太可能,考虑到这整件事或多或少是一个解决方案,可能不值得付出努力。
//  		
//  		参数:
//  			name 					类名
//  		返回值:
//  			此类的包信息,如果没有可用的包信息则返回"null"