DigestUtils (Apache Commons Codec 1.11 API)

java.lang.Object
- org.apache.commons.codec.digest.DigestUtils

```
public class DigestUtils
extends Object
```
Operations to simplify common MessageDigest tasks. This class is immutable and thread-safe. However the MessageDigest instances it creates generally won't be.
The MessageDigestAlgorithms class provides constants for standard digest algorithms that can be used with the getDigest(String) method and other methods that require the Digest algorithm name.
Note: the class has short-hand methods for all the algorithms present as standard in Java 6. This approach requires lots of methods for each algorithm, and quickly becomes unwieldy. The following code works with all algorithms:
```
 import static org.apache.commons.codec.digest.MessageDigestAlgorithms.SHA_224;
 ...
 byte [] digest = new DigestUtils(SHA_224).digest(dataToDigest);
 String hdigest = new DigestUtils(SHA_224).digestAsHex(new File("pom.xml"));
 
```
Version:

$Id: DigestUtils.java 1811344 2017-10-06 15:19:57Z ggregory $

See Also:

MessageDigestAlgorithms

Constructor Summary

Constructors
Constructor and Description
`DigestUtils()` Deprecated. since 1.11; only useful to preserve binary compatibility
`DigestUtils(MessageDigest digest)` Creates an instance using the provided `MessageDigest` parameter.
`DigestUtils(String name)` Creates an instance using the provided `MessageDigest` parameter.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`byte[]`	`digest(byte[] data)` Reads through a byte array and returns the digest for the data.
`byte[]`	`digest(ByteBuffer data)` Reads through a ByteBuffer and returns the digest for the data
`byte[]`	`digest(File data)` Reads through a File and returns the digest for the data
`byte[]`	`digest(InputStream data)` Reads through an InputStream and returns the digest for the data
`static byte[]`	`digest(MessageDigest messageDigest, byte[] data)` Reads through a byte array and returns the digest for the data.
`static byte[]`	`digest(MessageDigest messageDigest, ByteBuffer data)` Reads through a ByteBuffer and returns the digest for the data
`static byte[]`	`digest(MessageDigest messageDigest, File data)` Reads through a File and returns the digest for the data
`static byte[]`	`digest(MessageDigest messageDigest, InputStream data)` Reads through an InputStream and returns the digest for the data
`byte[]`	`digest(String data)` Reads through a byte array and returns the digest for the data.
`String`	`digestAsHex(byte[] data)` Reads through a byte array and returns the digest for the data.
`String`	`digestAsHex(ByteBuffer data)` Reads through a ByteBuffer and returns the digest for the data
`String`	`digestAsHex(File data)` Reads through a File and returns the digest for the data
`String`	`digestAsHex(InputStream data)` Reads through an InputStream and returns the digest for the data
`String`	`digestAsHex(String data)` Reads through a byte array and returns the digest for the data.
`static MessageDigest`	`getDigest(String algorithm)` Returns a `MessageDigest` for the given `algorithm`.
`static MessageDigest`	`getDigest(String algorithm, MessageDigest defaultMessageDigest)` Returns a `MessageDigest` for the given `algorithm` or a default if there is a problem getting the algorithm.
`static MessageDigest`	`getMd2Digest()` Returns an MD2 MessageDigest.
`static MessageDigest`	`getMd5Digest()` Returns an MD5 MessageDigest.
`MessageDigest`	`getMessageDigest()` Returns the message digest instance.
`static MessageDigest`	`getSha1Digest()` Returns an SHA-1 digest.
`static MessageDigest`	`getSha256Digest()` Returns an SHA-256 digest.
`static MessageDigest`	`getSha384Digest()` Returns an SHA-384 digest.
`static MessageDigest`	`getSha512Digest()` Returns an SHA-512 digest.
`static MessageDigest`	`getShaDigest()` Deprecated. (1.11) Use `getSha1Digest()`
`static boolean`	`isAvailable(String messageDigestAlgorithm)` Test whether the algorithm is supported.
`static byte[]`	`md2(byte[] data)` Calculates the MD2 digest and returns the value as a 16 element `byte[]`.
`static byte[]`	`md2(InputStream data)` Calculates the MD2 digest and returns the value as a 16 element `byte[]`.
`static byte[]`	`md2(String data)` Calculates the MD2 digest and returns the value as a 16 element `byte[]`.
`static String`	`md2Hex(byte[] data)` Calculates the MD2 digest and returns the value as a 32 character hex string.
`static String`	`md2Hex(InputStream data)` Calculates the MD2 digest and returns the value as a 32 character hex string.
`static String`	`md2Hex(String data)` Calculates the MD2 digest and returns the value as a 32 character hex string.
`static byte[]`	`md5(byte[] data)` Calculates the MD5 digest and returns the value as a 16 element `byte[]`.
`static byte[]`	`md5(InputStream data)` Calculates the MD5 digest and returns the value as a 16 element `byte[]`.
`static byte[]`	`md5(String data)` Calculates the MD5 digest and returns the value as a 16 element `byte[]`.
`static String`	`md5Hex(byte[] data)` Calculates the MD5 digest and returns the value as a 32 character hex string.
`static String`	`md5Hex(InputStream data)` Calculates the MD5 digest and returns the value as a 32 character hex string.
`static String`	`md5Hex(String data)` Calculates the MD5 digest and returns the value as a 32 character hex string.
`static byte[]`	`sha(byte[] data)` Deprecated. (1.11) Use `sha1(byte[])`
`static byte[]`	`sha(InputStream data)` Deprecated. (1.11) Use `sha1(InputStream)`
`static byte[]`	`sha(String data)` Deprecated. (1.11) Use `sha1(String)`
`static byte[]`	`sha1(byte[] data)` Calculates the SHA-1 digest and returns the value as a `byte[]`.
`static byte[]`	`sha1(InputStream data)` Calculates the SHA-1 digest and returns the value as a `byte[]`.
`static byte[]`	`sha1(String data)` Calculates the SHA-1 digest and returns the value as a `byte[]`.
`static String`	`sha1Hex(byte[] data)` Calculates the SHA-1 digest and returns the value as a hex string.
`static String`	`sha1Hex(InputStream data)` Calculates the SHA-1 digest and returns the value as a hex string.
`static String`	`sha1Hex(String data)` Calculates the SHA-1 digest and returns the value as a hex string.
`static byte[]`	`sha256(byte[] data)` Calculates the SHA-256 digest and returns the value as a `byte[]`.
`static byte[]`	`sha256(InputStream data)` Calculates the SHA-256 digest and returns the value as a `byte[]`.
`static byte[]`	`sha256(String data)` Calculates the SHA-256 digest and returns the value as a `byte[]`.
`static String`	`sha256Hex(byte[] data)` Calculates the SHA-256 digest and returns the value as a hex string.
`static String`	`sha256Hex(InputStream data)` Calculates the SHA-256 digest and returns the value as a hex string.
`static String`	`sha256Hex(String data)` Calculates the SHA-256 digest and returns the value as a hex string.
`static byte[]`	`sha384(byte[] data)` Calculates the SHA-384 digest and returns the value as a `byte[]`.
`static byte[]`	`sha384(InputStream data)` Calculates the SHA-384 digest and returns the value as a `byte[]`.
`static byte[]`	`sha384(String data)` Calculates the SHA-384 digest and returns the value as a `byte[]`.
`static String`	`sha384Hex(byte[] data)` Calculates the SHA-384 digest and returns the value as a hex string.
`static String`	`sha384Hex(InputStream data)` Calculates the SHA-384 digest and returns the value as a hex string.
`static String`	`sha384Hex(String data)` Calculates the SHA-384 digest and returns the value as a hex string.
`static byte[]`	`sha512(byte[] data)` Calculates the SHA-512 digest and returns the value as a `byte[]`.
`static byte[]`	`sha512(InputStream data)` Calculates the SHA-512 digest and returns the value as a `byte[]`.
`static byte[]`	`sha512(String data)` Calculates the SHA-512 digest and returns the value as a `byte[]`.
`static String`	`sha512Hex(byte[] data)` Calculates the SHA-512 digest and returns the value as a hex string.
`static String`	`sha512Hex(InputStream data)` Calculates the SHA-512 digest and returns the value as a hex string.
`static String`	`sha512Hex(String data)` Calculates the SHA-512 digest and returns the value as a hex string.
`static String`	`shaHex(byte[] data)` Deprecated. (1.11) Use `sha1Hex(byte[])`
`static String`	`shaHex(InputStream data)` Deprecated. (1.11) Use `sha1Hex(InputStream)`
`static String`	`shaHex(String data)` Deprecated. (1.11) Use `sha1Hex(String)`
`static MessageDigest`	`updateDigest(MessageDigest messageDigest, byte[] valueToDigest)` Updates the given `MessageDigest`.
`static MessageDigest`	`updateDigest(MessageDigest messageDigest, ByteBuffer valueToDigest)` Updates the given `MessageDigest`.
`static MessageDigest`	`updateDigest(MessageDigest digest, File data)` Reads through a File and updates the digest for the data
`static MessageDigest`	`updateDigest(MessageDigest digest, InputStream data)` Reads through an InputStream and updates the digest for the data
`static MessageDigest`	`updateDigest(MessageDigest messageDigest, String valueToDigest)` Updates the given `MessageDigest` from a String (converted to bytes using UTF-8).

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DigestUtils
```
@Deprecated
public DigestUtils()
```
    Deprecated. since 1.11; only useful to preserve binary compatibility
    
    Preserves binary compatibity only. As for previous versions does not provide useful behaviour
  - DigestUtils
