JSR 354 definiert nicht nur ein API, sondern auch ein mächtiges Service Provider Interface (SPI), das es erlaubt, praktisch alle Funktionen den jeweiligen Bedürfnissen in einer Unternehmung anzupassen. Die Expertengruppe diskutierte über Monate hinweg teilweise sehr kontrovers diese Unabhängigkeit des API. Das heute vorliegende Design hat sich zwar erst in der Schlussphase des JSR durchgesetzt, es hat sich aber in der Praxis bewährt.
Die Struktur des JSR 354 lässt sich in eine Matrix, bestehend aus vier Schichten und den drei funktionalen Bereichen, zerlegen (Tabelle 1). Die Schichten sind:
-
Die API-Schicht, die von den Benutzern aufgerufen wird.
-
Die API Singletons, eines je funktionalem Bereich: Monetary, MonetaryConversions, MonetaryFormats. Diese delegieren Aufrufe an die Singleton-SPI-Schicht (die entsprechenden Schnittstellen enden auf SingletonSpi).
-
Die Singleton-SPI-Schicht wiederum verwaltet und orchestriert das Provider-SPI, das kleinere, abgegrenzte Funktionen implementiert, z. B. bestimmte Formate, Konversionen oder die Zurverfügungstellung von Währungen.
Schlussendlich ist auch das Komponenten-Lifecycle-Management nicht fest codiert, um so unterschiedliche Umgebungen wie Java SE und OSGI oder auch CDI/Java EE unterstützen zu können. Diese Funktionalität wird von allen anderen Komponenten genutzt.
|
Schicht\Funktionalität |
Core |
Konversion |
Formatierung |
|---|---|---|---|
|
API-Singletons |
javax.money.Monetary |
javax.money.conversion.MonetaryConversions |
javax.money.format.MonetaryFormats |
|
API-Singleton-SPI (javax.money.spi) |
MonetaryAmountsSingletonSpi MonetaryAmountsSingletonQuerySpi MonetaryCurrenciesSingletonSpi MonetaryRounsingsSingletonSpi |
MonetaryConversionsSingletonSpi |
MonetaryFormatsSingletonSpi |
|
Provider-SPI |
MonetaryAmountFactoryProviderSpi CurrencyProviderSpi RoundingProviderSpi |
javax.money.conversion.ExchangeRateProvider |
MonetaryAmountFormatProviderSpi |
|
Lifecycle-Management |
javax.money.spi.Bootstrap, javax.money.spi.ServiceProvider | ||
Tabelle 1: Die Struktur des JSR
Betrachten wir zunächst die Klasse javax.money.Monetary, die den Einstiegspunkt für Geldbeträge, Währungen und Rundungen modelliert. In Listing 1 ist gut zu erkennen, wie Methodenaufrufe an das entsprechende Singleton-SPI delegiert werden. Die SPI-Implementierungen werden dabei über die Bootstrap-Komponente beim Laden der Singleton-Klasse einmalig geladen und gecacht (Listing 2 und Listing 3). Dieses Muster wird bei allen Singletons angewendet. Wenn also ein Verhalten angepasst oder erweitert werden soll, muss man theoretisch nichts anderes tun als die Singleton-SPI-Schnittstelle zu implementieren und im Bootstrap zu registrieren. Normalerweise ist das aber nicht notwendig, da die Implementierung des Provider-SPI in den meisten Fällen genügt sowie einfacher und schlanker ist. In diesem Artikel werden wir die core-Funktionen des JSR (zugreifbar über die Klasse Monetary) näher betrachten. Die Schnittstellen für die Bereiche Konversion und Formatierung werden im nächsten Artikel behandelt. Bevor wir aber starten, sehen wir uns noch den Bootstrap-Mechanismus an.
Listing 1
public static Set<String> getRoundingProviderNames() {
return Optional.ofNullable(MONETARY_ROUNDINGS_SINGLETON_SPI)
.orElseThrow(
) -> new MonetaryException(
"No MonetaryRoundingsSpi loaded, query functionality is not available.")
.getProviderNames();
}Listing 2
private static MonetaryCurrenciesSingletonSpi
loadMonetaryCurrenciesSingletonSpi() {
try {
return Optional.ofNullable(Bootstrap
.getService(MonetaryCurrenciesSingletonSpi.class))
.orElseGet(DefaultMonetaryCurrenciesSingletonSpi::new);
} catch (Exception e) {
Logger.getLogger(Monetary.class.getName())
.log(Level.INFO,
"Failed to load MonetaryCurrenciesSingletonSpi, using default.", e);
return new DefaultMonetaryCurrenciesSingletonSpi();
}
}Listing 3
public final class Monetary {
private static final MonetaryCurrenciesSingletonSpi
MONETARY_CURRENCIES_SINGLETON_SPI =
loadMonetaryCurrenciesSingletonSpi();
private static final MonetaryAmountsSingletonSpi
MONETARY_AMOUNTS_SINGLETON_SPI =
loadMonetaryAmountsSingletonSpi();
private static final MonetaryAmountsSingletonQuerySpi
MONETARY_AMOUNTS_SINGLETON_QUERY_SPI =
loadMonetaryAmountsSingleto...
