javax.measure.spi

Class ServiceProvider

java.lang.Object

javax.measure.spi.ServiceProvider

public abstract class ServiceProvider
extends Object

Service Provider for Units of Measurement services.

All the methods in this class are safe for use by multiple concurrent threads.

Version:

0.9.3, July 2, 2016

Author:

Werner Keil, Martin Desruisseaux

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ServiceProvider() Creates a new service provider.

Method Summary

Methods

Modifier and Type	Method and Description
static List<ServiceProvider>	available() Returns the list of available service providers.
static ServiceProvider	current() Returns the current ServiceProvider.
int	getPriority() This method allows to define a priority for a registered ServiceProvider instance.
abstract <Q extends Quantity<Q>> QuantityFactory<Q>	getQuantityFactory(Class<Q> quantity) Return a factory for this Quantity.
abstract SystemOfUnitsService	getSystemOfUnitsService() Returns the service to obtain a SystemOfUnits, or null if none.
abstract UnitFormatService	getUnitFormatService() Returns the service to obtain a UnitFormat, or null if none.
static ServiceProvider	setCurrent(ServiceProvider provider) Replaces the current ServiceProvider.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServiceProvider

protected ServiceProvider()

Creates a new service provider. Only to be used by subclasses.

Method Detail

getPriority

public int getPriority()

This method allows to define a priority for a registered ServiceProvider instance. When multiple providers are registered in the system the provider with the highest priority value is taken.

Returns:

the provider's priority (default is 0).

getSystemOfUnitsService

public abstract SystemOfUnitsService getSystemOfUnitsService()

Returns the service to obtain a SystemOfUnits, or null if none.

Returns:

the service to obtain a SystemOfUnits, or null.

getUnitFormatService

public abstract UnitFormatService getUnitFormatService()

Returns the service to obtain a UnitFormat, or null if none.

Returns:

the service to obtain a UnitFormat, or null.

getQuantityFactory

public abstract <Q extends Quantity<Q>> QuantityFactory<Q> getQuantityFactory(Class<Q> quantity)

Return a factory for this Quantity.

Parameters:

quantity - the quantity

Returns:

the QuantityFactory

available

public static List<ServiceProvider> available()

Returns the list of available service providers.

Returns:

all available service providers.

current

public static ServiceProvider current()

Returns the current ServiceProvider. If necessary the ServiceProvider will be lazily loaded.

Returns:

the ServiceProvider used.

Throws:

IllegalStateException - if no ServiceProvider has been found.

setCurrent

public static ServiceProvider setCurrent(ServiceProvider provider)

Replaces the current ServiceProvider.

Parameters:

provider - the new ServiceProvider

Returns:

the removed provider, or null.