org.apache.commons.codec.net
public class QCodec extends RFC1522Codec implements StringEncoder, StringDecoder
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.
Since: 1.3
Version: $Id: QCodec.java 130370 2004-05-24 00:25:22Z ggregory $
See Also: MIME (Multipurpose Internet Mail Extensions) Part Two: Message
Header Extensions for Non-ASCII Text
Field Summary | |
---|---|
static byte | BLANK |
String | charset
The default charset used for string decoding and encoding. |
boolean | encodeBlanks |
static BitSet | PRINTABLE_CHARS
BitSet of printable characters as defined in RFC 1522. |
static byte | UNDERSCORE |
Constructor Summary | |
---|---|
QCodec()
Default constructor. | |
QCodec(String charset)
Constructor which allows for the selection of a default charset
|
Method Summary | |
---|---|
String | decode(String pString)
Decodes a quoted-printable string into its original form. |
Object | decode(Object pObject)
Decodes a quoted-printable object into its original form. |
protected byte[] | doDecoding(byte[] bytes) |
protected byte[] | doEncoding(byte[] bytes) |
String | encode(String pString, String charset)
Encodes a string into its quoted-printable form using the specified charset. |
String | encode(String pString)
Encodes a string into its quoted-printable form using the default charset. |
Object | encode(Object pObject)
Encodes an object into its quoted-printable form using the default charset. |
String | getDefaultCharset()
The default charset used for string decoding and encoding.
|
protected String | getEncoding() |
boolean | isEncodeBlanks()
Tests if optional tranformation of SPACE characters is to be used
|
void | setEncodeBlanks(boolean b)
Defines whether optional tranformation of SPACE characters is to be used
|
Parameters: charset the default string charset to use.
See Also: JRE character
encoding names
Parameters: pString quoted-printable string to convert into its original form
Returns: original string
Throws: DecoderException A decoder exception is thrown if a failure condition is encountered during the decode process.
Parameters: pObject quoted-printable object to convert into its original form
Returns: original object
Throws: DecoderException A decoder exception is thrown if a failure condition is encountered during the decode process.
Parameters: pString string to convert to quoted-printable form charset the charset for pString
Returns: quoted-printable string
Throws: EncoderException thrown if a failure condition is encountered during the encoding process.
Parameters: pString string to convert to quoted-printable form
Returns: quoted-printable string
Throws: EncoderException thrown if a failure condition is encountered during the encoding process.
Parameters: pObject object to convert to quoted-printable form
Returns: quoted-printable object
Throws: EncoderException thrown if a failure condition is encountered during the encoding process.
Returns: the default string charset.
Returns: true
if SPACE characters are to be transformed, false
otherwise
Parameters: b
true
if SPACE characters are to be transformed, false
otherwise