| java.lang.Object | |
| ↳ | dalvik.system.DexFile |
Manipulates DEX files. The class is similar in principle to
ZipFile. It is used primarily by class loaders.
Note we don't directly open and read the DEX file here. They're memory-mapped read-only by the VM.
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Opens a DEX file from a given File object.
| |||||||||||
Opens a DEX file from a given filename.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Closes the DEX file.
| |||||||||||
Enumerate the names of the classes in this DEX file.
| |||||||||||
Gets the name of the (already opened) DEX file.
| |||||||||||
Returns true if the VM believes that the apk/jar file is out of date
and should be passed through "dexopt" again.
| |||||||||||
Loads a class.
| |||||||||||
Open a DEX file, specifying the file in which the optimized DEX
data should be written.
| |||||||||||
Returns a string containing a concise, human-readable description of this
object.
| |||||||||||
| Protected Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Called when the class is finalized.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Opens a DEX file from a given File object. This will usually be a ZIP/JAR file with a "classes.dex" inside. The VM will generate the name of the corresponding file in /data/dalvik-cache and open it, possibly creating or updating it first if system permissions allow. Don't pass in the name of a file in /data/dalvik-cache, as the named file is expected to be in its original (pre-dexopt) state.
| file | the File object referencing the actual DEX file |
|---|
| IOException | if an I/O error occurs, such as the file not being found or access rights missing for opening it |
|---|
Opens a DEX file from a given filename. This will usually be a ZIP/JAR file with a "classes.dex" inside. The VM will generate the name of the corresponding file in /data/dalvik-cache and open it, possibly creating or updating it first if system permissions allow. Don't pass in the name of a file in /data/dalvik-cache, as the named file is expected to be in its original (pre-dexopt) state.
| fileName | the filename of the DEX file |
|---|
| IOException | if an I/O error occurs, such as the file not being found or access rights missing for opening it |
|---|
Closes the DEX file.
This may not be able to release any resources. If classes from this DEX file are still resident, the DEX file can't be unmapped.
| IOException | if an I/O error occurs during closing the file, which normally should not happen |
|---|
Enumerate the names of the classes in this DEX file.
Gets the name of the (already opened) DEX file.
Returns true if the VM believes that the apk/jar file is out of date and should be passed through "dexopt" again.
| fileName | the absolute path to the apk/jar file to examine. |
|---|
| FileNotFoundException | if fileName is not readable, not a file, or not present. |
|---|---|
| IOException | if fileName is not a valid apk/jar file or if problems occur while parsing it. |
| NullPointerException | if fileName is null. |
Loads a class. Returns the class on success, or a null reference
on failure.
If you are not calling this from a class loader, this is most likely not
going to do what you want. Use forName(String) instead.
The method does not throw ClassNotFoundException if the class
isn't found because it isn't reasonable to throw exceptions wildly every
time a class is not found in the first DEX file we look at.
| name | the class name, which should look like "java/lang/String" |
|---|---|
| loader | the class loader that tries to load the class (in most cases the caller of the method |
Developers
Class object representing the class, or null
if the class cannot be loaded
Open a DEX file, specifying the file in which the optimized DEX data should be written. If the optimized form exists and appears to be current, it will be used; if not, the VM will attempt to regenerate it. This is intended for use by applications that wish to download and execute DEX files outside the usual application installation mechanism. This function should not be called directly by an application; instead, use a class loader such as dalvik.system.DexClassLoader.
| sourcePathName | Jar or APK file with "classes.dex". (May expand this to include "raw DEX" in the future.) |
|---|---|
| outputPathName | File that will hold the optimized form of the DEX data. |
| flags | Enable optional features. (Currently none defined.) |
| IOException | If unable to open the source or output file. |
|---|
Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:
getClass().getName() + '@' + Integer.toHexString(hashCode())
See Writing a useful
toString method
if you intend implementing your own toString method.
Called when the class is finalized. Makes sure the DEX file is closed.
| IOException | if an I/O error occurs during closing the file, which normally should not happen |
|---|---|
| Throwable |