/*
 * Copyright 2002-2018 the original author or authors.
 *
 * 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 org.springframework.ui.context.support;

import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import org.springframework.beans.factory.BeanClassLoaderAware;
import org.springframework.context.HierarchicalMessageSource;
import org.springframework.context.MessageSource;
import org.springframework.context.support.ResourceBundleMessageSource;
import org.springframework.lang.Nullable;
import org.springframework.ui.context.HierarchicalThemeSource;
import org.springframework.ui.context.Theme;
import org.springframework.ui.context.ThemeSource;

ThemeSource implementation that looks up an individual ResourceBundle per theme. The theme name gets interpreted as ResourceBundle basename, supporting a common basename prefix for all themes.
Author:Jean-Pierre Pawlak, Juergen Hoeller
See Also:
/** * {@link ThemeSource} implementation that looks up an individual * {@link java.util.ResourceBundle} per theme. The theme name gets * interpreted as ResourceBundle basename, supporting a common * basename prefix for all themes. * * @author Jean-Pierre Pawlak * @author Juergen Hoeller * @see #setBasenamePrefix * @see java.util.ResourceBundle * @see org.springframework.context.support.ResourceBundleMessageSource */
public class ResourceBundleThemeSource implements HierarchicalThemeSource, BeanClassLoaderAware { protected final Log logger = LogFactory.getLog(getClass()); @Nullable private ThemeSource parentThemeSource; private String basenamePrefix = ""; @Nullable private String defaultEncoding; @Nullable private Boolean fallbackToSystemLocale; @Nullable private ClassLoader beanClassLoader;
Map from theme name to Theme instance.
/** Map from theme name to Theme instance. */
private final Map<String, Theme> themeCache = new ConcurrentHashMap<>(); @Override public void setParentThemeSource(@Nullable ThemeSource parent) { this.parentThemeSource = parent; // Update existing Theme objects. // Usually there shouldn't be any at the time of this call. synchronized (this.themeCache) { for (Theme theme : this.themeCache.values()) { initParent(theme); } } } @Override @Nullable public ThemeSource getParentThemeSource() { return this.parentThemeSource; }
Set the prefix that gets applied to the ResourceBundle basenames, i.e. the theme names. E.g.: basenamePrefix="test.", themeName="theme" -> basename="test.theme".

Note that ResourceBundle names are effectively classpath locations: As a consequence, the JDK's standard ResourceBundle treats dots as package separators. This means that "test.theme" is effectively equivalent to "test/theme", just like it is for programmatic java.util.ResourceBundle usage.

See Also:
/** * Set the prefix that gets applied to the ResourceBundle basenames, * i.e. the theme names. * E.g.: basenamePrefix="test.", themeName="theme" -> basename="test.theme". * <p>Note that ResourceBundle names are effectively classpath locations: As a * consequence, the JDK's standard ResourceBundle treats dots as package separators. * This means that "test.theme" is effectively equivalent to "test/theme", * just like it is for programmatic {@code java.util.ResourceBundle} usage. * @see java.util.ResourceBundle#getBundle(String) */
public void setBasenamePrefix(@Nullable String basenamePrefix) { this.basenamePrefix = (basenamePrefix != null ? basenamePrefix : ""); }
Set the default charset to use for parsing resource bundle files.

ResourceBundleMessageSource's default is the java.util.ResourceBundle default encoding: ISO-8859-1.

See Also:
Since:4.2
/** * Set the default charset to use for parsing resource bundle files. * <p>{@link ResourceBundleMessageSource}'s default is the * {@code java.util.ResourceBundle} default encoding: ISO-8859-1. * @since 4.2 * @see ResourceBundleMessageSource#setDefaultEncoding */
public void setDefaultEncoding(@Nullable String defaultEncoding) { this.defaultEncoding = defaultEncoding; }
Set whether to fall back to the system Locale if no files for a specific Locale have been found.

ResourceBundleMessageSource's default is "true".

See Also:
Since:4.2
/** * Set whether to fall back to the system Locale if no files for a * specific Locale have been found. * <p>{@link ResourceBundleMessageSource}'s default is "true". * @since 4.2 * @see ResourceBundleMessageSource#setFallbackToSystemLocale */
public void setFallbackToSystemLocale(boolean fallbackToSystemLocale) { this.fallbackToSystemLocale = fallbackToSystemLocale; } @Override public void setBeanClassLoader(@Nullable ClassLoader beanClassLoader) { this.beanClassLoader = beanClassLoader; }
This implementation returns a SimpleTheme instance, holding a ResourceBundle-based MessageSource whose basename corresponds to the given theme name (prefixed by the configured "basenamePrefix").

SimpleTheme instances are cached per theme name. Use a reloadable MessageSource if themes should reflect changes to the underlying files.

See Also:
/** * This implementation returns a SimpleTheme instance, holding a * ResourceBundle-based MessageSource whose basename corresponds to * the given theme name (prefixed by the configured "basenamePrefix"). * <p>SimpleTheme instances are cached per theme name. Use a reloadable * MessageSource if themes should reflect changes to the underlying files. * @see #setBasenamePrefix * @see #createMessageSource */
@Override @Nullable public Theme getTheme(String themeName) { Theme theme = this.themeCache.get(themeName); if (theme == null) { synchronized (this.themeCache) { theme = this.themeCache.get(themeName); if (theme == null) { String basename = this.basenamePrefix + themeName; MessageSource messageSource = createMessageSource(basename); theme = new SimpleTheme(themeName, messageSource); initParent(theme); this.themeCache.put(themeName, theme); if (logger.isDebugEnabled()) { logger.debug("Theme created: name '" + themeName + "', basename [" + basename + "]"); } } } } return theme; }
Create a MessageSource for the given basename, to be used as MessageSource for the corresponding theme.

Default implementation creates a ResourceBundleMessageSource. for the given basename. A subclass could create a specifically configured ReloadableResourceBundleMessageSource, for example.

Params:
  • basename – the basename to create a MessageSource for
See Also:
Returns:the MessageSource
/** * Create a MessageSource for the given basename, * to be used as MessageSource for the corresponding theme. * <p>Default implementation creates a ResourceBundleMessageSource. * for the given basename. A subclass could create a specifically * configured ReloadableResourceBundleMessageSource, for example. * @param basename the basename to create a MessageSource for * @return the MessageSource * @see org.springframework.context.support.ResourceBundleMessageSource * @see org.springframework.context.support.ReloadableResourceBundleMessageSource */
protected MessageSource createMessageSource(String basename) { ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource(); messageSource.setBasename(basename); if (this.defaultEncoding != null) { messageSource.setDefaultEncoding(this.defaultEncoding); } if (this.fallbackToSystemLocale != null) { messageSource.setFallbackToSystemLocale(this.fallbackToSystemLocale); } if (this.beanClassLoader != null) { messageSource.setBeanClassLoader(this.beanClassLoader); } return messageSource; }
Initialize the MessageSource of the given theme with the one from the corresponding parent of this ThemeSource.
Params:
  • theme – the Theme to (re-)initialize
/** * Initialize the MessageSource of the given theme with the * one from the corresponding parent of this ThemeSource. * @param theme the Theme to (re-)initialize */
protected void initParent(Theme theme) { if (theme.getMessageSource() instanceof HierarchicalMessageSource) { HierarchicalMessageSource messageSource = (HierarchicalMessageSource) theme.getMessageSource(); if (getParentThemeSource() != null && messageSource.getParentMessageSource() == null) { Theme parentTheme = getParentThemeSource().getTheme(theme.getName()); if (parentTheme != null) { messageSource.setParentMessageSource(parentTheme.getMessageSource()); } } } } }