amaya-di

A framework responsible for monitoring and automating the dependency injection process.
It is only 1.27 times (15.829 vs 12.427) slower than manual injection! (see benchmark section).

Russian version

Philosophy

Taking into account the features of both existing implementations, and the JVM and the Java language in general, the framework was created in strict accordance with the following principles:

• Support only for new versions of java (11+)
• Complete rejection of reflective calls in the process of instantiating objects
• The minimum possible size of the framework
• The minimum possible set of dependencies
• Absence of transitive dependencies (i.e., when you get a framework, you get only it and several service libraries necessary for its operation)
• No dependencies outside the jdk (no plugins, utilities, or scripts)
• Lack of built-in integrations
• Maximum possible flexibility to adapt the framework to support specifications of any format
• Avoiding making difficult decisions (if something cannot be unambiguously determined in a finite time, it will not be determined)

Getting Started

To install it, you will need:

• java 11+
• Maven/Gradle

Installing

Gradle dependency

dependencies {
    implementation group: 'io.github.amayaframework', name: 'amaya-di', version: '2.2.0'
}

Maven dependency

<dependency>
    <groupId>io.github.amayaframework</groupId>
    <artifactId>amaya-di</artifactId>
    <version>2.2.0</version>
</dependency>

Usage example

Important: the order of transferring services to the builder does NOT matter, no changes and no exceptions will occur, the ServiceProviderBuilder#build() method has not been called yet.

Hello, world!

import io.github.amayaframework.di.ProviderBuilders;

public class Main {
    public static void main(String[] args) {
        var provider = ProviderBuilders
                .createChecked()
                .addInstance("Hello, world!")
                .build();
        System.out.println(provider.get(String.class));
    }
}

Two services and a dependent class

import io.github.amayaframework.di.ProviderBuilders;

public class Main {
    public static void main(String[] args) {
        var provider = ProviderBuilders
                .createChecked()
                .addTransient(Service1.class)
                .addSingleton(Service2.class)
                .addTransient(App.class)
                .build();
        System.out.println(provider.get(App.class));
        System.out.println(provider.get(App.class));
    }

    public static final class Service1 {
        @Override
        public String toString() {
            return "Service1, " + hashCode();
        }
    }

    public static final class Service2 {
        @Override
        public String toString() {
            return "Service2, " + hashCode();
        }
    }

    public static final class App {
        final Service1 s1;
        final Service2 s2;

        public App(Service1 s1, Service2 s2) {
            this.s1 = s1;
            this.s2 = s2;
        }

        @Override
        public String toString() {
            return "hash=" + hashCode() + "\ns1=" + s1 + "\ns2=" + s2;
        }
    }
}

This code will output:

hash=1852584274
s1=Service1, 280744458
s2=Service2, 377478451
hash=394714818
s1=Service1, 1952779858
s2=Service2, 377478451

Generics

import io.github.amayaframework.di.ProviderBuilders;
import com.github.romanqed.jtype.JType;

import java.util.List;

public class Main {
    public static void main(String[] args) {
        var provider = ProviderBuilders
                .createChecked()
                .addInstance(new JType<>(){}, List.of("Hi", "World"))
                .addInstance(new JType<>(){}, List.of(1, 2, 3))
                .addTransient(App.class)
                .build();
        System.out.println(provider.get(App.class));
    }

    public static final class App {
        final List<String> s1;
        final List<Integer> s2;

        public App(List<String> s1, List<Integer> s2) {
            this.s1 = s1;
            this.s2 = s2;
        }

        @Override
        public String toString() {
            return "hash=" + hashCode() + "\ns1=" + s1 + "\ns2=" + s2;
        }
    }
}

Output:

hash=1354011814
s1=[Hi, World]
s2=[1, 2, 3]

Fields, methods, multiple constructors

import io.github.amayaframework.di.ProviderBuilders;

public class Main {
    public static void main(String[] args) {
        var provider = ProviderBuilders
                .createChecked()
                .addTransient(Service1.class)
                .addTransient(Service2.class)
                .addTransient(Service3.class)
                .addTransient(Service4.class)
                .addTransient(App.class)
                .build();
        System.out.println(provider.get(App.class).s1);
    }

    public static final class Service1 {
    }

    public static final class Service2 {
    }

    public static final class Service3 {
    }

    public static final class Service4 {
    }

    public static final class App {
        @Inject
        public Service1 s1;

        public App() {
            System.out.println("Empty ctor");
        }

        @Inject
        public App(Service2 s2) {
            System.out.println("Service2=" + s2);
        }

        @Inject
        public void setService3(Service3 s3) {
            System.out.println("Service3=" + s3);
        }

        @Inject
        public static void setService4(App app, Service4 s4) {
            System.out.println("App=" + app + ", Service4=" + s4);
        }
    }
}

Output:

Service2=io.github.amayaframework.di.Main$Service2@9660f4e
App=io.github.amayaframework.di.Main$App@396f6598, Service4=io.github.amayaframework.di.Main$Service4@394e1a0f
Service3=io.github.amayaframework.di.Main$Service3@27a5f880
io.github.amayaframework.di.Main$Service1@1d29cf23

Missing dependency

import io.github.amayaframework.di.ProviderBuilders;

import java.util.List;

public class Main {
    public static void main(String[] args) {
        try {
            var provider = ProviderBuilders
                    .createChecked()
                    .addTransient(App.class)
                    .build();
            System.out.println(provider.get(App.class));
        } catch (TypeNotFoundException e) {
            System.out.println(e.getType() + " not found");
        }
    }

    public static final class App {
        final List<String> s1;
        final List<Integer> s2;

        public App(List<String> s1, List<Integer> s2) {
            this.s1 = s1;
            this.s2 = s2;
        }

        @Override
        public String toString() {
            return "hash=" + hashCode() + "\ns1=" + s1 + "\ns2=" + s2;
        }
    }
}

Output:

java.util.List<java.lang.String> not found

Cyclical dependency

import io.github.amayaframework.di.ProviderBuilders;

public class Main {
    public static void main(String[] args) {
        try {
            var provider = ProviderBuilders
                    .createChecked()
                    .addTransient(Service.class)
                    .addTransient(App.class)
                    .build();
            System.out.println(provider.get(App.class));
        } catch (CycleFoundException e) {
            System.out.println("Found cycle: " + e.getCycle());
        }
    }

    public static final class Service {
        public Service(App app) {
        }
    }

    public static final class App {
        public App(Service s) {
        }
    }
}

Output:

Found cycle: [class io.github.amayaframework.di.Main$App, class io.github.amayaframework.di.Main$Service]

Benchmark

See jmh benchmark. Running on your machine:

gradle jmh

Results:

# JMH version: 1.36
# VM version: JDK 11.0.22, OpenJDK 64-Bit Server VM, 11.0.22+7-LTS
# VM invoker: ~/.jdks/corretto-11.0.22/bin/java.exe

Benchmark                                      Mode  Cnt   Score   Error  Units
ServiceProviderBenchmark.benchAmayaInjection   avgt   25  15,829 ± 1,685  ns/op
ServiceProviderBenchmark.benchManualInjection  avgt   25  12,427 ± 0,930  ns/op

Built With

• Gradle - Dependency management
• ASM - Generation of proxy classes
• jeflect - Defining classes from bytecode, utilities for ASM
• jfunc - "Lazy" containers, functional interfaces, utilities
• jtype - Utilities for interaction with generic types

Authors

• RomanQed - Main work

See also the list of contributors who participated in this project.

License

This project is licensed under the Apache License Version 2.0 - see the LICENSE file for details