com.aspc.remote.util.net

Class EmailUtil

java.lang.Object

com.aspc.remote.util.net.EmailUtil

public final class EmailUtil
extends java.lang.Object

EmailUtil
THREAD MODE: MULTI-THREADED

Since:

July 29, 2013

Author:

Nigel Leck

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EmailUtil.ConnectionSecurity

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.ThreadLocal<java.lang.Boolean>	DISABLE_MX_LOOPUP

Constructor Summary

Constructors

Constructor and Description
EmailUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	checkLinks(java.lang.String htmlBody) validate if the url in html email body is on localhost
static java.lang.String	checkMX(java.lang.String hostName, java.util.Map<java.lang.String,java.lang.Object> hostCache) check the MX record
static java.lang.String[]	lookupMailHosts(java.lang.String domainName) returns a String array of mail exchange servers (mail hosts) sorted from most preferred to least preferred see: RFC 974 - Mail routing and the domain system see: RFC 1034 - Domain names - concepts and facilities see: http://java.sun.com/j2se/1.5.0/docs/guide/jndi/jndi-dns.html - DNS Service Provider for the Java Naming Directory Interface (JNDI)
static Session	makeSessionSMTP()
static Session	makeSessionSMTP(java.lang.String host, int port, java.lang.String username, java.lang.String password, EmailUtil.ConnectionSecurity security)
static void	validate(java.lang.String email, java.util.Map<java.lang.String,java.lang.Object> hostCache) Validate an email address.
static void	validateSMTP(java.lang.String host, int port, java.lang.String username, java.lang.String password, EmailUtil.ConnectionSecurity security)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DISABLE_MX_LOOPUP

public static final java.lang.ThreadLocal<java.lang.Boolean> DISABLE_MX_LOOPUP

Constructor Detail

EmailUtil

public EmailUtil()

Method Detail

makeSessionSMTP

public static Session makeSessionSMTP()
                               throws InvalidDataException

Throws:

InvalidDataException

makeSessionSMTP

@Nonnull
 @CheckReturnValue
public static Session makeSessionSMTP(java.lang.String host,
                                                                  int port,
                                                                  java.lang.String username,
                                                                  java.lang.String password,
                                                                  EmailUtil.ConnectionSecurity security)
                                                           throws InvalidDataException

Throws:

InvalidDataException

checkLinks

@CheckReturnValue
 @Nullable
public static java.lang.String checkLinks(@Nonnull
                                                                       java.lang.String htmlBody)

validate if the url in html email body is on localhost

Parameters:

htmlBody - email html body

Returns:

returns null if html valid, or the invalid url

validateSMTP

public static void validateSMTP(java.lang.String host,
                                int port,
                                java.lang.String username,
                                java.lang.String password,
                                EmailUtil.ConnectionSecurity security)
                         throws AuthenticationFailedException,
                                MessagingException

Throws:

AuthenticationFailedException

MessagingException

validate

public static void validate(@Nonnull
                            java.lang.String email,
                            @Nullable
                            java.util.Map<java.lang.String,java.lang.Object> hostCache)
                     throws InvalidDataException

Validate an email address.

Parameters:

email - the email to validate.

hostCache - OPTIONAL cache of host names

Throws:

InvalidDataException - details of the issue found. http://en.wikipedia.org/wiki/E-mail_address#Local_part

lookupMailHosts

@Nonnull
 @CheckReturnValue
public static java.lang.String[] lookupMailHosts(@Nonnull
                                                                             java.lang.String domainName)
                                                                      throws javax.naming.NamingException

returns a String array of mail exchange servers (mail hosts) sorted from most preferred to least preferred see: RFC 974 - Mail routing and the domain system see: RFC 1034 - Domain names - concepts and facilities see: http://java.sun.com/j2se/1.5.0/docs/guide/jndi/jndi-dns.html - DNS Service Provider for the Java Naming Directory Interface (JNDI)

Parameters:

domainName - the domain to check

Returns:

list of hosts

Throws:

javax.naming.NamingException

checkMX

@CheckReturnValue
 @Nullable
public static java.lang.String checkMX(@Nonnull
                                                                    java.lang.String hostName,
                                                                    @Nullable
                                                                    java.util.Map<java.lang.String,java.lang.Object> hostCache)

check the MX record

Parameters:

hostName - host to check

hostCache - OPTIONAL cache of host names

Returns:

message if NOT valid otherwise NULL