JarCasting
hydromatic-resource
Compiler-checked wrappers around resource and property files.
An example
This example shows how you can create a wrapper around some resources and properties. Suppose you have a properties file birthday.properties:
com.example.likes.cake=true
com.example.favorite.cake.flavor=Chocolate
and a resource bundle with resources in English in com/example/BirthdayResource_en_US.properties:
HappyBirthday=Happy birthday, {0}! You don't look {1,number}.
TooOld={0}, you're too old for cake!
and resources in French in com/example/BirthdayResource_fr_FR.properties:
HappyBirthday=Bon anniversaire, {0}! {1,number}, quel bon âge.
Write the following interface as a wrapper:
interface Birthday {
@BaseMessage("Happy birthday, {0}! You don't look {1,number}.")
Inst happyBirthday(String name, int age);
@BaseMessage("{0} is too old.")
ExInst<RuntimeException> tooOld(String name);
@BaseMessage("Have some {0} cake.")
Inst haveSomeCake(String flavor);
@Default("false")
@Resource("com.example.likes.cake")
BoolProp likesCake();
@Resource("com.example.favorite.cake.flavor")
StringProp cakeFlavor();
@Default("10")
IntProp maximumAge();
}
Now you can materialize the wrapper based on the resource bundle and properties file:
Birthday birthday = Resources.create("com.example.BirthdayResource",
"birthday.properties", Birthday.class);
and use it in a program:
void celebrate(String name, int age) {
if (age > birthday.maximumAge().get()) {
throw birthday.tooOld(name).ex();
}
System.out.println(birthday.happyBirthday(name, age).str());
if (birthday.likesCake()) {
System.out.println(birthday.haveSomeCake(birthday.cakeFlavor()).str());
}
}
Note that some resources and properties do not occur in the files. The @BaseMessage and @Default annotations supply default values. In the case of resources, Java's resource mechanism inherits resources from more general locales: for instance, US English ('en_US') inherits from English ('en').
The wrapper converts properties to the right type, substitutes parameters, validates that localized resources have the same number and type of parameters as the base message, and creates exceptions for error conditions.
Resources inherit the JVM's locale, but you can override for the current thread:
Resources.setThreadLocale(locale);
and even on the resource instance:
throw birthday.tooOld("Fred").localize(locale).ex();
Get hydromatic-resource
From Maven
Get hydromatic-resource from Maven Central:
<dependency>
<groupId>net.hydromatic</groupId>
<artifactId>hydromatic-resource-maven-plugin</artifactId>
<version>0.6</version>
</dependency>
Download and build
You need Java (1.6 or higher; 9 preferred), git and maven (3.2.1 or later).
$ git clone git://github.com/julianhyde/hydromatic-resource.git
$ cd hydromatic-resource
$ mvn package
Make a release
Using JDK 1.7, follow instructions in hydromatic-parent.
More information
- License: Apache License, Version 2.0
- Author: Julian Hyde
- Blog: http://julianhyde.blogspot.com
- Project page: http://www.hydromatic.net/hydromatic-resource
- Source code: http://github.com/julianhyde/hydromatic-resource
- Developers list: dev at calcite.apache.org (archive, subscribe)
- Release notes and history