org.alfresco.repo.i18n.MessageServiceImpl.java Source code

Java tutorial

Introduction

Here is the source code for org.alfresco.repo.i18n.MessageServiceImpl.java

Source

/*
 * #%L
 * Alfresco Repository
 * %%
 * Copyright (C) 2005 - 2016 Alfresco Software Limited
 * %%
 * This file is part of the Alfresco software. 
 * If the software was purchased under a paid Alfresco license, the terms of 
 * the paid license agreement will prevail.  Otherwise, the software is 
 * provided under the following open source license terms:
 * 
 * Alfresco is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * Alfresco is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public License
 * along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
 * #L%
 */
package org.alfresco.repo.i18n;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.Reader;
import java.text.MessageFormat;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Enumeration;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.Properties;
import java.util.ResourceBundle;
import java.util.Set;
import java.util.concurrent.locks.Lock;
import java.util.concurrent.locks.ReadWriteLock;
import java.util.concurrent.locks.ReentrantReadWriteLock;

import org.alfresco.error.AlfrescoRuntimeException;
import org.alfresco.model.ContentModel;
import org.alfresco.repo.cache.SimpleCache;
import org.alfresco.repo.dictionary.RepositoryLocation;
import org.alfresco.repo.security.authentication.AuthenticationUtil;
import org.alfresco.repo.security.authentication.AuthenticationUtil.RunAsWork;
import org.alfresco.repo.tenant.TenantService;
import org.alfresco.repo.tenant.TenantUtil;
import org.alfresco.repo.tenant.TenantUtil.TenantRunAsWork;
import org.alfresco.service.cmr.repository.ChildAssociationRef;
import org.alfresco.service.cmr.repository.ContentReader;
import org.alfresco.service.cmr.repository.ContentService;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.repository.NodeService;
import org.alfresco.service.cmr.repository.StoreRef;
import org.alfresco.service.namespace.NamespaceService;
import org.alfresco.service.namespace.QName;
import org.alfresco.service.namespace.RegexQNamePattern;
import org.alfresco.util.LockHelper;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.extensions.surf.util.I18NUtil;

/**
 * Message Service to get localised messages/strings which have been loaded from resource bundles either dynamically 
 * deployed in the Repository and/or statically loaded from the Classpath.
 * 
 * Also provides methods (delegated to core utility class) to access the Locale of the current thread.
 */
public class MessageServiceImpl implements MessageService {
    private static final Log logger = LogFactory.getLog(MessageServiceImpl.class);

    public static final String PROPERTIES_FILE_SUFFIX = ".properties";

    /**
     * Lock objects
     */
    private ReadWriteLock lock = new ReentrantReadWriteLock();
    private Lock readLock = lock.readLock();
    private Lock writeLock = lock.writeLock();

    // dependencies
    private TenantService tenantService;
    private ContentService contentService;
    private NamespaceService namespaceService;
    private NodeService nodeService;

    // Try lock timeout (MNT-11371)
    private long tryLockTimeout;

    /**
     * List of registered bundles
     */
    private SimpleCache<String, Set<String>> resourceBundleBaseNamesCache;

    /**
     * Map of loaded bundles by Locale
     */
    private SimpleCache<String, Map<Locale, Set<String>>> loadedResourceBundlesCache;

    /**
     * Map of cached messaged by Locale
     */
    private SimpleCache<String, Map<Locale, Map<String, String>>> messagesCache;

    private List<MessageDeployer> messageDeployers = new ArrayList<MessageDeployer>();

    public void setNamespaceService(NamespaceService namespaceService) {
        this.namespaceService = namespaceService;
    }

    public void setNodeService(NodeService nodeService) {
        this.nodeService = nodeService;
    }

    public void setTenantService(TenantService tenantService) {
        this.tenantService = tenantService;
    }

    public void setContentService(ContentService contentService) {
        this.contentService = contentService;
    }

    public void setResourceBundleBaseNamesCache(SimpleCache<String, Set<String>> resourceBundleBaseNamesCache) {
        this.resourceBundleBaseNamesCache = resourceBundleBaseNamesCache;
    }

    public void setLoadedResourceBundlesCache(
            SimpleCache<String, Map<Locale, Set<String>>> loadedResourceBundlesCache) {
        this.loadedResourceBundlesCache = loadedResourceBundlesCache;
    }

    public void setMessagesCache(SimpleCache<String, Map<Locale, Map<String, String>>> messagesCache) {
        this.messagesCache = messagesCache;
    }

    public void setTryLockTimeout(long tryLockTimeout) {
        this.tryLockTimeout = tryLockTimeout;
    }

    public void setLocale(Locale locale) {
        I18NUtil.setLocale(locale);
    }

    public Locale getLocale() {
        return I18NUtil.getLocale();
    }

    public void setContentLocale(Locale locale) {
        I18NUtil.setContentLocale(locale);
    }

    public Locale getContentLocale() {
        return I18NUtil.getContentLocale();
    }

    public Locale getNearestLocale(Locale templateLocale, Set<Locale> options) {
        return I18NUtil.getNearestLocale(templateLocale, options);
    }

    public Locale parseLocale(String localeStr) {
        return I18NUtil.parseLocale(localeStr);
    }

    public void registerResourceBundle(String resBundlePath) {
        String tenantDomain = getTenantDomain();
        Set<String> tenantResourceBundleBaseNames = null;
        LockHelper.tryLock(readLock, tryLockTimeout,
                "getting resource bundle base names in 'MessageServiceImpl.registerResourceBundle()'");
        try {
            tenantResourceBundleBaseNames = getResourceBundleBaseNames(tenantDomain, false, true);
        } finally {
            readLock.unlock();
        }

        LockHelper.tryLock(writeLock, tryLockTimeout,
                "adding new resource bundle path and clearing loaded resource bundles in 'MessageServiceImpl.registerResourceBundle()'");
        try {
            if (!tenantResourceBundleBaseNames.contains(resBundlePath)) {
                tenantResourceBundleBaseNames.add(resBundlePath);
                putResourceBundleBaseNames(tenantDomain, tenantResourceBundleBaseNames);
            }

            logger.info("Registered message bundle '" + resBundlePath + "'");

            clearLoadedResourceBundles(tenantDomain); // force re-load of message cache
        } finally {
            writeLock.unlock();
        }
    }

    public String getMessage(String messageKey) {
        return getMessage(messageKey, getLocale());
    }

    public String getMessage(final String messageKey, final Locale locale) {
        String message = null;

        // look for message, within context of tenant if applicable
        Map<String, String> props = getLocaleProperties(locale);
        if (props != null) {
            // get runtime/repo managed message (if it exists)
            message = props.get(messageKey);
        }

        if (message == null) {
            if (tenantService.isTenantUser()) {
                // tenant user, with no tenant-specific message

                //look for non-tenant-specific message
                message = AuthenticationUtil.runAs(new RunAsWork<String>() {
                    public String doWork() throws Exception {
                        String message = null;
                        Map<String, String> props = getLocaleProperties(locale);
                        if (props != null) {
                            // get default runtime/repo managed message (if it exists)
                            message = props.get(messageKey);
                        }
                        return message;
                    }
                }, AuthenticationUtil.getSystemUserName());
            }

            if (message == null) {
                // get default static message (if it exists)
                message = I18NUtil.getMessage(tenantService.getBaseName(messageKey), locale);
            }
        }

        return message;
    }

    public String getMessage(String messageKey, Object... params) {
        return getMessage(messageKey, getLocale(), params);
    }

    public String getMessage(String messageKey, Locale locale, Object... params) {
        String message = getMessage(messageKey, locale);
        if (message != null && params != null) {
            message = MessageFormat.format(message, params);
        }
        return message;
    }

