mirror of
https://github.com/google/nomulus.git
synced 2025-04-30 12:07:51 +02:00
c458c05801
The dark lord Gosling designed the Java package naming system so that ownership flows from the DNS system. Since we own the domain name registry.google, it seems only appropriate that we should use google.registry as our package name.
78 lines
3.3 KiB
Java
78 lines
3.3 KiB
Java
// Copyright 2016 The Domain Registry Authors. All Rights Reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package google.registry.util;
|
|
|
|
import com.google.common.base.Joiner;
|
|
|
|
import com.ibm.icu.text.IDNA;
|
|
import com.ibm.icu.text.IDNA.Info;
|
|
|
|
/**
|
|
* A partial API-compatible replacement for {@link java.net.IDN} that replaces <a
|
|
* href="http://www.ietf.org/rfc/rfc3490.txt">IDNA2003</a> processing with <a
|
|
* href="http://unicode.org/reports/tr46/">UTS46 transitional processing</a>, with differences as
|
|
* described in the <a href="http://www.unicode.org/reports/tr46/#IDNAComparison">UTS46
|
|
* documentation</a>/
|
|
*
|
|
* <p>This class provides methods to convert internationalized domain names (IDNs) between Unicode
|
|
* and ASCII-only <a href="http://www.ietf.org/rfc/rfc3492.txt">Punycode</a> form. It implements the
|
|
* parts of the API from {@link java.net.IDN} that we care about, but will return different results
|
|
* as defined by the differences between IDNA2003 and transitional UTS46.
|
|
*/
|
|
public final class Idn {
|
|
|
|
/** Cached UTS46 with the flags we want. */
|
|
private static final IDNA UTS46_INSTANCE = IDNA.getUTS46Instance(IDNA.CHECK_BIDI);
|
|
|
|
/**
|
|
* Translates a string from Unicode to ASCII Compatible Encoding (ACE), as defined by the ToASCII
|
|
* operation of <a href="http://www.ietf.org/rfc/rfc3490.txt">RFC 3490</a>.
|
|
*
|
|
* <p>This method always uses <a href="http://unicode.org/reports/tr46/">UTS46 transitional
|
|
* processing</a>.
|
|
*
|
|
* @param name a domain name, which may include multiple labels separated by dots
|
|
* @throws IllegalArgumentException if the input string doesn't conform to RFC 3490 specification
|
|
* @see java.net.IDN#toASCII(String)
|
|
*/
|
|
public static String toASCII(String name) {
|
|
Info info = new Info();
|
|
StringBuilder result = new StringBuilder();
|
|
UTS46_INSTANCE.nameToASCII(name, result, info);
|
|
if (info.hasErrors()) {
|
|
throw new IllegalArgumentException("Errors: " + Joiner.on(',').join(info.getErrors()));
|
|
}
|
|
return result.toString();
|
|
}
|
|
|
|
/**
|
|
* Translates a string from Unicode to ASCII Compatible Encoding (ACE), as defined by the ToASCII
|
|
* operation of <a href="http://www.ietf.org/rfc/rfc3490.txt">RFC 3490</a>.
|
|
*
|
|
* <p>This method always uses <a href="http://unicode.org/reports/tr46/">UTS46 transitional
|
|
* processing</a>.
|
|
*
|
|
* <p>ToUnicode never fails. In case of any error, the input string is returned unmodified.
|
|
*
|
|
* @param name a domain name, which may include multiple labels separated by dots
|
|
* @see java.net.IDN#toUnicode(String)
|
|
*/
|
|
public static String toUnicode(String name) {
|
|
Info info = new Info();
|
|
StringBuilder result = new StringBuilder();
|
|
UTS46_INSTANCE.nameToUnicode(name, result, info);
|
|
return info.hasErrors() ? name : result.toString();
|
|
}
|
|
}
|