Package org.apache.james.mime4j.codec

Class DecoderUtil

java.lang.Object

org.apache.james.mime4j.codec.DecoderUtil

public class DecoderUtil
extends Object

Static methods for decoding strings, byte arrays and encoded words.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final ThreadLocal<SoftReference<BufferRecycler>>	_recyclerRef

Constructor Summary

Constructors

Constructor	Description
DecoderUtil()

Method Summary

Modifier and Type	Method	Description
static String	decodeEncodedWords(String body, Charset fallback)	Decodes a string containing encoded words as defined by RFC 2047.
static String	decodeEncodedWords(String body, DecodeMonitor monitor)	Decodes a string containing encoded words as defined by RFC 2047.
static String	decodeEncodedWords(String body, DecodeMonitor monitor, Charset fallback)	Decodes a string containing encoded words as defined by RFC 2047.
static String	decodeEncodedWords(String body, DecodeMonitor monitor, Charset fallback, Map<Charset,Charset> charsetOverrides)	Decodes a string containing encoded words as defined by RFC 2047.
static BufferRecycler	getBufferRecycler()

Methods inherited from class java.lang.Object

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

Field Details

_recyclerRef

protected static final ThreadLocal<SoftReference<BufferRecycler>> _recyclerRef

Constructor Details

DecoderUtil

public DecoderUtil()

Method Details

getBufferRecycler

public static BufferRecycler getBufferRecycler()

decodeEncodedWords

public static String decodeEncodedWords(String body,
 DecodeMonitor monitor)
                                 throws IllegalArgumentException

Decodes a string containing encoded words as defined by RFC 2047. Encoded words have the form =?charset?enc?encoded-text?= where enc is either 'Q' or 'q' for quoted-printable and 'B' or 'b' for base64.

Parameters:

body - the string to decode

monitor - the DecodeMonitor to be used.

Returns:

the decoded string.

Throws:

IllegalArgumentException - only if the DecodeMonitor strategy throws it (Strict parsing)

decodeEncodedWords

public static String decodeEncodedWords(String body,
 Charset fallback)
                                 throws IllegalArgumentException

Decodes a string containing encoded words as defined by RFC 2047. Encoded words have the form =?charset?enc?encoded-text?= where enc is either 'Q' or 'q' for quoted-printable and 'B' or 'b' for base64. Using fallback charset if charset in encoded words is invalid.

Parameters:

body - the string to decode

fallback - the fallback Charset to be used.

Returns:

the decoded string.

Throws:

IllegalArgumentException - only if the DecodeMonitor strategy throws it (Strict parsing)

decodeEncodedWords

public static String decodeEncodedWords(String body,
 DecodeMonitor monitor,
 Charset fallback)
                                 throws IllegalArgumentException

Decodes a string containing encoded words as defined by RFC 2047. Encoded words have the form =?charset?enc?encoded-text?= where enc is either 'Q' or 'q' for quoted-printable and 'B' or 'b' for base64. Using fallback charset if charset in encoded words is invalid.

Parameters:

body - the string to decode

monitor - the DecodeMonitor to be used.

fallback - the fallback Charset to be used.

Returns:

the decoded string.

Throws:

IllegalArgumentException - only if the DecodeMonitor strategy throws it (Strict parsing)

decodeEncodedWords

public static String decodeEncodedWords(String body,
 DecodeMonitor monitor,
 Charset fallback,
 Map<Charset,Charset> charsetOverrides)
                                 throws IllegalArgumentException

Decodes a string containing encoded words as defined by RFC 2047. Encoded words have the form =?charset?enc?encoded-text?= where enc is either 'Q' or 'q' for quoted-printable and 'B' or 'b' for base64. Using fallback charset if charset in encoded words is invalid. Additionally, the found charset will be overridden if a corresponding mapping is found.

Parameters:

body - the string to decode

monitor - the DecodeMonitor to be used.

fallback - the fallback Charset to be used.

charsetOverrides - the Charsets to override and their replacements. Must not be null.

Returns:

the decoded string.

Throws:

IllegalArgumentException - only if the DecodeMonitor strategy throws it (Strict parsing)