Polishing

(cherry picked from commit 426f52b)

Author: jhoeller

spring-context/src/test/java/org/springframework/aop/framework/CglibProxyTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2014 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.
@@ -155,8 +155,8 @@ void hidden() {
 			assertTrue(ex.getCause() instanceof CodeGenerationException ||
 					ex.getCause() instanceof IllegalArgumentException);
 			// Check that error message is helpful
-			assertTrue(ex.getMessage().indexOf("final") != -1);
-			assertTrue(ex.getMessage().indexOf("visible") != -1);
+			assertTrue(ex.getMessage().contains("final"));
+			assertTrue(ex.getMessage().contains("visible"));
 		}
 	}
 
@@ -171,9 +171,7 @@ public void testMethodInvocationDuringConstructor() {
 		AopProxy aop = new CglibAopProxy(as);
 
 		CglibTestBean proxy = (CglibTestBean) aop.getProxy();
-
-		assertEquals("The name property has been overwritten by the constructor",
-				"Rob Harrop", proxy.getName());
+		assertEquals("The name property has been overwritten by the constructor", "Rob Harrop", proxy.getName());
 	}
 
 	@Test
@@ -186,9 +184,7 @@ public void testUnadvisedProxyCreationWithCallDuringConstructor() throws Excepti
 		pc.setTarget(target);
 
 		CglibAopProxy aop = new CglibAopProxy(pc);
-
 		CglibTestBean proxy = (CglibTestBean) aop.getProxy();
-
 		assertNotNull("Proxy should not be null", proxy);
 		assertEquals("Constructor overrode the value of name", "Rob Harrop", proxy.getName());
 
@@ -218,15 +214,18 @@ private ITestBean getAdvisedProxy(TestBean target) {
 			public ClassFilter getClassFilter() {
 				return ClassFilter.TRUE;
 			}
-
 			@Override
 			public MethodMatcher getMethodMatcher() {
 				return MethodMatcher.TRUE;
 			}
-
+			@Override
 			public boolean equals(Object obj) {
 				return true;
 			}
+			@Override
+			public int hashCode() {
+				return 0;
+			}
 		};
 		pf.addAdvisor(new DefaultPointcutAdvisor(pointcut, advice));
 
