DexArchive

java.lang.Object
- org.knopflerfish.framework.bundlestorage.file.Archive
- - org.knopflerfish.framework.bundlestorage.dex.DexArchive

All Implemented Interfaces:

FileArchive
```
public class DexArchive
extends Archive
```
JAR with classes.dex file handling.

Field Summary
- Fields inherited from class org.knopflerfish.framework.bundlestorage.file.Archive
  bundleDir, file, jar, revision, subId

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`downloadArchive(java.io.InputStream is, java.net.URL source)` Create an Archive based on contents of an InputStream, the archive is saved as local copy in the specified directory.
`boolean`	`exists(java.lang.String path, boolean onlyDirs)` Get a BundleResourceStream to named entry inside an Archive.
`byte[]`	`getClassBytes(java.lang.String name)` Return null to indicate that we can not get class bytes from DEX files
`java.lang.Class<?>`	`loadClassBytes(java.lang.String name, java.lang.ClassLoader cl)` Load a class using the Dalvik DexFile API.
`protected void`	`restoreArchive()` Create an Archive based on contents of a saved archive in the specified directory.
`protected Archive`	`subArchive(java.lang.String path, int id)` Create a Sub-Archive based on a path to in an already existing Archive.

Methods inherited from class org.knopflerfish.framework.bundlestorage.file.Archive
checkNativeLibrary, findResourcesPath, getBundleGeneration, getBundleResourceStream, getFile, getNativeLibrary, getSubId, isJar, listDir, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Method Detail
  - downloadArchive
```
protected void downloadArchive(java.io.InputStream is,
                               java.net.URL source)
                        throws java.io.IOException
```
    Description copied from class: Archive
    
    Create an Archive based on contents of an InputStream, the archive is saved as local copy in the specified directory.
    
    Overrides:
    
    downloadArchive in class Archive
    
    Parameters:
    
    is - Jar file data in an InputStream.
    
    Throws:
    
    java.io.IOException
  - restoreArchive
```
protected void restoreArchive()
                       throws java.io.IOException
```
    Description copied from class: Archive
    
    Create an Archive based on contents of a saved archive in the specified directory. Take lowest versioned archive and remove rest.
    
    Overrides:
    
    restoreArchive in class Archive
    
    Throws:
    
    java.io.IOException
  - subArchive
```
protected Archive subArchive(java.lang.String path,
                             int id)
                      throws java.io.IOException
```
    Description copied from class: Archive
    
    Create a Sub-Archive based on a path to in an already existing Archive. The new archive is saved in a subdirectory below local copy of the existing Archive.
    
    Overrides:
    
    subArchive in class Archive
    
    Parameters:
    
    path - Path of new Archive inside old Archive.
    
    id - Sub-id of Archive.
    
    Throws:
    
    java.io.FileNotFoundException - if no such Jar file in archive.
    
    java.io.IOException - if failed to read Jar file.
  - exists
```
public boolean exists(java.lang.String path,
                      boolean onlyDirs)
```
    Description copied from class: Archive
    
    Get a BundleResourceStream to named entry inside an Archive.
    
    Specified by:
    
    exists in interface FileArchive
    
    Overrides:
    
    exists in class Archive
    
    Returns:
    
    BundleResourceStream to entry or null if it doesn't exist.
  - getClassBytes
```
public byte[] getClassBytes(java.lang.String name)
```
    Return null to indicate that we can not get class bytes from DEX files
    
    Specified by:
    
    getClassBytes in interface FileArchive
    
    Overrides:
    
    getClassBytes in class Archive
    
    Parameters:
    
    name - File to get.
    
    Returns:
    
    Byte array with contents of class file or null if file doesn't exist.
  - loadClassBytes
```
public java.lang.Class<?> loadClassBytes(java.lang.String name,
                                         java.lang.ClassLoader cl)
```
    Load a class using the Dalvik DexFile API.
    This relies in the bundle having a "classes.dex" in its root
    TODO: We should create a specific bundle storage module for DEX files.
    To create such a bundle, do
    1. dx --dex --output=classes.dex bundle.jar
    2. aapt add bundle.jar classes.dex
    Specified by:
    
    loadClassBytes in interface FileArchive
    
    Overrides:
    
    loadClassBytes in class Archive
    
    cl - Class loader to use for component.
    
    Returns:
    
    Class for loaded bytes or null if no fil doesn't exist.

Class DexArchive

Field Summary

Fields inherited from class org.knopflerfish.framework.bundlestorage.file.Archive

Method Summary

Methods inherited from class org.knopflerfish.framework.bundlestorage.file.Archive

Methods inherited from class java.lang.Object

Method Detail

downloadArchive

restoreArchive

subArchive

exists

getClassBytes

loadClassBytes