```
public DigestUtils(MessageDigest digest)
```
    Creates an instance using the provided MessageDigest parameter. This can then be used to create digests using methods such as digest(byte[]) and digestAsHex(File).
    
    Parameters:
    
    digest - the MessageDigest to use
    
    Since:
    
    1.11
  - DigestUtils
```
public DigestUtils(String name)
```
    Creates an instance using the provided MessageDigest parameter. This can then be used to create digests using methods such as digest(byte[]) and digestAsHex(File).
    
    Parameters:
    
    name - the name of the MessageDigest to use
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught.
    
    Since:
    
    1.11
    
    See Also:
    
    getDigest(String)
- Method Detail
  - digest
```
public static byte[] digest(MessageDigest messageDigest,
                            byte[] data)
```
    Reads through a byte array and returns the digest for the data. Provided for symmetry with other methods.
    
    Parameters:
    
    messageDigest - The MessageDigest to use (e.g. MD5)
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Since:
    
    1.11
  - digest
```
public static byte[] digest(MessageDigest messageDigest,
                            ByteBuffer data)
```
    Reads through a ByteBuffer and returns the digest for the data
    
    Parameters:
    
    messageDigest - The MessageDigest to use (e.g. MD5)
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Since:
    
    1.11
  - digest
```
public static byte[] digest(MessageDigest messageDigest,
                            File data)
                     throws IOException
```
    Reads through a File and returns the digest for the data
    
    Parameters:
    
    messageDigest - The MessageDigest to use (e.g. MD5)
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.11
  - digest
