Skip to content
master
Switch branches/tags
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
src
 
 
 
 
 
 
 
 
 
 

README.md

APACHE v2 License Latest Release Build Status Codacy

email-rfc2822-validator

The world's only more-or-less-2822-compliant Java-based email address extractor / verifier

email-rfc2822-validator is available in Maven Central:

<dependency>
    <groupId>com.github.bbottema</groupId>
    <artifactId>emailaddress-rfc2822</artifactId>
    <version>2.3.0</version>
</dependency>

And just to show you that this stuff is hard, here's JavaMail's official parser's javadoc on the subject (line 669):

    /*
     * RFC822 Address parser.
     *
     * XXX - This is complex enough that it ought to be a real parser,
     *       not this ad-hoc mess, and because of that, this is not perfect.
     *
     * XXX - Deal with encoded Headers too.
     */
    @SuppressWarnings("fallthrough")
    private static InternetAddress[] parse(String s, boolean strict,
				    boolean parseHdr) throws AddressException {

Usage

There are two classes available, EmailaddressValidator and EmailAddressParser. The second is used to extract data from (complex / mangled) email strings.

For both of these, you use the EmailAddressCriteria enumeration to control RFC strictness.

Here's an example for validating an email address:

boolean isValid = EmailAddressValidator.isValid(emailaddress);
boolean isValid = EmailAddressValidator.isValid(emailaddress, EmailAddressCriteria.RECOMMENDED);
boolean isValid = EmailAddressValidator.isValid(emailaddress, EmailAddressCriteria.RFC_COMPLIANT);
boolean isValid = EmailAddressValidator.isValid(emailaddress, EnumSet.of(ALLOW_DOT_IN_A_TEXT, ALLOW_SQUARE_BRACKETS_IN_A_TEXT));

Latest Progress

v2.3.0

  • #21: Make Jakarta Mail dependency used for parsing (not validation) optional

NOTE: Jakarta Mail is now an optional dependency, which you need to add yourself, but only if you use the parsing facilities of this library (rather than only the validation function)

v2.2.0

  • #19: Parens not parsed properly and API documentation / usage needs improvement

v2.1.4

  • #17: IllegalArgumentException when passing null to EmailAddressValidator.isValid(String)

v2.1.3

  • #14: Update project to Java 1.7 and Jakarta Mail

v1.1.3

  • #13: Fixed TLD limitation for domains longer than six

v1.1.2

  • Fixed regression bug where name and address were switched around

v1.1.1

  • This library can now be used with any javax.mail dependency from 1.5.5 and upwards.

v1.1.0

  • #7: Clarified validation modes (default vs strictly rfc compliant)

NOTE: EmailAddressValidator.isValid() now validates using EmailAddressCriteria.DEFAULT rather than EmailAddressCriteria.RFC_COMPLIANT. Use EmailAddressValidator.isValidStrict() for RFC compliant validation.

v1.0.1

Initial release

About

The world's only Java-based rfc2822-compliant email address validator and parser

Topics

Resources

License

Contributors 4

  •  
  •  
  •  
  •  

Languages