Les agents java permettent d’observer et de modifier des programmes exécutés sur une JVM. Bien que présents depuis le JDK 1.5, ils sont très peu utilisés hormis par des outils avancés comme New Relic, JProfiler ou JRebel. A travers un exemple concret, on verra sur quels principes les agents se reposent et comment en créer un facilement. L'exemple est un java agent qui permet de visualiser dans un navigateur web des conteneurs d'injection de dependances (Spring, CDI, Dagger, and Guice). L'instrumentation du byte code est faite grace a Byte Buddy (http://bytebuddy.net/). Source code : https://github.com/YoannBuch/DependencyInjectionAgent Fait par l'equipe de http://findtheflow.io, un outil qui permet d'analyser et visualiser des executions d'applications Java.

1. Java Agent
en Action
Source: http://blog.takipi.com/double-agent-java-vs-native-agents/

2. Qui sommes nous ?
➔ 2 développeurs
➔ Lancent une entreprise autour d’outils de développement
http://findtheflow.io
➔ Focalisent sur la visualisation et analyse des exécutions de programmes
➔ Utilisent un java agent
Yoann Buch & Yiquan Zhou

3. Java Agents
JRebel
JProfiler
Plumbr
New Relic
AppDynamics
Dynatrace
DripStat
Chronon
Jacoco
Takipi
XRebel
VisualVM
Cobertura
Le votre ?
YourKit

4. > java -jar application.jar

5. > java -jar -javaagent:agent.jar application.jar

6. Mission : créer un outil de développement
➔Spring
➔CDI
➔Dagger
➔Guice
Visualiser des conteneurs
d’injection de dépendances

7. Par où commencer ?
class CustomerController {
@Inject
public CustomerController(
ShoppingService shoppingService) {
...
}
}
class CustomerController {
@Inject
public CustomerController(
ShoppingService shoppingService) {
// DependencyGraph.addDependency(this, shoppingService);
…
}
}

8. Démo

9. Récap
➔Très simple de créer un java agent
➔Instrumentation du byte code simplifiée grâce à ASM, Byte Buddy, etc.
➔Pas limité qu’au profiling
➔Pas limité qu’à l’instrumentation du byte code
➔Non-intrusif

10. Source code can be found on http://findtheflow.io

11. Java Agent - Hello World
public class DIAgent {
public static void premain(
String args,
Instrumentation instrumentation) {
System.out.println("Hello World from Agent");
}
}

12. Java Agent - Hello World

13. Java Agent - Instrumentation du byte code
instrumentation.addTransformer(new ClassFileTransformer() {
@Override
public byte[] transform(
ClassLoader loader,
String className,
Class<?> classBeingRedefined,
ProtectionDomain protectionDomain,
byte[] classfileBuffer) throws IllegalClassFormatException {
// Return modified or unchanged classfileBuffer
return classfileBuffer;
}
});

14. Java Agent - Byte Buddy
new AgentBuilder.Default().type(getTypeMatchers()).transform(new Transformer() {
@Override
public Builder<?> transform(Builder<?> builder, TypeDescription typeDescription) {
return builder
.invokable(isAnnotatedWith(named(INJECT_ANNOTATION))
.or(isAnnotatedWith(named(AUTOWIRED_ANNOTATION))))
.intercept(SuperMethodCall.INSTANCE
.andThen(MethodDelegation.to(InjectionInterceptor.class)));
}
}).installOn(instrumentation);

15. Java Agent - Byte Buddy
public class InjectionInterceptor {
public static void intercept(
@This Object currentInstance,
@AllArguments Object[] injectedInstances) {
DependencyGraphService.addDependency(currentInstance,
injectedInstances);
}
}

16. Java Agent - Byte Buddy

17. Java Agent - Serveur Web embarque
public static void premain(String args, Instrumentation instrumentation) {
System.out.println("Hello World from Agent");
startWebServer();
transformClasses(instrumentation);
}