com.google.gwt.i18n.client.DefaultLocalizedNamesBase Maven / Gradle / Ivy
/*
* Copyright 2010 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.client;
import java.util.HashMap;
import java.util.Map;
/**
* Base class of {@link DefaultLocalizedNames}, used just to isolate all
* hand-written code here from all generated code.
*/
public abstract class DefaultLocalizedNamesBase implements LocalizedNames {
protected String[] likelyRegionCodes = null;
protected String[] sortedRegionCodes = null;
protected Map namesMap = null;
public final String[] getLikelyRegionCodes() {
if (likelyRegionCodes == null) {
likelyRegionCodes = loadLikelyRegionCodes();
}
return likelyRegionCodes;
}
public final String getRegionName(String regionCode) {
if (needsNameMap()) {
loadNameMap();
}
return getRegionNameImpl(regionCode);
}
public final String[] getSortedRegionCodes() {
if (sortedRegionCodes == null) {
sortedRegionCodes = loadSortedRegionCodes();
}
return sortedRegionCodes;
}
protected String getRegionNameImpl(String regionCode) {
return namesMap.get(regionCode);
}
/**
* Returns a possibly-empty array of country codes, ordered by the literate
* population speaking this language.
*
* The default implementation is an empty array.
*
* @return a possibly-empty array of likely country codes
*/
protected String[] loadLikelyRegionCodes() {
return new String[0];
}
/**
* Initializes {{@link #namesMap} to a map of region code (including
* non-country codes) to localized names. Subclasses should generally call the
* parent implementation and then change specific entries, though if most
* entries are being changed they can just create their own map.
*/
protected void loadNameMap() {
namesMap = new HashMap();
}
/**
* Returns an array of currently valid country codes ordered by the collating
* order of the locale.
*
* @return an array of ordered country codes
*/
protected abstract String[] loadSortedRegionCodes();
/**
* @return true if the name map needs to be loaded -- subclasses that provide
* alternate storage for the name map (such as in JSOs) should override
* this.
*/
protected boolean needsNameMap() {
return namesMap == null;
}
}