    public void unregisterResourceBundle(String resBundlePath) {
        Map<Locale, Set<String>> loadedResourceBundlesForAllLocales;
        Map<Locale, Map<String, String>> cachedMessagesForAllLocales;
        Set<String> resourceBundleBaseNamesForAllLocales;

        String tenantDomain = getTenantDomain();
        LockHelper.tryLock(readLock, tryLockTimeout,
                "getting loaded resource bundles, messages and base names in 'MessageServiceImpl.unregisterResourceBundle()'");
        try {
            // all locales
            loadedResourceBundlesForAllLocales = getLoadedResourceBundles(tenantDomain, false);
            cachedMessagesForAllLocales = getMessages(tenantDomain, false);
            resourceBundleBaseNamesForAllLocales = getResourceBundleBaseNames(tenantDomain, false, true);
        } finally {
            readLock.unlock();
        }

        LockHelper.tryLock(writeLock, tryLockTimeout,
                "removing resource bundle by path in 'MessageServiceImpl.unregisterResourceBundle()'");
        try {
            // unload resource bundles for each locale (by tenant, if applicable)        
            if ((loadedResourceBundlesForAllLocales != null) && (cachedMessagesForAllLocales != null)) {
                Iterator<Locale> itr = loadedResourceBundlesForAllLocales.keySet().iterator();

                while (itr.hasNext()) {
                    Locale locale = itr.next();

                    Set<String> loadedBundles = loadedResourceBundlesForAllLocales.get(locale);
                    Map<String, String> props = cachedMessagesForAllLocales.get(locale);

                    if ((loadedBundles != null) && (props != null)) {
                        if (loadedBundles.contains(resBundlePath)) {
                            ResourceBundle resourcebundle = null;

                            int idx1 = resBundlePath.indexOf(StoreRef.URI_FILLER);

                            if (idx1 != -1) {
                                // load from repository
                                int idx2 = resBundlePath.indexOf("/", idx1 + 3);

                                String store = resBundlePath.substring(0, idx2);
                                String path = resBundlePath.substring(idx2);

                                StoreRef storeRef = tenantService.getName(new StoreRef(store));

                                try {
                                    resourcebundle = getRepoResourceBundle(storeRef, path, locale);
                                } catch (IOException ioe) {
                                    throw new AlfrescoRuntimeException(
                                            "Failed to read message resource bundle from repository "
                                                    + resBundlePath + " : " + ioe);
                                }
                            } else {
                                // load from classpath
                                resourcebundle = ResourceBundle.getBundle(resBundlePath, locale);
                            }

                            if (resourcebundle != null) {
                                // unload from the cached messages
                                Enumeration<String> enumKeys = resourcebundle.getKeys();
                                while (enumKeys.hasMoreElements() == true) {
                                    String key = enumKeys.nextElement();
                                    props.remove(key);
                                }
                            }

                            loadedBundles.remove(resBundlePath);
                        }
                    }
                }
            }

            // unregister resource bundle
            if (resourceBundleBaseNamesForAllLocales != null) {
                resourceBundleBaseNamesForAllLocales.remove(resBundlePath);
                logger.info("Unregistered message bundle '" + resBundlePath + "'");
            }

            clearLoadedResourceBundles(tenantDomain); // force re-load of message cache
        } finally {
            writeLock.unlock();
        }
    }

