Note

This project is moving to GitHub https://github.com/jOOQ/jOOR. Please obtain the sources from there!

Overview

jOOR stands for Java 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.

Dependencies

None!

Simple example

String world = on("java.lang.String") // Like Class.forName() .create("Hello World") // Call the most specific matching constructor .call("substring", 6) // Call the most specific matching substring() method .call("toString") // Call toString() .get(); // Get the wrapped object, in this case a String

Proxy abstraction

jOOR also gives access to the java.lang.reflect.Proxy API in a simple way:

``` public interface StringProxy { String substring(int beginIndex); }

String substring = on("java.lang.String") .create("Hello World") .as(StringProxy.class) // Create a proxy for the wrapped object .substring(6); // Call a proxy method ```

Comparison with standard java.lang.reflect

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); } ```

Similar projects

Everyday Java reflection with a fluent interface:

• http://docs.codehaus.org/display/FEST/Reflection+Module
• http://projetos.vidageek.net/mirror/mirror/

Reflection modelled as XPath (quite interesting!)

• http://commons.apache.org/jxpath/users-guide.html