com.helger.commons.codec

Class RFC1522QCodec

java.lang.Object

com.helger.commons.codec.AbstractByteArrayDecoder

com.helger.commons.codec.AbstractByteArrayCodec

com.helger.commons.codec.AbstractRFC1522Codec

com.helger.commons.codec.RFC1522QCodec

All Implemented Interfaces:

IByteArrayCodec, IByteArrayDecoder, IByteArrayEncoder, ICodec<byte[]>, IDecoder<byte[]>, IEncoder<byte[]>

public class RFC1522QCodec
extends AbstractRFC1522Codec

Similar to the Quoted-Printable content-transfer-encoding defined in RFC 1521 and designed to allow text containing mostly ASCII characters to be decipherable on an ASCII terminal without decoding.

RFC 1522 describes techniques to allow the encoding of non-ASCII text in various portions of a RFC 822 [2] message header, in a manner which is unlikely to confuse existing message handling software.

This class is conditionally thread-safe. The instance field m_bEncodeBlanks is mutable setEncodeBlanks(boolean) but is not volatile, and accesses are not synchronised. If an instance of the class is shared between threads, the caller needs to ensure that suitable synchronisation is used to ensure safe publication of the value between threads, and must not invoke setEncodeBlanks(boolean) after initial setup.

See Also:

MIME (Multipurpose Internet Mail Extensions) Part Two: Message Header Extensions for Non-ASCII Text

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_ENCODE_BLANKS

Fields inherited from class com.helger.commons.codec.AbstractRFC1522Codec

POSTFIX, PREFIX, SEP

Constructor Summary

Constructors

Constructor and Description
RFC1522QCodec() Default constructor with the UTF-8 charset.
RFC1522QCodec(Charset aCharset) Constructor which allows for the selection of a default charset.

Method Summary

Methods

Modifier and Type	Method and Description
Charset	getCharset()
byte[]	getDecoded(byte[] aBuffer) Decode a byte array.
String	getDecodedText(String sText) Decodes a quoted-printable string into its original form.
byte[]	getEncoded(byte[] aBuffer) Encode a byte array.
String	getEncodedText(String sText) Encodes a string into its quoted-printable form using the default charset.
protected String	getRFC1522Encoding() Returns the codec name (referred to as encoding in the RFC 1522).
boolean	isEncodeBlanks() Tests if optional transformation of SPACE characters is to be used
void	setEncodeBlanks(boolean bEncodeBlanks) Defines whether optional transformation of SPACE characters is to be used

Methods inherited from class com.helger.commons.codec.AbstractRFC1522Codec

getEncodedText

Methods inherited from class com.helger.commons.codec.AbstractByteArrayCodec

getEncoded

Methods inherited from class com.helger.commons.codec.AbstractByteArrayDecoder

getDecoded

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.commons.codec.IByteArrayDecoder

getDecoded

Field Detail

DEFAULT_ENCODE_BLANKS

public static final boolean DEFAULT_ENCODE_BLANKS

See Also:

Constant Field Values

Constructor Detail

RFC1522QCodec

public RFC1522QCodec()

Default constructor with the UTF-8 charset.

RFC1522QCodec

public RFC1522QCodec(@Nonnull
             Charset aCharset)

Constructor which allows for the selection of a default charset.

Parameters:

aCharset - the default string charset to use.

Method Detail

getRFC1522Encoding

protected String getRFC1522Encoding()

Description copied from class: AbstractRFC1522Codec

Returns the codec name (referred to as encoding in the RFC 1522).

Specified by:

getRFC1522Encoding in class AbstractRFC1522Codec

Returns:

name of the codec

getCharset

@Nonnull
public Charset getCharset()

isEncodeBlanks

public boolean isEncodeBlanks()

Tests if optional transformation of SPACE characters is to be used

Returns:

true if SPACE characters are to be transformed, false otherwise

setEncodeBlanks

public void setEncodeBlanks(boolean bEncodeBlanks)

Defines whether optional transformation of SPACE characters is to be used

Parameters:

bEncodeBlanks - true if SPACE characters are to be transformed, false otherwise

getEncoded

@Nullable
@ReturnsMutableCopy
public byte[] getEncoded(@Nullable
                                            byte[] aBuffer)

Description copied from interface: IByteArrayEncoder

Encode a byte array.

Parameters:

aBuffer - The byte array to be encoded. May be null.

Returns:

The encoded byte array or null if the parameter was null.

getDecoded

@Nullable
@ReturnsMutableCopy
public byte[] getDecoded(@Nullable
                                            byte[] aBuffer)
                  throws DecodeException

Description copied from interface: IByteArrayDecoder

Decode a byte array.

Parameters:

aBuffer - The byte array to be decoded. May not be null.

Returns:

The decoded byte array or null if the parameter was null.

Throws:

DecodeException - in case something goes wrong

getEncodedText

@Nullable
public String getEncodedText(@Nullable
                             String sText)
                      throws EncodeException

Encodes a string into its quoted-printable form using the default charset. Unsafe characters are escaped.

Parameters:

sText - string to convert to quoted-printable form

Returns:

quoted-printable string

Throws:

EncodeException - thrown if a failure condition is encountered during the encoding process.

getDecodedText

@Nullable
public String getDecodedText(@Nullable
                             String sText)
                      throws DecodeException

Decodes a quoted-printable string into its original form. Escaped characters are converted back to their original representation.

Overrides:

getDecodedText in class AbstractRFC1522Codec

Parameters:

sText - quoted-printable string to convert into its original form

Returns:

original string

Throws:

DecodeException - A decoder exception is thrown if a failure condition is encountered during the decode process.