Package org.eclipse.steady.java.monitor.trace

Class TraceCollector

java.lang.Object

org.eclipse.steady.java.monitor.trace.TraceCollector

public class TraceCollector
extends Object

Offers callback methods used by the two trace instrumentors SingleTraceInstrumentor and StackTraceInstrumentor. Prepares and uploads trace information to the backend and triggers the analysis of JAR files.

Method Summary

Modifier and Type	Method	Description
void	addTrace(ConstructId _id, ClassLoader _class_loader, URL _url, String _archive_digest, String _app_groupid, String _app_artifactid, String _app_version, Map<String,Serializable> _params)	addTrace.
void	awaitUpload()	awaitUpload.
static boolean	callbackClinit(String _qname, ClassLoader _class_loader, URL _url, String _archive_digest, String _app_groupid, String _app_artifactid, String _app_version, Map<String,Serializable> _params)	Callback method for instrumented class constructors.
static boolean	callbackConstructor(String _qname, ClassLoader _class_loader, URL _url, String _archive_digest, String _app_groupid, String _app_artifactid, String _app_version, Map<String,Serializable> _params)	Callback method for instrumented class constructors.
static boolean	callbackMethod(String _qname, ClassLoader _class_loader, URL _url, String _archive_digest, String _app_groupid, String _app_artifactid, String _app_version, Map<String,Serializable> _params)	Callback method for instrumented class methods.
static TraceCollector	getInstance()	Getter for the field instance.
Map<String,Long>	getStatistics()	getStatistics.
void	uploadInformation(AbstractGoal _exe, int batchSize)	uploadInformation.
void	uploadPaths(int _batch_size)	Upload _batch_size paths gathered from stack trace information (all if _batch_size is negative).

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static TraceCollector getInstance()

Getter for the field instance.

Returns:

a TraceCollector object.

callbackMethod

public static boolean callbackMethod(String _qname,
                                     ClassLoader _class_loader,
                                     URL _url,
                                     String _archive_digest,
                                     String _app_groupid,
                                     String _app_artifactid,
                                     String _app_version,
                                     Map<String,Serializable> _params)

Callback method for instrumented class methods.

Parameters:

_qname - the qualified name of the method or constructor instrumented, thus, performing the callback

_archive_digest - the SHA1 digest of the original JAR archive (optional, must be added to the class during offline instrumentation)

_app_groupid - the Maven group Id of the application context (optional, can be added to the class during offline instrumentation)

_app_artifactid - the Maven artifact Id of the application context (optional, see above)

_app_version - the Maven version of the application context (optional, see above)

_class_loader - a ClassLoader object.

_url - a URL object.

_params - a Map object.

Returns:

a boolean.

callbackConstructor

public static boolean callbackConstructor(String _qname,
                                          ClassLoader _class_loader,
                                          URL _url,
                                          String _archive_digest,
                                          String _app_groupid,
                                          String _app_artifactid,
                                          String _app_version,
                                          Map<String,Serializable> _params)

Callback method for instrumented class constructors.

Parameters:

_qname - the qualified name of the method or constructor instrumented, thus, performing the callback

_archive_digest - the SHA1 digest of the original JAR archive (optional, must be added to the class during static instrumentation)

_app_groupid - the Maven group Id of the application context (optional, can be added to the class during static instrumentation)

_app_artifactid - the Maven artifact Id of the application context (optional, see above)

_app_version - the Maven version of the application context (optional, see above)

_class_loader - a ClassLoader object.

_url - a URL object.

_params - a Map object.

Returns:

a boolean.

callbackClinit

public static boolean callbackClinit(String _qname,
                                     ClassLoader _class_loader,
                                     URL _url,
                                     String _archive_digest,
                                     String _app_groupid,
                                     String _app_artifactid,
                                     String _app_version,
                                     Map<String,Serializable> _params)

Callback method for instrumented class constructors.

Parameters:

_qname - the qualified name of the method or constructor instrumented, thus, performing the callback

_archive_digest - the SHA1 digest of the original JAR archive (optional, must be added to the class during static instrumentation)

_app_groupid - the Maven group Id of the application context (optional, can be added to the class during static instrumentation)

_app_artifactid - the Maven artifact Id of the application context (optional, see above)

_app_version - the Maven version of the application context (optional, see above)

_class_loader - a ClassLoader object.

_url - a URL object.

_params - a Map object.

Returns:

a boolean.

addTrace

public void addTrace(ConstructId _id,
                     ClassLoader _class_loader,
                     URL _url,
                     String _archive_digest,
                     String _app_groupid,
                     String _app_artifactid,
                     String _app_version,
                     Map<String,Serializable> _params)

addTrace.

Parameters:

_id - a ConstructId object.

_class_loader - a ClassLoader object.

_url - a URL object.

_archive_digest - a String object.

_app_groupid - a String object.

_app_artifactid - a String object.

_app_version - a String object.

_params - a Map object.

uploadInformation

public void uploadInformation(AbstractGoal _exe,
                              int batchSize)

uploadInformation.

Parameters:

_exe - a AbstractGoal object.

batchSize - a int.

awaitUpload

public void awaitUpload()

awaitUpload.

uploadPaths

public void uploadPaths(int _batch_size)

Upload _batch_size paths gathered from stack trace information (all if _batch_size is negative).

Parameters:

_batch_size - a int.

getStatistics

public Map<String,Long> getStatistics()

getStatistics.

Returns:

a Map object.