proguard.classfile.attribute

Class StructuredLineNumberInfo

java.lang.Object

proguard.classfile.attribute.LineNumberInfo

proguard.classfile.attribute.StructuredLineNumberInfo

public class StructuredLineNumberInfo
extends LineNumberInfo

Line number info with extra information for lines that came from a different source than the current method (e.g. inlined from a different method). Tracking this information is necessary for printing a correct mapping file.

The structured line number info contains:

• Source string indicating the originating class/method of the line.
• Optional start/end line number indicating the original line numbers for a block of inlined instructions.
• A list of origins, indicating the transformations these lines underwent, e.g. multiple levels of inlining
• A block ID, that identifies a group of lines that belongs to a singular block.

Since these transformations operate on blocks of lines, and the mapping file identifies blocks rather than singular lines, StructuredLineNumberInfo objects are generated through a StructuredLineNumberInfo.Block object, which is a factory object that generates StructuredLineNumberInfos with consistent block IDs.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StructuredLineNumberInfo.Block Factory for StructuredLineNumberInfo objects.

Field Summary

Fields inherited from class proguard.classfile.attribute.LineNumberInfo

LINE_RANGE_NO_SOURCE, SIMPLE_LINE_NUMBER_BLOCK_ID, u2lineNumber, u2startPC

Method Summary

Modifier and Type	Method and Description
LineNumberInfoBlock	getBlock()
StructuredLineNumberInfo.Block	getBlock(LineOrigin... addedOrigins)
int	getBlockId() Get the block ID which identifies related line numbers which form a single block in the mapping file.
java.util.List<LineOrigin>	getOrigin() Get a chronological list of manipulations that this line went through.
java.lang.String	getSource() Returns a description of the source of the line, if known, or null otherwise.
int	getSourceLineEnd()
int	getSourceLineStart()
java.lang.String	getSourceMethod()

Methods inherited from class java.lang.Object

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

Method Detail

getSourceMethod

public java.lang.String getSourceMethod()

Overrides:

getSourceMethod in class LineNumberInfo

getSourceLineStart

public int getSourceLineStart()

Overrides:

getSourceLineStart in class LineNumberInfo

getSourceLineEnd

public int getSourceLineEnd()

Overrides:

getSourceLineEnd in class LineNumberInfo

getBlockId

public int getBlockId()

Get the block ID which identifies related line numbers which form a single block in the mapping file.

Overrides:

getBlockId in class LineNumberInfo

getOrigin

public java.util.List<LineOrigin> getOrigin()

Get a chronological list of manipulations that this line went through. True origin is the first element, followed by any subsequent manipulations (e.g. multiple levels of inlining, copying, etc.).

Overrides:

getOrigin in class LineNumberInfo

getSource

public java.lang.String getSource()

Description copied from class: LineNumberInfo

Returns a description of the source of the line, if known, or null otherwise. Standard line number entries don't contain information about their source; it is assumed to be the same source file.

Overrides:

getSource in class LineNumberInfo

getBlock

public LineNumberInfoBlock getBlock()

Overrides:

getBlock in class LineNumberInfo

getBlock

public StructuredLineNumberInfo.Block getBlock(LineOrigin... addedOrigins)