org.evomaster.client.java.controller

Class EmbeddedSutController

java.lang.Object

org.evomaster.client.java.controller.internal.SutController

org.evomaster.client.java.controller.EmbeddedSutController

All Implemented Interfaces:

CustomizationHandler, SutHandler

public abstract class EmbeddedSutController
extends SutController

Main class used to implement an EvoMaster Driver. A user that wants to use EvoMaster for white-box testing will need to implement this abstract class.

For full details on how to implement this class, look at the documentation for Write an EvoMaster Driver for White-Box Testing, currently at https://github.com/WebFuzzing/EvoMaster/blob/master/docs/write_driver.md

Constructor Summary

Constructors

Constructor and Description
EmbeddedSutController()

Method Summary

Modifier and Type	Method and Description
void	bootingSut(boolean bootingSut) specify whether the SUT is booting (ie starting up), or not.
List<AdditionalInfo>	getAdditionalInfoList()
BootTimeInfoDto	getBootTimeInfoDto()
String	getExecutableFullPath()
void	getJvmDtoSchema(List<String> dtoNames)
List<TargetInfo>	getTargetInfos(Collection<Integer> ids, boolean fullyCovered, boolean descriptiveIds)
UnitsInfoDto	getUnitsInfoDto()
boolean	isInstrumentationActivated() Check if bytecode instrumentation is on.
void	newActionSpecificHandler(ActionDto dto)
void	newScheduleActionSpecificHandler(ScheduleTaskInvocationDto dto)
void	newSearch() Re-initialize all internal data to enable a completely new search phase which should be independent from previous ones
void	newTestSpecificHandler()
void	setExecutingAction(boolean executingAction)
void	setExecutingInitMongo(boolean executingInitMongo)
void	setExecutingInitSql(boolean executingInitSql)
void	setKillSwitch(boolean b)
void	setupForGeneratedTest() There might be different settings based on when the SUT is run during the search of EvoMaster, and when it is later started in the generated tests.

Methods inherited from class org.evomaster.client.java.controller.internal.SutController

addSuccessfulInitSqlInsertion, addTableToInserted, categorizeBasedOnResponse, cleanAccessedTables, computeExtraHeuristics, computeMongoHeuristics, customizeMockingDatabase, customizeMockingRPCExternalService, customizeRPCTestOutput, customizeScheduleTaskInvocation, deriveObjectParameterData, doEmploySmartDbClean, enableComputeSqlHeuristicsOrExtractExecution, execInsertionsIntoDatabase, execInsertionsIntoMongoDatabase, executeAction, executeHandleLocalAuthenticationSetup, executeRPCEndpoint, extractRPCProblemDto, extractRPCSchema, extractSqlDbSchemaAndConstraints, getActionIndex, getBootTimeInfoDto, getConnection, getConnectionIfExist, getControllerHost, getControllerPort, getControllerServerPort, getCustomizedValueInRequests, getDatabaseDriverName, getExceptionImportanceLevels, getExtraHeuristics, getInfoForAuthentication, getLocalAuthSetupSchemaMap, getPackagePrefixesToCover, getPreferredOutputFormat, getProblemInfo, getRPCClient, getRPCSchema, getSqlDatabaseSchema, getUnitsInfoDto, handleSeededTests, initMongoHandler, initSqlHandler, invokeScheduleTasks, invokeScheduleTaskWithCustomizedHandling, isScheduleTaskCompleted, isSutRunning, mockDatabasesWithCustomizedHandling, mockRPCExternalServicesWithCustomizedHandling, newAction, newScheduleAction, newTest, packagesToSkipInstrumentation, postSearchAction, readFileAsStringFromTestResource, registerOrExecuteInitSqlCommandsIfNeeded, registerOrExecuteInitSqlCommandsIfNeeded, resetCustomizedMethodForMockObject, resetDatabase, resetExtraHeuristics, seedRPCTests, setControllerHost, setControllerPort, specifyCustomizedNotNullAnnotation, startTheControllerServer, stopTheControllerServer, verifySqlConnection

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.evomaster.client.java.controller.SutHandler

getDbSpecifications, getMongoConnection, handleLocalAuthenticationSetup, resetStateOfSUT, startSut, stopSut

Constructor Detail

EmbeddedSutController

public EmbeddedSutController()

Method Detail

setupForGeneratedTest

public final void setupForGeneratedTest()

Description copied from interface: SutHandler

There might be different settings based on when the SUT is run during the search of EvoMaster, and when it is later started in the generated tests.

isInstrumentationActivated

public final boolean isInstrumentationActivated()

Description copied from class: SutController

Check if bytecode instrumentation is on.

Specified by:

isInstrumentationActivated in class SutController

Returns:

true if the instrumentation is on

newSearch

public final void newSearch()

Description copied from class: SutController

Re-initialize all internal data to enable a completely new search phase which should be independent from previous ones

Specified by:

newSearch in class SutController

newTestSpecificHandler

public final void newTestSpecificHandler()

Specified by:

newTestSpecificHandler in class SutController

getTargetInfos

public final List<TargetInfo> getTargetInfos(Collection<Integer> ids,
                                             boolean fullyCovered,
                                             boolean descriptiveIds)

Specified by:

getTargetInfos in class SutController

getAdditionalInfoList

public final List<AdditionalInfo> getAdditionalInfoList()

Specified by:

getAdditionalInfoList in class SutController

Returns:

additional info for each action in the test. The list is ordered based on the action index.

newActionSpecificHandler

public final void newActionSpecificHandler(ActionDto dto)

Specified by:

newActionSpecificHandler in class SutController

newScheduleActionSpecificHandler

public final void newScheduleActionSpecificHandler(ScheduleTaskInvocationDto dto)

Specified by:

newScheduleActionSpecificHandler in class SutController

getUnitsInfoDto

public final UnitsInfoDto getUnitsInfoDto()

Specified by:

getUnitsInfoDto in class SutController

setKillSwitch

public final void setKillSwitch(boolean b)

Specified by:

setKillSwitch in class SutController

setExecutingInitSql

public final void setExecutingInitSql(boolean executingInitSql)

Specified by:

setExecutingInitSql in class SutController

setExecutingInitMongo

public final void setExecutingInitMongo(boolean executingInitMongo)

Specified by:

setExecutingInitMongo in class SutController

setExecutingAction

public final void setExecutingAction(boolean executingAction)

Specified by:

setExecutingAction in class SutController

getBootTimeInfoDto

public BootTimeInfoDto getBootTimeInfoDto()

Specified by:

getBootTimeInfoDto in class SutController

getExecutableFullPath

public final String getExecutableFullPath()

Specified by:

getExecutableFullPath in class SutController

getJvmDtoSchema

public final void getJvmDtoSchema(List<String> dtoNames)

Specified by:

getJvmDtoSchema in class SutController

bootingSut

public final void bootingSut(boolean bootingSut)

Description copied from class: SutController

specify whether the SUT is booting (ie starting up), or not. this is needed because we don't want to handle targets covered at startup during the fitness evaluations

Specified by:

bootingSut in class SutController