/* * Copyright (C) 2008 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ART_LIBARTBASE_BASE_ZIP_ARCHIVE_H_ #define ART_LIBARTBASE_BASE_ZIP_ARCHIVE_H_ #include <stdint.h> #include <memory> #include <string> #include <android-base/logging.h> #include "globals.h" #include "mem_map.h" #include "os.h" #include "safe_map.h" #include "unix_file/random_access_file.h" // system/core/zip_archive definitions. struct ZipArchive; struct ZipEntry; typedef ZipArchive* ZipArchiveHandle; namespace art { class ZipArchive; class MemMap; class ZipEntry { public: bool ExtractToFile(File& file, std::string* error_msg); // Extract this entry to anonymous memory (R/W). // Returns null on failure and sets error_msg. MemMap ExtractToMemMap(const char* zip_filename, const char* entry_filename, std::string* error_msg); // Create a file-backed private (clean, R/W) memory mapping to this entry. // 'zip_filename' is used for diagnostics only, // the original file that the ZipArchive was open with is used // for the mapping. // // Will only succeed if the entry is stored uncompressed. // Returns invalid MemMap on failure and sets error_msg. MemMap MapDirectlyFromFile(const char* zip_filename, /*out*/std::string* error_msg); virtual ~ZipEntry(); MemMap MapDirectlyOrExtract(const char* zip_filename, const char* entry_filename, std::string* error_msg, size_t alignment); uint32_t GetUncompressedLength(); uint32_t GetCrc32(); bool IsUncompressed(); bool IsAlignedTo(size_t alignment) const; private: ZipEntry(ZipArchiveHandle handle, ::ZipEntry* zip_entry, const std::string& entry_name) : handle_(handle), zip_entry_(zip_entry), entry_name_(entry_name) {} ZipArchiveHandle handle_; ::ZipEntry* const zip_entry_; std::string const entry_name_; friend class ZipArchive; DISALLOW_COPY_AND_ASSIGN(ZipEntry); }; class ZipArchive { public: // return new ZipArchive instance on success, null on error. static ZipArchive* Open(const char* filename, std::string* error_msg); static ZipArchive* OpenFromFd(int fd, const char* filename, std::string* error_msg); ZipEntry* Find(const char* name, std::string* error_msg) const; ~ZipArchive(); private: explicit ZipArchive(ZipArchiveHandle handle) : handle_(handle) {} friend class ZipEntry; ZipArchiveHandle handle_; DISALLOW_COPY_AND_ASSIGN(ZipArchive); }; } // namespace art #endif // ART_LIBARTBASE_BASE_ZIP_ARCHIVE_H_