    /**
     * Get the messages for a locale.
     * <p>
     * Will use cache where available otherwise will load into cache from bundles.
     *
     * @param locale    the locale
     * @return          message map
     */
    private Map<String, String> getLocaleProperties(Locale locale) {
        Set<String> loadedBundles = null;
        Map<String, String> props = null;

        int loadedBundleCount = 0;

        String tenantDomain = getTenantDomain();
        boolean init = false;

        Map<Locale, Set<String>> tenantLoadedResourceBundles = null;
        Map<Locale, Map<String, String>> tenantCachedMessages = null;
        Set<String> tenantResourceBundleBaseNames = null;

        LockHelper.tryLock(readLock, tryLockTimeout,
                "getting loaded resource bundles, messages and base names in 'MessageServiceImpl.getLocaleProperties()'");
        try {
            tenantLoadedResourceBundles = getLoadedResourceBundles(tenantDomain, true);
            loadedBundles = tenantLoadedResourceBundles.get(locale);

            tenantCachedMessages = getMessages(tenantDomain, true);
            props = tenantCachedMessages.get(locale);

            tenantResourceBundleBaseNames = getResourceBundleBaseNames(tenantDomain, false, false);
            loadedBundleCount = tenantResourceBundleBaseNames.size();
        } finally {
            readLock.unlock();
        }

        if (loadedBundles == null) {
            LockHelper.tryLock(writeLock, tryLockTimeout,
                    "adding resource bundle for locale in 'MessageServiceImpl.getLocaleProperties()'");
            try {
                loadedBundles = new HashSet<String>();
                tenantLoadedResourceBundles.put(locale, loadedBundles);
                putLoadedResourceBundles(tenantDomain, tenantLoadedResourceBundles);
                init = true;
            } finally {
                writeLock.unlock();
            }
        }

        if (props == null) {
            LockHelper.tryLock(writeLock, tryLockTimeout,
                    "adding resource bundle properties into the cache (because properties are not cached) in 'MessageServiceImpl.getLocaleProperties()'");
            try {
                props = new HashMap<String, String>();
                tenantCachedMessages.put(locale, props);
                putMessages(tenantDomain, tenantCachedMessages);
                init = true;
            } finally {
                writeLock.unlock();
            }
        }

        if ((loadedBundles.size() != loadedBundleCount) || (init == true)) {
            LockHelper.tryLock(writeLock, tryLockTimeout,
                    "searching resource bundle and adding new resource bundle for locale if the bundle is not found in 'MessageServiceImpl.getLocaleProperties()'");
            try {
                // get registered resource bundles               
                Set<String> resBundleBaseNames = getResourceBundleBaseNames(tenantDomain, true, false);

                int count = 0;

                // load resource bundles for given locale (by tenant, if applicable)
                for (String resBundlePath : resBundleBaseNames) {
                    if (loadedBundles.contains(resBundlePath) == false) {
                        ResourceBundle resourcebundle = null;

                        int idx1 = resBundlePath.indexOf(StoreRef.URI_FILLER);

                        if (idx1 != -1) {
                            // load from repository
                            int idx2 = resBundlePath.indexOf("/", idx1 + 3);

                            String store = resBundlePath.substring(0, idx2);
                            String path = resBundlePath.substring(idx2);

                            StoreRef storeRef = tenantService.getName(new StoreRef(store));

                            try {
                                resourcebundle = getRepoResourceBundle(storeRef, path, locale);
                            } catch (IOException ioe) {
                                throw new AlfrescoRuntimeException(
                                        "Failed to read message resource bundle from repository " + resBundlePath
                                                + " : " + ioe);
                            }
                        } else {
                            // load from classpath
                            resourcebundle = ResourceBundle.getBundle(resBundlePath, locale);
                        }

                        if (resourcebundle != null) {
                            Enumeration<String> enumKeys = resourcebundle.getKeys();
                            while (enumKeys.hasMoreElements() == true) {
                                String key = enumKeys.nextElement();
                                props.put(key, resourcebundle.getString(key));
                            }

                            loadedBundles.add(resBundlePath);
                            count++;
                        }
                    }
                }

                logger.info("Message bundles (x " + count + ") loaded for locale " + locale);
            } finally {
                writeLock.unlock();
            }
        }

        return props;
    }

