Package proguard.dexfile.reader

Class DexFileReader

java.lang.Object

proguard.dexfile.reader.DexFileReader

All Implemented Interfaces:

BaseDexFileReader

public class DexFileReader
extends Object
implements BaseDexFileReader

Open and read a dex file.this is the entrance of dex-reader. to read a dex/odex, use the following code:

 DexFileVisitor visitor = new xxxFileVisitor();
 DexFileReader reader = new DexFileReader(dexFile);
 reader.accept(visitor);
 

Field Summary

Fields

Modifier and Type	Field	Description
static final int	IGNORE_READ_EXCEPTION	ingore read exception
static final int	KEEP_ALL_METHODS	read all methods, even if they are glitch
static final int	KEEP_CLINIT	keep clinit method when SKIP_DEBUG
static final int	SKIP_ANNOTATION	skip annotation info in dex file.
static final int	SKIP_BROKEN_DEBUG_INFO	Do not throw an exception if debug info is not valid
static final int	SKIP_CODE	skip code info in dex file, this indicate SKIP_DEBUG
static final int	SKIP_DEBUG	skip debug infos in dex file.
static final int	SKIP_EXCEPTION	keep clinit method when SKIP_DEBUG
static final int	SKIP_FIELD_CONSTANT	skip field constant in dex file.

Constructor Summary

Constructors

Constructor	Description
DexFileReader(byte[] data)
DexFileReader(ByteBuffer in)	read dex from a ByteBuffer.
DexFileReader(ByteBuffer in, int position)	read dex from a ByteBuffer.

Method Summary

Modifier and Type	Method	Description
void	accept(Consumer<String> stringConsumer)	Provides the given consumer with all strings in the dex file.
void	accept(DexFileVisitor dv)	equals to accept(DexFileVisitor, int) with 0 as config
void	accept(DexFileVisitor dv, int config)	Makes the given visitor visit the dex file.
void	accept(DexFileVisitor dv, int classIdx, int config)	Makes the given visitor visit the dex file.
List<String>	getClassNames()
final int	getClassSize()	the size of class in dex file
int	getDexVersion()
Boolean	ignoreClass(String className)
static void	niceExceptionMessage(Throwable t, int deep)
static int	readLeb128i(ByteBuffer in)
static int	readULeb128i(ByteBuffer in)

Methods inherited from class java.lang.Object

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

Field Details

SKIP_DEBUG

public static final int SKIP_DEBUG

skip debug infos in dex file.

See Also:

• Constant Field Values

SKIP_CODE

public static final int SKIP_CODE

skip code info in dex file, this indicate SKIP_DEBUG

See Also:

• Constant Field Values

SKIP_ANNOTATION

public static final int SKIP_ANNOTATION

skip annotation info in dex file.

See Also:

• Constant Field Values

SKIP_FIELD_CONSTANT

public static final int SKIP_FIELD_CONSTANT

skip field constant in dex file.

See Also:

• Constant Field Values

IGNORE_READ_EXCEPTION

public static final int IGNORE_READ_EXCEPTION

ingore read exception

See Also:

• Constant Field Values

KEEP_ALL_METHODS

public static final int KEEP_ALL_METHODS

read all methods, even if they are glitch

See Also:

• Constant Field Values

KEEP_CLINIT

public static final int KEEP_CLINIT

keep clinit method when SKIP_DEBUG

See Also:

• Constant Field Values

SKIP_EXCEPTION

public static final int SKIP_EXCEPTION

keep clinit method when SKIP_DEBUG

See Also:

• Constant Field Values

SKIP_BROKEN_DEBUG_INFO

public static final int SKIP_BROKEN_DEBUG_INFO

Do not throw an exception if debug info is not valid

See Also:

• Constant Field Values

Constructor Details

DexFileReader

public DexFileReader(ByteBuffer in)

read dex from a ByteBuffer.

Parameters:

in -

DexFileReader

public DexFileReader(ByteBuffer in,
 int position)

read dex from a ByteBuffer.

Parameters:

in -

position - start of the dexfile in the buffer

DexFileReader

public DexFileReader(byte[] data)

Parameters:

data - the byte array of dex

Method Details

niceExceptionMessage

public static void niceExceptionMessage(Throwable t,
 int deep)

readULeb128i

public static int readULeb128i(ByteBuffer in)

readLeb128i

public static int readLeb128i(ByteBuffer in)

getDexVersion

public int getDexVersion()

Specified by:

getDexVersion in interface BaseDexFileReader

accept

public void accept(DexFileVisitor dv)

equals to accept(DexFileVisitor, int) with 0 as config

Specified by:

accept in interface BaseDexFileReader

Parameters:

dv -

getClassNames

public List<String> getClassNames()

Specified by:

getClassNames in interface BaseDexFileReader

accept

public void accept(DexFileVisitor dv,
 int config)

Makes the given visitor visit the dex file.

Specified by:

accept in interface BaseDexFileReader

Parameters:

dv - visitor

config - config flags, SKIP_CODE, SKIP_DEBUG, SKIP_ANNOTATION, SKIP_FIELD_CONSTANT

accept

public void accept(DexFileVisitor dv,
 int classIdx,
 int config)

Makes the given visitor visit the dex file. Notice the DexFileVisitor.visitEnd() is not called

Specified by:

accept in interface BaseDexFileReader

Parameters:

dv - visitor

classIdx - index of class_def

config - config flags, SKIP_CODE, SKIP_DEBUG, SKIP_ANNOTATION, SKIP_FIELD_CONSTANT

accept

public void accept(Consumer<String> stringConsumer)

Provides the given consumer with all strings in the dex file.

Specified by:

accept in interface BaseDexFileReader

ignoreClass

public Boolean ignoreClass(String className)

getClassSize

public final int getClassSize()

the size of class in dex file

Returns:

class_defs_size