@@ -250,7 +249,7 @@ public void testMultipleProxiesForIntroductionAdvisor() {
 	}
 
 	private ITestBean getIntroductionAdvisorProxy(TestBean target) {
-		ProxyFactory pf = new ProxyFactory(new Class<?>[]{ITestBean.class});
+		ProxyFactory pf = new ProxyFactory(new Class<?>[] {ITestBean.class});
 		pf.setProxyTargetClass(true);
 
 		pf.addAdvisor(new LockMixinAdvisor());
@@ -270,8 +269,7 @@ public void testWithNoArgConstructor() {
 		AdvisedSupport pc = new AdvisedSupport(new Class<?>[]{});
 		pc.setTargetSource(mockTargetSource);
 		CglibAopProxy aop = new CglibAopProxy(pc);
-		aop.setConstructorArguments(new Object[] {"Rob Harrop", new Integer(22)},
-				new Class<?>[] {String.class, int.class});
+		aop.setConstructorArguments(new Object[] {"Rob Harrop", 22}, new Class<?>[] {String.class, int.class});
 
 		NoArgCtorTestBean proxy = (NoArgCtorTestBean) aop.getProxy();
 		proxy = (NoArgCtorTestBean) aop.getProxy();
@@ -347,9 +345,9 @@ public void testExceptionHandling() {
 	}
 
 	@Test
+	@SuppressWarnings("resource")
 	public void testWithDependencyChecking() {
-		ApplicationContext ctx =
-				new ClassPathXmlApplicationContext(DEPENDENCY_CHECK_CONTEXT, getClass());
+		ApplicationContext ctx = new ClassPathXmlApplicationContext(DEPENDENCY_CHECK_CONTEXT, getClass());
 		ctx.getBean("testBean");
 	}
 

spring-core/src/main/java/org/springframework/util/ConcurrentReferenceHashMap.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2014 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.
@@ -132,6 +132,15 @@ public ConcurrentReferenceHashMap(int initialCapacity, int concurrencyLevel) {
 		this(initialCapacity, DEFAULT_LOAD_FACTOR, concurrencyLevel, DEFAULT_REFERENCE_TYPE);
 	}
 
+	/**
+	 * Create a new {@code ConcurrentReferenceHashMap} instance.
+	 * @param initialCapacity the initial capacity of the map
+	 * @param referenceType the reference type used for entries (soft or weak)
+	 */
+	public ConcurrentReferenceHashMap(int initialCapacity, ReferenceType referenceType) {
+		this(initialCapacity, DEFAULT_LOAD_FACTOR, DEFAULT_CONCURRENCY_LEVEL, referenceType);
+	}
+
 	/**
 	 * Create a new {@code ConcurrentReferenceHashMap} instance.
 	 * @param initialCapacity the initial capacity of the map
@@ -151,7 +160,7 @@ public ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int con
 	 * table exceeds this value, resize will be attempted.
 	 * @param concurrencyLevel the expected number of threads that will concurrently
 	 * write to the map
-	 * @param referenceType the reference type used for entries
+	 * @param referenceType the reference type used for entries (soft or weak)
 	 */
 	@SuppressWarnings("unchecked")
 	public ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int concurrencyLevel,
@@ -165,10 +174,10 @@ public ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int con
 		this.shift = calculateShift(concurrencyLevel, MAXIMUM_CONCURRENCY_LEVEL);
 		int size = 1 << this.shift;
 		this.referenceType = referenceType;
-		int roundedUpSegmentCapactity = (int) ((initialCapacity + size - 1L) / size);
+		int roundedUpSegmentCapacity = (int) ((initialCapacity + size - 1L) / size);
 		this.segments = (Segment[]) Array.newInstance(Segment.class, size);
 		for (int i = 0; i < this.segments.length; i++) {
-			this.segments[i] = new Segment(roundedUpSegmentCapactity);
+			this.segments[i] = new Segment(roundedUpSegmentCapacity);
 		}
 	}
 
@@ -186,8 +195,8 @@ protected final Segment getSegment(int index) {
 	}
 
 	/**
-	 * Factory method that returns the {@link ReferenceManager}. This method will be
-	 * called once for each {@link Segment}.
+	 * Factory method that returns the {@link ReferenceManager}.
+	 * This method will be called once for each {@link Segment}.
 	 * @return a new reference manager
 	 */
 	protected ReferenceManager createReferenceManager() {

spring-core/src/main/java/org/springframework/util/CustomizableThreadCreator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2012 the original author or authors.
+ * Copyright 2002-2014 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.
@@ -19,8 +19,8 @@
 import java.io.Serializable;
 
 /**
- * Simple customizable helper class for creating threads. Provides various
- * bean properties, such as thread name prefix, thread priority, etc.
+ * Simple customizable helper class for creating new {@link Thread} instances.
+ * Provides various bean properties: thread name prefix, thread priority, etc.
  *
  * <p>Serves as base class for thread factories such as
  * {@link org.springframework.scheduling.concurrent.CustomizableThreadFactory}.
@@ -96,11 +96,11 @@ public int getThreadPriority() {
 	/**
 	 * Set whether this factory is supposed to create daemon threads,
 	 * just executing as long as the application itself is running.
-	 * <p>Default is "false": Concrete factories usually support explicit
-	 * cancelling. Hence, if the application shuts down, Runnables will
-	 * by default finish their execution.
-	 * <p>Specify "true" for eager shutdown of threads which still
-	 * actively execute a Runnable.
+	 * <p>Default is "false": Concrete factories usually support explicit cancelling.
+	 * Hence, if the application shuts down, Runnables will by default finish their
+	 * execution.
+	 * <p>Specify "true" for eager shutdown of threads which still actively execute
+	 * a {@link Runnable} at the time that the application itself shuts down.
 	 * @see java.lang.Thread#setDaemon
 	 */
 	public void setDaemon(boolean daemon) {
@@ -132,17 +132,17 @@ public void setThreadGroup(ThreadGroup threadGroup) {
 
 	/**
 	 * Return the thread group that threads should be created in
-	 * (or {@code null}) for the default group.
+	 * (or {@code null} for the default group).
 	 */
 	public ThreadGroup getThreadGroup() {
 		return this.threadGroup;
 	}
 
 
 	/**
-	 * Template method for the creation of a Thread.
-	 * <p>Default implementation creates a new Thread for the given
-	 * Runnable, applying an appropriate thread name.
+	 * Template method for the creation of a new {@link Thread}.
+	 * <p>The default implementation creates a new Thread for the given
+	 * {@link Runnable}, applying an appropriate thread name.
 	 * @param runnable the Runnable to execute
 	 * @see #nextThreadName()
 	 */
@@ -154,10 +154,9 @@ public Thread createThread(Runnable runnable) {
 	}
 
 	/**
-	 * Return the thread name to use for a newly created thread.
-	 * <p>Default implementation returns the specified thread name prefix
-	 * with an increasing thread count appended: for example,
-	 * "SimpleAsyncTaskExecutor-0".
+	 * Return the thread name to use for a newly created {@link Thread}.
+	 * <p>The default implementation returns the specified thread name prefix
+	 * with an increasing thread count appended: e.g. "SimpleAsyncTaskExecutor-0".
 	 * @see #getThreadNamePrefix()
 	 */
 	protected String nextThreadName() {

spring-core/src/main/java/org/springframework/util/ReflectionUtils.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2014 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.
@@ -44,8 +44,13 @@
  */
 public abstract class ReflectionUtils {
 
+	/**
+	 * Pattern for detecting CGLIB-renamed methods.
+	 * @see #isCglibRenamedMethod
+	 */
 	private static final Pattern CGLIB_RENAMED_METHOD_PATTERN = Pattern.compile("CGLIB\\$(.+)\\$\\d+");
 
+
 	/**
 	 * Attempt to find a {@link Field field} on the supplied {@link Class} with the
 	 * supplied {@code name}. Searches all superclasses up to {@link Object}.
@@ -133,7 +138,7 @@ public static Object getField(Field field, Object target) {
 	 * @return the Method object, or {@code null} if none found
 	 */
 	public static Method findMethod(Class<?> clazz, String name) {
-		return findMethod(clazz, name, new Class[0]);
+		return findMethod(clazz, name, new Class<?>[0]);
 	}
 
 	/**
@@ -373,19 +378,21 @@ public static boolean isToStringMethod(Method method) {
 	 * Determine whether the given method is originally declared by {@link java.lang.Object}.
 	 */
 	public static boolean isObjectMethod(Method method) {
+		if (method == null) {
+			return false;
+		}
 		try {
 			Object.class.getDeclaredMethod(method.getName(), method.getParameterTypes());
 			return true;
-		} catch (SecurityException ex) {
-			return false;
-		} catch (NoSuchMethodException ex) {
+		}
+		catch (Exception ex) {
 			return false;
 		}
 	}
 
 	/**
-	 * Determine whether the given method is a CGLIB 'renamed' method, following
-	 * the pattern "CGLIB$methodName$0".
+	 * Determine whether the given method is a CGLIB 'renamed' method,
+	 * following the pattern "CGLIB$methodName$0".
 	 * @param renamedMethod the method to check
 	 * @see org.springframework.cglib.proxy.Enhancer#rename
 	 */
@@ -512,15 +519,15 @@ public static Method[] getUniqueDeclaredMethods(Class<?> leafClass) throws Illeg
 			public void doWith(Method method) {
 				boolean knownSignature = false;
 				Method methodBeingOverriddenWithCovariantReturnType = null;
-
 				for (Method existingMethod : methods) {
 					if (method.getName().equals(existingMethod.getName()) &&
 							Arrays.equals(method.getParameterTypes(), existingMethod.getParameterTypes())) {
-						// is this a covariant return type situation?
+						// Is this a covariant return type situation?
 						if (existingMethod.getReturnType() != method.getReturnType() &&
 								existingMethod.getReturnType().isAssignableFrom(method.getReturnType())) {
 							methodBeingOverriddenWithCovariantReturnType = existingMethod;
-						} else {
+						}
+						else {
 							knownSignature = true;
 						}
 						break;