org.rapidcontext.util

Class BinaryUtil

java.lang.Object

org.rapidcontext.util.BinaryUtil

public class BinaryUtil
extends java.lang.Object

A set of utility methods for handling binary data.

Version:

1.0

Author:

Per Cederberg

Constructor Summary

Constructors

Constructor and Description
BinaryUtil()

Method Summary

Modifier and Type	Method and Description
static byte[]	decodeBase64(java.lang.String data) Decodes a Base64 string back to the original byte array.
static java.lang.String	encodeBase64(byte[] data) Encodes a byte array to a string with Base64 characters (websafe).
static java.lang.String	encodeHexString(byte[] data) Encodes a byte array to a string with hexadecimal numbers.
static byte[]	hashBytes(java.lang.String alg, byte[] data) Performs a digest hash on the specified byte array.
static java.lang.String	hashMD5(java.lang.String input) Calculates the MD5 digest hash on the UTF-8 encoding of an input string.
static java.lang.String	hashSHA256(java.lang.String input) Calculates the SHA-256 digest hash on the UTF-8 encoding of an input string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BinaryUtil

public BinaryUtil()

Method Detail

hashMD5

public static java.lang.String hashMD5(java.lang.String input)
                                throws java.security.NoSuchAlgorithmException,
                                       java.io.UnsupportedEncodingException

Calculates the MD5 digest hash on the UTF-8 encoding of an input string. The result will be returned as an hexadecimal string.

Parameters:

input - the input string

Returns:

the hexadecimal string with the MD5 hash

Throws:

java.security.NoSuchAlgorithmException - if the MD5 algorithm isn't available (should be RuntimeException)

java.io.UnsupportedEncodingException - if the UTF-8 encoding isn't available (should be RuntimeException)

hashSHA256

public static java.lang.String hashSHA256(java.lang.String input)
                                   throws java.security.NoSuchAlgorithmException,
                                          java.io.UnsupportedEncodingException

Calculates the SHA-256 digest hash on the UTF-8 encoding of an input string. The result will be returned as an hexadecimal string.

Parameters:

input - the input string

Returns:

the hexadecimal string with the SHA-256 hash

Throws:

java.security.NoSuchAlgorithmException - if the SHA-256 algorithm isn't available (should be RuntimeException)

java.io.UnsupportedEncodingException - if the UTF-8 encoding isn't available (should be RuntimeException)

hashBytes

public static byte[] hashBytes(java.lang.String alg,
                               byte[] data)
                        throws java.security.NoSuchAlgorithmException

Performs a digest hash on the specified byte array.

Parameters:

alg - the hash algorithm (e.g. "MD5" or "SHA-256")

data - the data to hash

Returns:

the digest hash of the data

Throws:

java.security.NoSuchAlgorithmException - if the hash algorithm isn't available

encodeHexString

public static java.lang.String encodeHexString(byte[] data)

Encodes a byte array to a string with hexadecimal numbers.

Parameters:

data - the byte array

Returns:

the hexadecimal string with the converted data

encodeBase64

public static java.lang.String encodeBase64(byte[] data)

Encodes a byte array to a string with Base64 characters (websafe).

Parameters:

data - the byte array

Returns:

the Base64 string with the converted data

decodeBase64

public static byte[] decodeBase64(java.lang.String data)

Decodes a Base64 string back to the original byte array.

Parameters:

data - the Base64-encoded string

Returns:

the decoded original byte array