yakworks.rally.mail.EmailUtils.groovy Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of rally-domain Show documentation

gorm domain models for core app and testing

There is a newer version: 7.3.76

/*
* Copyright 2023 Yak.Works - Licensed under the Apache License, Version 2.0 (the "License")
* You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
*/
package yakworks.rally.mail

import javax.mail.internet.AddressException
import javax.mail.internet.InternetAddress

import groovy.transform.CompileStatic

import org.apache.commons.lang3.StringUtils

import yakworks.api.problem.data.DataProblem

/**
 * Misc utils for emails.
 */
@CompileStatic
class EmailUtils {

    /**
     * Accepts a string with 1 or more emails in a comma separated RFC 822 format. 

     * Examples: 

     * "[email protected]" - simple single email 

     * "Account Services , "Galt, John" , [email protected]" - 3 valid emails
     *
     * @throws ThrowableProblem if validation fails
     */
    static void validateEmail(String emails) {
        if (!emails?.trim()) {
            throw DataProblem.of("error.data.empty").detail("Empty email").toException()
        }
        try {
            InternetAddress[] addys = InternetAddress.parse(emails)
            for (InternetAddress addr : addys) {
                try {
                    addr.validate()
                } catch (AddressException e) {
                    throw DataProblem.of(e)
                        .payload(addr.address)
                        .detail("Invalid email address [${addr.address}], " + e.message).toException()
                }
            }
        } catch (AddressException e) {
            throw DataProblem.of(e).payload(emails).toException()
        }
    }

    public static String nameWithEmail(String name, String email) {
        return StringUtils.isBlank(name) ? email : name + " <" + email + ">"
    }
}