com.oracle.svm.hosted.jdk.localization

Class LocalizationFeature

java.lang.Object

com.oracle.svm.hosted.jdk.localization.LocalizationFeature

All Implemented Interfaces:

org.graalvm.nativeimage.hosted.Feature

public abstract class LocalizationFeature
extends Object
implements org.graalvm.nativeimage.hosted.Feature

LocalizationFeature is the core class of SVM localization support. It contains all the options that can be used to configure how localization in the resulting image should work. One can specify what charsets, locales and resource bundles should be accessible. The runtime data for localization is stored in an image singleton of type LocalizationSupport or one of its subtypes. In case of ResourceBundles, one can also specify how bundles should be handled, because currently there are two different modes. The first approach is using a simple in memory map instead of the original JDK lookup. This simpler implementation leads to image size savings for smaller images such as hello world, but could cause compatibility issues and maintenance overhead. It is implemented in OptimizedLocalizationSupport. The second approach relies on the original JVM implementation instead. This approach is consistent by design, which solves compatibility issues and reduces maintenance overhead. Unfortunately, the default way of storing bundle data in getContents methods, see sun.text.resources.FormatData for example, is not very AOT friendly. Compiling these methods is time consuming and results in a bloated image (183 MB HelloWorld with all locales). Therefore, the bundle content itself is again stored in the image heap by default and furthermore is compressed to reduce the image size, see BundleContentSubstitutedLocalizationSupport and GzipBundleCompression.

See Also:

LocalizationSupport, OptimizedLocalizationSupport, BundleContentSubstitutedLocalizationSupport

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LocalizationFeature.CharsetNodePlugin Many subclasses of Charset initialize encoding and decoding tables lazily.
static class	LocalizationFeature.Options

Nested classes/interfaces inherited from interface org.graalvm.nativeimage.hosted.Feature

org.graalvm.nativeimage.hosted.Feature.AfterAnalysisAccess, org.graalvm.nativeimage.hosted.Feature.AfterCompilationAccess, org.graalvm.nativeimage.hosted.Feature.AfterHeapLayoutAccess, org.graalvm.nativeimage.hosted.Feature.AfterImageWriteAccess, org.graalvm.nativeimage.hosted.Feature.AfterRegistrationAccess, org.graalvm.nativeimage.hosted.Feature.BeforeAnalysisAccess, org.graalvm.nativeimage.hosted.Feature.BeforeCompilationAccess, org.graalvm.nativeimage.hosted.Feature.BeforeImageWriteAccess, org.graalvm.nativeimage.hosted.Feature.BeforeUniverseBuildingAccess, org.graalvm.nativeimage.hosted.Feature.CompilationAccess, org.graalvm.nativeimage.hosted.Feature.DuringAnalysisAccess, org.graalvm.nativeimage.hosted.Feature.DuringSetupAccess, org.graalvm.nativeimage.hosted.Feature.FeatureAccess, org.graalvm.nativeimage.hosted.Feature.IsInConfigurationAccess, org.graalvm.nativeimage.hosted.Feature.OnAnalysisExitAccess, org.graalvm.nativeimage.hosted.Feature.QueryReachabilityAccess

Field Summary

Fields

Modifier and Type	Field and Description
protected Set<Locale>	allLocales
protected Locale	defaultLocale The Locale that the native image is built for.
protected boolean	optimizedMode
protected LocalizationSupport	support
protected boolean	trace

Constructor Summary

Constructors

Constructor and Description
LocalizationFeature()

Method Summary

Modifier and Type	Method and Description
static void	addCharset(Charset charset)
protected void	addResourceBundles()
void	afterAnalysis(org.graalvm.nativeimage.hosted.Feature.AfterAnalysisAccess access)
void	afterRegistration(org.graalvm.nativeimage.hosted.Feature.AfterRegistrationAccess access)
void	beforeAnalysis(org.graalvm.nativeimage.hosted.Feature.BeforeAnalysisAccess access)
void	duringSetup(org.graalvm.nativeimage.hosted.Feature.DuringSetupAccess access)
protected List<Class<? extends LocaleServiceProvider>>	getSpiClasses()
protected sun.util.resources.LocaleData	localeData(Class<? extends LocaleServiceProvider> providerClass, Locale locale)
protected void	prepareBundle(ResourceBundle bundle, Locale locale)
void	prepareBundle(String baseName)
void	prepareBundle(String baseName, Collection<Locale> wantedLocales)
void	prepareClassResourceBundle(String basename, String className)
protected void	trace(String msg)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.graalvm.nativeimage.hosted.Feature

afterCompilation, afterHeapLayout, afterImageWrite, beforeCompilation, beforeImageWrite, beforeUniverseBuilding, cleanup, duringAnalysis, getRequiredFeatures, isInConfiguration, onAnalysisExit

Field Detail

optimizedMode

protected final boolean optimizedMode

trace

protected final boolean trace

defaultLocale

protected Locale defaultLocale

The Locale that the native image is built for.

allLocales

protected Set<Locale> allLocales

support

protected LocalizationSupport support

Constructor Detail

LocalizationFeature

public LocalizationFeature()

Method Detail

afterRegistration

public void afterRegistration(org.graalvm.nativeimage.hosted.Feature.AfterRegistrationAccess access)

Specified by:

afterRegistration in interface org.graalvm.nativeimage.hosted.Feature

duringSetup

public void duringSetup(org.graalvm.nativeimage.hosted.Feature.DuringSetupAccess access)

Specified by:

duringSetup in interface org.graalvm.nativeimage.hosted.Feature

beforeAnalysis

public void beforeAnalysis(org.graalvm.nativeimage.hosted.Feature.BeforeAnalysisAccess access)

Specified by:

beforeAnalysis in interface org.graalvm.nativeimage.hosted.Feature

afterAnalysis

public void afterAnalysis(org.graalvm.nativeimage.hosted.Feature.AfterAnalysisAccess access)

Specified by:

afterAnalysis in interface org.graalvm.nativeimage.hosted.Feature

addCharset

public static void addCharset(Charset charset)

getSpiClasses

protected List<Class<? extends LocaleServiceProvider>> getSpiClasses()

addResourceBundles

protected void addResourceBundles()

localeData

protected sun.util.resources.LocaleData localeData(Class<? extends LocaleServiceProvider> providerClass,
                                                   Locale locale)

prepareClassResourceBundle

public void prepareClassResourceBundle(String basename,
                                       String className)

prepareBundle

public void prepareBundle(String baseName)

prepareBundle

public void prepareBundle(String baseName,
                          Collection<Locale> wantedLocales)

prepareBundle

protected void prepareBundle(ResourceBundle bundle,
                             Locale locale)

trace

protected void trace(String msg)