elopteryx / bean-mirror

Modern reflection library.

Bean Mirror

Bean Mirror is a fluent, type-safe reflection library for the latest Java versions.

Features

• Fluent API
• Type-safe
• Modularized
• Lightweight, no dependencies

Requirements

Versions	Min JVM
2.0.0	17
1.1.0	11

Motivation

There are several reflection based libraries which allow the developers to easily manipulate objects during runtime. What separates this library is that it uses the newer API (java.lang.invoke) which allows faster code if used properly, compared to the classic java.lang.reflect package.

Because several additions have been added in Java 9 setting the minimum required Java version to anything lower is not feasible (it would not make sense to create another library, which would not be any different from the existing ones).

The project was inspired by jOOR. If you are using an older Java I suggest using that instead.

Examples

        // Get the name of the school principal by field access
        final String principalName = BeanMirror.of(school, MethodHandles.lookup())
                .field("principal", Principal.class)
                .get("name", String.class);

        // Create a setter function to set the value on any instance
        final BiConsumer<Student, Integer> setter = BeanMirror.of(Student.class, MethodHandles.lookup())
                .createSetter("startingYear", Integer.class);

        setter.accept(student, 2018);
        setter.accept(otherStudent, 2020);

Documentation

Javadoc

Gradle

implementation 'com.github.elopteryx:bean-mirror:2.0.0'

Maven

<dependency>
    <groupId>com.github.elopteryx</groupId>
    <artifactId>bean-mirror</artifactId>
    <version>2.0.0</version>
</dependency>

Find available versions on Maven Central Repository.

bean-mirror's Issues

No Licence

This Project has no license. Please consider adding one.