```
public static byte[] digest(MessageDigest messageDigest,
                            InputStream data)
                     throws IOException
```
    Reads through an InputStream and returns the digest for the data
    
    Parameters:
    
    messageDigest - The MessageDigest to use (e.g. MD5)
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.11 (was private)
  - getDigest
```
public static MessageDigest getDigest(String algorithm)
```
    Returns a MessageDigest for the given algorithm.
    
    Parameters:
    
    algorithm - the name of the algorithm requested. See Appendix A in the Java Cryptography Architecture Reference Guide for information about standard algorithm names.
    
    Returns:
    
    A digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught.
    
    See Also:
    
    MessageDigest.getInstance(String)
  - getDigest
```
public static MessageDigest getDigest(String algorithm,
                                      MessageDigest defaultMessageDigest)
```
    Returns a MessageDigest for the given algorithm or a default if there is a problem getting the algorithm.
    
    Parameters:
    
    algorithm - the name of the algorithm requested. See Appendix A in the Java Cryptography Architecture Reference Guide for information about standard algorithm names.
    
    defaultMessageDigest - The default MessageDigest.
    
    Returns:
    
    A digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught.
    
    Since:
    
    1.11
    
    See Also:
    
    MessageDigest.getInstance(String)
  - getMd2Digest
