jOOR stands for jOOR Object Oriented Reflection. It is a simple wrapper for the java.lang.reflect package.
jOOR's name is inspired by jOOQ, a fluent API for SQL building and execution.
None!
For use with Java 9+
<dependency>
<groupId>org.jooq</groupId>
<artifactId>joor</artifactId>
<version>0.9.14</version>
</dependency>
For use with Java 8+
<dependency>
<groupId>org.jooq</groupId>
<artifactId>joor-java-8</artifactId>
<version>0.9.14</version>
</dependency>
For use with Java 6+
<dependency>
<groupId>org.jooq</groupId>
<artifactId>joor-java-6</artifactId>
<version>0.9.14</version>
</dependency>
// All examples assume the following static import:
import static org.joor.Reflect.*;
String world = onClass("java.lang.String") // Like Class.forName()
.create("Hello World") // Call most specific matching constructor
.call("substring", 6) // Call most specific matching substring() method
.call("toString") // Call toString()
.get(); // Get the wrapped object, in this case a String
jOOR also gives access to the java.lang.reflect.Proxy API in a simple way:
public interface StringProxy {
String substring(int beginIndex);
}
String substring = onClass("java.lang.String")
.create("Hello World")
.as(StringProxy.class) // Create a proxy for the wrapped object
.substring(6); // Call a proxy method
jOOR has an optional dependency on the java.compiler
module and simplifies access to javax.tools.JavaCompiler
through the following API:
Supplier<String> supplier = Reflect.compile(
"com.example.HelloWorld",
"package com.example;\n" +
"class HelloWorld implements java.util.function.Supplier<String> {\n" +
" public String get() {\n" +
" return \"Hello World!\";\n" +
" }\n" +
"}\n").create().get();
// Prints "Hello World!"
System.out.println(supplier.get());
jOOR code:
Employee[] employees = on(department).call("getEmployees").get();
for (Employee employee : employees) {
Street street = on(employee).call("getAddress").call("getStreet").get();
System.out.println(street);
}
The same example with normal reflection in Java:
try {
Method m1 = department.getClass().getMethod("getEmployees");
Employee[] employees = (Employee[]) m1.invoke(department);
for (Employee employee : employees) {
Method m2 = employee.getClass().getMethod("getAddress");
Address address = (Address) m2.invoke(employee);
Method m3 = address.getClass().getMethod("getStreet");
Street street = (Street) m3.invoke(address);
System.out.println(street);
}
}
// There are many checked exceptions that you are likely to ignore anyway
catch (Exception ignore) {
// ... or maybe just wrap in your preferred runtime exception:
throw new RuntimeException(e);
}
Everyday Java reflection with a fluent interface:
Reflection modelled as XPath (quite interesting!)