Java tutorial
/* * Copyright 2000-2018 Vaadin Ltd. * * 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.vaadin.util; import java.io.Serializable; import java.lang.ref.WeakReference; import java.util.Collections; import java.util.HashMap; import java.util.Iterator; import java.util.Map; import java.util.Map.Entry; import java.util.concurrent.ConcurrentHashMap; import java.util.logging.Level; import java.util.logging.Logger; import com.vaadin.server.VaadinRequest; import com.vaadin.server.VaadinResponse; import com.vaadin.server.VaadinService; import com.vaadin.server.VaadinSession; import com.vaadin.ui.UI; /** * Keeps track of various current instances for the current thread. All the * instances are automatically cleared after handling a request from the client * to avoid leaking memory. * <p> * Please note that the instances are stored using {@link WeakReference}. This * means that the a current instance value may suddenly disappear if there a no * other references to the object. * <p> * Currently the framework uses the following instances: * </p> * <p> * {@link UI}, {@link VaadinService}, {@link VaadinSession}, * {@link VaadinRequest}, {@link VaadinResponse}. * </p> * * @author Vaadin Ltd * @since 7.0.0 */ public class CurrentInstance implements Serializable { private static final Object NULL_OBJECT = new Object(); private static final CurrentInstance CURRENT_INSTANCE_NULL = new CurrentInstance(NULL_OBJECT); private static final ConcurrentHashMap<Class<?>, CurrentInstanceFallbackResolver<?>> fallbackResolvers = new ConcurrentHashMap<Class<?>, CurrentInstanceFallbackResolver<?>>(); private final WeakReference<Object> instance; private static final ThreadLocal<Map<Class<?>, CurrentInstance>> INSTANCES = new ThreadLocal<>(); private CurrentInstance(Object instance) { this.instance = new WeakReference<>(instance); } /** * Gets the current instance of a specific type if available. * <p> * When a current instance of the specific type is not found, the * {@link CurrentInstanceFallbackResolver} registered via * {@link #defineFallbackResolver(Class, CurrentInstanceFallbackResolver)} * (if any) is invoked. * * @param type * the class to get an instance of * @return the current instance or the provided type, or <code>null</code> * if there is no current instance. */ public static <T> T get(Class<T> type) { T result = doGet(type); if (result != null) { return result; } CurrentInstanceFallbackResolver<?> fallbackResolver = fallbackResolvers.get(type); if (fallbackResolver != null) { return (T) fallbackResolver.resolve(); } return null; } private static <T> T doGet(Class<T> type) { Map<Class<?>, CurrentInstance> map = INSTANCES.get(); if (map == null) { return null; } CurrentInstance currentInstance = map.get(type); if (currentInstance != null) { Object value = currentInstance.instance.get(); if (value == null) { /* * This is believed to never actually happen since the * ThreadLocal should only outlive the referenced object on * threads that are not doing anything related to Vaadin, which * should thus never invoke CurrentInstance.get(). * * At this point, there might also be other values that have * been collected, so we'll scan the entire map and remove stale * CurrentInstance objects. Using a ReferenceQueue could make * this assumingly rare case slightly more efficient, but would * significantly increase the complexity of the code for * maintaining a separate ReferenceQueue for each Thread. */ removeStaleInstances(map); if (map.isEmpty()) { INSTANCES.remove(); } return null; } return type.cast(value); } else { return null; } } /** * Adds a CurrentInstanceFallbackResolver, that is triggered when * {@link #get(Class)} can't find a suitable instance for the given type * parameter. * * @param type * the class used on {@link #get(Class)} invocations to retrieve * the current instance * @param fallbackResolver * the resolver, not <code>null</code> * * @throws IllegalArgumentException * if there's already a defined fallback resolver for the given * type * @since 8.5.2 */ public static <T> void defineFallbackResolver(Class<T> type, CurrentInstanceFallbackResolver<T> fallbackResolver) { if (fallbackResolver == null) { throw new IllegalArgumentException("The fallback resolver can not be null."); } if (fallbackResolvers.putIfAbsent(type, fallbackResolver) != null) { throw new IllegalArgumentException("A fallback resolver for the type " + type + " is already defined."); } } private static void removeStaleInstances(Map<Class<?>, CurrentInstance> map) { for (Iterator<Entry<Class<?>, CurrentInstance>> iterator = map.entrySet().iterator(); iterator.hasNext();) { Entry<Class<?>, CurrentInstance> entry = iterator.next(); Object instance = entry.getValue().instance.get(); if (instance == null) { iterator.remove(); getLogger().log(Level.FINE, "CurrentInstance for {0} has been garbage collected.", entry.getKey()); } } } /** * Sets the current instance of the given type. * * @see ThreadLocal * * @param type * the class that should be used when getting the current * instance back * @param instance * the actual instance */ public static <T> CurrentInstance set(Class<T> type, T instance) { Map<Class<?>, CurrentInstance> map = INSTANCES.get(); CurrentInstance previousInstance = null; if (instance == null) { // remove the instance if (map != null) { previousInstance = map.remove(type); if (map.isEmpty()) { INSTANCES.remove(); map = null; } } } else { assert type.isInstance(instance) : "Invald instance type"; if (map == null) { map = new HashMap<>(); INSTANCES.set(map); } previousInstance = map.put(type, new CurrentInstance(instance)); } if (previousInstance == null) { previousInstance = CURRENT_INSTANCE_NULL; } return previousInstance; } /** * Clears all current instances. */ public static void clearAll() { INSTANCES.remove(); } /** * Restores the given instances to the given values. Note that this should * only be used internally to restore Vaadin classes. * * @since 7.1 * * @param old * A Class -> CurrentInstance map to set as current instances */ public static void restoreInstances(Map<Class<?>, CurrentInstance> old) { boolean removeStale = false; for (Class c : old.keySet()) { CurrentInstance ci = old.get(c); Object v = ci.instance.get(); if (v == null) { removeStale = true; } else if (v == NULL_OBJECT) { /* * NULL_OBJECT is used to identify objects that are null when * #setCurrent(UI) or #setCurrent(VaadinSession) are called on a * CurrentInstance. Without this a reference to an already * collected instance may be left in the CurrentInstance when it * really should be restored to null. * * One example case that this fixes: * VaadinService.runPendingAccessTasks() clears all current * instances and then sets everything but the UI. This makes * UI.accessSynchronously() save these values before calling * setCurrent(UI), which stores UI=null in the map it returns. * This map will be restored after UI.accessSync(), which, * unless it respects null values, will just leave the wrong UI * instance registered. */ v = null; } set(c, v); } if (removeStale) { removeStaleInstances(old); } } /** * Gets the currently set instances so that they can later be restored using * {@link #restoreInstances(Map)}. * * @since 8.0 * * @return a map containing the current instances */ public static Map<Class<?>, CurrentInstance> getInstances() { Map<Class<?>, CurrentInstance> map = INSTANCES.get(); if (map == null) { return Collections.emptyMap(); } else { Map<Class<?>, CurrentInstance> copy = new HashMap<>(); boolean removeStale = false; for (Class<?> c : map.keySet()) { CurrentInstance ci = map.get(c); if (ci.instance.get() == null) { removeStale = true; } else { copy.put(c, ci); } } if (removeStale) { removeStaleInstances(map); if (map.isEmpty()) { INSTANCES.remove(); } } return copy; } } /** * Sets current instances for the UI and all related classes. The previously * defined values can be restored by passing the returned map to * {@link #restoreInstances(Map)}. * * @since 7.1 * * @param ui * The UI * @return A map containing the old values of the instances that this method * updated. */ public static Map<Class<?>, CurrentInstance> setCurrent(UI ui) { Map<Class<?>, CurrentInstance> old = setCurrent(ui.getSession()); old.put(UI.class, set(UI.class, ui)); return old; } /** * Sets current instances for the {@link VaadinSession} and all related * classes. The previously defined values can be restored by passing the * returned map to {@link #restoreInstances(Map)}. * * @since 7.1 * * @param session * The VaadinSession * @return A map containing the old values of the instances this method * updated. */ public static Map<Class<?>, CurrentInstance> setCurrent(VaadinSession session) { Map<Class<?>, CurrentInstance> old = new HashMap<>(); old.put(VaadinSession.class, set(VaadinSession.class, session)); VaadinService service = null; if (session != null) { service = session.getService(); } old.put(VaadinService.class, set(VaadinService.class, service)); return old; } private static Logger getLogger() { return Logger.getLogger(CurrentInstance.class.getName()); } }