Package com.googlecode.d2j.reader

Class DexFileReader

java.lang.Object

com.googlecode.d2j.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	COMPUTE_FRAMES	Instruct ASM to compute frames when generating class files, using ClassWriter.COMPUTE_FRAMES **EXPERIMENTAL CODE**
static final int	DONT_SANITIZE_NAMES
static final int	IGNORE_READ_EXCEPTION	ignore 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_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
static final int	SKIP_FIELD_CONSTANT	skip field constant in dex file.

Constructor Summary

Constructors

Constructor	Description
DexFileReader(byte[] data)
DexFileReader(File file)
DexFileReader(InputStream is)
DexFileReader(ByteBuffer in)	read dex from a ByteBuffer.
DexFileReader(Path file)

Method Summary

Modifier and Type	Method	Description
void	accept(com.googlecode.d2j.visitors.DexFileVisitor dv)	equals to accept(DexFileVisitor, int) with 0 as config
void	accept(com.googlecode.d2j.visitors.DexFileVisitor dv, int config)	Makes the given visitor visit the dex file.
void	accept(com.googlecode.d2j.visitors.DexFileVisitor dv, int classIdx, int config)	Makes the given visitor visit the dex file.
List<String>	getClassNames()
final int	getClassSize()
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

ignore 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

See Also:

• Constant Field Values

DONT_SANITIZE_NAMES

public static final int DONT_SANITIZE_NAMES

See Also:

• Constant Field Values

COMPUTE_FRAMES

public static final int COMPUTE_FRAMES

Instruct ASM to compute frames when generating class files, using ClassWriter.COMPUTE_FRAMES **EXPERIMENTAL CODE**

See Also:

• Constant Field Values

Constructor Details

DexFileReader

public DexFileReader(ByteBuffer in)

read dex from a ByteBuffer.

DexFileReader

public DexFileReader(byte[] data)

Parameters:

data - the byte array of dex

DexFileReader

public DexFileReader(File file)
              throws IOException

Parameters:

file - the dex file

Throws:

IOException

DexFileReader

public DexFileReader(Path file)
              throws IOException

Throws:

IOException

DexFileReader

public DexFileReader(InputStream is)
              throws IOException

Throws:

IOException

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(com.googlecode.d2j.visitors.DexFileVisitor dv)

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

Specified by:

accept in interface BaseDexFileReader

getClassNames

public List<String> getClassNames()

Specified by:

getClassNames in interface BaseDexFileReader

accept

public void accept(com.googlecode.d2j.visitors.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(com.googlecode.d2j.visitors.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

ignoreClass

public Boolean ignoreClass(String className)

getClassSize

public final int getClassSize()