| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
InternetHeaders hedr = new InternetHeaders();
Based on 39 examples
public class InternetHeaders extends Object
InternetHeaders is a utility class that manages RFC822 style headers. Given an RFC822 format message stream, it reads lines until the blank line that indicates end of header. The input stream is positioned at the start of the body. The lines are stored within the object and can be extracted as either Strings or {@link javax.mail.Header} objects.
This class is mostly intended for service providers. MimeMessage and MimeBody use this class for holding their headers.
RFC822 and MIME header fields must contain only
US-ASCII characters. If a header contains non US-ASCII characters,
it must be encoded as per the rules in RFC 2047. The MimeUtility
class provided in this package can be used to to achieve this.
Callers of the setHeader
, addHeader
, and
addHeaderLine
methods are responsible for enforcing
the MIME requirements for the specified headers. In addition, these
header fields must be folded (wrapped) before being sent if they
exceed the line length limitation for the transport (1000 bytes for
SMTP). Received headers may have been folded. The application is
responsible for folding and unfolding headers as appropriate.
Nested Class Summary | |
---|---|
protected static class |
An individual internet header. |
Field Summary | |
---|---|
protected List |
headers
The actual list of Headers, including placeholder entries. |
Constructor Summary | |
---|---|
Create an empty InternetHeaders object. |
|
Read and parse the given RFC822 message stream till the blank line separating the header from the body. |
Method Summary | |
---|---|
void |
Add a header with the specified name and value to the header list. |
void |
addHeaderLine(String line) Add an RFC822 header line to the header store. |
Enumeration |
Return all the header lines as an Enumeration of Strings. |
Enumeration |
Return all the headers as an Enumeration of javax.mail.Header objects. |
String[] |
Return all the values for the specified header. |
String |
Get all the headers for this header name, returned as a single String, with headers separated by the delimiter. |
Enumeration |
getMatchingHeaderLines(String[] names) Return all matching header lines as an Enumeration of Strings. |
Enumeration |
getMatchingHeaders(String[] names) Return all matching javax.mail.Header objects. |
Enumeration |
getNonMatchingHeaderLines(String[] names) Return all non-matching header lines |
Enumeration |
getNonMatchingHeaders(String[] names) Return all non-matching javax.mail.Header objects. |
void |
load(InputStream is) Read and parse the given RFC822 message stream till the blank line separating the header from the body. |
void |
removeHeader(String name) Remove all header entries that match the given name |
void |
Change the first header line that matches name to have value, adding a new header if no existing header matches. |
Field Detail |
---|
protected List headers
Received
and
Return-Path
headers). If no existing header
or placeholder for the header is found, new headers are
added after the special placeholder with the name ":".
Constructor Detail |
---|
public InternetHeaders()
public InternetHeaders(InputStream is) throws MessagingException
For efficiency, wrap a BufferedInputStream around the actual input stream and pass it as the parameter.
No placeholder entries are inserted; the original order of the headers is preserved.
is
- RFC822 input streamMessagingException
Method Detail |
---|
public void addHeader(String name, String value)
The current implementation knows about the preferred order of most
well-known headers and will insert headers in that order. In
addition, it knows that Received
headers should be
inserted in reverse order (newest before oldest), and that they
should appear at the beginning of the headers, preceeded only by
a possible Return-Path
header.
Note that RFC822 headers can only contain US-ASCII characters.
name
- header namevalue
- header valuepublic void addHeaderLine(String line)
Note that RFC822 headers can only contain US-ASCII characters
line
- raw RFC822 header linepublic Enumeration getAllHeaderLines()
public Enumeration getAllHeaders()
public String[] getHeader(String name)
null
if no headers with the specified name exist.
name
- header namepublic String getHeader(String name, String delimiter)
null
, only the first header is
returned. Returns null
if no headers with the specified name exist.
name
- header namedelimiter
- delimiterpublic Enumeration getMatchingHeaderLines(String[] names)
names
public Enumeration getMatchingHeaders(String[] names)
names
public Enumeration getNonMatchingHeaderLines(String[] names)
names
public Enumeration getNonMatchingHeaders(String[] names)
names
public void load(InputStream is) throws MessagingException
Note that the header lines are added into this InternetHeaders object, so any existing headers in this object will not be affected. Headers are added to the end of the existing list of headers, in order.
is
- RFC822 input streamMessagingException
public void removeHeader(String name)
name
- header namepublic void setHeader(String name, String value)
Note that RFC822 headers can only contain US-ASCII characters
name
- header namevalue
- header value
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |