How rohannagar/jmail works
JMail is a dependency-free Java library for parsing, validating, and working with email addresses. The principal workflow is a caller submitting an address to JMail, which parses it and returns a validation result; callers can instead configure an EmailValidator with additional rules. Successful parsing produces an Email value with address-part accessors and normalization options. Other documented capabilities include IP-address validation, encoded display-name decoding, and optional disposable-domain checks. Relationships reflect the README and SOURCE INDEX references; unsampled implementations are represented only where the tree and references support them.
Main entry points: EmailValidator.java Email Validator · Email.java Parsed Email · JMail.java JMail API · ValidationRules.java Built-in Rules
Components 19
Parsing and API
- JMail API
src/main/java/com/sanctionco/jmail/JMail.java - Parsed Email
src/main/java/com/sanctionco/jmail/Email.java - Validation Result
src/main/java/com/sanctionco/jmail/EmailValidationResult.java
Validation Rules
- Email Validator
src/main/java/com/sanctionco/jmail/EmailValidator.java - Built-in Rules
src/main/java/com/sanctionco/jmail/ValidationRules.java - Failure Reasons
src/main/java/com/sanctionco/jmail/FailureReason.java
Address Features
- Top-Level Domains
src/main/java/com/sanctionco/jmail/TopLevelDomain.java - IP Validation
src/main/java/com/sanctionco/jmail/net/InternetProtocolAddress.java - Normalization Options
src/main/java/com/sanctionco/jmail/normalization/NormalizationOptions.java - Options Builder
src/main/java/com/sanctionco/jmail/normalization/NormalizationOptionsBuilder.java - Case Options
src/main/java/com/sanctionco/jmail/normalization/CaseOption.java - IDN Conversion
src/main/java/com/sanctionco/jmail/normalization/IDNConverter.java - Encoded Names
src/main/java/com/sanctionco/jmail/mime/EncodedWord.java
Optional Sources
- Disposable Domains
src/main/java/com/sanctionco/jmail/disposable/DisposableDomainSource.java - HTTP Client
src/main/java/com/sanctionco/jmail/disposable/HttpClient.java - DNS Lookup
src/main/java/com/sanctionco/jmail/dns/DNSLookupUtil.java - IsTempMail Source
src/main/java/com/sanctionco/jmail/disposable/IsTempMailAPISource.java - Stream Source
src/main/java/com/sanctionco/jmail/disposable/InputStreamSource.java
Other components
- Library Caller
Connections 25
- Library Caller → JMail API: submits address
README.md - Library Caller → Email Validator: configures rules
README.md - JMail API → Email Validator: delegates validation
src/main/java/com/sanctionco/jmail/JMail.java - JMail API → Parsed Email: parses address
src/main/java/com/sanctionco/jmail/JMail.java - JMail API → Validation Result: returns result
src/main/java/com/sanctionco/jmail/JMail.java - JMail API → IP Validation: validates IP
src/main/java/com/sanctionco/jmail/JMail.java - Email Validator → JMail API: uses parser
src/main/java/com/sanctionco/jmail/EmailValidator.java - Email Validator → Built-in Rules: applies rules
src/main/java/com/sanctionco/jmail/EmailValidator.java - Email Validator → Parsed Email: checks parsed email
src/main/java/com/sanctionco/jmail/EmailValidator.java - Email Validator → Validation Result: produces result
src/main/java/com/sanctionco/jmail/EmailValidator.java - Email Validator → Failure Reasons: reports failures
src/main/java/com/sanctionco/jmail/EmailValidator.java - Built-in Rules → Parsed Email: checks address fields
src/main/java/com/sanctionco/jmail/ValidationRules.java - Built-in Rules → Top-Level Domains: checks TLD
src/main/java/com/sanctionco/jmail/ValidationRules.java - Built-in Rules → DNS Lookup: uses lookup
src/main/java/com/sanctionco/jmail/ValidationRules.java - Built-in Rules → Disposable Domains: checks domain
src/main/java/com/sanctionco/jmail/ValidationRules.java - Parsed Email → Top-Level Domains: extracts TLD
src/main/java/com/sanctionco/jmail/Email.java - Parsed Email → Encoded Names: decodes display name
src/main/java/com/sanctionco/jmail/Email.java - Parsed Email → Normalization Options: normalizes address
src/main/java/com/sanctionco/jmail/Email.java - Parsed Email → IDN Conversion: converts domain
src/main/java/com/sanctionco/jmail/Email.java - Options Builder → Normalization Options: builds options
src/main/java/com/sanctionco/jmail/normalization/NormalizationOptionsBuilder.java - Normalization Options → Case Options: selects casing
src/main/java/com/sanctionco/jmail/normalization/NormalizationOptions.java - Disposable Domains → Stream Source: creates stream source
src/main/java/com/sanctionco/jmail/disposable/DisposableDomainSource.java - Disposable Domains → IsTempMail Source: creates API source
src/main/java/com/sanctionco/jmail/disposable/DisposableDomainSource.java - Disposable Domains → HTTP Client: configures client
src/main/java/com/sanctionco/jmail/disposable/DisposableDomainSource.java - IsTempMail Source → HTTP Client: requests API data
src/main/java/com/sanctionco/jmail/disposable/IsTempMailAPISource.java