The simple, stupid properties library for Java™
Orginal project link: link
- 15/11/2020: Version 4.0.0 is now released! You can find all details about the changes in the release notes.
Easy Props is a library to inject configuration properties in Java objects declaratively using annotations.
Let's see a quick example. Suppose you have an object of type Bean
which should be configured with:
- An Integer property
threshold
from a system property passed to the JVM with-Dthreshold=100
- A String property
bean.name
from a properties file namedmyProperties.properties
To load these properties in the Bean
object using Easy Props, you annotate fields as follows:
public class Bean {
@Property(source = "myProperties.properties", key = "bean.name")
private String beanName;
@SystemProperty(value = "threshold", defaultValue = "50")
private int threshold;
//getters and setters omitted
}
and instruct the library to inject these properties in the annotated fields:
//Instantiate your object
Bean bean = new Bean();
//Create a PropertiesInjector and inject properties in your object
aNewPropertiesInjector().injectProperties(bean);
That's it! Easy Props will:
- introspect the
Bean
instance looking for fields annotated with@Property
and@SystemProperty
- convert each property value to the target field's type
- and inject that value into the annotated field
You can also configure your object at construction time:
public class Bean {
@Property(source = "myProperties.properties", key = "bean.name")
private String beanName;
@SystemProperty(value = "threshold", defaultValue = "50")
private int threshold;
public Bean () {
aNewPropertiesInjector().injectProperties(this);
}
//getters and setters omitted
}
Now just create your object and it will be configured and ready to use.
Dependency injection frameworks allow you to inject properties in Java objects and they do it well. But in order to benefit from this feature, your code should run inside a DI container, or at least, the object in which you are trying to inject properties must be managed by a DI container. What if your code does not run inside a DI container? This is where Easy Props comes to play, to allow you to benefit from properties injection without requiring your code to run inside a DI container.
- Lightweight library with no dependencies
- Type safe access to configuration properties
- Declarative configuration with intuitive annotations
- Ability to inject properties from custom configuration sources
- Ability to hot reload configuration automatically at runtime
- Ability to manage configuration at runtime via JMX
You are welcome to contribute to the project with pull requests on GitHub.
If you found a bug or want to request a feature, please use the issue tracker.
Thank you all for your contributions!
Easy Props is released under the terms of the MIT license:
The MIT License (MIT)
Copyright (c) 2020 Mahmoud Ben Hassine ([email protected])
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.