com.android.dx.dex.file

Class Item

java.lang.Object

com.android.dx.dex.file.Item

Direct Known Subclasses:

IndexedItem, OffsettedItem

public abstract class Item
extends java.lang.Object

Base class for any structurally-significant and (potentially) repeated piece of a Dalvik file.

Constructor Summary

Constructors

Constructor and Description
Item() Constructs an instance.

Method Summary

Modifier and Type	Method and Description
abstract void	addContents(DexFile file) Populates a DexFile with items from within this instance.
abstract ItemType	itemType() Returns the item type for this instance.
java.lang.String	typeName() Returns the human name for the particular type of item this instance is.
abstract int	writeSize() Gets the size of this instance when written, in bytes.
abstract void	writeTo(DexFile file, AnnotatedOutput out) Writes the representation of this instance to the given data section, using the given DexFile to look things up as needed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Item

public Item()

Constructs an instance.

Method Detail

itemType

public abstract ItemType itemType()

Returns the item type for this instance.

Returns:

non-null; the item type

typeName

public final java.lang.String typeName()

Returns the human name for the particular type of item this instance is.

Returns:

non-null; the name

writeSize

public abstract int writeSize()

Gets the size of this instance when written, in bytes.

Returns:

>= 0; the write size

addContents

public abstract void addContents(DexFile file)

Populates a DexFile with items from within this instance. This will not add an item to the file for this instance itself (which should have been done by whatever refers to this instance).

Note: Subclasses must override this to do something appropriate.

Parameters:

file - non-null; the file to populate

writeTo

public abstract void writeTo(DexFile file,
                             AnnotatedOutput out)

Writes the representation of this instance to the given data section, using the given DexFile to look things up as needed. If this instance keeps track of its offset, then this method will note the written offset and will also throw an exception if this instance has already been written.

Parameters:

file - non-null; the file to use for reference

out - non-null; where to write to