```
public static MessageDigest getMd2Digest()
```
    Returns an MD2 MessageDigest.
    
    Returns:
    
    An MD2 digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught, which should never happen because MD2 is a built-in algorithm
    
    Since:
    
    1.7
    
    See Also:
    
    MessageDigestAlgorithms.MD2
  - getMd5Digest
```
public static MessageDigest getMd5Digest()
```
    Returns an MD5 MessageDigest.
    
    Returns:
    
    An MD5 digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught, which should never happen because MD5 is a built-in algorithm
    
    See Also:
    
    MessageDigestAlgorithms.MD5
  - getSha1Digest
```
public static MessageDigest getSha1Digest()
```
    Returns an SHA-1 digest.
    
    Returns:
    
    An SHA-1 digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught, which should never happen because SHA-1 is a built-in algorithm
    
    Since:
    
    1.7
    
    See Also:
    
    MessageDigestAlgorithms.SHA_1
  - getSha256Digest
```
public static MessageDigest getSha256Digest()
```
    Returns an SHA-256 digest.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Returns:
    
    An SHA-256 digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught, which should never happen because SHA-256 is a built-in algorithm
    
    See Also:
    
    MessageDigestAlgorithms.SHA_256
  - getSha384Digest
```
public static MessageDigest getSha384Digest()
```
    Returns an SHA-384 digest.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Returns:
    
    An SHA-384 digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught, which should never happen because SHA-384 is a built-in algorithm
    
    See Also:
    
    MessageDigestAlgorithms.SHA_384
  - getSha512Digest
```
public static MessageDigest getSha512Digest()
```
    Returns an SHA-512 digest.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Returns:
    
    An SHA-512 digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught, which should never happen because SHA-512 is a built-in algorithm
    
    See Also:
    
    MessageDigestAlgorithms.SHA_512
  - getShaDigest
```
@Deprecated
public static MessageDigest getShaDigest()
```
    Deprecated. (1.11) Use getSha1Digest()
    
    Returns an SHA-1 digest.
    
    Returns:
    
    An SHA-1 digest instance.
    
    Throws:
    
    IllegalArgumentException - when a NoSuchAlgorithmException is caught
  - md2
```
public static byte[] md2(byte[] data)
```
    Calculates the MD2 digest and returns the value as a 16 element byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD2 digest
    
    Since:
    
    1.7
  - md2
```
public static byte[] md2(InputStream data)
                  throws IOException
```
    Calculates the MD2 digest and returns the value as a 16 element byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD2 digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.7
  - md2
```
public static byte[] md2(String data)
```
    Calculates the MD2 digest and returns the value as a 16 element byte[].
    
    Parameters:
    
    data - Data to digest; converted to bytes using StringUtils.getBytesUtf8(String)
    
    Returns:
    
    MD2 digest
    
    Since:
    
    1.7
  - md2Hex
```
public static String md2Hex(byte[] data)
```
    Calculates the MD2 digest and returns the value as a 32 character hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD2 digest as a hex string
    
    Since:
    
    1.7
  - md2Hex
```
public static String md2Hex(InputStream data)
                     throws IOException
```
    Calculates the MD2 digest and returns the value as a 32 character hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD2 digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.7
  - md2Hex
```
public static String md2Hex(String data)
```
    Calculates the MD2 digest and returns the value as a 32 character hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD2 digest as a hex string
    
    Since:
    
    1.7
  - md5
```
public static byte[] md5(byte[] data)
```
    Calculates the MD5 digest and returns the value as a 16 element byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD5 digest
  - md5
