Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ljacqu/dependencyinjector
Lightweight dependency injector
https://github.com/ljacqu/dependencyinjector
application-initializer dependency dependency-injection injection injector ioc ioc-container java
Last synced: about 2 months ago
JSON representation
Lightweight dependency injector
- Host: GitHub
- URL: https://github.com/ljacqu/dependencyinjector
- Owner: ljacqu
- License: mit
- Created: 2016-06-20T17:11:24.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-18T05:50:34.000Z (about 2 months ago)
- Last Synced: 2024-12-18T06:43:11.862Z (about 2 months ago)
- Topics: application-initializer, dependency, dependency-injection, injection, injector, ioc, ioc-container, java
- Language: Java
- Size: 660 KB
- Stars: 32
- Watchers: 3
- Forks: 3
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## Lightweight Dependency Injector
[](https://travis-ci.org/ljacqu/DependencyInjector)
[](https://coveralls.io/github/ljacqu/DependencyInjector?branch=master)
[](http://www.javadoc.io/doc/ch.jalu/injector)
[](https://codeclimate.com/github/ljacqu/DependencyInjector)
Simple but customizable dependency injector for Java 1.8 and above.
### Why use it
- Very lightweight (only has `javax.inject` and `javax.annotation-api` as dependency)
- Allows gradual transition to injection for existing projects
- You can implement your own injection methods and behaviors
- Support for projects with optional dependencies
### Integrating it
Using Maven, you can get the injector by adding this to your pom.xml:
```xml
ch.jalu
injector
1.0
```
### Simple example
By default, the injector supports **constructor injection** and **field injection**.
Consider the following class skeletons:
```java
public class Settings {
// regular class
}
public class Messages {
private File messagesFile;
@Inject
Messages(Settings settings) {
messagesFile = new File(settings.getLanguage() + ".txt");
}
}
public class CalculationService {
@Inject
private Messages messages;
@Inject
private RoundingService roundingService;
}
public class RoundingService {
private int precision;
@Inject
RoundingService(Settings settings) {
precision = settings.getPrecision();
}
}
```
At the startup of the application, we might only care about getting an instance of `CalculationService`. All other
classes are required by it to run, but we don't immediately care about them. With the injector, we don't have to
deal with those classes and can just retrieve what we actually want:
```java
public class MyApp {
public static void main(String... args) {
Injector injector = new InjectorBuilder().addDefaultHandlers("com.example.my.project").create();
CalculationService calcService = injector.getSingleton(CalculationService.class);
calcService.performCalculation();
}
}
```
... That's all! No need to deal with creating any other classes, but you still have a setup that allows you to easily
unit test or switch a component.
--> Full, runnable example can be found [here](https://github.com/ljacqu/DependencyInjector/tree/master/injector/src/test/java/ch/jalu/injector/demo).
### Handlers
You may implement your own logic to instantiate classes and resolve dependencies. This allows you, for example, to
implement specific behavior for custom annotations.
Read more on the Wiki: [Handlers explained](https://github.com/ljacqu/DependencyInjector/wiki/Handlers)