dalvik.system.profiler

Class HprofData

java.lang.Object

dalvik.system.profiler.HprofData

public final class HprofData
extends Object

Represents sampling profiler data. Can be converted to ASCII or binary hprof-style output using AsciiHprofWriter or BinaryHprofWriter.

The data includes:

• the start time of the last sampling period
• the history of thread start and end events
• stack traces with frequency counts

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HprofData.Sample A read only container combining a stack trace with its frequency.
static class	HprofData.StackTrace A unique stack trace for a specific thread.
static class	HprofData.ThreadEvent ThreadEvent represents thread creation and death events for reporting.
static class	HprofData.ThreadEventType

Constructor Summary

Constructors

Constructor and Description
HprofData(Map<HprofData.StackTrace,int[]> stackTraces)

Method Summary

Modifier and Type	Method and Description
void	addStackTrace(HprofData.StackTrace stackTrace, int[] countCell) Record an stack trace and an associated int[] cell of sample cound for the stack trace.
void	addThreadEvent(HprofData.ThreadEvent event) Record an event in the thread history.
int	getDepth() Get the stack sampling depth
int	getFlags() Get the BinaryHprof.ControlSettings flags
Set<HprofData.Sample>	getSamples() Return a new set containing the current sample data.
long	getStartMillis() The start time in milliseconds of the last profiling period.
List<HprofData.ThreadEvent>	getThreadHistory() Return an unmodifiable history of start and end thread events.
void	setDepth(int depth) Set the stack sampling depth
void	setFlags(int flags) Set the BinaryHprof.ControlSettings flags
void	setStartMillis(long startMillis) Set the time for the start of the current sampling period.

Methods inherited from class java.lang.Object

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

Constructor Detail

HprofData

public HprofData(Map<HprofData.StackTrace,int[]> stackTraces)

Method Detail

getStartMillis

public long getStartMillis()

The start time in milliseconds of the last profiling period.

setStartMillis

public void setStartMillis(long startMillis)

Set the time for the start of the current sampling period.

getFlags

public int getFlags()

Get the BinaryHprof.ControlSettings flags

setFlags

public void setFlags(int flags)

Set the BinaryHprof.ControlSettings flags

getDepth

public int getDepth()

Get the stack sampling depth

setDepth

public void setDepth(int depth)

Set the stack sampling depth

getThreadHistory

public List<HprofData.ThreadEvent> getThreadHistory()

Return an unmodifiable history of start and end thread events.

getSamples

public Set<HprofData.Sample> getSamples()

Return a new set containing the current sample data.

addThreadEvent

public void addThreadEvent(HprofData.ThreadEvent event)

Record an event in the thread history.

addStackTrace

public void addStackTrace(HprofData.StackTrace stackTrace,
                          int[] countCell)

Record an stack trace and an associated int[] cell of sample cound for the stack trace. The caller is allowed retain a pointer to the cell to update the count. The SamplingProfiler intentionally does not present a mutable view of the count.