Reflecting Objects

REFLECTO

Overview

The Cariochi Reflecto library simplifies Java reflection, allowing developers to access and manipulate object fields, invoke methods, and work with collections in a more intuitive way. Below are examples demonstrating the core functionalities of Reflecto.

Example Usage

Initial Object for Examples

Bug bug = Bug.builder()
        .id(1)
        .summary("Invalid value")
        .reporter(new User(100, "qa"))
        .watchers(new ArrayList<>(List.of(
                new User(101, "developer"),
                new User(102, "manager")
        )))
        .details(new HashMap<>(Map.of(
                "Sprint", new Details("SPR-001"),
                "Component", new Details("Authorization")
        )))
        .build();

Methods

List<TargetMethod> methods = Reflecto.reflect(bug).methods().list();

User reporter = Reflecto.reflect(bug).methods().find("getReporter()")
    .map(TargetMethod::invoke)
    .map(User.class::cast)
    .orElseThrow();
    
Reflecto.reflect(bug).methods().find("setReporter(?)", User.class)
    .ifPresent(method -> method.invoke(reporter));    

Fields

List<TargetField> fields = Reflecto.reflect(bug).fields().list();

User reporter = Reflecto.reflect(bug).fields().find("reporter")
    .map(TargetField::getValue)
    .map(User.class::cast)
    .orElseThrow();
    
Reflecto.reflect(bug).fields().find("reporter")
    .ifPresent(field -> field.setValue(reporter));

Simple Field Access and Modification

// Getting Value

String username = Reflecto.reflect(bug)
        .reflect("reporter.username")
        .getValue();

String username = Reflecto.reflect(bug)
        .invoke("reporter.username");
        
// Setting Value

Reflecto.reflect(bug)
        .reflect("reporter.username")
        .setValue("new_name");

Reflecto.reflect(bug)
        .invoke("reporter.username=?", "new_name");

Working with Lists/Arrays

// Getting Value

String username = Reflecto.reflect(bug)
        .reflect("watchers[0].username")
        .getValue();

String username = Reflecto.reflect(bug)
        .reflect("watchers[?].username", 0)
        .getValue();
        
String username = Reflecto.reflect(bug)
        .invoke("watchers[0].username");
        
String username = Reflecto.reflect(bug)
        .invoke("watchers[?].username", 0);
        
// Setting Value

Reflecto.reflect(bug)
        .reflect("watchers[0]")
        .setValue(new User("user4"));

Reflecto.reflect(bug)
        .reflect("watchers[?]", 0)
        .setValue(new User("user4"));
        
Reflecto.reflect(bug)
        .invoke("watchers[0]=?", new User("user4"));
        
Reflecto.reflect(bug)
        .invoke("watchers[?]=?", 0, new User("user4"));

Working with Maps

// Getting Value

String sprint = Reflecto.reflect(bug)
        .reflect("details[Sprint].text")
        .getValue();
        
String sprint = Reflecto.reflect(bug)
        .reflect("details[?].text", "Sprint")
        .getValue();
        
String sprint = Reflecto.reflect(bug)
        .invoke("details[Sprint].text");
        
String sprint = Reflecto.reflect(bug)
        .invoke("details[?].text", "Sprint");
        
// Setting Value

Reflecto.reflect(bug)
        .reflect("details[Sprint]")
        .setValue(new Details("SPR-002"));

Reflecto.reflect(bug)
        .reflect("details[?]", "Sprint")
        .setValue(new Details("SPR-002"));
        
Reflecto.reflect(bug)
        .invoke("details[Sprint]=?", new Details("SPR-002"));
        
Reflecto.reflect(bug)
        .invoke("details[?]=?", "Sprint", new Details("SPR-002"));

Invoking Methods

String username = Reflecto.reflect(bug)
        .reflect("getWatchers().get(?).getUsername()", 0)
        .getValue();

Reflecto.reflect(bug)
        .invoke("getWatchers().get(?).setUsername(?)", 0, "new_name");
        
Reflecto.reflect(bug)
        .invoke("getDetails().remove(?)", "Sprint");
        
Reflecto.reflect(bug)
        .invoke("getDetails().put(?, ?)", "Sprint", new Details("SPR-002"));

Mixed Usage

String username = Reflecto.reflect(bug)
        .reflect("watchers[0].getUsername()")
        .getValue();

String username = Reflecto.reflect(bug)
        .reflect("watchers[?].getUsername()", 0)
        .getValue();
        
String username = Reflecto.reflect(bug)
        .reflect("getWatchers()[0].getUsername()")
        .getValue();
        
String username = Reflecto.reflect(bug)
        .reflect("getWatchers()[?].getUsername()", 0)
        .getValue();

Reflecto.reflect(bug)
        .invoke("getWatchers().get(?).username=?", 0, "new_name");
        
Reflecto.reflect(bug)
        .invoke("details[Sprint].setText(?)", "SPR-002");
        
Reflecto.reflect(bug)
        .invoke("details[?].setText(?)", "Sprint", "SPR-002");