prop-core

Dynamic properties for your Java app

License

License

GroupId

GroupId

io.pleo
ArtifactId

ArtifactId

prop-core
Last Version

Last Version

1.3.1
Release Date

Release Date

Type

Type

jar
Description

Description

prop-core
Dynamic properties for your Java app
Project URL

Project URL

http://github.com/pleo-io/prop
Source Code Management

Source Code Management

https://github.com/pleo-io/prop

Download prop-core

How to add to project

<!-- https://jarcasting.com/artifacts/io.pleo/prop-core/ -->
<dependency>
    <groupId>io.pleo</groupId>
    <artifactId>prop-core</artifactId>
    <version>1.3.1</version>
</dependency>
// https://jarcasting.com/artifacts/io.pleo/prop-core/
implementation 'io.pleo:prop-core:1.3.1'
// https://jarcasting.com/artifacts/io.pleo/prop-core/
implementation ("io.pleo:prop-core:1.3.1")
'io.pleo:prop-core:jar:1.3.1'
<dependency org="io.pleo" name="prop-core" rev="1.3.1">
  <artifact name="prop-core" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.pleo', module='prop-core', version='1.3.1')
)
libraryDependencies += "io.pleo" % "prop-core" % "1.3.1"
[io.pleo/prop-core "1.3.1"]

Dependencies

compile (1)

Group / Artifact Type Version
org.slf4j : slf4j-api jar 1.7.20

Project Modules

There are no modules declared in this project.

Prop

build-n-deploy

Pleo prop is a dynamic property library. It allows you to configure your application using properties that are not hardcoded and can be easily modified at runtime.

It is made of 4 modules that when combined give you a full, flexible and powerful solution.

Usage

If you're okay with using Guice, Archaius and Jackson, add a dependency on prop-all (Gradle):

implementation "io.pleo:prop-all:2.0.0"

All you need is to initialize the AutoPropModule by passing it all of the Guice Modules you'd like it to scan for Prop<X> dependencies.

List<Module> modules = ...
AutoPropModule autoPropModule = new AutoPropModule("io.pleo", // Package prefix
                                                   modules,
                                                   new ArchaiusPropFactory(),
                                                   new JacksonParserFactory());
modules.add(autoPropModule);
Guice.createInjector(modules);

And then you can simply add a @Named("myPropName") Prop<X> to your class, like this

public class MyServiceClient {
    private Prop<String> serviceUrl;
    
    // The @Named annotation is required. A detailed exception will be thrown when 
    // bootstrapping the Guice injector if it is missing.
    @Inject
    public MyServiceClient(@Named("service.url") Prop<String> serviceUrl) {
        this.serviceUrl = serviceUrl;
    }

    // ...
    public Health getHealth() {
        return Unirest.get(serviceUrl.get() + "/rest/health").asObject(Health.class).getBody();
    }
}

You can also use default values using the @Default annotation

public class MyThing {
    @Inject
    public MyThing(@Default("localhost"@Named("service.host") Prop<String> serviceHost) {
    ...
    }
}

You can use many type parameters for your Prop<X>. Out of the box, the following types are supported:

  • Boolean
  • Integer
  • Float
  • Double
  • BigDecimal
  • java.time.Duration
  • java.time.Instant

As well as all types that can be deserialized by Jackson.

How does it work

AutoPropModule will scan all of the modules that you provide and will find all InjectionPoints that require a Prop<X> instance.

It will determine the type parameter of the Prop<X> and dynamically generate a parser for this Prop<X>.

It will then initialize an Archaius property based on the @Named annotation and the parser.

Finally it dynamically binds this new Prop<X> instance in Guice. Guice does the rest of the magic.

The Modules

prop-core

The classes that your application will use. It has no dependencies and is extremely lightweight.

prop-guice

The Google Guice integration. Will automatically detect all Prop<X> that are required by your application and bind these to the right Prop<X> instance.

prop-archaius

The Netflix Archaius integration. Will fetch Prop<X> values using Archaius which can be configured to read properties from many many configuration repositories.

prop-jackson

The Jackson integration. Allows using serialized JSON as Prop<X> values so you can use Prop<MyComplexObject> as long as MyComplexObject can be desrialized from a JSON String.

Extending

You can easily customize the behavior of prop. The two main extension points are PropFactory and ParserFactory.

PropFactory

PropFactory takes a property name and a parse function and must return a Prop<X>. The default implementation is ArchaiusPropFactory.

ParserFactory

ParserFactory takes a java.reflect.Type and returns a java.util.Function that can transform a String into an instace of the right Type. The default implementation is JacksonParserFactory.

Other

You could easily create a prop-spring module that would dynamically add Prop<X> beans depending on what is required. Pull requests are welcome!

io.pleo

Pleo

Versions

Version
1.3.1
1.3.0
1.2.1
1.2.0
1.1.3
1.1.2-Beta1
1.1.1
1.1.0
1.0.2
1.0.1
1.0.0