Modifier and Type	Class and Description
private static class	DebugInfoDecoder.LocalEntry An entry in the resulting locals table
private static class	DebugInfoDecoder.PositionEntry An entry in the resulting postions table

Field Summary

Modifier and Type	Field and Description
private int	address current decoding state: bytecode address
private final int	codesize size of code block in code units
private final Prototype	desc method descriptor of method this debug info is for
private final byte[]	encoded encoded debug info
private final DexFile	file dex file this debug info will be stored in
private final boolean	isStatic true if method is static
private final DebugInfoDecoder.LocalEntry[]	lastEntryForReg indexed by register, the last local variable live in a reg
private int	line current decoding state: line number
private final ArrayList<DebugInfoDecoder.LocalEntry>	locals locals decoded
private final ArrayList<DebugInfoDecoder.PositionEntry>	positions positions decoded
private final int	regSize register size, in register units, of the register space used by this method
private final int	thisStringIdx string index of the string "this"

Access	Constructor and Description
pack-priv	DebugInfoDecoder(byte[] encoded debug info encoded, int size of code block in code units codesize, int register size, in register units, of the register space used by this method regSize, boolean true if method is static isStatic, CstMethodRef method descriptor of method this debug info is for ref, DexFile dex file this debug info will be stored in file) Constructs an instance.

Method Summary

Modifier and Type	Method and Description
public void	decode() Decodes the debug info sequence.
private void	decode0()
public List<DebugInfoDecoder.LocalEntry>	Returns: locals list in ascending address order. getLocals() Gets the decoded locals list, in ascending start-address order.
private int	Returns: register as noted above. getParamBase() Gets the register that begins the method's parameter range (including the 'this' parameter for non-static methods).
public List<DebugInfoDecoder.PositionEntry>	Returns: positions list in ascending address order. getPositionList() Gets the decoded positions list.
private int	Returns: index into file's string ids table, -1 means null readStringIndex(ByteInput bs) Reads a string index.
public static void	validateEncode(byte[] encoded debug info info, DexFile `non-null;` file to refer to during decoding file, CstMethodRef `non-null;` method whose info is being decoded ref, DalvCode `non-null;` original code object that was encoded code, boolean whether the method is static isStatic) Validates an encoded debug info stream against data used to encode it, throwing an exception if they do not match.
private static void	validateEncode0(byte[] info, int codeSize, int countRegisters, boolean isStatic, CstMethodRef ref, DexFile file, PositionList pl, LocalList ll)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

address	back to summary
private int address current decoding state: bytecode address

codesize	back to summary
private final int codesize size of code block in code units

desc	back to summary
private final Prototype desc method descriptor of method this debug info is for

encoded	back to summary
private final byte[] encoded encoded debug info

file	back to summary
private final DexFile file dex file this debug info will be stored in

isStatic	back to summary
private final boolean isStatic true if method is static

lastEntryForReg	back to summary
private final DebugInfoDecoder.LocalEntry[] lastEntryForReg indexed by register, the last local variable live in a reg

line	back to summary
private int line current decoding state: line number

locals	back to summary
private final ArrayList<DebugInfoDecoder.LocalEntry> locals locals decoded

positions	back to summary
private final ArrayList<DebugInfoDecoder.PositionEntry> positions positions decoded

regSize	back to summary
private final int regSize register size, in register units, of the register space used by this method

thisStringIdx	back to summary
private final int thisStringIdx string index of the string "this"

Constructor Detail

DebugInfoDecoder	back to summary
pack-priv DebugInfoDecoder(byte[] encoded, int codesize, int regSize, boolean isStatic, CstMethodRef ref, DexFile file) Constructs an instance. Parameters encoded:byte[] encoded debug info codesize:int size of code block in code units regSize:int register size, in register units, of the register space used by this method isStatic:boolean true if method is static ref:CstMethodRef method descriptor of method this debug info is for file:DexFile dex file this debug info will be stored in

DebugInfoDecoder

back to summary

pack-priv DebugInfoDecoder(byte[] encoded, int codesize, int regSize, boolean isStatic, CstMethodRef ref, DexFile file)

Constructs an instance.

Parameters

encoded:byte[]: encoded debug info
codesize:int: size of code block in code units
regSize:int: register size, in register units, of the register space used by this method
isStatic:boolean: true if method is static
ref:CstMethodRef: method descriptor of method this debug info is for
file:DexFile: dex file this debug info will be stored in

Method Detail

decode	back to summary
public void decode() Decodes the debug info sequence.

decode0	back to summary
private void decode0() throws IOException

getLocals back to summary

getLocals	back to summary
public List<DebugInfoDecoder.LocalEntry> getLocals() Gets the decoded locals list, in ascending start-address order. Valid after calling `decode`. Returns:List<DebugInfoDecoder.LocalEntry> locals list in ascending address order.

public List<DebugInfoDecoder.LocalEntry> getLocals()

