software.amazon.disco.agent.interception

Interface Installable

All Known Implementing Classes:

DataAccessor

public interface Installable

DiSCo interceptions are broken apart by category e.g. Web, AWS, concurrency support, etc. This interface describes a hook which can be installed, and all DiSCo support 'plugins' adhere to it

Method Summary

Modifier and Type	Method and Description
default void	handleArguments(java.util.List<java.lang.String> args) Given a list of command line arguments, handle them in whatever way makes sense for the implementing class.
net.bytebuddy.agent.builder.AgentBuilder	install(net.bytebuddy.agent.builder.AgentBuilder agentBuilder) Install the necessary hooks for this piece of DiSCo functionality.
default java.util.List<InstallationError>	verifyEffect() Verify that one or more classes appear instrumented as intended by this Installable.

Method Detail

install

net.bytebuddy.agent.builder.AgentBuilder install(net.bytebuddy.agent.builder.AgentBuilder agentBuilder)

Install the necessary hooks for this piece of DiSCo functionality.

Parameters:

agentBuilder - - an AgentBuilder to append instructions to

Returns:

- the same AgentBuilder instance, for continuation/chaining, or null to prevent installation of the agentBuilder, in case the Installable instance does not require this instrumentation to take place.

handleArguments

default void handleArguments(java.util.List<java.lang.String> args)

Given a list of command line arguments, handle them in whatever way makes sense for the implementing class. This should ultimately be deprecated in favor of a more structured API, where the key-value pairs are expressed in a structured form, instead of expecting Installables to parse a list of raw strings.

Parameters:

args - command line arguments in the form ["key1=value1", "key2=value2,value3", "value4"]

verifyEffect

default java.util.List<InstallationError> verifyEffect()

Verify that one or more classes appear instrumented as intended by this Installable. May cause those classes to be loaded if they weren't loaded before.

Returns:

A list of installation errors that describes all the problems found.