Java Swing 框架

/* * Copyright (C) 2006 Sun Microsystems, Inc. All rights reserved. Use is * subject to license terms. */ package application; import application.ResourceConverter.ResourceConverterException; import java.awt.Color; import java.awt.Component; import java.awt.Container; import java.awt.Font; import java.awt.Image; import java.beans.BeanInfo; import java.beans.IntrospectionException; import java.beans.Introspector; import java.beans.PropertyDescriptor; import java.lang.reflect.Array; import java.lang.reflect.Field; import java.lang.reflect.Method; import java.net.URL; import java.text.MessageFormat; import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; import java.util.Enumeration; import java.util.HashSet; import java.util.List; import java.util.Locale; import java.util.Map; import java.util.MissingResourceException; import java.util.ResourceBundle; import java.util.Set; import java.util.concurrent.ConcurrentHashMap; import java.util.logging.Logger; import java.util.regex.Matcher; import java.util.regex.Pattern; import javax.swing.Icon; import javax.swing.ImageIcon; import javax.swing.JMenu; import javax.swing.KeyStroke; /** * A read-only encapsulation of one or more ResourceBundles that adds * automatic string conversion, support for field and Swing component * property injection, string resource variable substitution, and chaining. * <p> * ResourceMaps are typically obtained with the {@code ApplicationContext} * {@link ApplicationContext#getResourceMap getResourceMap} method * which lazily creates per Application, package, and class ResourceMaps that * are linked together with the ResourceMap <tt>parent</tt> property. * <p> * An individual ResourceMap provides read-only access to all of the * resources defined by the ResourceBundles named when the ResourceMap * was created as well as all of its parent ResourceMaps. Resources * are retrieved with the <tt>getObject</tt> method which requires both * the name of the resource and its expected type. The latter is used * to convert strings if neccessary. * Converted values are cached. As a convenience, <tt>getObject</tt> * wrapper methods for common GUI types, like <tt>getFont</tt>, * and <tt>getColor</tt>, are provided. * <p> * The <tt>getObject</tt> method scans raw string resource values * for <tt>${resourceName}</tt> variable substitutions before * performing string conversion. Variables named this way can * refer to String resources defined anywhere in their ResourceMap * or any parent ResourceMap. The special variable <tt>${null}</tt> * means that the value of the resource will be null. * <p> * ResourceMaps can be used to "inject" resource values into Swing * component properties and into object fields. The * <tt>injectComponents</tt> method uses Component names ({@link * Component#setName}) to match resources names with properties. The * <tt>injectFields</tt> method sets fields that have been tagged with * the <tt>&#064;Resource</tt> annotation to the value of resources * with the same name. * * @author Hans Muller (Hans.Muller@Sun.COM) * @see #injectComponents * @see #injectFields * @see ResourceConverter * @see ResourceBundle */ public class ResourceMap { private static Logger logger = Logger.getLogger(ResourceMap.class.getName()); private final static Object nullResource = new String("null resource"); private final ClassLoader classLoader; private final ResourceMap parent; private final String bundleNames[]; private final String resourcesDir; private Map<String, Object> bundlesMapP = null; // see getBundlesMap() private Set<String> bundlesMapKeysP = null; // set getBundlesMapKeys() private boolean bundlesLoaded = false; // ResourceBundles are loaded lazily /* If path doesn't have a leading "/" then the resourcesDir * is prepended, otherwise the leading "/" is removed. */ private static String resourcePath(String path, ResourceMap resourceMap) { String rPath = path; if (path == null) { rPath = null; } else if (path.startsWith("/")) { rPath = (path.length() > 1) ? path.substring(1) : null; } else { rPath = resourceMap.getResourcesDir() + path; } return rPath; } private static ImageIcon loadImageIcon(String s, ResourceMap resourceMap) throws ResourceConverterException { String rPath = resourcePath(s, resourceMap); if (rPath == null) { String msg = String.format("invalid image/icon path \"%s\"", s); throw new ResourceConverterException(msg, s); } URL url = resourceMap.getClassLoader().getResource(rPath); if (url != null) { return new ImageIcon(url); } else { String msg = String.format("couldn't find Icon resource \"%s\"", s); throw new ResourceConverterException(msg, s); } } /* Register ResourceConverters that are defined in this class * and documented here. */ static { ResourceConverter[] stringConverters = { new ColorStringConverter(), new IconStringConverter(), new ImageStringConverter(), new FontStringConverter(), new KeyStrokeStringConverter(), }; for (ResourceConverter sc : stringConverters) { ResourceConverter.register(sc); } } private static class FontStringConverter extends ResourceConverter { FontStringConverter() { super(Font.class); } /* Just delegates to Font.decode. * Typical string is: face-STYLE-size, for example "Arial-PLAIN-12" */ @Override public Object parseString(String s, ResourceMap ignore) throws ResourceConverterException { return Font.decode(s); } } private static class ColorStringConverter extends ResourceConverter { ColorStringConverter() { super(Color.class); } private void error(String msg, String s, Exception e) throws ResourceConverterException { throw new ResourceConverterException(msg, s, e); } private void error(String msg, String s) throws ResourceConverterException { error(msg, s, null); } /* An improved version of Color.decode() that supports colors * with an alpha channel and comma separated RGB[A] values. * Legal format for color resources are: * "#RRGGBB", "#AARRGGBB", "R, G, B", "R, G, B, A" * Thanks to Romain Guy for the code. */ @Override public Object parseString(String s, ResourceMap ignore) throws ResourceConverterException { Color color = null; if (s.startsWith("#")) { switch (s.length()) { // RGB/hex color case 7: color = Color.decode(s); break; // ARGB/hex color case 9: int alpha = Integer.decode(s.substring(0, 3)); int rgb = Integer.decode("#" + s.substring(3)); color = new Color(alpha << 24 | rgb, true); break; default: throw new ResourceConverterException("invalid #RRGGBB or #AARRGGBB color string", s); } } else { String[] parts = s.split(","); if (parts.length < 3 || parts.length > 4) { throw new ResourceConverterException("invalid R, G, B[, A] color string", s); } try { // with alpha component if (parts.length == 4) { int r = Integer.parseInt(parts[0].trim()); int g = Integer.parseInt(parts[1].trim()); int b = Integer.parseInt(parts[2].trim()); int a = Integer.parseInt(parts[3].trim()); color = new Color(r, g, b, a); } else { int r = Integer.parseInt(parts[0].trim()); int g = Integer.parseInt(parts[1].trim()); int b = Integer.parseInt(parts[2].trim()); color = new Color(r, g, b); } } catch (NumberFormatException e) { throw new ResourceConverterException("invalid R, G, B[, A] color string", s, e); } } return color; } } private static class IconStringConverter extends ResourceConverter { IconStringConverter() { super(Icon.class); } @Override public Object parseString(String s, ResourceMap resourceMap) throws ResourceConverterException { return loadImageIcon(s, resourceMap); } @Override public