© Excellent backgrounds/Shutterstock.com
Teil 2: SPI: Basics, Rundungen und Währungen

Go for the Money


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...

headline from sands settings