```
public static byte[] md5(InputStream data)
                  throws IOException
```
    Calculates the MD5 digest and returns the value as a 16 element byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD5 digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - md5
```
public static byte[] md5(String data)
```
    Calculates the MD5 digest and returns the value as a 16 element byte[].
    
    Parameters:
    
    data - Data to digest; converted to bytes using StringUtils.getBytesUtf8(String)
    
    Returns:
    
    MD5 digest
  - md5Hex
```
public static String md5Hex(byte[] data)
```
    Calculates the MD5 digest and returns the value as a 32 character hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD5 digest as a hex string
  - md5Hex
```
public static String md5Hex(InputStream data)
                     throws IOException
```
    Calculates the MD5 digest and returns the value as a 32 character hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD5 digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - md5Hex
```
public static String md5Hex(String data)
```
    Calculates the MD5 digest and returns the value as a 32 character hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    MD5 digest as a hex string
  - sha
```
@Deprecated
public static byte[] sha(byte[] data)
```
    Deprecated. (1.11) Use sha1(byte[])
    
    Calculates the SHA-1 digest and returns the value as a byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest
  - sha
```
@Deprecated
public static byte[] sha(InputStream data)
                               throws IOException
```
    Deprecated. (1.11) Use sha1(InputStream)
    
    Calculates the SHA-1 digest and returns the value as a byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - sha
```
@Deprecated
public static byte[] sha(String data)
```
    Deprecated. (1.11) Use sha1(String)
    
    Calculates the SHA-1 digest and returns the value as a byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest
  - sha1
```
public static byte[] sha1(byte[] data)
```
    Calculates the SHA-1 digest and returns the value as a byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest
    
    Since:
    
    1.7
  - sha1
```
public static byte[] sha1(InputStream data)
                   throws IOException
```
    Calculates the SHA-1 digest and returns the value as a byte[].
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.7
  - sha1
```
public static byte[] sha1(String data)
```
    Calculates the SHA-1 digest and returns the value as a byte[].
    
    Parameters:
    
    data - Data to digest; converted to bytes using StringUtils.getBytesUtf8(String)
    
    Returns:
    
    SHA-1 digest
  - sha1Hex
```
public static String sha1Hex(byte[] data)
```
    Calculates the SHA-1 digest and returns the value as a hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest as a hex string
    
    Since:
    
    1.7
  - sha1Hex
```
public static String sha1Hex(InputStream data)
                      throws IOException
```
    Calculates the SHA-1 digest and returns the value as a hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.7
  - sha1Hex
```
public static String sha1Hex(String data)
```
    Calculates the SHA-1 digest and returns the value as a hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest as a hex string
    
    Since:
    
    1.7
  - sha256
```
public static byte[] sha256(byte[] data)
```
    Calculates the SHA-256 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-256 digest
    
    Since:
    
    1.4
  - sha256
```
public static byte[] sha256(InputStream data)
                     throws IOException
```
    Calculates the SHA-256 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-256 digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - sha256
```
public static byte[] sha256(String data)
```
    Calculates the SHA-256 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest; converted to bytes using StringUtils.getBytesUtf8(String)
    
    Returns:
    
    SHA-256 digest
    
    Since:
    
    1.4
  - sha256Hex
```
public static String sha256Hex(byte[] data)
```
    Calculates the SHA-256 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-256 digest as a hex string
    
    Since:
    
    1.4
  - sha256Hex
```
public static String sha256Hex(InputStream data)
                        throws IOException
```
    Calculates the SHA-256 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-256 digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - sha256Hex
```
public static String sha256Hex(String data)
```
    Calculates the SHA-256 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-256 digest as a hex string
    
    Since:
    
    1.4
  - sha384
```
public static byte[] sha384(byte[] data)
```
    Calculates the SHA-384 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-384 digest
    
    Since:
    
    1.4
  - sha384
```
public static byte[] sha384(InputStream data)
                     throws IOException
```
    Calculates the SHA-384 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-384 digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - sha384
