com.aspose.email

Interfaces

Classes

Enums

Exceptions

com.aspose.email

Class HeaderType



  • public final class HeaderType
    extends Object

    Represents the Internet standards and RFCs define header fields which may occur on Internet Mail Messages .

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      boolean equals(Object o)
      Returns a boolean indicating if the passed in object obj is Equal to this.
      static HeaderType getApparentlyTo()
      Inserted by sending e-mail when there is no 'To:' recipient in the original message.
      static HeaderType getApprovedBy()
      Name of the moderator of the mailing list to which this message is sent; necessary on a posting sent to a moderated mailing list to allow its distribution to the list members.
      static HeaderType getBcc()
      A copy of the e-mail message that is sent to one or more recipients without the knowledge of the primary recipients.
      static HeaderType getCC()
      This header can be considered an extension of the 'To:' field as it is used to specifiy additional recipients.
      static HeaderType getComments()
      This is a free-form header field defined in RFC2822.
      static HeaderType getContentTransferEncoding()
      The third of the MIME-related headers.
      static HeaderType getContentType()
      The 'Content-Type' defines the format of content (character set etc.) Note that the values for this header are defined in different ways in RFC1049 and in MIME (RFC2045).
      static HeaderType getDate()
      This header specifies a date (and time), normally the date the message was composed and sent.
      static HeaderType getDispositionNotificationTo()
      When the DispositionNotificationTo field is set, a request for a MDN (Message Delivery Notification) is made.
      static HeaderType getFollowupTo()
      Used in Usenet News to indicate that future discussions (=follow-up) on an article should go to a different set of newsgroups than the replied-to article.
      static HeaderType getFrom()
      This field contains the identity of the person(s) who wished this message to be sent.
      static HeaderType getImportance()
      Gets the importance.
      static HeaderType getInReplyTo()
      Reference to message which this message is a reply to.
      static HeaderType getMessageID()
      Unique ID of this message.
      static HeaderType getMIMEVersion()
      An indicator that this message is formatted according to the MIME standard, and an indication of which version of MIME is utilized.
      static HeaderType getNewsgroups()
      In Usenet News: group(s) to which this article was posted.
      static HeaderType getReceived()
      Trace of MTAs which a message has passed.
      static HeaderType getReferences()
      Reference to other related messages.
      static HeaderType getReplyTo()
      This header field is meant to indicate where the sender wants replies to go.
      static HeaderType getReturnPath()
      Used to convey the information from the MAIL FROM envelope attribute in final delivery, when the message leaves the SMTP environment in which 'MAIL FROM' is used.
      static HeaderType getReturnReceiptTo()
      A sender can request a return-receipt by including this header field.
      static HeaderType getSender()
      The person or agent submitting the message to the network, if other than shown by the From: header field.
      static HeaderType getSensitivity()
      Gets the sensitivity.
      static HeaderType getSubject()
      Title, heading, subject.
      static HeaderType getTo()
      Primary recipients.
      static HeaderType getXConfirmReadingTo()
      This header requests an automated confirmation notice when the message is received or read.
      static HeaderType getXMailer()
      Information about the client software of the originator.
      int hashCode()
      Serves as a hash function for a particular type.
      String toString()
      Returns a T:System.String that represents the current T:System.Object.
      static String toString(HeaderType type)
      Performs an implicit conversion from HeaderType to System.String.
    • Method Detail

      • equals

        public boolean equals(Object o)

        Returns a boolean indicating if the passed in object obj is Equal to this.

        Overrides:
        equals in class Object
        Parameters:
        o - The HeaderType object to compare.
        Returns:
        Returns true if objects are equal, otherwise returns false
      • hashCode

        public int hashCode()

        Serves as a hash function for a particular type.

        Overrides:
        hashCode in class Object
        Returns:
        A hash code for the current T:System.Object.
      • toString

        public String toString()

        Returns a T:System.String that represents the current T:System.Object.

        Overrides:
        toString in class Object
        Returns:
        A T:System.String that represents the current T:System.Object.
      • getApparentlyTo

        public static HeaderType getApparentlyTo()

        Inserted by sending e-mail when there is no 'To:' recipient in the original message. This causes the recipients derived from the envelope to be listed in the message heading. This behavior is not quite proper, MTAs should not modify headers (except inserting Received lines), and it can in some cases cause Bcc recipients to be wrongly divulged to non-Bcc recipients. Example: Apparently-To: someone@somedomain.com Non-standard header that is discouraged in use, mentioned in RFC1211.

        Returns:
        a HeaderType object.
      • getApprovedBy

        public static HeaderType getApprovedBy()

        Name of the moderator of the mailing list to which this message is sent; necessary on a posting sent to a moderated mailing list to allow its distribution to the list members. Example: Approved-By: someone@somedomain.com Non-standard for use in e-mail. Defined in RFC1036.

        Returns:
        a HeaderType object.
      • getBcc

        public static HeaderType getBcc()

        A copy of the e-mail message that is sent to one or more recipients without the knowledge of the primary recipients. Primary recipients are listed in the To: and Cc: lines. This is useful if you want to copy a message to many people without each of them seeing who the other recipients are. If you see this header on incoming mail, something is wrong because it does not appear in the headers.

        Returns:
        a HeaderType object.
      • getCC

        public static HeaderType getCC()

        This header can be considered an extension of the 'To:' field as it is used to specifiy additional recipients. In this case, the copy of an e-mail message sent to a recipient has the recipient's address appearing in the message. This is useful if you want to copy a message to many people with each of them seeing who the other recipients are; contrast with Bcc above. This header does appear in incoming e-mail. Exmple: Cc: gboyd@netcom.com

        Returns:
        a HeaderType object.
      • getDispositionNotificationTo

        public static HeaderType getDispositionNotificationTo()

        When the DispositionNotificationTo field is set, a request for a MDN (Message Delivery Notification) is made. The recipient's email software (Outlook, Eudora, etc.) may silently ignore the request, or it may prompt the user for permission to send the MDN. There is no guarantee of the 'return-receipt'. The DispositionNotificationTo field is the de facto standard for requesting return-receipts (i.e. MDN, or message delivery notifications).

        Returns:
        a HeaderType object.
      • getReturnReceiptTo

        public static HeaderType getReturnReceiptTo()

        A sender can request a return-receipt by including this header field. The return-receipt is sent to the Return-Path address of the email and not to the address specified in the Return-Receipt-To header field. This header is non-standard and mostly not supported. Use Disposition-Notification-To instead. Even if supported, there is no guarantee of a receipt being sent.

        Returns:
        a HeaderType object.
      • getComments

        public static HeaderType getComments()

        This is a free-form header field defined in RFC2822. The header is used to place explanatory text into the header portion of an e-mail message. The field may contain arbitrary text. Exmple: Comments: Authenticated sender is someone@somedonmain.com.

        Returns:
        a HeaderType object.
      • getContentType

        public static HeaderType getContentType()

        The 'Content-Type' defines the format of content (character set etc.) Note that the values for this header are defined in different ways in RFC1049 and in MIME (RFC2045). Look for the MIME-version: header to understand if Content-Type is to be interpreted according to RFC1049 or according to MIME (RFC2045). The MIME definition should be used in generating mail. Historically, Content-Type field was proposed in RFC1049. In it, Content-Type did not distinguish type and subtype like RFC2045 does. Example: Content-Type: text/plain; charset='us-ascii' Content-type: text/plain; charset=US-ASCII Content-Type: text/plain; charset='iso-8859-1' Content-Type: text/plain; charset=koi8-r Content-Type: text/plain; charset=unknown-8bit

        Returns:
        a HeaderType object.
      • getContentTransferEncoding

        public static HeaderType getContentTransferEncoding()

        The third of the MIME-related headers. Indicates the coding method used in a MIME message body. It has no direct relevance to the delivery of e-mail, but it affects how MIME compliant mail programs interpret the content of the message. Defined in RFC2045. Content-Transfer-Encoding: 8bit Content-transfer-encoding: 7BIT Content-Transfer-Encoding: 7bit Content-Transfer-Encoding: base64 Content-Transfer-Encoding: quoted-printable

        Returns:
        a HeaderType object.
      • getDate

        public static HeaderType getDate()

        This header specifies a date (and time), normally the date the message was composed and sent. In X.400 mail systems, the time a message was submitted. Some Internet mail systems also use the date when the message was submitted. If this header is omitted by the sender's computer, it might conceivably be added by a mail server or even by some other machine along the route. What you may not know is that the information in the 'Date:' line is supplied by the time on the sender's computer, which may or may not be set correctly. Also, the 'Date:' header does not normally indicate when the message was sent, but only when it was composed. The date is in the form 3 character day-of-week (Sun - Sat), day number (1-31) dd, 3-character month name, 4-digit year yyyy, followed by time (24-hour) hh:mm:ss and zone zzz format. Time Zone (zzz) is either the 3-character time zone or the local differential in hours and minutes offset from UTC (Universal Time Coordinated - old Greenwich Mean Time). '-' indicates west and '+' indicates east of UTC. No standard Time Zone definitions seem to exist. Many UNIX versions understand a great range of abbreviations, but the most exhaustive list I found was the GNU tar manual Timezone item and documentation for the Perl date manipulation module TIMEZONES. Example: Date: Tue, 9 Jan 2001 23:40:00 -0800 Date: Sun, 1 Apr 2001 22:52:04 EDT Date: Mon, 2 Apr 2001 16:02:19 +0200 Date: Fri, 30 Mar 2001 10:47:15 -0800

        Returns:
        a HeaderType object.
      • getFrom

        public static HeaderType getFrom()

        This field contains the identity of the person(s) who wished this message to be sent. The message-creation process should default this field to be a single, authenticated machine address, indicating the AGENT (person, system or process) composing the message. If this is not done, the 'Sender:' field MUST be present. If the 'From:' field IS defaulted this way, the 'Sender:' field is optional and is redundant with the 'From:' field. Example: From: 'Mr. Some One' someone@somedomain.com

        Returns:
        a HeaderType object.
      • getFollowupTo

        public static HeaderType getFollowupTo()

        Used in Usenet News to indicate that future discussions (=follow-up) on an article should go to a different set of newsgroups than the replied-to article. The most common usage is when an article is posted to several newsgroups, and further discussions is to take place in only one of them. Defined in RFC 1036: 2.2.3, not standardized for use in e-mail.

        Returns:
        a HeaderType object.
      • getInReplyTo

        public static HeaderType getInReplyTo()

        Reference to message which this message is a reply to.

        Returns:
        a HeaderType object.
      • getMessageID

        public static HeaderType getMessageID()

        Unique ID of this message. Defined In RFC 822: 4.6.1 ,RFC 1036: 2.1.5.

        Returns:
        a HeaderType object.
      • getMIMEVersion

        public static HeaderType getMIMEVersion()

        An indicator that this message is formatted according to the MIME standard, and an indication of which version of MIME is utilized. Defined in RFC 2045

        Returns:
        a HeaderType object.
      • getNewsgroups

        public static HeaderType getNewsgroups()

        In Usenet News: group(s) to which this article was posted. Some systems provide this header field also in e-mail although it is not standardized there. Unfortunately, the header field can appear in e-mail with three different and contradictory meanings: (a) Indicating the newsgroup recipient of an article/message sent to both e-mail and Usenet News recipients. (b) In a message adressed to some mail to news gateways, indicates the newsgroup(s) that the message is to be posted to. (c) In a personally addressed reply to an article in a news-group, indicating the newsgroup in which this discussion originated. Defined in RFC 1036: 2.1.3, not standardized and controversial for use in e-mail.

        Returns:
        a HeaderType object.
      • getReceived

        public static HeaderType getReceived()

        Trace of MTAs which a message has passed. Defined in RFC 822

        Returns:
        a HeaderType object.
      • getReturnPath

        public static HeaderType getReturnPath()

        Used to convey the information from the MAIL FROM envelope attribute in final delivery, when the message leaves the SMTP environment in which 'MAIL FROM' is used. ///

        Returns:
        a HeaderType object.
      • getSender

        public static HeaderType getSender()

        The person or agent submitting the message to the network, if other than shown by the From: header field. Should be authenticated, according to RFC 822, but what kind of authentication is not clear.

        Returns:
        a HeaderType object.
      • getReplyTo

        public static HeaderType getReplyTo()

        This header field is meant to indicate where the sender wants replies to go. Unfortunately, this is ambiguous, since there are different kinds of replies, which the sender may wish to go to different addresses. In particular, there are personal replies intended for only one person, and group replies, intended for the whole group of people who read the replied-to message (often a mailing list, anewsgroup name cannot appear here because of different syntax, see 'FollowupTo' .).

        Returns:
        a HeaderType object.
      • getSubject

        public static HeaderType getSubject()

        Title, heading, subject. Often used as thread indicator for messages replying to or commenting on other messages.

        Returns:
        a HeaderType object.
      • getTo

        public static HeaderType getTo()

        Primary recipients. Example: To: someone@somedomain.com

        Returns:
        a HeaderType object.
      • getReferences

        public static HeaderType getReferences()

        Reference to other related messages.

        Returns:
        a HeaderType object.
      • getXMailer

        public static HeaderType getXMailer()

        Information about the client software of the originator. Example: X-Mailer: Aspose.Email

        Returns:
        a HeaderType object.
      • getXConfirmReadingTo

        public static HeaderType getXConfirmReadingTo()

        This header requests an automated confirmation notice when the message is received or read. It is typically ignored; presumably some software acts on it.

        Returns:
        a HeaderType object.
      • getImportance

        public static HeaderType getImportance()

        Gets the importance.

        Value: The importance.
        Returns:
        a HeaderType object.
      • getSensitivity

        public static HeaderType getSensitivity()

        Gets the sensitivity.

        Value: The sensitivity.
        Returns:
        a HeaderType object.
      • toString

        public static String toString(HeaderType type)

        Performs an implicit conversion from HeaderType to System.String.

        Parameters:
        type - The 'HeaderType' object to convert.
        Returns:
        The result of the conversion.