cn.sissors.hummingbird.runtime.timer

Class TimerManager

java.lang.Object

cn.sissors.hummingbird.runtime.timer.TimerManager

public class TimerManager
extends Object

TimerManager is a convenient tool to manage Timer.

In TimerManager, timers are identified by name. Timers with the same name are merged into the same group to support aggregation function. Besides, it contains a series of methods to manage the lifecycle of timer.

Version:

2019-04-02

Author:

zyz

Constructor Summary

Constructors

Constructor and Description
TimerManager()

Method Summary

Modifier and Type	Method and Description
static Long	agg(String name, TimerAggregation function) Get the aggregation value of a group of timers.
static Long	agg(TimerAggregation function) Get the aggregation value of the default group of timers.
static Timer	create() Create a timer with an empty name and start after creation.
static Timer	create(String name) Create a timer with a given name and start after creation.
static Timer	createWithoutStart(String name) Create a timer with a given name.
static String	format() Format the time with the default name into human readable style .
static String	format(long time) Format the time with the specified name into human readable style .
static String	format(String name) Format the time with the specified name into human readable style .
static Timer	getFirstTimer() Get the oldest created timer with the default name.
static Timer	getFirstTimer(String name) Get the oldest created timer with the specified name.
static Timer	getLastTimer() Get the newest created timer with the default name.
static Timer	getLastTimer(String name) Get the newest created timer with the specified name.
static List<Timer>	getTimerGroup() Get the group of timers with the default name.
static List<Timer>	getTimerGroup(String name) Get the group of timers with the specified name.
static Timer	start() Start a timer with the default name EMPTY_NAME.
static Timer	start(String name) Start a timer with the specified name.
static Timer	stop() Stop a timer with the default name EMPTY_NAME.
static Timer	stop(String name) Stop a timer with the specified name.
static Long	time() Get recorded time of a timer with the default name.
static Long	time(String name) Get recorded time of a timer with the specified name.

Methods inherited from class java.lang.Object

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

Constructor Detail

TimerManager

public TimerManager()

Method Detail

create

public static Timer create()

Create a timer with an empty name and start after creation.

Returns:

a timer

create

public static Timer create(String name)

Create a timer with a given name and start after creation.

Parameters:

name - the name of timer

Returns:

a timer

createWithoutStart

public static Timer createWithoutStart(String name)

Create a timer with a given name.

Parameters:

name - the name of timer

Returns:

a timer

start

public static Timer start()

Start a timer with the default name EMPTY_NAME.

Returns:

the recorded time of the timer

start

public static Timer start(String name)

Start a timer with the specified name.

Parameters:

name - the specified name

Returns:

the recorded time of the timer

stop

public static Timer stop()

Stop a timer with the default name EMPTY_NAME.

Returns:

the recorded time of the timer

stop

public static Timer stop(String name)

Stop a timer with the specified name.

Parameters:

name - the specified name

Returns:

the recorded time of the timer

time

public static Long time()

Get recorded time of a timer with the default name.

Returns:

the recorded time of the timer

time

public static Long time(String name)

Get recorded time of a timer with the specified name.

Parameters:

name - the specified name

Returns:

the recorded time of the timer

format

public static String format()

Format the time with the default name into human readable style .

The default format is HH:mm:ss.SSS

Returns:

the string in human readable style

format

public static String format(String name)

Format the time with the specified name into human readable style .

The default format is HH:mm:ss.SSS

Parameters:

name - the specified name

Returns:

the string in human readable style

format

public static String format(long time)

Format the time with the specified name into human readable style .

The default format is HH:mm:ss.SSS

Parameters:

time - the time

Returns:

the string in human readable style

getLastTimer

public static Timer getLastTimer()

Get the newest created timer with the default name.

Returns:

the newest created timer

getLastTimer

public static Timer getLastTimer(String name)

Get the newest created timer with the specified name.

Parameters:

name - the specified name

Returns:

the newest created timer

getFirstTimer

public static Timer getFirstTimer()

Get the oldest created timer with the default name.

Returns:

the oldest created timer

getFirstTimer

public static Timer getFirstTimer(String name)

Get the oldest created timer with the specified name.

Parameters:

name - the specified name

Returns:

the oldest created timer

getTimerGroup

public static List<Timer> getTimerGroup()

Get the group of timers with the default name.

Returns:

the group of timers with the same name

getTimerGroup

public static List<Timer> getTimerGroup(String name)

Get the group of timers with the specified name.

Parameters:

name - the specified name

Returns:

the group of timers with the same name

agg

public static Long agg(TimerAggregation function)

Get the aggregation value of the default group of timers.

Parameters:

function - aggregation function defined in TimerAggregation

Returns:

the aggregation result

agg

public static Long agg(String name,
                       TimerAggregation function)

Get the aggregation value of a group of timers.

Parameters:

name - the specified name of group

function - aggregation function defined in TimerAggregation

Returns:

the aggregation result