```
public static byte[] sha384(String data)
```
    Calculates the SHA-384 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest; converted to bytes using StringUtils.getBytesUtf8(String)
    
    Returns:
    
    SHA-384 digest
    
    Since:
    
    1.4
  - sha384Hex
```
public static String sha384Hex(byte[] data)
```
    Calculates the SHA-384 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-384 digest as a hex string
    
    Since:
    
    1.4
  - sha384Hex
```
public static String sha384Hex(InputStream data)
                        throws IOException
```
    Calculates the SHA-384 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-384 digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - sha384Hex
```
public static String sha384Hex(String data)
```
    Calculates the SHA-384 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-384 digest as a hex string
    
    Since:
    
    1.4
  - sha512
```
public static byte[] sha512(byte[] data)
```
    Calculates the SHA-512 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-512 digest
    
    Since:
    
    1.4
  - sha512
```
public static byte[] sha512(InputStream data)
                     throws IOException
```
    Calculates the SHA-512 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-512 digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - sha512
```
public static byte[] sha512(String data)
```
    Calculates the SHA-512 digest and returns the value as a byte[].
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest; converted to bytes using StringUtils.getBytesUtf8(String)
    
    Returns:
    
    SHA-512 digest
    
    Since:
    
    1.4
  - sha512Hex
```
public static String sha512Hex(byte[] data)
```
    Calculates the SHA-512 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-512 digest as a hex string
    
    Since:
    
    1.4
  - sha512Hex
```
public static String sha512Hex(InputStream data)
                        throws IOException
```
    Calculates the SHA-512 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-512 digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - sha512Hex
```
public static String sha512Hex(String data)
```
    Calculates the SHA-512 digest and returns the value as a hex string.
    Throws a RuntimeException on JRE versions prior to 1.4.0.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-512 digest as a hex string
    
    Since:
    
    1.4
  - shaHex
```
@Deprecated
public static String shaHex(byte[] data)
```
    Deprecated. (1.11) Use sha1Hex(byte[])
    
    Calculates the SHA-1 digest and returns the value as a hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest as a hex string
  - shaHex
```
@Deprecated
public static String shaHex(InputStream data)
                                  throws IOException
```
    Deprecated. (1.11) Use sha1Hex(InputStream)
    
    Calculates the SHA-1 digest and returns the value as a hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.4
  - shaHex
```
@Deprecated
public static String shaHex(String data)
```
    Deprecated. (1.11) Use sha1Hex(String)
    
    Calculates the SHA-1 digest and returns the value as a hex string.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    SHA-1 digest as a hex string
  - updateDigest
```
public static MessageDigest updateDigest(MessageDigest messageDigest,
                                         byte[] valueToDigest)
```
    Updates the given MessageDigest.
    
    Parameters:
    
    messageDigest - the MessageDigest to update
    
    valueToDigest - the value to update the MessageDigest with
    
    Returns:
    
    the updated MessageDigest
    
    Since:
    
    1.7
  - updateDigest
```
public static MessageDigest updateDigest(MessageDigest messageDigest,
                                         ByteBuffer valueToDigest)
```
    Updates the given MessageDigest.
    
    Parameters:
    
    messageDigest - the MessageDigest to update
    
    valueToDigest - the value to update the MessageDigest with
    
    Returns:
    
    the updated MessageDigest
    
    Since:
    
    1.11
  - updateDigest
```
public static MessageDigest updateDigest(MessageDigest digest,
                                         File data)
                                  throws IOException
```
    Reads through a File and updates the digest for the data
    
    Parameters:
    
    digest - The MessageDigest to use (e.g. MD5)
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.11
  - updateDigest
```
public static MessageDigest updateDigest(MessageDigest digest,
                                         InputStream data)
                                  throws IOException
```
    Reads through an InputStream and updates the digest for the data
    
    Parameters:
    
    digest - The MessageDigest to use (e.g. MD5)
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.8
  - updateDigest
