com.cloudhopper.commons.charset

Class JavaCharset

java.lang.Object

com.cloudhopper.commons.charset.BaseCharset

com.cloudhopper.commons.charset.JavaCharset

All Implemented Interfaces:

Charset

Direct Known Subclasses:

ISO885915Charset, ISO88591Charset, UCS2Charset, UTF8Charset

public abstract class JavaCharset
extends BaseCharset

Base class for all charset conversions that rely on the internal Java String getBytes() methods.

Author:

joelauer (twitter: @jjlauer or http://twitter.com/jjlauer)

Constructor Summary

Constructors

Constructor and Description
JavaCharset(String charsetName)

Method Summary

Methods

Modifier and Type	Method and Description
String	decode(byte[] bytes) Default implementation that simply returns a String by creating a new StringBuffer, appending to it, and then returning a new String.
void	decode(byte[] bytes, StringBuilder buffer) Decode the byte array to a Java string that is appended to the buffer.
byte[]	encode(CharSequence str0) Encode the Java string into a byte array.

Methods inherited from class com.cloudhopper.commons.charset.BaseCharset

normalize

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.cloudhopper.commons.charset.Charset

estimateDecodeCharLength, estimateEncodeByteLength

Constructor Detail

JavaCharset

public JavaCharset(String charsetName)

Method Detail

encode

public byte[] encode(CharSequence str0)

Description copied from interface: Charset

Encode the Java string into a byte array.

Parameters:

str0 - The Java string to convert into a byte array

Returns:

A new byte array

decode

public void decode(byte[] bytes,
          StringBuilder buffer)

Description copied from interface: Charset

Decode the byte array to a Java string that is appended to the buffer. Implementations of this method will not change any of the byte values contained in the byte array.

Parameters:

bytes - The array of bytes to decode

buffer - The String buffer to append chars to

decode

public String decode(byte[] bytes)

Description copied from class: BaseCharset

Default implementation that simply returns a String by creating a new StringBuffer, appending to it, and then returning a new String. NOTE: This method is NOT efficient since it requires a double copy of a new String. Some charsets will override this default implementation to provide a more efficient impl.

Specified by:

decode in interface Charset

Overrides:

decode in class BaseCharset

Parameters:

bytes - The array of bytes to decode

Returns:

A new String with characters decoded from the byte array in the given charset.