readFrom, or the value that was
- * cached when place was called
- * @return the cached value
- */
- public int getCachedValue() {
- return value;
- }
-
- public void cacheValue(int value) {
- this.value = value;
- }
-}
diff --git a/dexlib/src/main/java/org/jf/dexlib/ClassDataItem.java b/dexlib/src/main/java/org/jf/dexlib/ClassDataItem.java
deleted file mode 100644
index fac084bf..00000000
--- a/dexlib/src/main/java/org/jf/dexlib/ClassDataItem.java
+++ /dev/null
@@ -1,438 +0,0 @@
-/*
- * [The "BSD licence"]
- * Copyright (c) 2009 Ben Gruver
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- * 2. Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in the
- * documentation and/or other materials provided with the distribution.
- * 3. The name of the author may not be used to endorse or promote products
- * derived from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
- * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
- * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
- * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
- * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
- * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
- * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-package org.jf.dexlib;
-
-import org.jf.dexlib.Util.*;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-
-public class ClassDataItem extends OffsettedItemThese are the main use cases that drove the design of this library
- * - *Annotate an existing dex file - In this case, the intent is to document the structure of - * an existing dex file. We want to be able to read in the dex file, and then write out a dex file - * that is exactly the same (while adding annotation information to an AnnotatedOutput object)
Canonicalize an existing dex file - In this case, the intent is to rewrite an existing dex file - * so that it is in a canonical form. There is a certain amount of leeway in how various types of - * tems in a dex file are ordered or represented. It is sometimes useful to be able to easily - * compare a disassebled and reassembled dex file with the original dex file. If both dex-files are - * written canonically, they "should" match exactly, barring any explicit changes to the reassembled - * file.
- * - *Currently, there are a couple of pieces of information that probably won't match exactly - *
EncodedCatchHandlerList for a method{@link DebugInfoItem} for a methodNote that the above discrepancies should typically only be "intra-item" differences. They - * shouldn't change the size of the item, or affect how anything else is placed or laid out
Creating a dex file from scratch - In this case, a blank dex file is created and then classes - * are added to it incrementally by calling the {@link Section#intern intern} method of - * {@link DexFile#ClassDefsSection}, which will add all the information necessary to represent the given - * class. For example, when assembling a dex file from a set of assembly text files.
- * - *In this case, we can choose to write the dex file in a canonical form or not. It is somewhat - * slower to write it in a canonical format, due to the extra sorting and calculations that are - * required.
Reading in the dex file - In this case, the intent is to read in a dex file and expose all the - * data to the calling application. For example, when disassembling a dex file into a text based - * assembly format, or doing other misc processing of the dex file.
These are other use cases that are possible, but did not drive the design of the library. - * No effort was made to test these use cases or ensure that they work. Some of these could - * probably be better achieved with a disassemble - modify - reassemble type process, using - * smali/baksmali or another assembler/disassembler pair that are compatible with each other
- * - *getPreserveSignedRegisters()
- */
- private DexFile(boolean preserveSignedRegisters) {
- this.preserveSignedRegisters = preserveSignedRegisters;
-
- sectionsByType = new HashMapgetPreserveSignedRegisters()
- */
- public DexFile(String file, boolean preserveSignedRegisters) {
- this(new File(file), preserveSignedRegisters);
- }
-
- /**
- * Construct a new DexFile instead by reading in the given dex file.
- * @param file The dex file to read in
- */
- public DexFile(File file) {
- this(file, true);
- }
-
- /**
- * Construct a new DexFile instance by reading in the given dex file,
- * and optionally keep track of any registers in the debug information that are signed,
- * so they will be written in the same format.
- * @param file The dex file to read in
- * @param preserveSignedRegisters If true, keep track of any registers in the debug information
- * that are signed, so they will be written in the same format.
- * @see #getPreserveSignedRegisters
- */
- public DexFile(File file, boolean preserveSignedRegisters) {
- this(preserveSignedRegisters);
-
- Input in = new ByteArrayInput(FileUtils.readFile(file));
-
- HeaderItemSection.readFrom(1, in);
- HeaderItem headerItem = HeaderItemSection.items.get(0);
-
- in.setCursor(headerItem.getMapOffset());
- MapSection.readFrom(1, in);
-
- MapField[] mapEntries = MapSection.items.get(0).getMapEntries();
- HashMapSection.intern() method of ClassDefsSection
- */
- public DexFile() {
- this(true);
-
- HeaderItemSection.intern(new HeaderItem(dexFile, 0));
- MapSection.intern(new MapItem(dexFile));
- }
-
- /**
- * Convenience method to retrieve the header item
- * @return the header item
- */
- public HeaderItem getHeaderItem() {
- return HeaderItemSection.getItems().get(0);
- }
-
- /**
- * Convenience method to retrieve the map item
- * @return the map item
- */
- public MapItem getMapItem() {
- return MapSection.getItems().get(0);
- }
-
- /**
- * Get the Section containing items of the same type as the given item
- * @param item Get the Section that contains items of this type
- * @param Section containing items of the same type as the given item
- */
- public Section containing items of the given type
- * @param itemType the type of item
- * @return the Section containing items of the given type
- */
- public Section getSectionForType(ItemType itemType) {
- return sectionsByType.get(itemType);
- }
-
- /**
- * Get a boolean value indicating whether this dex file preserved any signed
- * registers in the debug info as it read the dex file in. By default, the dex file
- * doesn't check whether the registers are encoded as unsigned or signed values.
- *
- * This does *not* affect the actual register value that is read in. The value is
- * read correctly regardless
- *
- * This does affect whether any signed registers will retain the same encoding or be
- * forced to the (correct) unsigned encoding when the dex file is written back out.
- *
- * See the discussion about signed register values in the documentation for
- * DexFile
- * @return a boolean indicating whether this dex file preserved any signed registers
- * as it was read in
- */
- public boolean getPreserveSignedRegisters() {
- return preserveSignedRegisters;
- }
-
- /**
- * Get a boolean value indicating whether all items should be placed into a
- * (possibly arbitrary) "canonical" ordering. If false, then only the items
- * that must be ordered per the dex specification are sorted.
- *
- * When true, writing the dex file involves somewhat more overhead
- *
- * If both SortAllItems and Inplace are true, Inplace takes precedence
- * @return a boolean value indicating whether all items should be sorted
- */
- public boolean getSortAllItems() {
- return this.sortAllItems;
- }
-
- /**
- * Set a boolean value indicating whether all items should be placed into a
- * (possibly arbitrary) "canonical" ordering. If false, then only the items
- * that must be ordered per the dex specification are sorted.
- *
- * When true, writing the dex file involves somewhat more overhead
- *
- * If both SortAllItems and Inplace are true, Inplace takes precedence
- * @param value a boolean value indicating whether all items should be sorted
- */
- public void setSortAllItems(boolean value) {
- this.sortAllItems = value;
- }
-
- /**
- * Get a boolean value indicating whether items in this dex file should be
- * written back out "in-place", or whether the normal layout logic should be
- * applied.
- *
- * This should only be used for a dex file that has been read from an existing
- * dex file, and no modifications have been made to the dex file. Otherwise,
- * there is a good chance that the resulting dex file will be invalid due to
- * items that aren't placed correctly
- *
- * If both SortAllItems and Inplace are true, Inplace takes precedence
- * @return a boolean value indicating whether items in this dex file should be
- * written back out in-place.
- */
- public boolean getInplace() {
- return this.inplace;
- }
-
- /**
- * Set a boolean value indicating whether items in this dex file should be
- * written back out "in-place", or whether the normal layout logic should be
- * applied.
- *
- * This should only be used for a dex file that has been read from an existing
- * dex file, and no modifications have been made to the dex file. Otherwise,
- * there is a good chance that the resulting dex file will be invalid due to
- * items that aren't placed correctly
- *
- * If both SortAllItems and Inplace are true, Inplace takes precedence
- * @param value a boolean value indicating whether items in this dex file should be
- * written back out in-place.
- */
- public void setInplace(boolean value) {
- this.inplace = value;
- }
-
- /**
- * This method should be called before writing a dex file. It sorts the sections
- * as needed or as indicated by getSortAllItems() and getInplace(),
- * and then performs a pass through all of the items, finalizing the position (i.e.
- * index and/or offset) of each item in the dex file.
- *
- * This step is needed primarily so that the indexes and offsets of all indexed and
- * offsetted items are available when writing references to those items elsewhere.
- */
- public void place() {
- HeaderItem headerItem = getHeaderItem();
-
- int offset = HeaderItemSection.place(0);
-
- int dataOffset;
-
- for (IndexedSection indexedSection: indexedSections) {
- offset = indexedSection.place(offset);
- }
-
- dataOffset = offset;
- headerItem.setDataOffset(dataOffset);
-
- //TODO: if inplace is true, we need to use the order of the sections as they were in the original file
- for (OffsettedSection offsettedSection: offsettedSections) {
- if (this.sortAllItems && !this.inplace) {
- offsettedSection.sortSection();
- }
- offset = offsettedSection.place(offset);
- }
-
- offset = MapSection.place(offset);
-
-
- headerItem.setFileSize(offset);
- headerItem.setDataSize(offset - dataOffset);
- }
-
- /**
- * Writes the dex file to the give AnnotatedOutput object. If
- * out.Annotates() is true, then annotations that document the format
- * of the dex file are written.
- *
- * You must call place() on this dex file, before calling this method
- * @param out the AnnotatedOutput object to write the dex file and annotations to
- *
- * After calling this method, you should call calcSignature() and
- * then calcChecksum() on the resulting byte array, to calculate the
- * signature and checksum in the header
- */
- public void writeTo(AnnotatedOutput out) {
- HeaderItemSection.writeTo(out);
-
- for (IndexedSection indexedSection: indexedSections) {
- indexedSection.writeTo(out);
- }
-
- for (OffsettedSection offsettedSection: offsettedSections) {
- offsettedSection.writeTo(out);
- }
-
- MapSection.writeTo(out);
- }
-
- /**
- * The IndexedSection containing the sole HeaderItem item. Use
- * getHeaderItem() instead.
- */
- public final IndexedSectionIndexedSection containing StringIdItem items
- */
- public final IndexedSection