JarCastinglsd-interceptors 
A central library for interceptors that can be used with yatspec-lsd (aka living sequence diagrams).
The interceptors capture interactions that flow in and out of the App during tests so that they can be added to the TestState bean used by the yatspec-lsd framework to generate sequence diagrams.
Autoconfig
This library is designed with @SpringBootTest in mind and attempts to minimise boilerplate code by wiring up default bean configurations based on the beans and classes available in the project.
The interceptors can be used outside of a spring project but will require some manual setup. The classes in the com/nickmcdowall/lsd/interceptor/autoconfigure package would be a good starting point for examples on how to configure the interceptors when autowiring is not an option.
To disable autoconfig so that the beans can be used in another library add the following property:
yatspec.lsd.interceptors.autoconfig.enabled=false
Available Interceptors
LsdRestTemplateInterceptor
If a TestState bean exists and a RestTemplate class is on the classpath then a RestTemplateCustomizer bean will be loaded into the default RestTemplateBuilder bean.
This causes an interceptor to be injected along with a BufferingClientHttpRequestFactory to allow for multiple reads of the response stream (to avoid breaking the chain on additional reads).
- Don't instantiate a
RestTemplatebean using the default constructor (or else you won't get the interceptor and factory out the box), avoid:
// Wrong
@Bean
public RestTemplate restTemplate(){
return new RestTemplate();
}
instead use a RestTemplateBuilder bean which will provide a correctly configured bean:
// Correct
@Bean
public RestTemplate restTemplate(RestTemplateBuilder builder){
return builder.build();
}
TestRestTemplatebeans just need to be@Autowiredinto your tests and will be instantiated and configured for you.
LsdFeignLoggerInterceptor
- For
Feignclients - Auto configured if a
TestStatebean exists and bothFeignClientBuilderandLogger.Levelclasses are on the classpath. Note that if no feignLogger.Levelbean exists one will be created (Logger.Level.BASIC) to enable the interceptor to work. If one exists it will not be replaced.
LsdOkHttpInterceptor
- For
OkHttpClientclients. - Auto configured if
TestStateandOkHttpClient.Builderbeans exists and has spring propertyyatspec.lsd.interceptors.autoconfig.okhttp.enabled=true(requires explicit property to prevent clashing withLsdFeignLoggerInterceptor- as it is a popular client implementation forFeignand the former interceptor should work across all Feign client implementations).
Spring AOP
Another option is to use Spring AOP for intercepting calls - e.g. if you want to capture method calls to any method in YourClass that takes one argument you may have something like this in your acceptance/component tests (requires spring aop dependencies):
@Aspect
@Component
@EnableAspectJAutoProxy
public class YourClassLsdInterceptor {
@Before("execution(* com.your.package.YourClass.*(*) && args(yourArg))")
public void captureEvents(JoinPoint joinpoint, Object yourArg) {
var methodName = joinpoint.getSignature().getName();
var yourArgType = yourArg.getClass().getSimpleName();
testState.log(methodName + "( " + yourArgType + " ) from A to B", yourArg);
}
}
(Additional interceptors and auto configuration will be added over time).
Naming
Source Name
If you set the property info.app.name then this will be used as the default source name for interactions captured on the sequence diagrams. (i.e. your app is calling downstream services)
This can be overridden by setting the Source-Name http header on a request. For example if you want to create a client that represents a user calling into your app say from within a test then you can set the Source-Name header value to the name of the user.
If neither are set then the library will default to the value App.
Destination Name
Set the Target-Name header value to control the name of the destination service of an interaction on the sequence diagrams.
If this header is not set the library will attempt to derive a destination name based on the path of the http request.
Build/Release
Requirements
JDK
- Java 11
IDE
- Lombok plugin and enable annotation processing
./gradlew clean build
Release
Run script
./release.sh