org.evomaster.client.java.controller.problem.rpc

Class RPCEndpointsBuilder

java.lang.Object

org.evomaster.client.java.controller.problem.rpc.RPCEndpointsBuilder

public class RPCEndpointsBuilder
extends Object

created by manzhang on 2021/11/4

Constructor Summary

Constructors

Constructor and Description
RPCEndpointsBuilder()

Method Summary

Modifier and Type	Method and Description
static InterfaceSchema	build(String interfaceName, RPCType rpcType, Object client, List<String> skipEndpointsByName, List<String> skipEndpointsByAnnotation, List<String> involveEndpointsByName, List<String> involveEndpointsByAnnotation, List<AuthenticationDto> authenticationDtoList, List<CustomizedRequestValueDto> customizedRequestValueDtos, List<CustomizedNotNullAnnotationForRPCDto> notNullAnnotations)
static void	buildExternalServiceResponse(InterfaceSchema schema, List<String> responseTypes, RPCType rpcType) attempt to identify class from the given client
static Map<Integer,LocalAuthSetupSchema>	buildLocalAuthSetup(List<AuthenticationDto> authenticationDtoList) build the local auth setup
static List<List<RPCActionDto>>	buildSeededTest(Map<String,InterfaceSchema> rpcInterfaceSchema, List<SeededRPCTestDto> seedRPCTests, RPCType rpcType)
static void	validateCustomizedNotNullAnnotationForRPCDto(List<CustomizedNotNullAnnotationForRPCDto> notNullAnnotations) validate specified notNullAnnotations
static void	validateCustomizedValueInRequests(List<CustomizedRequestValueDto> customizedRequestValueDtos) validate CustomizedRequestValueDto, eg, 1) for any CustomizedRequestValueDto, keyValuePairs and keyValues could not be specified or null at the same time 2) for keyValuePairs, if annotationOnEndpoint or specificEndpointName or specificRequestTypeName are specified, they should have consistent keys 3) keyValues with respect to any specific annotationOnEndpoint or specificEndpointName or specificRequestTypeName should be specified only one time

Methods inherited from class java.lang.Object

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

Constructor Detail

RPCEndpointsBuilder

public RPCEndpointsBuilder()

Method Detail

validateCustomizedValueInRequests

public static void validateCustomizedValueInRequests(List<CustomizedRequestValueDto> customizedRequestValueDtos)

validate CustomizedRequestValueDto, eg, 1) for any CustomizedRequestValueDto, keyValuePairs and keyValues could not be specified or null at the same time 2) for keyValuePairs, if annotationOnEndpoint or specificEndpointName or specificRequestTypeName are specified, they should have consistent keys 3) keyValues with respect to any specific annotationOnEndpoint or specificEndpointName or specificRequestTypeName should be specified only one time

Parameters:

customizedRequestValueDtos - are customized info to be checked

validateCustomizedNotNullAnnotationForRPCDto

public static void validateCustomizedNotNullAnnotationForRPCDto(List<CustomizedNotNullAnnotationForRPCDto> notNullAnnotations)

validate specified notNullAnnotations

Parameters:

notNullAnnotations - are specified customized annotation representing if any field of RPC dto is required

buildExternalServiceResponse

public static void buildExternalServiceResponse(InterfaceSchema schema,
                                                List<String> responseTypes,
                                                RPCType rpcType)

attempt to identify class from the given client

Parameters:

schema - is the interface schema which might request the responses from the external service

responseTypes - are a list of types to identify

rpcType - is the rpc type

build

public static InterfaceSchema build(String interfaceName,
                                    RPCType rpcType,
                                    Object client,
                                    List<String> skipEndpointsByName,
                                    List<String> skipEndpointsByAnnotation,
                                    List<String> involveEndpointsByName,
                                    List<String> involveEndpointsByAnnotation,
                                    List<AuthenticationDto> authenticationDtoList,
                                    List<CustomizedRequestValueDto> customizedRequestValueDtos,
                                    List<CustomizedNotNullAnnotationForRPCDto> notNullAnnotations)

Parameters:

interfaceName - the name of interface

rpcType - is the type of RPC, e.g., gRPC, Thrift

client - is the corresponding client to maniplute the interface

skipEndpointsByName - specifies a list of names of endpoints to be skipped during testing

skipEndpointsByAnnotation - specifies a list of annotations applied on endpoints that could be skipped during testing

involveEndpointsByName - specifies a list of names of endpoints to be involved during testing

involveEndpointsByAnnotation - specifies a list of annotations applied on endpoints that are involved during testing

authenticationDtoList - specifies a list of authentication info

customizedRequestValueDtos - specifies a list of candidate values in requests

Returns:

an interface schema for evomaster to access

buildLocalAuthSetup

public static Map<Integer,LocalAuthSetupSchema> buildLocalAuthSetup(List<AuthenticationDto> authenticationDtoList)

build the local auth setup

Parameters:

authenticationDtoList - a list of auth info specified by user

Returns:

a map of such local auth setup key - index at a list of auth info specified by user value - local endpoint

buildSeededTest

public static List<List<RPCActionDto>> buildSeededTest(Map<String,InterfaceSchema> rpcInterfaceSchema,
                                                       List<SeededRPCTestDto> seedRPCTests,
                                                       RPCType rpcType)