javax.mail.internet

Class InternetHeaders

java.lang.Object

javax.mail.internet.InternetHeaders

public class InternetHeaders
extends java.lang.Object

Class that represents the RFC822 headers associated with a message.

Version:

$Rev: 517148 $ $Date: 2007-03-12 10:31:41 +0100 (Mon, 12 Mar 2007) $

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	InternetHeaders.InternetHeader

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List	headers

Constructor Summary

Constructors

Constructor and Description
InternetHeaders() Create an empty InternetHeaders
InternetHeaders(java.io.InputStream in) Create a new InternetHeaders initialized by reading headers from the stream.

Method Summary

Modifier and Type	Method and Description
void	addHeader(java.lang.String name, java.lang.String value) Add a new value to the header with the supplied name.
void	addHeaderLine(java.lang.String line) Add an RFC822 header line to the header store.
java.util.Enumeration	getAllHeaderLines() Return all the header lines as an Enumeration of Strings.
java.util.Enumeration	getAllHeaders() Return all headers.
java.lang.String[]	getHeader(java.lang.String name) Return all the values for the specified header.
java.lang.String	getHeader(java.lang.String name, java.lang.String delimiter) Return the values for the specified header as a single String.
java.util.Enumeration	getMatchingHeaderLines(java.lang.String[] names) Return all matching header lines as an Enumeration of Strings.
java.util.Enumeration	getMatchingHeaders(java.lang.String[] names) Return all matching Header objects.
java.util.Enumeration	getNonMatchingHeaderLines(java.lang.String[] names) Return all non-matching header lines.
java.util.Enumeration	getNonMatchingHeaders(java.lang.String[] names) Return all non matching Header objects.
void	load(java.io.InputStream in) Read and parse the supplied stream and add all headers to the current set.
void	removeHeader(java.lang.String name) Remove all header entries with the supplied name
void	setHeader(java.lang.String name, java.lang.String value) Set the value of the header to the supplied value; any existing headers are removed.

Methods inherited from class java.lang.Object

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

Field Detail

headers

protected java.util.List headers

Constructor Detail

InternetHeaders

public InternetHeaders()

Create an empty InternetHeaders

InternetHeaders

public InternetHeaders(java.io.InputStream in)
                throws MessagingException

Create a new InternetHeaders initialized by reading headers from the stream.

Parameters:

in - the RFC822 input stream to load from

Throws:

MessagingException - if there is a problem pasring the stream

Method Detail

load

public void load(java.io.InputStream in)
          throws MessagingException

Read and parse the supplied stream and add all headers to the current set.

Parameters:

in - the RFC822 input stream to load from

Throws:

MessagingException - if there is a problem pasring the stream

getHeader

public java.lang.String[] getHeader(java.lang.String name)

Return all the values for the specified header.

Parameters:

name - the header to return

Returns:

the values for that header, or null if the header is not present

getHeader

public java.lang.String getHeader(java.lang.String name,
                                  java.lang.String delimiter)

Return the values for the specified header as a single String. If the header has more than one value then all values are concatenated together separated by the supplied delimiter.

Parameters:

name - the header to return

delimiter - the delimiter used in concatenation

Returns:

the header as a single String

setHeader

public void setHeader(java.lang.String name,
                      java.lang.String value)

Set the value of the header to the supplied value; any existing headers are removed.

Parameters:

name - the name of the header

value - the new value

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String value)

Add a new value to the header with the supplied name.

Parameters:

name - the name of the header to add a new value for

value - another value

removeHeader

public void removeHeader(java.lang.String name)

Remove all header entries with the supplied name

Parameters:

name - the header to remove

getAllHeaders

public java.util.Enumeration getAllHeaders()

Return all headers.

Returns:

an Enumeration

containing all headers

getMatchingHeaders

public java.util.Enumeration getMatchingHeaders(java.lang.String[] names)

Return all matching Header objects.

getNonMatchingHeaders

public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names)

Return all non matching Header objects.

addHeaderLine

public void addHeaderLine(java.lang.String line)

Add an RFC822 header line to the header store. If the line starts with a space or tab (a continuation line), add it to the last header line in the list. Otherwise, append the new header line to the list. Note that RFC822 headers can only contain US-ASCII characters

Parameters:

line - raw RFC822 header line

getAllHeaderLines

public java.util.Enumeration getAllHeaderLines()

Return all the header lines as an Enumeration of Strings.

getMatchingHeaderLines

public java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names)

Return all matching header lines as an Enumeration of Strings.

getNonMatchingHeaderLines

public java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names)

Return all non-matching header lines.