/** * Converts an array of character bytes representing hexadecimal values into an array of bytes of those same values. * The returned array will be half the length of the passed array, as it takes two characters to represent any given * byte. An exception is thrown if the passed char array has an odd number of elements. * * @param array * An array of character bytes containing hexadecimal digits * @return A byte array containing binary data decoded from the supplied byte array (representing characters). * @throws DecoderException * Thrown if an odd number of characters is supplied to this function * @see #decodeHex(char[]) */ public byte[] decode(byte[] array) throws DecoderException { try { return decodeHex(new String(array, getCharsetName()).toCharArray()); } catch (UnsupportedEncodingException e) { throw new DecoderException(e.getMessage(), e); } }
/** * Converts an array of bytes into an array of bytes for the characters representing the hexadecimal values of each * byte in order. The returned array will be double the length of the passed array, as it takes two characters to * represent any given byte. * <p> * The conversion from hexadecimal characters to the returned bytes is performed with the charset named by * {@link #getCharsetName()}. * </p> * * @param array * a byte[] to convert to Hex characters * @return A byte[] containing the bytes of the hexadecimal characters * @throws IllegalStateException * if the charsetName is invalid. This API throws {@link IllegalStateException} instead of * {@link UnsupportedEncodingException} for backward compatibility. * @see #encodeHex(byte[]) */ public byte[] encode(byte[] array) { return Strings.getBytes(encodeHexString(array), getCharsetName()); }
/** * Converts a String or an array of bytes into an array of characters representing the hexadecimal values of each * byte in order. The returned array will be double the length of the passed String or array, as it takes two * characters to represent any given byte. * <p> * The conversion from hexadecimal characters to bytes to be encoded to performed with the charset named by * {@link #getCharsetName()}. * </p> * * @param object * a String, or byte[] to convert to Hex characters * @return A char[] containing hexadecimal characters * @throws EncoderException * Thrown if the given object is not a String or byte[] * @see #encodeHex(byte[]) */ public Object encode(Object object) throws EncoderException { try { byte[] byteArray = object instanceof String ? ((String) object).getBytes(getCharsetName()) : (byte[]) object; return encodeHex(byteArray); } catch (ClassCastException e) { throw new EncoderException(e.getMessage(), e); } catch (UnsupportedEncodingException e) { throw new EncoderException(e.getMessage(), e); } }