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.

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.

Methods inherited from class java.lang.Object

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

Constructor Detail

DecoderUtil

public DecoderUtil()

Method Detail

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)