org.evomaster.client.java.controller

Interface SutHandler

All Known Implementing Classes:

EmbeddedSutController, ExternalSutController, SutController

public interface SutHandler

Base interface used to control the System Under Test (SUT) from the generated tests. Needed base functionalities are for example, starting/stopping the SUT, and reset its state.

Method Summary

Modifier and Type	Method and Description
InsertionResultsDto	execInsertionsIntoDatabase(List<InsertionDto> insertions, InsertionResultsDto... previous) Execute the given data insertions into the database (if any)
default Object	executeRPCEndpoint(String json) execute an RPC endpoint with evomaster driver
default void	extractRPCSchema() execute an RPC endpoint with evomaster driver
default Object	getRPCClient(String interfaceName) return an instance of a client of an RPC service.
default boolean	handleLocalAuthenticationSetup(String authenticationInfo) authentication setup might be handled locally.
void	resetStateOfSUT() Make sure the SUT is in a clean state (eg, reset data in database).
default 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.
String	startSut() Start a new instance of the SUT.
void	stopSut() Stop the SUT.

Method Detail

setupForGeneratedTest

default 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.

startSut

String startSut()

Start a new instance of the SUT.

This method must be blocking until the SUT is initialized.

How this method is implemented depends on the library/framework in which the application is written. For example, in Spring applications you can use something like: SpringApplication.run()

Returns:

the base URL of the running SUT, eg "http://localhost:8080"

stopSut

void stopSut()

Stop the SUT.

How to implement this method depends on the library/framework in which the application is written. For example, in Spring applications you can save in a variable the ConfigurableApplicationContext returned when starting the application, and then call stop() on it here.

resetStateOfSUT

void resetStateOfSUT()

Make sure the SUT is in a clean state (eg, reset data in database).

A possible (likely very inefficient) way to implement this would be to call stopSUT followed by startSUT.

When dealing with databases, you can look at the utility functions from the class DbCleaner. How to access the database depends on the application. To access a java.sql.Connection, in Spring applications you can use something like: ctx.getBean(JdbcTemplate.class).getDataSource().getConnection().

execInsertionsIntoDatabase

InsertionResultsDto execInsertionsIntoDatabase(List<InsertionDto> insertions,
                                               InsertionResultsDto... previous)

Execute the given data insertions into the database (if any)

Parameters:

insertions - DTOs for each insertion to execute

previous - an array of insertion results which were executed before this execution

Returns:

insertion execution results

getRPCClient

default Object getRPCClient(String interfaceName)

return an instance of a client of an RPC service.

This method must be blocking until the SUT is initialized.

This method is only required when the problem is RPC for the moment, otherwise return null

might change string interfaceName to class interface

Parameters:

interfaceName - a full name of an interface

Returns:

a client which could send requests to the interface

executeRPCEndpoint

default Object executeRPCEndpoint(String json)
                           throws Exception

execute an RPC endpoint with evomaster driver

Parameters:

json - contains info of an RPC endpoint

Returns:

value returned by this execution. it is nullable.

Throws:

Exception

extractRPCSchema

default void extractRPCSchema()

execute an RPC endpoint with evomaster driver

TODO remove this later if we do not use test generation with driver

handleLocalAuthenticationSetup

default boolean handleLocalAuthenticationSetup(String authenticationInfo)

authentication setup might be handled locally. then we provide this interface to define it.

Parameters:

authenticationInfo - info for the authentication setup

Returns:

if the authentication is set up successfully