    public ResourceBundle getRepoResourceBundle(final StoreRef storeRef, final String path, final Locale locale)
            throws IOException {
        // TODO - need to replace basic strategy with a more complete
        // search & instantiation strategy similar to ResourceBundle.getBundle()
        // Consider search query with basename* and then apply strategy ...

        // Avoid permission exceptions
        RunAsWork<ResourceBundle> getBundleWork = new RunAsWork<ResourceBundle>() {
            @Override
            public ResourceBundle doWork() throws Exception {
                NodeRef rootNode = nodeService.getRootNode(storeRef);

                // first attempt - with locale        
                NodeRef nodeRef = getNode(rootNode, path + "_" + locale + PROPERTIES_FILE_SUFFIX);

                if (nodeRef == null) {
                    // second attempt - basename 
                    nodeRef = getNode(rootNode, path + PROPERTIES_FILE_SUFFIX);
                }

                if (nodeRef == null) {
                    logger.debug("Could not find message resource bundle " + storeRef + "/" + path);
                    return null;
                }

                ContentReader cr = contentService.getReader(nodeRef, ContentModel.PROP_CONTENT);
                ResourceBundle resBundle = new MessagePropertyResourceBundle(
                        new InputStreamReader(cr.getContentInputStream(), cr.getEncoding()));
                return resBundle;
            }
        };
        return AuthenticationUtil.runAs(getBundleWork, AuthenticationUtil.getSystemUserName());
    }

    public void onEnableTenant() {
        // NOOP - refer to DictionaryRepositoryBootstrap
    }

    public void onDisableTenant() {
        destroy(); // will be called in context of tenant
    }

    public void init() {
        // initialise empty message service       
        String tenantDomain = getTenantDomain();

        putResourceBundleBaseNames(tenantDomain, new HashSet<String>());
        putLoadedResourceBundles(tenantDomain, new HashMap<Locale, Set<String>>());
        putMessages(tenantDomain, new HashMap<Locale, Map<String, String>>());

        logger.info("Empty message service initialised");
    }

    public void destroy() {
        // used by reset and also as callback when destroying tenant(s) during shutdown
        String tenantDomain = getTenantDomain();

        removeLoadedResourceBundles(tenantDomain);
        removeMessages(tenantDomain);
        removeResourceBundleBaseNames(tenantDomain);

        logger.info("Messages cache destroyed (all locales)");
    }

    public Set<String> getRegisteredBundles() {
        LockHelper.tryLock(readLock, tryLockTimeout,
                "getting resource bundle base names in 'MessageServiceImpl.getRegisteredBundles()'");
        try {
            return getResourceBundleBaseNames(getTenantDomain(), false, false);
        } finally {
            readLock.unlock();
        }
    }

    private Set<String> getResourceBundleBaseNames(String tenantDomain, boolean haveWriteLock, boolean forWrite) {
        // Assume a read lock is present
        Set<String> resourceBundleBaseNames = resourceBundleBaseNamesCache.get(tenantDomain);
        if (resourceBundleBaseNames != null) {
            return getOrCopyResourceBundleBaseNames(resourceBundleBaseNames, forWrite);
        }

        if (!haveWriteLock) {
            // They are not there. Upgrade to the write lock.
            readLock.unlock();
            LockHelper.tryLock(writeLock, tryLockTimeout,
                    "getting cached resource bundle base names by tenant domain in 'MessageServiceImpl.getRegisteredBundles()'");
        }

        try {
            resourceBundleBaseNames = resourceBundleBaseNamesCache.get(tenantDomain);
            if (resourceBundleBaseNames != null) {
                return getOrCopyResourceBundleBaseNames(resourceBundleBaseNames, forWrite);
            }
            reset(tenantDomain); // reset caches - may have been invalidated (e.g. in a cluster)
            resourceBundleBaseNames = resourceBundleBaseNamesCache.get(tenantDomain);
        } finally {
            if (!haveWriteLock) {
                writeLock.unlock();
                LockHelper.tryLock(readLock, tryLockTimeout,
                        "upgrading to read lock in MessageServiceImpl.getResourceBundleBaseNames()");
            }
        }

        if (resourceBundleBaseNames == null) {
            // unexpected
            throw new AlfrescoRuntimeException(
                    "Failed to re-initialise resourceBundleBaseNamesCache " + tenantDomain);
        }
        // Done
        return getOrCopyResourceBundleBaseNames(resourceBundleBaseNames, forWrite);
    }

