Package io.cui.tools.net

Class IDNInternetAddress

java.lang.Object

io.cui.tools.net.IDNInternetAddress

public final class IDNInternetAddress
extends Object

Utility class to handle IDN email addresses.

See

• https://docs.oracle.com/ javase/tutorial/i18n/network/idn.html
• https://de.wikipedia.org /wiki/Internationalisierter_Domainname
• https://en.wikipedia.org/ wiki/Internationalized_domain_name

Author:

Matthias Walliczek

Method Summary

Modifier and Type	Method	Description
static String	decode(@NonNull String completeAddress)	Decode the domain part of an email address
static String	decode(@NonNull String completeAddress, UnaryOperator<String> sanitizer)	Decodes the given address and sanitizes the elements with the provided sanitizer.
static String	encode(@NonNull String completeAddress)	Encode the domain part of an email address
static String	encode(@NonNull String completeAddress, UnaryOperator<String> sanitizer)	Encodes the given address and sanitizes the elements with the provided sanitizer.

Methods inherited from class java.lang.Object

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

Method Detail

encode

public static String encode(@NonNull
                            @NonNull String completeAddress)

Encode the domain part of an email address

Parameters:

completeAddress - the address to encode in RFC822 format

Returns:

the encoded address in RFC822 format

encode

public static String encode(@NonNull
                            @NonNull String completeAddress,
                            UnaryOperator<String> sanitizer)

Encodes the given address and sanitizes the elements with the provided sanitizer. It takes care on the special elements like <> by not trying to sanitize them.

Parameters:

completeAddress -

sanitizer - to be passed as UnaryOperator

Returns:

the sanitized and encoded address.

decode

public static String decode(@NonNull
                            @NonNull String completeAddress)

Decode the domain part of an email address

Parameters:

completeAddress - the address to decode in RFC822 format

Returns:

the decoded address in RFC822 format

decode

public static String decode(@NonNull
                            @NonNull String completeAddress,
                            UnaryOperator<String> sanitizer)

Decodes the given address and sanitizes the elements with the provided sanitizer. It takes care on the special elements like <> by not trying to sanitize them.

Parameters:

completeAddress -

sanitizer - to be passed as UnaryOperator

Returns:

the sanitized and decoded address.