```
public static MessageDigest updateDigest(MessageDigest messageDigest,
                                         String valueToDigest)
```
    Updates the given MessageDigest from a String (converted to bytes using UTF-8).
    To update the digest using a different charset for the conversion, convert the String to a byte array using String.getBytes(java.nio.charset.Charset) and pass that to the updateDigest(MessageDigest, byte[]) method
    
    Parameters:
    
    messageDigest - the MessageDigest to update
    
    valueToDigest - the value to update the MessageDigest with; converted to bytes using StringUtils.getBytesUtf8(String)
    
    Returns:
    
    the updated MessageDigest
    
    Since:
    
    1.7
  - isAvailable
```
public static boolean isAvailable(String messageDigestAlgorithm)
```
    Test whether the algorithm is supported.
    
    Parameters:
    
    messageDigestAlgorithm - the algorithm name
    
    Returns:
    
    true if the algorithm can be found
    
    Since:
    
    1.11
  - getMessageDigest
```
public MessageDigest getMessageDigest()
```
    Returns the message digest instance.
    
    Returns:
    
    the message digest instance
    
    Since:
    
    1.11
  - digest
```
public byte[] digest(byte[] data)
```
    Reads through a byte array and returns the digest for the data.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Since:
    
    1.11
  - digest
```
public byte[] digest(String data)
```
    Reads through a byte array and returns the digest for the data.
    
    Parameters:
    
    data - Data to digest treated as UTF-8 string
    
    Returns:
    
    the digest
    
    Since:
    
    1.11
  - digest
```
public byte[] digest(ByteBuffer data)
```
    Reads through a ByteBuffer and returns the digest for the data
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Since:
    
    1.11
  - digest
```
public byte[] digest(File data)
              throws IOException
```
    Reads through a File and returns the digest for the data
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.11
  - digest
```
public byte[] digest(InputStream data)
              throws IOException
```
    Reads through an InputStream and returns the digest for the data
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.11
  - digestAsHex
```
public String digestAsHex(byte[] data)
```
    Reads through a byte array and returns the digest for the data.
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest as a hex string
    
    Since:
    
    1.11
  - digestAsHex
```
public String digestAsHex(String data)
```
    Reads through a byte array and returns the digest for the data.
    
    Parameters:
    
    data - Data to digest treated as UTF-8 string
    
    Returns:
    
    the digest as a hex string
    
    Since:
    
    1.11
  - digestAsHex
```
public String digestAsHex(ByteBuffer data)
```
    Reads through a ByteBuffer and returns the digest for the data
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest as a hex string
    
    Since:
    
    1.11
  - digestAsHex
```
public String digestAsHex(File data)
                   throws IOException
```
    Reads through a File and returns the digest for the data
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.11
  - digestAsHex
```
public String digestAsHex(InputStream data)
                   throws IOException
```
    Reads through an InputStream and returns the digest for the data
    
    Parameters:
    
    data - Data to digest
    
    Returns:
    
    the digest as a hex string
    
    Throws:
    
    IOException - On error reading from the stream
    
    Since:
    
    1.11

Class DigestUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DigestUtils

DigestUtils

DigestUtils

Method Detail

digest

digest

digest

digest

getDigest

getDigest

getMd2Digest

getMd5Digest

getSha1Digest

getSha256Digest

getSha384Digest

getSha512Digest

getShaDigest

md2

md2

md2

md2Hex

md2Hex

md2Hex

md5

md5

md5

md5Hex

md5Hex

md5Hex

sha

sha

sha

sha1

sha1

sha1

sha1Hex

sha1Hex

sha1Hex

sha256

sha256

sha256

sha256Hex

sha256Hex

sha256Hex

sha384

sha384

sha384

sha384Hex

sha384Hex

sha384Hex

sha512

sha512

sha512

sha512Hex

sha512Hex

sha512Hex

shaHex

shaHex

shaHex

updateDigest

updateDigest

updateDigest

updateDigest

updateDigest

isAvailable

getMessageDigest

digest

digest

digest

digest

digest

digestAsHex

digestAsHex

digestAsHex

digestAsHex