    private Set<String> getOrCopyResourceBundleBaseNames(Set<String> inbound, boolean createNew) {
        return createNew ? new HashSet<String>(inbound) : inbound;
    }

    private void putResourceBundleBaseNames(String tenantDomain, Set<String> resourceBundleBaseNames) {
        resourceBundleBaseNames = Collections.unmodifiableSet(new HashSet<String>(resourceBundleBaseNames));
        resourceBundleBaseNamesCache.put(tenantDomain, resourceBundleBaseNames);
    }

    private void removeResourceBundleBaseNames(String tenantDomain) {
        if (resourceBundleBaseNamesCache.get(tenantDomain) != null) {
            resourceBundleBaseNamesCache.remove(tenantDomain);
        }
    }

    private Map<Locale, Set<String>> getLoadedResourceBundles(String tenantDomain, boolean forWrite) {
        // Assume a read lock is present
        Map<Locale, Set<String>> loadedResourceBundles = loadedResourceBundlesCache.get(tenantDomain);
        if (loadedResourceBundles != null) {
            return getOrCopyResourceBundles(loadedResourceBundles, forWrite);
        }

        // Not present.  Upgrade to write lock.
        readLock.unlock();
        LockHelper.tryLock(writeLock, tryLockTimeout,
                "getting cached resource bundle by tenant domain in 'MessageServiceImpl.getLoadedResourceBundles()'");
        try {
            loadedResourceBundles = loadedResourceBundlesCache.get(tenantDomain);
            if (loadedResourceBundles != null) {
                return getOrCopyResourceBundles(loadedResourceBundles, forWrite);
            }
            reset(tenantDomain); // reset caches - may have been invalidated (e.g. in a cluster)
            loadedResourceBundles = loadedResourceBundlesCache.get(tenantDomain);
        } finally {
            writeLock.unlock();
            LockHelper.tryLock(readLock, tryLockTimeout,
                    "upgrading to read lock in MessageServiceImpl.getLoadedResourceBundles()");
        }

        if (loadedResourceBundles == null) {
            // unexpected
            throw new AlfrescoRuntimeException(
                    "Failed to re-initialise loadedResourceBundlesCache " + tenantDomain);
        }
        // Done
        return getOrCopyResourceBundles(loadedResourceBundles, forWrite);
    }

    private Map<Locale, Set<String>> getOrCopyResourceBundles(Map<Locale, Set<String>> inbound, boolean createNew) {
        return createNew ? new HashMap<Locale, Set<String>>(inbound) : inbound;
    }

    private void putLoadedResourceBundles(String tenantDomain, Map<Locale, Set<String>> loadedResourceBundles) {
        loadedResourceBundles = Collections
                .unmodifiableMap(new HashMap<Locale, Set<String>>(loadedResourceBundles));
        loadedResourceBundlesCache.put(tenantDomain, loadedResourceBundles);
    }

    private void removeLoadedResourceBundles(String tenantDomain) {
        if (loadedResourceBundlesCache.get(tenantDomain) != null) {
            loadedResourceBundlesCache.remove(tenantDomain);
        }
    }

    private void clearLoadedResourceBundles(String tenantDomain) {
        if (loadedResourceBundlesCache.get(tenantDomain) != null) {
            putLoadedResourceBundles(tenantDomain, new HashMap<Locale, Set<String>>());
        }
    }

