Package tech.units.tck.util

Interface ServiceConfiguration

public interface ServiceConfiguration

Libraries that implement this JSR and want to be tested with this TCK must implement this interface and register it using the ServiceLoader.

Since:

1.0

Version:

1.2, May 12, 2019

Author:

Werner Keil

Method Summary

Modifier and Type	Method	Description
Collection<javax.measure.Dimension>	getBaseDimensions()	This method returns the base dimensions to be tested for requirements and recommendations.
Collection<Class>	getDimensionClasses()	List a collection of Dimension implementations.
Collection<Class>	getPrefixClasses()	List a collection of Prefix implementations.
Collection<Class>	getQuantityClasses()	Return a collection with all Quantity classes that are implemented.
Collection<javax.measure.format.QuantityFormat>	getQuantityFormats4Test()	This method allows instances of QuantityFormat to be tested for requirements and recommendations.
Collection<Class<? extends javax.measure.Quantity>>	getSupportedQuantityTypes()	Return a collection with all supported Quantity types.
<Q extends javax.measure.Quantity<Q>> javax.measure.Unit<Q>	getUnit4Type(Class<Q> quantityType)	Returns a matching unit for the specified quantity type.
Collection<Class>	getUnitClasses()	List a collection of Unit implementations.
Collection<javax.measure.UnitConverter>	getUnitConverters4Test()	This method allows instances of UnitConverter to be tested for requirements and recommendations.
Collection<javax.measure.format.UnitFormat>	getUnitFormats4Test()	This method allows instances of UnitFormat to be tested for requirements and recommendations.
Collection<? extends javax.measure.Unit<?>>	getUnits4Test()	This method allows instances of Unit to be tested for requirements and recommendations.

Method Detail

getQuantityClasses

Collection<Class> getQuantityClasses()

Return a collection with all Quantity classes that are implemented. The list must not be empty and should contain every quantity class implemented.

This enables the TCK to check in addition to the basic implementation compliance, if according ServiceProvider is registered/available.

Returns:

a collection with all implemented amount classes, not null.

getUnitClasses

Collection<Class> getUnitClasses()

List a collection of Unit implementations.

This enables the TCK to check the basic implementation compliance.

Returns:

a collection with Unit implementations to be tested.

getDimensionClasses

Collection<Class> getDimensionClasses()

List a collection of Dimension implementations.

This enables the TCK to check the basic implementation compliance.

Returns:

a collection with Dimension implementations to be tested.

getPrefixClasses

Collection<Class> getPrefixClasses()

List a collection of Prefix implementations.

This enables the TCK to check the basic implementation compliance.

Returns:

a collection with Prefix implementations to be tested.

Since:

2.0

getSupportedQuantityTypes

Collection<Class<? extends javax.measure.Quantity>> getSupportedQuantityTypes()

Return a collection with all supported Quantity types. The list must not return null, but could be empty in certain profiles.

Returns:

the list of quantity types to be checked, not null. It is allowed to return an empty list here, which will return a collection with all implemented amount classes, not null.

getUnit4Type

<Q extends javax.measure.Quantity<Q>> javax.measure.Unit<Q> getUnit4Type(Class<Q> quantityType)

Returns a matching unit for the specified quantity type. This is a "helper method" to avoid direct references to SystemOfUnits or implementations in profiles without SPI.

Type Parameters:

Q - the compile-time quantity type.

Parameters:

quantityType - the quantity type.

Returns:

the unit for the specified quantity.

getUnits4Test

Collection<? extends javax.measure.Unit<?>> getUnits4Test()

This method allows instances of Unit to be tested for requirements and recommendations.

Returns:

the list of units to be checked, not null. It is allowed to return an empty list here, which will disable certain TCK tests, e.g. if the result isn't needed by a particular profile.

getBaseDimensions

Collection<javax.measure.Dimension> getBaseDimensions()

This method returns the base dimensions to be tested for requirements and recommendations.

Returns:

the list of base dimensions to be checked, not null. It is allowed to return an empty list here, which will disable certain TCK tests, e.g. if the result isn't needed by a particular profile.

getUnitConverters4Test

Collection<javax.measure.UnitConverter> getUnitConverters4Test()

This method allows instances of UnitConverter to be tested for requirements and recommendations.

Returns:

the list of unit converters to be checked, not null. It is allowed to return an empty list here, which will disable TCK tests for UnitConverter instances.

getUnitFormats4Test

Collection<javax.measure.format.UnitFormat> getUnitFormats4Test()

This method allows instances of UnitFormat to be tested for requirements and recommendations.

Returns:

the list of unit converters to be checked, not null. It is allowed to return an empty list here, which will disable certain TCK tests, e.g. if the result isn't needed by a particular profile.

getQuantityFormats4Test

Collection<javax.measure.format.QuantityFormat> getQuantityFormats4Test()

This method allows instances of QuantityFormat to be tested for requirements and recommendations.

Returns:

the list of unit converters to be checked, not null. It is allowed to return an empty list here, which will disable certain TCK tests, e.g. if the result isn't needed by a particular profile.

Since:

2.0