    All Packages    This Package    Previous    Next

# Class net.www.html.MessageHeader

    java.lang.Object
       |
       +----net.www.html.MessageHeader

public class MessageHeader
extends Object

An RFC 844 or MIME message header. Includes methods for parsing headers from incoming streams, fetching values, setting values, and printing headers. Key values of null are legal: they indicate lines in the header that don't have a valid key, but do have a value (this isn't legal according to the standard, but lines like this are everywhere).

##

MessageHeader()
MessageHeader(InputStream)

##

add(String, String)
  Adds a key value pair to the end of the header.
canonicalID(String)
  Convert a message-id string to canonical form (strips off leading and trailing <>s)
findNextValue(String, String)
  Find the next value that corresponds to this key.
findValue(String)
  Find the value that corresponds to this key.
parseHeader(InputStream)
  Parse a MIME header from an input stream.
print(PrintStream)
  Prints the key-value pairs represented by this header.
set(String, String)
  Sets the value of a key.

##

MessageHeader

      public MessageHeader()

MessageHeader

      public MessageHeader(InputStream is)

##

findValue

      public String findValue(String k)

  Find the value that corresponds to this key. It finds only the first occurrance of the key. Returns null if not found.

findNextValue

      public String findNextValue(String k,
                                  String v)

  Find the next value that corresponds to this key. It finds the first value that follows v. To iterate over all the values of a key use:

      		for(String v=h.findValue(k); v!=null; v=h.findNextValue(k, v)) {
      		    ...
      		}

print

      public void print(PrintStream p)

  Prints the key-value pairs represented by this header. Also prints the RFC required blank line at the end. Omits pairs with a null key.

add

      public void add(String k,
                      String v)

  Adds a key value pair to the end of the header. Duplicates are allowed

set

      public void set(String k,
                      String v)

  Sets the value of a key. If the key already exists in the header, it's value will be changed. Otherwise a new key/value pair will be added to the end of the header.

canonicalID

      public String canonicalID(String id)

  Convert a message-id string to canonical form (strips off leading and trailing <>s)

parseHeader

      public void parseHeader(InputStream is)

  Parse a MIME header from an input stream.

    All Packages    This Package    Previous    Next