    private Map<Locale, Map<String, String>> getMessages(String tenantDomain, boolean forWrite) {
        // Assume a read lock
        Map<Locale, Map<String, String>> messages = messagesCache.get(tenantDomain);
        if (messages != null) {
            return getOrCopyMessages(messages, forWrite);
        }

        // Need to create it.  Upgrade to write lock.
        readLock.unlock();
        LockHelper.tryLock(writeLock, tryLockTimeout,
                "getting messages by tenant domain from the cache in 'MessageServiceImpl.getMessages()'");
        try {
            messages = messagesCache.get(tenantDomain);
            if (messages != null) {
                return getOrCopyMessages(messages, forWrite);
            }
            reset(tenantDomain); // reset caches - may have been invalidated (e.g. in a cluster)
            messages = messagesCache.get(tenantDomain);
        } finally {
            writeLock.unlock();
            LockHelper.tryLock(readLock, tryLockTimeout,
                    "upgrading to read lock in MessageServiceImpl.getMessages()");
        }

        if (messages == null) {
            // unexpected
            throw new AlfrescoRuntimeException("Failed to re-initialise messagesCache " + tenantDomain);
        }
        // Done
        return getOrCopyMessages(messages, forWrite);
    }

    private Map<Locale, Map<String, String>> getOrCopyMessages(Map<Locale, Map<String, String>> inbound,
            boolean createNew) {
        return createNew ? new HashMap<Locale, Map<String, String>>(inbound) : inbound;
    }

    private void putMessages(String tenantDomain, Map<Locale, Map<String, String>> messages) {
        messages = Collections.unmodifiableMap(new HashMap<Locale, Map<String, String>>(messages));
        messagesCache.put(tenantDomain, messages);
    }

    private void removeMessages(String tenantDomain) {
        if (messagesCache.get(tenantDomain) != null) {
            messagesCache.remove(tenantDomain);
        }
    }

    // local helper - returns tenant domain (or empty string if default non-tenant)
    private String getTenantDomain() {
        return tenantService.getCurrentUserDomain();
    }

    public void register(MessageDeployer messageDeployer) {
        if (!messageDeployers.contains(messageDeployer)) {
            messageDeployers.add(messageDeployer);
        }
    }

    /**
     * Resets the message service
     */
    public void reset() {
        reset(getTenantDomain());
    }

    private void reset(String tenantDomain) {
        if (logger.isDebugEnabled()) {
            logger.debug("Resetting messages ...");
        }

        TenantUtil.runAsSystemTenant(new TenantRunAsWork<Object>() {
            public Object doWork() {
                destroy();
                init();

                for (final MessageDeployer messageDeployer : messageDeployers) {
                    messageDeployer.initMessages();
                }

                return null;
            }
        }, tenantDomain);

        if (logger.isDebugEnabled()) {
            logger.debug("... resetting messages completed");
        }
    }

    /**
     * Message Resource Bundle
     * <p/>
     * Custom message property resource bundle, to overcome known limitation of JDK 5.0 (and lower).<br/>
     * http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6204853
     * <p/>
     * Note: JDK 6.0 provides the ability to construct a PropertyResourceBundle from a Reader.
     */
    private class MessagePropertyResourceBundle extends ResourceBundle {
        private Properties properties = new Properties();

        /**
         * @param reader            the source of the properties, which will be closed after use
         */
        public MessagePropertyResourceBundle(Reader reader) throws IOException {
            BufferedReader br = new BufferedReader(reader);
            try {
                String line = br.readLine();
                while (line != null) {
                    if ((line.length() > 0) && (line.charAt(0) != '#')) {
                        String[] splits = line.split("=", 2);

                        if (splits.length == 2) {
                            properties.put(splits[0], splits[1]);
                        } else if (splits.length == 1) {
                            properties.put(splits[0], "");
                        } else {
                            logger.warn("Unexpected message properties file format: " + line);
                            throw new AlfrescoRuntimeException(
                                    "Unexpected message properties file format: " + line);
                        }
                    }
                    line = br.readLine();
                }
            } finally {
                try {
                    br.close();
                } catch (IOException e) {
                }
                try {
                    reader.close();
                } catch (IOException e) {
                }
            }
        }

