Class NewsAddress

java.lang.Object
jakarta.mail.Address
jakarta.mail.internet.NewsAddress
All Implemented Interfaces:
Serializable

public class NewsAddress extends Address
This class models an RFC1036 newsgroup address.
Author:
Bill Shannon, John Mani
See Also:
  • Field Details

    • newsgroup

      protected String newsgroup
      The newsgroup.
    • host

      protected String host
      The host. May be null.
  • Constructor Details

    • NewsAddress

      public NewsAddress()
      Default constructor.
    • NewsAddress

      public NewsAddress(String newsgroup)
      Construct a NewsAddress with the given newsgroup.
      Parameters:
      newsgroup - the newsgroup
    • NewsAddress

      public NewsAddress(String newsgroup, String host)
      Construct a NewsAddress with the given newsgroup and host.
      Parameters:
      newsgroup - the newsgroup
      host - the host
  • Method Details

    • getType

      public String getType()
      Return the type of this address. The type of a NewsAddress is "news".
      Specified by:
      getType in class Address
      Returns:
      address type
      See Also:
    • setNewsgroup

      public void setNewsgroup(String newsgroup)
      Set the newsgroup.
      Parameters:
      newsgroup - the newsgroup
    • getNewsgroup

      public String getNewsgroup()
      Get the newsgroup.
      Returns:
      newsgroup
    • setHost

      public void setHost(String host)
      Set the host.
      Parameters:
      host - the host
    • getHost

      public String getHost()
      Get the host.
      Returns:
      host
    • toString

      public String toString()
      Convert this address into a RFC 1036 address.
      Specified by:
      toString in class Address
      Returns:
      newsgroup
    • equals

      public boolean equals(Object a)
      The equality operator.
      Specified by:
      equals in class Address
      Parameters:
      a - Address object
    • hashCode

      public int hashCode()
      Compute a hash code for the address.
      Overrides:
      hashCode in class Object
    • toString

      public static String toString(Address[] addresses)
      Convert the given array of NewsAddress objects into a comma separated sequence of address strings. The resulting string contains only US-ASCII characters, and hence is mail-safe.
      Parameters:
      addresses - array of NewsAddress objects
      Returns:
      comma separated address strings
      Throws:
      ClassCastException - if any address object in the given array is not a NewsAddress objects. Note that this is a RuntimeException.
    • parse

      public static NewsAddress[] parse(String newsgroups) throws AddressException
      Parse the given comma separated sequence of newsgroups into NewsAddress objects.
      Parameters:
      newsgroups - comma separated newsgroup string
      Returns:
      array of NewsAddress objects
      Throws:
      AddressException - if the parse failed