method public int describeContents();
method public static android.util.LocaleList forLanguageTags(java.lang.String);
method public java.util.Locale get(int);
- method public java.util.Locale getBestMatch(java.lang.String[]);
method public static android.util.LocaleList getDefault();
method public static android.util.LocaleList getEmptyLocaleList();
+ method public java.util.Locale getFirstMatch(java.lang.String[]);
method public java.util.Locale getPrimary();
method public boolean isEmpty();
method public int size();
method public int describeContents();
method public static android.util.LocaleList forLanguageTags(java.lang.String);
method public java.util.Locale get(int);
- method public java.util.Locale getBestMatch(java.lang.String[]);
method public static android.util.LocaleList getDefault();
method public static android.util.LocaleList getEmptyLocaleList();
+ method public java.util.Locale getFirstMatch(java.lang.String[]);
method public java.util.Locale getPrimary();
method public boolean isEmpty();
method public int size();
method public int describeContents();
method public static android.util.LocaleList forLanguageTags(java.lang.String);
method public java.util.Locale get(int);
- method public java.util.Locale getBestMatch(java.lang.String[]);
method public static android.util.LocaleList getDefault();
method public static android.util.LocaleList getEmptyLocaleList();
+ method public java.util.Locale getFirstMatch(java.lang.String[]);
method public java.util.Locale getPrimary();
method public boolean isEmpty();
method public int size();
import android.annotation.NonNull;
import android.annotation.Nullable;
import android.annotation.Size;
+import android.icu.util.ULocale;
import android.os.Parcel;
import android.os.Parcelable;
}
}
+ private static String getLikelyScript(Locale locale) {
+ final String script = locale.getScript();
+ if (!script.isEmpty()) {
+ return script;
+ } else {
+ // TODO: Cache the results if this proves to be too slow
+ return ULocale.addLikelySubtags(ULocale.forLocale(locale)).getScript();
+ }
+ }
+
+ private static int matchScore(Locale supported, Locale desired) {
+ if (supported.equals(desired)) {
+ return 1; // return early so we don't do unnecessary computation
+ }
+ if (!supported.getLanguage().equals(desired.getLanguage())) {
+ return 0;
+ }
+ // There is no match if the two locales use different scripts. This will most imporantly
+ // take care of traditional vs simplified Chinese.
+ final String supportedScr = getLikelyScript(supported);
+ final String desiredScr = getLikelyScript(desired);
+ return supportedScr.equals(desiredScr) ? 1 : 0;
+ }
+
+ /**
+ * Returns the first match in the locale list given an unordered array of supported locales
+ * in BCP47 format.
+ *
+ * If the locale list is empty, null would be returned.
+ */
@Nullable
- public Locale getBestMatch(String[] locales) {
- // TODO: Fix this to actually do locale negotiation and choose the best match
- return getPrimary();
+ public Locale getFirstMatch(String[] supportedLocales) {
+ if (mList.length == 1) { // just one locale, perhaps the most common scenario
+ return mList[0];
+ }
+ if (mList.length == 0) { // empty locale list
+ return null;
+ }
+ // TODO: Figure out what to if en-XA or ar-XB are in the locale list
+ int bestIndex = Integer.MAX_VALUE;
+ for (String tag : supportedLocales) {
+ final Locale supportedLocale = Locale.forLanguageTag(tag);
+ // We expect the average length of locale lists used for locale resolution to be
+ // smaller than three, so it's OK to do this as an O(mn) algorithm.
+ for (int idx = 0; idx < mList.length; idx++) {
+ final int score = matchScore(supportedLocale, mList[idx]);
+ if (score > 0) {
+ if (idx == 0) { // We have a match on the first locale, which is good enough
+ return mList[0];
+ } else if (idx < bestIndex) {
+ bestIndex = idx;
+ }
+ }
+ }
+ }
+ if (bestIndex == Integer.MAX_VALUE) { // no match was found
+ return mList[0];
+ } else {
+ return mList[bestIndex];
+ }
}
private final static Object sLock = new Object();