        @Override
        public Enumeration<String> getKeys() {
            List<String> keys = new ArrayList<String>();
            Enumeration<Object> enums = properties.keys();
            while (enums.hasMoreElements()) {
                keys.add((String) enums.nextElement());
            }
            return new StringIteratorEnumeration(keys.iterator());
        }

        @Override
        protected Object handleGetObject(String arg0) {
            return properties.get(arg0);
        }

        private class StringIteratorEnumeration implements Enumeration<String> {
            private Iterator<String> enums;

            public StringIteratorEnumeration(Iterator<String> enums) {
                this.enums = enums;
            }

            public boolean hasMoreElements() {
                return enums.hasNext();
            }

            public String nextElement() {
                return enums.next();
            }
        }
    }

    public String getBaseBundleName(String resourceName) {
        // convert resource file name to a resource bundle basename
        // e.g. either 'workflow_fr_FR.properties' or 'workflow.properties' should be converted to 'workflow'
        // note: this assumes that the baseName itself does not contain underscore !

        String bundleBaseName = resourceName;
        int idx = resourceName.indexOf("_");
        if (idx > 0) {
            bundleBaseName = resourceName.substring(0, idx);
        } else {
            int idx1 = resourceName.indexOf(".");
            if (idx1 > 0) {
                bundleBaseName = resourceName.substring(0, idx1);
            }
        }

        return bundleBaseName;
    }

    protected NodeRef getNode(NodeRef rootNodeRef, String path) {
        RepositoryLocation repositoryLocation = new RepositoryLocation(rootNodeRef.getStoreRef(), path,
                RepositoryLocation.LANGUAGE_PATH);
        String[] pathElements = repositoryLocation.getPathElements();

        NodeRef nodeRef = rootNodeRef;
        if (pathElements.length > 0) {
            nodeRef = resolveQNamePath(rootNodeRef, pathElements);
        }

        return nodeRef;
    }

    // TODO refactor (see also DictionaryRepositoryBootstrap)
    protected NodeRef resolveQNamePath(NodeRef rootNodeRef, String[] pathPrefixQNameStrings) {
        if (pathPrefixQNameStrings.length == 0) {
            throw new IllegalArgumentException("Path array is empty");
        }
        // walk the path
        NodeRef parentNodeRef = rootNodeRef;
        for (int i = 0; i < pathPrefixQNameStrings.length; i++) {
            String pathPrefixQNameString = pathPrefixQNameStrings[i];

            QName pathQName = null;
            if (AuthenticationUtil.isMtEnabled()) {
                String[] parts = QName.splitPrefixedQName(pathPrefixQNameString);
                if ((parts.length == 2) && (parts[0].equals(NamespaceService.APP_MODEL_PREFIX))) {
                    String pathUriQNameString = new StringBuilder(64).append(QName.NAMESPACE_BEGIN)
                            .append(NamespaceService.APP_MODEL_1_0_URI).append(QName.NAMESPACE_END).append(parts[1])
                            .toString();

                    pathQName = QName.createQName(pathUriQNameString);
                } else {
                    pathQName = QName.createQName(pathPrefixQNameString, namespaceService);
                }
            } else {
                pathQName = QName.createQName(pathPrefixQNameString, namespaceService);
            }

            List<ChildAssociationRef> childAssocRefs = nodeService.getChildAssocs(parentNodeRef,
                    RegexQNamePattern.MATCH_ALL, pathQName);
            if (childAssocRefs.size() != 1) {
                return null;
            }
            parentNodeRef = childAssocRefs.get(0).getChildRef();
        }
        return parentNodeRef;
    }
}