195: Priority not for sorting in ServiceProvider?

Task-Url: #195

Author: keilw

src/main/java/javax/measure/spi/FormatService.java

@@ -89,6 +89,18 @@ public static enum FormatType {
      */
     UnitFormat getUnitFormat(String name);
 
+    /**
+     * Returns the unit format having the specified name or {@code null} if none.
+     *
+     * For example {@code getUnitFormat("Simple")} to return a simple {@link UnitFormat} implementation.<br>
+     * The variant is an arbitrary value to allow a variation of a <code>UnitFormat</code>, for example <code>case sensitive</code> vs. <code>case insensitive</code> <a href="https://ucum.org/ucum.html">UCUM</a> format. 
+     * @param name
+     *          the name of the format.
+     * @param variant Any arbitrary value used to indicate a variation of a <code>UnitFormat</code>.
+     * @return the corresponding unit format.
+     */
+    UnitFormat getUnitFormat(String name, String variant);
+    
     /**
      * Gets a list with available format names of a given type for this format service.
      *

src/test/java/javax/measure/spi/FormatServiceTest.java

@@ -82,6 +82,17 @@ public UnitFormat getUnitFormat(String formatName) {
             Objects.requireNonNull(formatName, "Format name required");
             return unitFormats.get(formatName);
         }
+        
+        /*
+         * (non-Javadoc)
+         *
+         * @see UnitFormatService#getUnitFormat(String)
+         */
+        @Override
+        public UnitFormat getUnitFormat(String formatName, String variant) {
+            Objects.requireNonNull(formatName, "Format name required");
+            return unitFormats.get(formatName);
+        }
 
         /*
          * (non-Javadoc)