[CODEC-213] Support JEP 287: SHA-3 Hash Algorithms

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/codec/trunk@1743938 13f79535-47bb-0310-9956-ffa450edef68

Author: garydgregory

src/changes/changes.xml

@@ -47,6 +47,7 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="ggregory" type="fix" issue="CODEC-207" due-to="Gary Gregory">Charsets Javadoc breaks build when using Java 8</action>         
       <action dev="ggregory" type="fix" issue="CODEC-199" due-to="Yossi Tamari">Bug in HW rule in Soundex</action>         
       <action dev="ggregory" type="fix" issue="CODEC-209" due-to="Gary Gregory">Javadoc for SHA-224 DigestUtils methods should mention Java 1.8.0 restriction instead of 1.4.0.</action>         
+      <action dev="ggregory" type="add" issue="CODEC-213" due-to="Gary Gregory">Support JEP 287: SHA-3 Hash Algorithms</action>         
       <action dev="ggregory" type="add" issue="CODEC-212" due-to="Gary Gregory">Create a minimal Digest command line utility: org.apache.commons.codec.digest.Digest</action>         
       <action dev="ggregory" type="add" issue="CODEC-211" due-to="Gary Gregory">Create enum MessageDigestAlgorithm and deprecate class MessageDigestAlgorithms</action>         
       <action dev="ggregory" type="add" issue="CODEC-210" due-to="Gary Gregory">Add DigestUtils.getDigest(String, MessageDigest)</action>         

src/main/java/org/apache/commons/codec/digest/MessageDigestAlgorithm.java

@@ -74,7 +74,39 @@ public enum MessageDigestAlgorithm {
     /**
      * The SHA-512 hash algorithm defined in the FIPS PUB 180-2.
      */
-    SHA_512("SHA-512");
+    SHA_512("SHA-512"),
+
+    /**
+     * The SHA3-224 hash algorithm defined in the NIST FIPS 202.
+     * <p>
+     * Java 9 only.
+     * </p>
+     */
+    SHA3_224("SHA3-224"),
+
+    /**
+     * The SHA3-256 hash algorithm defined in the NIST FIPS 202.
+     * <p>
+     * Java 9 only.
+     * </p>
+     */
+    SHA3_256("SHA3-256"),
+
+    /**
+     * The SHA3-384 hash algorithm defined in the NIST FIPS 202.
+     * <p>
+     * Java 9 only.
+     * </p>
+     */
+    SHA3_384("SHA3-384"),
+
+    /**
+     * The SHA3-512 hash algorithm defined in the NIST FIPS 202.
+     * <p>
+     * Java 9 only.
+     * </p>
+     */
+    SHA3_512("SHA3-512");
 
     private final String algorithm;