Package org.gradle.profiler

Interface ProfilerController

public interface ProfilerController

Field Summary

Fields

Modifier and Type	Field	Description
static final ProfilerController	EMPTY

Method Summary

Modifier and Type	Method	Description
void	startRecording()	Tells the profiler to start collecting data (again).
void	startSession()	Connects the profiler to the daemon and does any other one-time setup work.
void	stopRecording(String pid)	Tells the profiler to stop collecting data for now, e.g.
void	stopSession()	Ends the profiling session, writing the collected results to disk and disconnecting the profiler from the daemon.

Field Details

EMPTY

static final ProfilerController EMPTY

Method Details

startSession

void startSession()
           throws IOException,
InterruptedException

Connects the profiler to the daemon and does any other one-time setup work. The profiler should not start collecting data yet. If the profiler cannot connect without starting data collection, it should defer startup to startRecording() instead.

Throws:

IOException

InterruptedException

startRecording

void startRecording()
             throws IOException,
InterruptedException

Tells the profiler to start collecting data (again). Profilers may chose to throw an exception if they don't support multiple start/stop operations.

Throws:

IOException

InterruptedException

stopRecording

void stopRecording(String pid)
            throws IOException,
InterruptedException

Tells the profiler to stop collecting data for now, e.g. so it doesn't profile cleanup tasks. If the data collection can only be stopped by stopping the session, the profiler should implement this as a no-op and throw an exception when startRecording() is called another time.

Throws:

IOException

InterruptedException

stopSession

void stopSession()
          throws IOException,
InterruptedException

Ends the profiling session, writing the collected results to disk and disconnecting the profiler from the daemon.

Throws:

IOException

InterruptedException