net.shibboleth.utilities.java.support.codec

Class StringDigester

java.lang.Object

net.shibboleth.utilities.java.support.codec.StringDigester

All Implemented Interfaces:

com.google.common.base.Function<java.lang.String,java.lang.String>

public class StringDigester
extends java.lang.Object
implements com.google.common.base.Function<java.lang.String,java.lang.String>

A function impl which accepts a String input, digests it according to a specified MessageDigest algorithm, and then returns the output in a specified format: Base64-encoded or hexadecimal with with lower or upper case characters.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StringDigester.OutputFormat The output format determining how the the digested byte[] is converted to the output String.

Field Summary

Fields

Modifier and Type	Field and Description
static java.nio.charset.Charset	DEFAULT_INPUT_CHARSET The default input character set.
private java.lang.String	digestAlgorithm The message digest algorithm to use.
private java.nio.charset.Charset	inputCharset The Charset instance used in converting the input String to a byte[].
private org.slf4j.Logger	log Logger.
private StringDigester.OutputFormat	outputFormat The output format instance used to determine how the digested byte[] is converted to the output String.
private java.lang.String	salt Optional salt to add into the digest.

Constructor Summary

Constructors

Constructor and Description
StringDigester(java.lang.String algorithm, StringDigester.OutputFormat format) Constructor.
StringDigester(java.lang.String algorithm, StringDigester.OutputFormat format, java.nio.charset.Charset charset) Constructor.

Method Summary

Modifier and Type	Method and Description
java.lang.String	apply(java.lang.String input)
void	setSalt(java.lang.String s) Set a salt to add to the digest input for obfuscation.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.common.base.Function

equals

Field Detail

DEFAULT_INPUT_CHARSET

@Nonnull
public static final java.nio.charset.Charset DEFAULT_INPUT_CHARSET

The default input character set.

log

@Nonnull
private final org.slf4j.Logger log

Logger.

digestAlgorithm

@Nonnull
 @NotEmpty
private java.lang.String digestAlgorithm

The message digest algorithm to use.

outputFormat

@Nonnull
private StringDigester.OutputFormat outputFormat

The output format instance used to determine how the digested byte[] is converted to the output String.

inputCharset

@Nonnull
private java.nio.charset.Charset inputCharset

The Charset instance used in converting the input String to a byte[].

salt

@Nullable
private java.lang.String salt

Optional salt to add into the digest.

Constructor Detail

StringDigester

public StringDigester(@Nonnull @NotEmpty
                      java.lang.String algorithm,
                      @Nonnull
                      StringDigester.OutputFormat format)
               throws java.security.NoSuchAlgorithmException

Constructor.

The input character set will be UTF-8.

Parameters:

algorithm - the JCA digest algorithm identifier

format - the output format used to convert the digested[] to the output string

Throws:

java.security.NoSuchAlgorithmException - thrown if the digestAlgorithm is not invalid or unsupported

StringDigester

public StringDigester(@Nonnull @NotEmpty
                      java.lang.String algorithm,
                      @Nonnull
                      StringDigester.OutputFormat format,
                      @Nullable
                      java.nio.charset.Charset charset)
               throws java.security.NoSuchAlgorithmException

Constructor.

Parameters:

algorithm - the JCA digest algorithm identifier

format - the output format used to convert the digested[] to the output string

charset - the character set to use in converting the input string to a byte[] prior to digesting

Throws:

java.security.NoSuchAlgorithmException - thrown if the digestAlgorithm is not invalid or unsupported

Method Detail

setSalt

public void setSalt(@Nullable
                    java.lang.String s)

Set a salt to add to the digest input for obfuscation.

Parameters:

s - salt value

apply

@Nullable
public java.lang.String apply(@Nullable
                                        java.lang.String input)

Specified by:

apply in interface com.google.common.base.Function<java.lang.String,java.lang.String>