/*
* Copyright 2009 Google Inc.
*
* 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 com.google.gwt.i18n.rebind;
import com.google.gwt.core.ext.BadPropertyValueException;
import com.google.gwt.core.ext.ConfigurationProperty;
import com.google.gwt.core.ext.GeneratorContext;
import com.google.gwt.core.ext.PropertyOracle;
import com.google.gwt.core.ext.SelectionProperty;
import com.google.gwt.core.ext.TreeLogger;
import com.google.gwt.i18n.server.GwtLocaleFactoryImpl;
import com.google.gwt.i18n.shared.GwtLocale;
import com.google.gwt.i18n.shared.GwtLocaleFactory;
import java.util.Collections;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.SortedSet;
import java.util.WeakHashMap;
/**
* Utility methods for dealing with locales.
*/
public class LocaleUtils {
private static final GwtLocaleFactoryImpl factory = new GwtLocaleFactoryImpl();
/**
* The token representing the locale property controlling Localization.
*/
private static final String PROP_LOCALE = "locale";
/**
* The config property identifying the URL query paramter name to possibly get
* the value of the locale property.
*/
private static final String PROP_LOCALE_QUERY_PARAM = "locale.queryparam";
/**
* The config property identifying the cookie name to possibly get the value
* of the locale property.
*/
private static final String PROP_LOCALE_COOKIE = "locale.cookie";
/**
* The token representing the runtime.locales configuration property.
*/
private static final String PROP_RUNTIME_LOCALES = "runtime.locales";
/**
* Multiple generators need to access the shared cache state of
* LocaleInfoContext.
*/
private static final WeakHashMap<GeneratorContext, LocaleInfoContext>
localeInfoCtxHolder = new WeakHashMap<GeneratorContext, LocaleInfoContext>();
/**
* Create a new LocaleUtils instance for the given PropertyOracle. Returned
* instances will be immutable and can be shared across threads.
*
* @param logger
* @param propertyOracle
* @return LocaleUtils instance
*/
public static LocaleUtils getInstance(TreeLogger logger,
PropertyOracle propertyOracle, GeneratorContext context) {
try {
SelectionProperty localeProp
= propertyOracle.getSelectionProperty(logger, PROP_LOCALE);
ConfigurationProperty runtimeLocaleProp
= propertyOracle.getConfigurationProperty(PROP_RUNTIME_LOCALES);
ConfigurationProperty queryParamProp
= propertyOracle.getConfigurationProperty(PROP_LOCALE_QUERY_PARAM);
ConfigurationProperty cookieProp
= propertyOracle.getConfigurationProperty(PROP_LOCALE_COOKIE);
LocaleInfoContext localeInfoCtx = getLocaleInfoCtx(context);
LocaleUtils localeUtils = localeInfoCtx.getLocaleUtils(localeProp,
runtimeLocaleProp, queryParamProp, cookieProp);
if (localeUtils == null) {
localeUtils = createInstance(localeProp, runtimeLocaleProp,
queryParamProp, cookieProp);
localeInfoCtx.putLocaleUtils(localeProp, runtimeLocaleProp,
queryParamProp, cookieProp, localeUtils);
}
return localeUtils;
} catch (BadPropertyValueException e) {
// if we don't have locale properties defined, just return a basic one
logger.log(TreeLogger.WARN,
"Unable to get locale properties, using defaults", e);
GwtLocale defaultLocale = factory.fromString("default");
Set<GwtLocale> allLocales = new HashSet<GwtLocale>();
allLocales.add(defaultLocale);
return new LocaleUtils(defaultLocale, allLocales, allLocales,
Collections.<GwtLocale>emptySet(), null, null);
}
}
/**
* Get a shared GwtLocale factory so instances are cached between all uses.
*
* @return singleton GwtLocaleFactory instance.
*/
public static GwtLocaleFactory getLocaleFactory() {
return factory;
}
private static LocaleUtils createInstance(SelectionProperty localeProp,
ConfigurationProperty prop, ConfigurationProperty queryParamProp,
ConfigurationProperty cookieProp) {
GwtLocale compileLocale = null;
Set<GwtLocale> allLocales = new HashSet<GwtLocale>();
Set<GwtLocale> allCompileLocales = new HashSet<GwtLocale>();
Set<GwtLocale> runtimeLocales = new HashSet<GwtLocale>();
String localeName = localeProp.getCurrentValue();
String queryParam = queryParamProp.getValues().get(0);
if (queryParam.length() == 0) {
queryParam = null;
}
String cookie = cookieProp.getValues().get(0);
if (cookie.length() == 0) {
cookie = null;
}
SortedSet<String> localeValues = localeProp.getPossibleValues();
GwtLocaleFactory factoryInstance = getLocaleFactory();
GwtLocale newCompileLocale = factoryInstance.fromString(localeName);
compileLocale = newCompileLocale;
for (String localeValue : localeValues) {
allCompileLocales.add(factoryInstance.fromString(localeValue));
}
allLocales.addAll(allCompileLocales);
List<String> rtLocaleNames = prop.getValues();
if (rtLocaleNames != null) {
for (String rtLocale : rtLocaleNames) {
GwtLocale locale = factoryInstance.fromString(rtLocale);
// TODO(jat): remove use of labels
existingLocales:
for (GwtLocale existing : allCompileLocales) {
for (GwtLocale alias : existing.getAliases()) {
if (!alias.isDefault() && locale.inheritsFrom(alias)
&& locale.usesSameScript(alias)) {
allLocales.add(locale);
break existingLocales;
}
}
}
if (!compileLocale.isDefault()
&& locale.inheritsFrom(compileLocale)
&& locale.usesSameScript(compileLocale)) {
// TODO(jat): don't include runtime locales which also inherit
// from a more-specific compile locale than this one
runtimeLocales.add(locale);
}
}
}
return new LocaleUtils(compileLocale, allLocales, allCompileLocales,
runtimeLocales, queryParam, cookie);
}
private static synchronized LocaleInfoContext getLocaleInfoCtx(
GeneratorContext context) {
if (context instanceof CachedGeneratorContext) {
context = ((CachedGeneratorContext) context).getWrappedGeneratorContext();
}
LocaleInfoContext localeInfoCtx = localeInfoCtxHolder.get(context);
if (localeInfoCtx == null) {
localeInfoCtx = new LocaleInfoContext();
localeInfoCtxHolder.put(context, localeInfoCtx);
}
return localeInfoCtx;
}
private final Set<GwtLocale> allCompileLocales;
private final Set<GwtLocale> allLocales;
private final GwtLocale compileLocale;
private final Set<GwtLocale> runtimeLocales;
private final String queryParam;
private final String cookie;
private LocaleUtils(GwtLocale compileLocale, Set<GwtLocale> allLocales,
Set<GwtLocale> allCompileLocales, Set<GwtLocale> runtimeLocales,
String queryParam, String cookie) {
this.compileLocale = compileLocale;
this.allLocales = Collections.unmodifiableSet(allLocales);
this.allCompileLocales = Collections.unmodifiableSet(allCompileLocales);
this.runtimeLocales = Collections.unmodifiableSet(runtimeLocales);
this.queryParam = queryParam;
this.cookie = cookie;
}
/**
* Returns the set of all compile-time locales.
*
* @return unmodifiable set of all compile-time locales
*/
public Set<GwtLocale> getAllCompileLocales() {
return allCompileLocales;
}
/**
* Returns the set of all available locales, whether compile-time locales or
* runtime locales.
*
* @return unmodifiable set of all locales
*/
public Set<GwtLocale> getAllLocales() {
return allLocales;
}
/**
* Returns the static compile-time locale for this permutation.
*/
public GwtLocale getCompileLocale() {
return compileLocale;
}
/**
* Return the name of the cookie to potentially get the locale value from.
*
* @return the cookie name or null if none
*/
public String getCookie() {
return cookie;
}
/**
* Return the name of the URL query param to potentially get the locale value
* from.
*
* @return the URL query param or null if none
*/
public String getQueryParam() {
return queryParam;
}
/**
* Returns a list of locales which are children of the current compile-time
* locale.
*
* @return unmodifiable list of matching locales
*/
public Set<GwtLocale> getRuntimeLocales() {
return runtimeLocales;
}
}