org.jsecurity.codec
Class CodecSupport

java.lang.Object
  org.jsecurity.codec.CodecSupport

Direct Known Subclasses:

AbstractHash, SimpleCredentialsMatcher

public abstract class CodecSupport
extends Object

Since:

0.9

Author:

Les Hazlewood

Field Summary

static String

PREFERRED_ENCODING JSecurity's default preferred Character encoding, equal to UTF-8.

Constructor Summary

CodecSupport()

Method Summary

protected byte[]	objectToBytes(Object o) Default implementation throws a CodecException immediately since it can't infer how to convert the Object to a byte array.
protected String	objectToString(Object o) Default implementation merely returns objectArgument.toString().
static byte[]	toBytes(char[] chars) Converts the specified character array to a byte array using the JSecurity's preferred encoding (UTF-8).
static byte[]	toBytes(char[] chars, String encoding) Converts the specified character array into a byte array using the specified character encoding.
protected byte[]	toBytes(Object o) Converts the specified Object into a byte array.
static byte[]	toBytes(String source) Converts the specified source argument to a byte array with JSecurity's PREFERRED_ENCODING.
static byte[]	toBytes(String source, String encoding) Converts the specified source to a byte array via the specified encoding, throwing a CodecException if the encoding fails.
static char[]	toChars(byte[] bytes) Returns the specified byte array as a character array using JSecurity's PREFERRED_ENCODING.
static char[]	toChars(byte[] bytes, String encoding) Converts the specified byte array to a character array using the specified character encoding.
static String	toString(byte[] bytes) Converts the specified byte array to a string using JSecurity's PREFERRED_ENCODING.
static String	toString(byte[] bytes, String encoding) Converts the specified byte array to a String using the specified character encoding.
protected String	toString(Object o) Converts the specified Object into a String.

Methods inherited from class java.lang.Object

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

Field Detail

PREFERRED_ENCODING

public static final String PREFERRED_ENCODING

JSecurity's default preferred Character encoding, equal to UTF-8.

See Also:

Constant Field Values

Constructor Detail

CodecSupport

public CodecSupport()

Method Detail

toBytes

public static byte[] toBytes(char[] chars)

Converts the specified character array to a byte array using the JSecurity's preferred encoding (UTF-8).

This is a convenience method equivalent to calling the toBytes(String,String) method with a a wrapping String and PREFERRED_ENCODING, i.e.

toBytes( new String(chars), PREFERRED_ENCODING );

Parameters:

chars - the character array to be converted to a byte array.

Returns:

the byte array of the UTF-8 encoded character array.

toBytes

public static byte[] toBytes(char[] chars,
                             String encoding)
                      throws CodecException

Converts the specified character array into a byte array using the specified character encoding.

This is a convenience method equivalent to calling the toBytes(String,String) method with a a wrapping String and the specified encoding, i.e.

toBytes( new String(chars), encoding );

Parameters:

chars - the character array to be converted to a byte array

encoding - the character encoding to use to when converting to bytes.

Returns:

the bytes of the specified character array under the specified encoding.

Throws:

CodecException - if the JVM does not support the specified encoding.

toBytes

public static byte[] toBytes(String source)

Converts the specified source argument to a byte array with JSecurity's PREFERRED_ENCODING.

Parameters:

source - the string to convert to a byte array.

Returns:

the bytes representing the specified string under JSecurity's PREFERRED_ENCODING.

toBytes

public static byte[] toBytes(String source,
                             String encoding)
                      throws CodecException

Converts the specified source to a byte array via the specified encoding, throwing a CodecException if the encoding fails.

Parameters:

source - the source string to convert to a byte array.

encoding - the encoding to use to use.

Returns:

the byte array of the specified source with the given encoding.

Throws:

CodecException - if the JVM does not support the specified encoding.

toString

public static String toString(byte[] bytes)

Converts the specified byte array to a string using JSecurity's PREFERRED_ENCODING.

Parameters:

bytes - the byte array to turn into a String.

Returns:

the specified byte array as an encoded String (PREFERRED_ENCODING).

toString

public static String toString(byte[] bytes,
                              String encoding)
                       throws CodecException

Converts the specified byte array to a String using the specified character encoding.

Parameters:

bytes - the byte array to convert to a String

encoding - the character encoding used to encode the String.

Returns:

the specified byte array as an encoded String

Throws:

CodecException - if the JVM does not support the specified encoding.

toChars

public static char[] toChars(byte[] bytes)

Returns the specified byte array as a character array using JSecurity's PREFERRED_ENCODING.

Parameters:

bytes - the byte array to convert to a char array

Returns:

the specified byte array encoded as a character array (PREFERRED_ENCODING).

toChars

public static char[] toChars(byte[] bytes,
                             String encoding)
                      throws CodecException

Converts the specified byte array to a character array using the specified character encoding.

Parameters:

bytes - the byte array to convert to a String

encoding - the character encoding used to encode the bytes.

Returns:

the specified byte array as an encoded char array

Throws:

CodecException - if the JVM does not support the specified encoding.

toBytes

protected byte[] toBytes(Object o)

Converts the specified Object into a byte array.

If the argument is a byte[], char[], or String it will be converted automatically and returned.

If the argument is anything other than these three types, it is passed to the objectToBytes method which must be overridden by subclasses.

Parameters:

o - the Object to convert into a byte array

Returns:

a byte array representation of the Object argument.

toString

protected String toString(Object o)

Converts the specified Object into a String.

If the argument is a byte[], char[], or String it will be converted automatically and returned.

If the argument is anything other than these three types, it is passed to the objectToString method which must be overridden by subclasses.

Parameters:

o - the Object to convert into a byte array

Returns:

a byte array representation of the Object argument.

objectToBytes

protected byte[] objectToBytes(Object o)

Default implementation throws a CodecException immediately since it can't infer how to convert the Object to a byte array. This method must be overridden by subclasses if anything other than the three default types (listed in the toBytes(Object) JavaDoc) are to be converted to a byte array.

Parameters:

o - the Object to convert to a byte array.

Returns:

a byte array representation of the Object argument.

objectToString

protected String objectToString(Object o)

Default implementation merely returns objectArgument.toString(). Subclasses can override this method for different mechanisms of converting an object to a String.

Parameters:

o - the Object to convert to a byte array.

Returns:

a String representation of the Object argument.