Dictionary

Class Overview

Provides dynamic string lookup of key/value string pairs defined in a module's host HTML page. Each unique instance of Dictionary is bound to a named JavaScript object that resides in the global namespace of the host page's window object. The bound JavaScript object is used directly as an associative array.

For example, suppose you define the following JavaScript object in your host page: {@gwt.include com/google/gwt/examples/i18n/ThemeDictionaryExample.js} You can then use a Dictionary to access the key/value pairs above: {@example com.google.gwt.examples.i18n.ThemeDictionaryExample#useThemeDictionary()}

Unlike the family of interfaces that extend Localizable which support static internationalization, the Dictionary class is fully dynamic. As a result, a variety of error conditions (particularly those involving key mismatches) cannot be caught until runtime. Similarly, the GWT compiler is unable discard unused dictionary values since the structure cannot be statically analyzed.

A Caveat Regarding Locale

The module's host page completely determines the mappings defined for each dictionary without regard to the locale client property. Thus, Dictionary is the most flexible of the internationalization types and may provide the simplest form of integration with existing localization systems which were not specifically designed to use GWT's locale client property.

See Localizable for background on the locale client property.

Required Module

Modules that use this interface should inherit com.google.gwt.i18n.I18N. {@gwt.include com/google/gwt/examples/i18n/InheritsExample.gwt.xml}

Summary

Public Methods
String	get(String key) Get the value associated with the given Dictionary key.
static Dictionary	getDictionary(String name) Returns the Dictionary object associated with the given name.
Set<String>	keySet() The set of keys associated with this dictionary.
String	toString()
Collection<String>	values() Collection of values associated with this dictionary.

[Expand] Inherited Methods
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)