Gets the decoded locals list, in ascending start-address order. Valid after calling decode.

Returns:List<DebugInfoDecoder.LocalEntry>: locals list in ascending address order.

getParamBase back to summary

getParamBase	back to summary
private int getParamBase() Gets the register that begins the method's parameter range (including the 'this' parameter for non-static methods). The range continues until `regSize` Returns:int register as noted above.

private int getParamBase()

Gets the register that begins the method's parameter range (including the 'this' parameter for non-static methods). The range continues until regSize

Returns:int: register as noted above.

getPositionList back to summary

getPositionList	back to summary
public List<DebugInfoDecoder.PositionEntry> getPositionList() Gets the decoded positions list. Valid after calling `decode`. Returns:List<DebugInfoDecoder.PositionEntry> positions list in ascending address order.

public List<DebugInfoDecoder.PositionEntry> getPositionList()

Gets the decoded positions list. Valid after calling decode.

Returns:List<DebugInfoDecoder.PositionEntry>: positions list in ascending address order.

readStringIndex	back to summary
private int readStringIndex(ByteInput bs) throws IOException Reads a string index. String indicies are offset by 1, and a 0 value in the stream (-1 as returned by this method) means "null" Returns:int index into file's string ids table, -1 means null

readStringIndex

back to summary

private int readStringIndex(ByteInput bs) throws IOException

Reads a string index. String indicies are offset by 1, and a 0 value in the stream (-1 as returned by this method) means "null"

Returns:int: index into file's string ids table, -1 means null

validateEncode back to summary

validateEncode	back to summary
public static void validateEncode(byte[] info, DexFile file, CstMethodRef ref, DalvCode code, boolean isStatic) Validates an encoded debug info stream against data used to encode it, throwing an exception if they do not match. Used to validate the encoder. Parameters info:byte[] encoded debug info file:DexFile `non-null;` file to refer to during decoding ref:CstMethodRef `non-null;` method whose info is being decoded code:DalvCode `non-null;` original code object that was encoded isStatic:boolean whether the method is static

public static void validateEncode(byte[] info, DexFile file, CstMethodRef ref, DalvCode code, boolean isStatic)

Validates an encoded debug info stream against data used to encode it, throwing an exception if they do not match. Used to validate the encoder.

Parameters

info:byte[]: encoded debug info
file:DexFile: non-null; file to refer to during decoding
ref:CstMethodRef: non-null; method whose info is being decoded
code:DalvCode: non-null; original code object that was encoded
isStatic:boolean: whether the method is static

validateEncode0	back to summary
private static void validateEncode0(byte[] info, int codeSize, int countRegisters, boolean isStatic, CstMethodRef ref, DexFile file, PositionList pl, LocalList ll)

org.droidparts.dexmaker.dx.dex.file back to summary

private Class DebugInfoDecoder.LocalEntry

Class Inheritance

extends Object

java.lang.Object
org.droidparts.dexmaker.dx.dex.file.DebugInfoDecoder.LocalEntry

An entry in the resulting locals table

Field Summary

Modifier and Type	Field and Description
public int	address address of event
public boolean	isStart `true` iff it's a local start
public int	nameIndex index of name in strings table
public int	reg register number
public int	signatureIndex index of type signature in strings table
public int	typeIndex index of type in types table

Constructor Summary

Access	Constructor and Description
public	LocalEntry(int address, boolean isStart, int reg, int nameIndex, int typeIndex, int signatureIndex)

Method Summary

Modifier and Type	Method and Description
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

address	back to summary
public int address address of event

isStart	back to summary
public boolean isStart `true` iff it's a local start

nameIndex	back to summary
public int nameIndex index of name in strings table

reg	back to summary
public int reg register number

signatureIndex	back to summary
public int signatureIndex index of type signature in strings table

typeIndex	back to summary
public int typeIndex index of type in types table

Constructor Detail

LocalEntry	back to summary
public LocalEntry(int address, boolean isStart, int reg, int nameIndex, int typeIndex, int signatureIndex)

Method Detail

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Returns:String a string representation of the object

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String: a string representation of the object

org.droidparts.dexmaker.dx.dex.file back to summary

private Class DebugInfoDecoder.PositionEntry

Class Inheritance

extends Object

java.lang.Object
org.droidparts.dexmaker.dx.dex.file.DebugInfoDecoder.PositionEntry

An entry in the resulting postions table

Field Summary

Modifier and Type	Field and Description
public int	address bytecode address
public int	line line number

Constructor Summary

Access	Constructor and Description
public	PositionEntry(int address, int line)

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

address	back to summary
public int address bytecode address

line	back to summary
public int line line number

Constructor Detail

PositionEntry	back to summary
public PositionEntry(int address, int line)

public Class DebugInfoDecoder

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DebugInfoDecoder.LocalEntry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DebugInfoDecoder.PositionEntry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail