base/android/java/src/org/chromium/base/LocaleUtils.java - platform/external/cronet - Git at Google

 // Copyright 2014 The Chromium Authors
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.

 package org.chromium.base;

 import android.content.Context;
 import android.content.res.Configuration;
 import android.os.Build;
 import android.os.LocaleList;
 import android.text.TextUtils;

 import androidx.annotation.RequiresApi;
 import androidx.annotation.VisibleForTesting;

 import org.jni_zero.CalledByNative;

 import java.util.ArrayList;
 import java.util.Locale;

 /** This class provides the locale related methods. */
 public class LocaleUtils {
     /** Guards this class from being instantiated. */
     private LocaleUtils() {}

     /**
      * Java keeps deprecated language codes for Hebrew, Yiddish and Indonesian but Chromium uses
      * updated ones. Similarly, Android uses "tl" while Chromium uses "fil" for Tagalog/Filipino.
      * The Translate settings use "gom", but Chrome uses "kok". Apply a mapping here. See
      * http://developer.android.com/reference/java/util/Locale.html
      * @return a updated language code for Chromium with given language string.
      */
     public static String getUpdatedLanguageForChromium(String language) {
         // IMPORTANT: If adding a new Chrome UI language, update the mapping found in:
         // build/android/gyp/util/resource_utils.py (Languages that are accept languages, but not
         // Chrome Android UI languages do not need to be kept in sync).
         switch (language) {
             case "gom":
                 return "kok"; // Konkani
             case "in":
                 return "id"; // Indonesian
             case "iw":
                 return "he"; // Hebrew
             case "ji":
                 return "yi"; // Yiddish
             case "jw":
                 return "jv"; // Javanese
             case "tl":
                 return "fil"; // Filipino
             default:
                 return language;
         }
     }

     /**
      * @return a locale with updated language codes for Chromium, with translated modern language
      *         codes used by Chromium.
      */
     @VisibleForTesting
     public static Locale getUpdatedLocaleForChromium(Locale locale) {
         String language = locale.getLanguage();
         String languageForChrome = getUpdatedLanguageForChromium(language);
         if (languageForChrome.equals(language)) {
             return locale;
         }
         return new Locale.Builder().setLocale(locale).setLanguage(languageForChrome).build();
     }

     /**
      * Android uses "tl" while Chromium uses "fil" for Tagalog/Filipino.
      * So apply a mapping here.
      * See http://developer.android.com/reference/java/util/Locale.html
      * @return a updated language code for Android with given language string.
      */
     public static String getUpdatedLanguageForAndroid(String language) {
         // IMPORTANT: Keep in sync with the mapping found in:
         // build/android/gyp/util/resource_utils.py
         switch (language) {
             case "und":
                 return ""; // Undefined
             case "fil":
                 return "tl"; // Filipino
             default:
                 return language;
         }
     }

     /**
      * @return a locale with updated language codes for Android, from translated modern language
      *         codes used by Chromium.
      */
     @VisibleForTesting
     public static Locale getUpdatedLocaleForAndroid(Locale locale) {
         String language = locale.getLanguage();
         String languageForAndroid = getUpdatedLanguageForAndroid(language);
         if (languageForAndroid.equals(language)) {
             return locale;
         }
         return new Locale.Builder().setLocale(locale).setLanguage(languageForAndroid).build();
     }

     /**
      * This function creates a Locale object from xx-XX style string where xx is language code
      * and XX is a country code.
      * @return the locale that best represents the language tag.
      */
     public static Locale forLanguageTag(String languageTag) {
         Locale locale = Locale.forLanguageTag(languageTag);
         return getUpdatedLocaleForAndroid(locale);
     }

     /**
      * Converts Locale object to the BCP 47 compliant string format.
      * This works for API level lower than 24.
      *
      * Note that for Android M or before, we cannot use Locale.getLanguage() and
      * Locale.toLanguageTag() for this purpose. Since Locale.getLanguage() returns deprecated
      * language code even if the Locale object is constructed with updated language code. As for
      * Locale.toLanguageTag(), it does a special conversion from deprecated language code to updated
      * one, but it is only usable for Android N or after.
      * @return a well-formed IETF BCP 47 language tag with language and country code that
      *         represents this locale.
      */
     public static String toLanguageTag(Locale locale) {
         String language = getUpdatedLanguageForChromium(locale.getLanguage());
         String country = locale.getCountry();
         if (language.equals("no") && country.equals("NO") && locale.getVariant().equals("NY")) {
             return "nn-NO";
         }
         return country.isEmpty() ? language : language + "-" + country;
     }

     /**
      * Converts LocaleList object to the comma separated BCP 47 compliant string format.
      *
      * @return a well-formed IETF BCP 47 language tag with language and country code that
      *         represents this locale list.
      */
     @RequiresApi(Build.VERSION_CODES.N)
     public static String toLanguageTags(LocaleList localeList) {
         ArrayList<String> newLocaleList = new ArrayList<>();
         for (int i = 0; i < localeList.size(); i++) {
             Locale locale = getUpdatedLocaleForChromium(localeList.get(i));
             newLocaleList.add(toLanguageTag(locale));
         }
         return TextUtils.join(",", newLocaleList);
     }

     /**
      * Extracts the base language from a BCP 47 language tag.
      * @param languageTag language tag of the form xx-XX or xx.
      * @return the xx part of the language tag.
      */
     public static String toBaseLanguage(String languageTag) {
         int pos = languageTag.indexOf('-');
         if (pos < 0) {
             return languageTag;
         }
         return languageTag.substring(0, pos);
     }

     /**
      * @param first A BCP 47 formated language tag.
      * @param second A BCP 47 formated language tag.
      * @return True if the base language (e.g. "en" for "en-AU") is the same for each tag.
      */
     public static boolean isBaseLanguageEqual(String first, String second) {
         return TextUtils.equals(toBaseLanguage(first), toBaseLanguage(second));
     }

     /**
      * @return a language tag string that represents the default locale.
      *         The language tag is well-formed IETF BCP 47 language tag with language and country
      *         code.
      */
     @CalledByNative
     public static String getDefaultLocaleString() {
         return toLanguageTag(Locale.getDefault());
     }

     /**
      * @return a comma separated language tags string that represents a default locale or locales.
      *         Each language tag is well-formed IETF BCP 47 language tag with language and country
      *         code.
      */
     @CalledByNative
     public static String getDefaultLocaleListString() {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
             return toLanguageTags(LocaleList.getDefault());
         }
         return getDefaultLocaleString();
     }

     /**
      * @return The default country code set during install.
      */
     @CalledByNative
     private static String getDefaultCountryCode() {
         CommandLine commandLine = CommandLine.getInstance();
         return commandLine.hasSwitch(BaseSwitches.DEFAULT_COUNTRY_CODE_AT_INSTALL)
                 ? commandLine.getSwitchValue(BaseSwitches.DEFAULT_COUNTRY_CODE_AT_INSTALL)
                 : Locale.getDefault().getCountry();
     }

     /**
      * Return the language tag of the first language in Configuration.
      * @param config Configuration to get language for.
      * @return The BCP 47 tag representation of the configuration's first locale.
      * Configuration.locale is deprecated on N+. However, read only is equivalent to
      * Configuration.getLocales()[0]. Change when minSdkVersion >= 24.
      */
     @SuppressWarnings("deprecation")
     public static String getConfigurationLanguage(Configuration config) {
         Locale locale = config.locale;
         return (locale != null) ? locale.toLanguageTag() : "";
     }

     /**
      * Return the language tag of the first language in the configuration
      * @param context Context to get language for.
      * @return The BCP 47 tag representation of the context's first locale.
      */
     public static String getContextLanguage(Context context) {
         return getConfigurationLanguage(context.getResources().getConfiguration());
     }

     /**
      * Prepend languageTag to the default locales on config.
      * @param base The Context to use for the base configuration.
      * @param config The Configuration to update.
      * @param languageTag The language to prepend to default locales.
      */
     public static void updateConfig(Context base, Configuration config, String languageTag) {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
             ApisN.setConfigLocales(base, config, languageTag);
         } else {
             config.setLocale(Locale.forLanguageTag(languageTag));
         }
     }

     /**
      * Updates the default Locale/LocaleList to those of config.
      * @param config
      */
     public static void setDefaultLocalesFromConfiguration(Configuration config) {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
             ApisN.setLocaleList(config);
         } else {
             Locale.setDefault(config.locale);
         }
     }

     /** Helper class for N only code that is not validated on pre-N devices. */
     @RequiresApi(Build.VERSION_CODES.N)
     @VisibleForTesting
     static class ApisN {
         static void setConfigLocales(Context base, Configuration config, String language) {
             LocaleList updatedLocales =
                     prependToLocaleList(
                             language, base.getResources().getConfiguration().getLocales());
             config.setLocales(updatedLocales);
         }

         static void setLocaleList(Configuration config) {
             LocaleList.setDefault(config.getLocales());
         }

         /**
          * Create a new LocaleList with languageTag added to the front.
          * If languageTag is already in the list the existing tag is moved to the front.
          * @param languageTag String of language tag to prepend
          * @param localeList LocaleList to prepend to.
          * @return LocaleList
          */
         static LocaleList prependToLocaleList(String languageTag, LocaleList localeList) {
             String languageList = localeList.toLanguageTags();

             // Remove the first instance of languageTag with associated comma if present.
             // Pattern example: "(^|,)en-US$|en-US,"
             String pattern = String.format("(^|,)%1$s$|%1$s,", languageTag);
             languageList = languageList.replaceFirst(pattern, "");

             return LocaleList.forLanguageTags(
                     String.format("%1$s,%2$s", languageTag, languageList));
         }
     }
 }
	// Copyright 2014 The Chromium Authors
	// Use of this source code is governed by a BSD-style license that can be
	// found in the LICENSE file.

	package org.chromium.base;

	import android.content.Context;
	import android.content.res.Configuration;
	import android.os.Build;
	import android.os.LocaleList;
	import android.text.TextUtils;

	import androidx.annotation.RequiresApi;
	import androidx.annotation.VisibleForTesting;

	import org.jni_zero.CalledByNative;

	import java.util.ArrayList;
	import java.util.Locale;

	/** This class provides the locale related methods. */
	public class LocaleUtils {
	/** Guards this class from being instantiated. */
	private LocaleUtils() {}

	/**
	* Java keeps deprecated language codes for Hebrew, Yiddish and Indonesian but Chromium uses
	* updated ones. Similarly, Android uses "tl" while Chromium uses "fil" for Tagalog/Filipino.
	* The Translate settings use "gom", but Chrome uses "kok". Apply a mapping here. See
	* http://developer.android.com/reference/java/util/Locale.html
	* @return a updated language code for Chromium with given language string.
	*/
	public static String getUpdatedLanguageForChromium(String language) {
	// IMPORTANT: If adding a new Chrome UI language, update the mapping found in:
	// build/android/gyp/util/resource_utils.py (Languages that are accept languages, but not
	// Chrome Android UI languages do not need to be kept in sync).
	switch (language) {
	case "gom":
	return "kok"; // Konkani
	case "in":
	return "id"; // Indonesian
	case "iw":
	return "he"; // Hebrew
	case "ji":
	return "yi"; // Yiddish
	case "jw":
	return "jv"; // Javanese
	case "tl":
	return "fil"; // Filipino
	default:
	return language;
	}
	}

	/**
	* @return a locale with updated language codes for Chromium, with translated modern language
	* codes used by Chromium.
	*/
	@VisibleForTesting
	public static Locale getUpdatedLocaleForChromium(Locale locale) {
	String language = locale.getLanguage();
	String languageForChrome = getUpdatedLanguageForChromium(language);
	if (languageForChrome.equals(language)) {
	return locale;
	}
	return new Locale.Builder().setLocale(locale).setLanguage(languageForChrome).build();
	}

	/**
	* Android uses "tl" while Chromium uses "fil" for Tagalog/Filipino.
	* So apply a mapping here.
	* See http://developer.android.com/reference/java/util/Locale.html
	* @return a updated language code for Android with given language string.
	*/
	public static String getUpdatedLanguageForAndroid(String language) {
	// IMPORTANT: Keep in sync with the mapping found in:
	// build/android/gyp/util/resource_utils.py
	switch (language) {
	case "und":
	return ""; // Undefined
	case "fil":
	return "tl"; // Filipino
	default:
	return language;
	}
	}

	/**
	* @return a locale with updated language codes for Android, from translated modern language
	* codes used by Chromium.
	*/
	@VisibleForTesting
	public static Locale getUpdatedLocaleForAndroid(Locale locale) {
	String language = locale.getLanguage();
	String languageForAndroid = getUpdatedLanguageForAndroid(language);
	if (languageForAndroid.equals(language)) {
	return locale;
	}
	return new Locale.Builder().setLocale(locale).setLanguage(languageForAndroid).build();
	}

	/**
	* This function creates a Locale object from xx-XX style string where xx is language code
	* and XX is a country code.
	* @return the locale that best represents the language tag.
	*/
	public static Locale forLanguageTag(String languageTag) {
	Locale locale = Locale.forLanguageTag(languageTag);
	return getUpdatedLocaleForAndroid(locale);
	}

	/**
	* Converts Locale object to the BCP 47 compliant string format.
	* This works for API level lower than 24.
	*
	* Note that for Android M or before, we cannot use Locale.getLanguage() and
	* Locale.toLanguageTag() for this purpose. Since Locale.getLanguage() returns deprecated
	* language code even if the Locale object is constructed with updated language code. As for
	* Locale.toLanguageTag(), it does a special conversion from deprecated language code to updated
	* one, but it is only usable for Android N or after.
	* @return a well-formed IETF BCP 47 language tag with language and country code that
	* represents this locale.
	*/
	public static String toLanguageTag(Locale locale) {
	String language = getUpdatedLanguageForChromium(locale.getLanguage());
	String country = locale.getCountry();
	if (language.equals("no") && country.equals("NO") && locale.getVariant().equals("NY")) {
	return "nn-NO";
	}
	return country.isEmpty() ? language : language + "-" + country;
	}

	/**
	* Converts LocaleList object to the comma separated BCP 47 compliant string format.
	*
	* @return a well-formed IETF BCP 47 language tag with language and country code that
	* represents this locale list.
	*/
	@RequiresApi(Build.VERSION_CODES.N)
	public static String toLanguageTags(LocaleList localeList) {
	ArrayList<String> newLocaleList = new ArrayList<>();
	for (int i = 0; i < localeList.size(); i++) {
	Locale locale = getUpdatedLocaleForChromium(localeList.get(i));
	newLocaleList.add(toLanguageTag(locale));
	}
	return TextUtils.join(",", newLocaleList);
	}

	/**
	* Extracts the base language from a BCP 47 language tag.
	* @param languageTag language tag of the form xx-XX or xx.
	* @return the xx part of the language tag.
	*/
	public static String toBaseLanguage(String languageTag) {
	int pos = languageTag.indexOf('-');
	if (pos < 0) {
	return languageTag;
	}
	return languageTag.substring(0, pos);
	}

	/**
	* @param first A BCP 47 formated language tag.
	* @param second A BCP 47 formated language tag.
	* @return True if the base language (e.g. "en" for "en-AU") is the same for each tag.
	*/
	public static boolean isBaseLanguageEqual(String first, String second) {
	return TextUtils.equals(toBaseLanguage(first), toBaseLanguage(second));
	}

	/**
	* @return a language tag string that represents the default locale.
	* The language tag is well-formed IETF BCP 47 language tag with language and country
	* code.
	*/
	@CalledByNative
	public static String getDefaultLocaleString() {
	return toLanguageTag(Locale.getDefault());
	}

	/**
	* @return a comma separated language tags string that represents a default locale or locales.
	* Each language tag is well-formed IETF BCP 47 language tag with language and country
	* code.
	*/
	@CalledByNative
	public static String getDefaultLocaleListString() {
	if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
	return toLanguageTags(LocaleList.getDefault());
	}
	return getDefaultLocaleString();
	}

	/**
	* @return The default country code set during install.
	*/
	@CalledByNative
	private static String getDefaultCountryCode() {
	CommandLine commandLine = CommandLine.getInstance();
	return commandLine.hasSwitch(BaseSwitches.DEFAULT_COUNTRY_CODE_AT_INSTALL)
	? commandLine.getSwitchValue(BaseSwitches.DEFAULT_COUNTRY_CODE_AT_INSTALL)
	: Locale.getDefault().getCountry();
	}

	/**
	* Return the language tag of the first language in Configuration.
	* @param config Configuration to get language for.
	* @return The BCP 47 tag representation of the configuration's first locale.
	* Configuration.locale is deprecated on N+. However, read only is equivalent to
	* Configuration.getLocales()[0]. Change when minSdkVersion >= 24.
	*/
	@SuppressWarnings("deprecation")
	public static String getConfigurationLanguage(Configuration config) {
	Locale locale = config.locale;
	return (locale != null) ? locale.toLanguageTag() : "";
	}

	/**
	* Return the language tag of the first language in the configuration
	* @param context Context to get language for.
	* @return The BCP 47 tag representation of the context's first locale.
	*/
	public static String getContextLanguage(Context context) {
	return getConfigurationLanguage(context.getResources().getConfiguration());
	}

	/**
	* Prepend languageTag to the default locales on config.
	* @param base The Context to use for the base configuration.
	* @param config The Configuration to update.
	* @param languageTag The language to prepend to default locales.
	*/
	public static void updateConfig(Context base, Configuration config, String languageTag) {
	if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
	ApisN.setConfigLocales(base, config, languageTag);
	} else {
	config.setLocale(Locale.forLanguageTag(languageTag));
	}
	}

	/**
	* Updates the default Locale/LocaleList to those of config.
	* @param config
	*/
	public static void setDefaultLocalesFromConfiguration(Configuration config) {
	if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
	ApisN.setLocaleList(config);
	} else {
	Locale.setDefault(config.locale);
	}
	}

	/** Helper class for N only code that is not validated on pre-N devices. */
	@RequiresApi(Build.VERSION_CODES.N)
	@VisibleForTesting
	static class ApisN {
	static void setConfigLocales(Context base, Configuration config, String language) {
	LocaleList updatedLocales =
	prependToLocaleList(
	language, base.getResources().getConfiguration().getLocales());
	config.setLocales(updatedLocales);
	}

	static void setLocaleList(Configuration config) {
	LocaleList.setDefault(config.getLocales());
	}

	/**
	* Create a new LocaleList with languageTag added to the front.
	* If languageTag is already in the list the existing tag is moved to the front.
	* @param languageTag String of language tag to prepend
	* @param localeList LocaleList to prepend to.
	* @return LocaleList
	*/
	static LocaleList prependToLocaleList(String languageTag, LocaleList localeList) {
	String languageList = localeList.toLanguageTags();

	// Remove the first instance of languageTag with associated comma if present.
	// Pattern example: "(^\|,)en-US$\|en-US,"
	String pattern = String.format("(^\|,)%1$s$\|%1$s,", languageTag);
	languageList = languageList.replaceFirst(pattern, "");

	return LocaleList.forLanguageTags(
	String.format("%1$s,%2$s", languageTag, languageList));
	}
	}
	}