vm/JarFile.h

   1 /*
   2  * Copyright (C) 2008 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 /*
  17  * Decode jar/apk/zip files.
  18  */
  19 #ifndef _DALVIK_JARFILE
  20 #define _DALVIK_JARFILE
  21
  22 /*
  23  * This represents an open, scanned Jar file.  (It's actually for any Zip
  24  * archive that happens to hold a Dex file.)
  25  */
  26 typedef struct JarFile {
  27     ZipArchive  archive;
  28     //MemMapping  map;
  29     char*       cacheFileName;
  30     DvmDex*     pDvmDex;
  31 } JarFile;
  32
  33 /*
  34  * Open the Zip archive and get a list of the classfile entries.
  35  *
  36  * On success, returns 0 and sets "*ppJarFile" to a newly-allocated JarFile.
  37  * On failure, returns a meaningful error code [currently just -1].
  38  */
  39 int dvmJarFileOpen(const char* fileName, const char* odexOutputName,
  40     JarFile** ppJarFile, bool isBootstrap);
  41
  42 /*
  43  * Free a JarFile structure, along with any associated structures.
  44  */
  45 void dvmJarFileFree(JarFile* pJarFile);
  46
  47 /* pry the DexFile out of a JarFile */
  48 INLINE DvmDex* dvmGetJarFileDex(JarFile* pJarFile) {
  49     return pJarFile->pDvmDex;
  50 }
  51
  52 /* get full path of optimized DEX file */
  53 INLINE const char* dvmGetJarFileCacheFileName(JarFile* pJarFile) {
  54     return pJarFile->cacheFileName;
  55 }
  56
  57 typedef enum DexCacheStatus {
  58     DEX_CACHE_ERROR = -2,
  59     DEX_CACHE_BAD_ARCHIVE = -1,
  60     DEX_CACHE_OK = 0,
  61     DEX_CACHE_STALE,
  62     DEX_CACHE_STALE_ODEX,
  63 } DexCacheStatus;
  64
  65 /*
  66  * Checks the dependencies of the dex cache file corresponding
  67  * to the jar file at the absolute path "fileName".
  68  */
  69 DexCacheStatus dvmDexCacheStatus(const char *fileName);
  70
  71 #endif /*_DALVIK_JARFILE*/