001/**
002 * Unit-API - Units of Measurement API for Java
003 * Copyright (c) 2014 Jean-Marie Dautelle, Werner Keil, V2COM
004 * All rights reserved.
005 *
006 * See LICENSE.txt for details.
007 */
008package javax.measure.spi;
009
010
011/**
012 * <p>
013 * This interface represents the service to obtain a {@link SystemOfUnits system
014 * of units}.
015 * </p>
016 * 
017 * <p>
018 * Common system of units are "SI" (System International), "Imperial" (British),
019 * "US" (US Customary).
020 * </p>
021 * 
022 * @author <a href="mailto:[email protected]">Jean-Marie Dautelle</a>
023 * @author <a href="mailto:[email protected]">Werner Keil</a>
024 * @version 0.5 $Date: 2014-12-03 $
025 */
026public interface SystemOfUnitsService {
027
028        /**
029         * Returns the default <a
030         * href=http://en.wikipedia.org/wiki/International_System_of_Units">
031         * International System of Units</a>.
032         * 
033         * @return <code>getSystemOfUnits("SI")</code>
034         */
035        SystemOfUnits getSystemOfUnits();
036
037    /**
038     * Returns the system of units having the specified name or
039     * <code>null</code> if none.
040     *
041     * @param name the system of unit name.
042     * @return the system of units.
043     */
044        SystemOfUnits getSystemOfUnits(String name);
045
046}