Class MailSendUtil


  • public final class MailSendUtil
    extends Object
    Utility class for sending mail.
    • Method Detail

      • send

        public static void send​(MandantMailData data,
                                IBaseMailData mail)
                         throws Exception
        Sends email(s), using the client email server when available or the system mail server otherwise.
        Parameters:
        data - Data regarding the client mail server to use. When null or not available, uses the system mail server configuration.
        mail - Email to send.
        Throws:
        MailContextNotAvailableException - When neither a client mail server nor a system mail server is available.
        Exception - When the email cannot be sent, such as when an email address is invalid, the network is not available etc.
      • send

        public static void send​(Mandant client,
                                IBaseMailData mail)
                         throws Exception
        Sends email(s), using the email server of the client when available, or the system email server otherwise.
        Parameters:
        client - Client with a mail server to use. When null or unavailable, uses the system mail server configuration.
        mail - Email to send.
        Throws:
        MailContextNotAvailableException - When neither a client mail server nor a system mail server is available.
        Exception - When the email cannot be sent, such as when an email address is invalid, the network is not available etc.
      • send

        public static void send​(IMailServerData serverData,
                                IBaseMailData mailData)
                         throws Exception
        Sends mail(s) based on the server data and mail data
        Parameters:
        serverData - the data of the server
        mailData - the data of the mail
        Throws:
        Exception - When the email cannot be sent, such as when an email address is invalid, the network is not available etc.
      • send

        @Deprecated
        public static void send​(String server,
                                Integer port,
                                javax.mail.Authenticator auth,
                                EMailEncryption encryption,
                                IBaseMailData mail)
                         throws Exception
        Sends email(s) via the given mail server.
        Parameters:
        server - Address of the mail server.
        port - Port of the mail sever. Must not be null.
        auth - Authenticator when required, may be null.
        encryption - Email encryption method to use.
        mail - Email to send.
        Throws:
        MailContextNotAvailableException - When the given mail server configuration is invalid.
        Exception - When the email cannot be sent, such as when an email address is invalid, the network is not available etc.
      • send

        @Deprecated
        public static void send​(String server,
                                Integer port,
                                javax.mail.Authenticator auth,
                                EMailEncryption encryption,
                                boolean allowUtf8,
                                IBaseMailData mail)
                         throws Exception
        Sends email(s) via the given mail server.
        Parameters:
        server - Address of the mail server.
        port - Port of the mail sever. Must not be null.
        auth - Authenticator when required, may be null.
        encryption - Email encryption method to use.
        allowUtf8 - Whether the mail server support UTF-8 message headers.
        mail - Email to send.
        Throws:
        MailContextNotAvailableException - When the given mail server configuration is invalid.
        Exception - When the email cannot be sent, such as when an email address is invalid, the network is not available etc.