Package gnu.inet.encoding
Class IDNA
java.lang.Object
gnu.inet.encoding.IDNA
This class offers static methods for converting internationalized domain names to ACE and back.
- RFC3490 IDNA
-
Field Summary
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic String
Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1.static String
Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1.static String
Converts an ASCII-encoded string to Unicode.static String
Converts an ASCII-encoded string to Unicode.
-
Field Details
-
ACE_PREFIX
- See Also:
-
-
Constructor Details
-
IDNA
public IDNA()
-
-
Method Details
-
toASCII
Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1. Unassigned characters are not allowed and STD3 ASCII rules are enforced. The input string may be a domain name containing dots.- Parameters:
input
- Unicode string.- Returns:
- Encoded string.
- Throws:
IDNAException
-
toASCII
public static String toASCII(String input, boolean allowUnassigned, boolean useSTD3ASCIIRules) throws IDNAException Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1. Unassigned characters are not allowed and STD3 ASCII rules are enforced.- Parameters:
input
- Unicode string.allowUnassigned
- Unassigned characters, allowed or not?useSTD3ASCIIRules
- STD3 ASCII rules, enforced or not?- Returns:
- Encoded string.
- Throws:
IDNAException
-
toUnicode
Converts an ASCII-encoded string to Unicode. Unassigned characters are not allowed and STD3 hostnames are enforced. Input may be domain name containing dots.- Parameters:
input
- ASCII input string.- Returns:
- Unicode string.
-
toUnicode
Converts an ASCII-encoded string to Unicode.- Parameters:
input
- ASCII input string.allowUnassigned
- Allow unassigned Unicode characters.useSTD3ASCIIRules
- Check that the output conforms to STD3.- Returns:
- Unicode string.
-