com_atlassian_clover

Class Clover

java.lang.Object

com_atlassian_clover.Clover

public final class Clover
extends Object

user-accessible runtime control for Clover

Field Summary

Fields

Modifier and Type	Field and Description
static int	NO_SLICE
static String	SECURITY_EXCEPTION_MSG

Method Summary

Modifier and Type	Method and Description
static void	allRecordersFlush()
static void	allRecordersSliceEnd(String type, String method, String runtimeTestName, int slice, int p, ErrorInfo ei) Remebmer to update RpcMessage.METHODS if you change method signature.
static void	allRecordersSliceStart(String type, int slice, long startTime) Remebmer to update RpcMessage.METHODS if you change method's signature.
static CoverageRecorder	createRecorder(String dbName, long dbVersion, long cfgbits, int maxNumElements, CloverProfile profile, CloverProperties properties) This is only public for CompilationCombinationTest#recordExecution
static int	getCurrentSlice()
static long	getCurrentSliceStart()
static int	getCurrentTestRunID()
static String	getCurrentType()
static ErrorInfo	getErrorInfo(Throwable t)
static CoverageRecorder	getNullRecorder()
static CoverageRecorder	getRecorder(String initChars, long dbVersion, long cfgbits, int maxNumElements, CloverProfile[] profiles, String[] nvpProperties)
static String	getRecordingName(int hash, String dbname, long timestamp) Generate a unique file name for recording snapshot.
static String	getSliceRecordingName(int typeid, int methodID, int runID, int hash, String dbname, long timestamp) Generate a unique file name for test slice recording snapshot.
static int	getTypeID(String runtimeType)
static void	globalFlush() tell all reachable Clover recorders to flush
static boolean	hasRecorded()
static boolean	isInitialised()
static void	l(String m)
static void	l(String m, Throwable t)
static void	resetRecorders() For testing purposes only
static String	stackTraceFor(Throwable throwable)

Methods inherited from class java.lang.Object

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

Field Detail

NO_SLICE

public static final int NO_SLICE

See Also:

Constant Field Values

SECURITY_EXCEPTION_MSG

public static final String SECURITY_EXCEPTION_MSG

See Also:

Constant Field Values

Method Detail

isInitialised

public static boolean isInitialised()

globalFlush

public static void globalFlush()

tell all reachable Clover recorders to flush

getCurrentSlice

public static int getCurrentSlice()

getCurrentType

public static String getCurrentType()

getCurrentSliceStart

public static long getCurrentSliceStart()

getCurrentTestRunID

public static int getCurrentTestRunID()

getRecorder

public static CoverageRecorder getRecorder(String initChars,
                                           long dbVersion,
                                           long cfgbits,
                                           int maxNumElements,
                                           CloverProfile[] profiles,
                                           String[] nvpProperties)

getTypeID

public static int getTypeID(String runtimeType)

resetRecorders

public static void resetRecorders()

For testing purposes only

hasRecorded

public static boolean hasRecorded()

Returns:

whether any coverage recording has been attempted

allRecordersFlush

public static void allRecordersFlush()

allRecordersSliceStart

public static void allRecordersSliceStart(String type,
                                          int slice,
                                          long startTime)

Remebmer to update RpcMessage.METHODS if you change method's signature.

allRecordersSliceEnd

public static void allRecordersSliceEnd(String type,
                                        String method,
                                        String runtimeTestName,
                                        int slice,
                                        int p,
                                        ErrorInfo ei)

Remebmer to update RpcMessage.METHODS if you change method signature.

createRecorder

public static CoverageRecorder createRecorder(String dbName,
                                              long dbVersion,
                                              long cfgbits,
                                              int maxNumElements,
                                              CloverProfile profile,
                                              CloverProperties properties)

This is only public for CompilationCombinationTest#recordExecution

getRecordingName

public static String getRecordingName(int hash,
                                      String dbname,
                                      long timestamp)

Generate a unique file name for recording snapshot. See com.atlassian.clover.recorder.RecordingTranscripts#STD_REC_SUFFIX - regexp for recording name

Parameters:

hash - unique hash identifying the coverage recorder

dbname - base name of the clover database (used as prefix)

timestamp - snapshot timestamp

Returns:

String generated file name

getSliceRecordingName

public static String getSliceRecordingName(int typeid,
                                           int methodID,
                                           int runID,
                                           int hash,
                                           String dbname,
                                           long timestamp)

Generate a unique file name for test slice recording snapshot. See com.atlassian.clover.recorder.RecordingTranscripts#SLICE_SUFFIX - regexp for slice recording name

Parameters:

typeid - the runtime type id of the slice

methodID - test method identified

runID - number of test run of the method

hash - unique hash identifying the coverage recorder

dbname - base name of the clover database (used as prefix)

timestamp - snapshot timestamp

Returns:

String generated file name

l

public static void l(String m)

l

public static void l(String m,
                     Throwable t)

getErrorInfo

public static ErrorInfo getErrorInfo(Throwable t)

Returns:

an ErrorInfo holding the message and stactrace of Throwable t. *

getNullRecorder

public static CoverageRecorder getNullRecorder()

stackTraceFor

public static String stackTraceFor(Throwable throwable)