⇒ Index (Frames) |  ⇒ Index (No Frames) |  ⇒ Package |  ⇒ Package Tree |  ⇒ Full Tree 
javax.mail.internet

Class HeaderTokenizer

java.lang.Object
|
+--javax.mail.internet.HeaderTokenizer


public class HeaderTokenizer
extends java.lang.Object

This class tokenizes RFC822 and MIME headers into the basic symbols specified by RFC822 and MIME.

This class handles folded headers (ie headers with embedded CRLF SPACE sequences). The folds are removed in the returned tokens.

Author:

Field Summary

static String

MIME

MIME specials

static String

RFC822

RFC822 specials

Constructor Summary

HeaderTokenizer(String header, String delimiters, boolean skipComments)

Constructor that takes a rfc822 style header.

HeaderTokenizer(String header, String delimiters)

Constructor.

HeaderTokenizer(String header)

Constructor.

Method Summary

String

getRemainder()

Return the rest of the header.

HeaderTokenizer.Token

next()

Parses the next token from this String.

HeaderTokenizer.Token

peek()

Peek at the next token, without actually removing the token from the parse stream.

Field Details

MIME

public static final String MIME

MIME specials


RFC822

public static final String RFC822

RFC822 specials

Constructor Details

HeaderTokenizer

public HeaderTokenizer(String header)

Constructor. The RFC822 defined delimiters - RFC822 - are used to delimit ATOMS. Also comments are skipped and not returned as tokens

Parameters:
header

HeaderTokenizer

public HeaderTokenizer(String header, String delimiters)

Constructor. Comments are ignored and not returned as tokens

Parameters:
header - The header that is tokenized
delimiters - The delimiters to be used

HeaderTokenizer

public HeaderTokenizer(String header, String delimiters, boolean skipComments)

Constructor that takes a rfc822 style header.

Parameters:
header - The rfc822 header to be tokenized
delimiters - Set of delimiter characters to be used to delimit ATOMS.
skipComments - If true, comments are skipped and not returned as tokens

Method Details

getRemainder

public String getRemainder()

Return the rest of the header.


next

public HeaderTokenizer.Token next()

Parses the next token from this String.

Clients sit in a loop calling next() to parse successive tokens until an EOF Token is returned.

Returns:
the next token
Throws:
ParseException - if the parse fails

peek

public HeaderTokenizer.Token peek()

Peek at the next token, without actually removing the token from the parse stream. Invoking this method multiple times will return successive tokens, until next() is called.

Returns:
the next peek token