OWNER :: Core

Get rid of the boilerplate code in Java properties based configuration.

License

License

Categories

Categories

owner Application Layer Libs Configuration
GroupId

GroupId

org.aeonbits.owner
ArtifactId

ArtifactId

owner
Last Version

Last Version

1.0.12
Release Date

Release Date

Type

Type

jar
Description

Description

OWNER :: Core
Get rid of the boilerplate code in Java properties based configuration.
Project Organization

Project Organization

Luigi R. Viggiano
Source Code Management

Source Code Management

https://github.com/lviggiano/owner/tree/master/owner

Download owner

How to add to project

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

Dependencies

test (4)

Group / Artifact Type Version
org.hamcrest : hamcrest-all jar 1.3
junit : junit jar 4.12
org.mockito : mockito-core jar 2.23.4
commons-codec : commons-codec jar 1.11

Project Modules

There are no modules declared in this project.

OWNER

OWNER, an API to ease Java property files usage.

Build Status Coverage Status security status stability status Built with Maven

DONATIONS

Your support, is the acknowledgment of the value of this work and helps it running and improving. Donations are welcome.

Donate bitcoin:1DARNDYjjKhNF8j2DFwT3zrtUsMQvV2am1
bitcoin:1DARNDYjjKhNF8j2DFwT3zrtUsMQvV2am1

Donate with PayPal

Thank you!

INTRODUCTION

The goal of OWNER API is to minimize the code required to handle application configuration through Java properties files.

Full documentation available on project website.

BASIC USAGE

The approach used by OWNER APIs, is to define a Java interface associated to a properties file.

Suppose your properties file is defined as ServerConfig.properties:

port=80
hostname=foobar.com
maxThreads=100

To access this property you need to define a convenient Java interface in ServerConfig.java:

public interface ServerConfig extends Config {
    int port();
    String hostname();
    int maxThreads();
}

We'll call this interface the Properties Mapping Interface or just Mapping Interface since its goal is to map Properties into a an easy to use piece of code.

Then, you can use it from inside your code:

public class MyApp {
    public static void main(String[] args) {
        ServerConfig cfg = ConfigFactory.create(ServerConfig.class);
        System.out.println("Server " + cfg.hostname() + ":" + cfg.port() +
                           " will run " + cfg.maxThreads());
    }
}

But this is just the tip of the iceberg.

Continue reading here: Basic usage.

DOWNLOAD

Public Releases can be downloaded from GitHub Releases page or Maven Central Repository.

DOCUMENTATION

Make sure to have a look at the documentation on project website to learn how flexible and powerful OWNER is, and why you may need it!

Chinese documentation is provided by Yunfeng Cheng via a GitHub independent project at this address.

LICENSE

OWNER is released under the BSD license. See LICENSE file included for the details.

Versions

Version
1.0.12
1.0.11
1.0.10
1.0.9
1.0.8
1.0.7
1.0.6
1.0.5.1
1.0.5
1.0.4.1
1.0.4
1.0.3.1
1.0.3
1.0.2