Polishing

Author: jhoeller

spring-test/src/main/java/org/springframework/test/web/servlet/result/MockMvcResultHandlers.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2012 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -31,10 +31,6 @@
  */
 public abstract class MockMvcResultHandlers {
 
-
-	private MockMvcResultHandlers() {
-	}
-
 	/**
 	 * Print {@link MvcResult} details to the "standard" output stream.
 	 */
@@ -43,18 +39,18 @@ public static ResultHandler print() {
 	}
 
 
-	/** An {@link PrintingResultHandler} that writes to the "standard" output stream */
+	/**
+	 * A {@link PrintingResultHandler} that writes to the "standard" output stream.
+	 */
 	private static class ConsolePrintingResultHandler extends PrintingResultHandler {
 
 		public ConsolePrintingResultHandler() {
 			super(new ResultValuePrinter() {
-
 				@Override
 				public void printHeading(String heading) {
 					System.out.println();
 					System.out.println(String.format("%20s:", heading));
 				}
-
 				@Override
 				public void printValue(String label, Object value) {
 					if (value != null && value.getClass().isArray()) {
@@ -65,4 +61,5 @@ public void printValue(String label, Object value) {
 			});
 		}
 	}
+
 }

spring-test/src/main/java/org/springframework/test/web/servlet/result/MockMvcResultMatchers.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -28,23 +28,22 @@
 import static org.springframework.test.util.AssertionErrors.*;
 
 /**
- * Static, factory methods for {@link ResultMatcher}-based result actions.
+ * Static factory methods for {@link ResultMatcher}-based result actions.
  *
- * <p><strong>Eclipse users:</strong> consider adding this class as a Java editor
- * favorite. To navigate, open the Preferences and type "favorites".
+ * <h3>Eclipse Users</h3>
+ * <p>Consider adding this class as a Java editor favorite. To navigate to
+ * this setting, open the Preferences and type "favorites".
  *
  * @author Rossen Stoyanchev
  * @author Brian Clozel
+ * @author Sam Brannen
  * @since 3.2
  */
 public abstract class MockMvcResultMatchers {
 
 	private static final AntPathMatcher pathMatcher = new AntPathMatcher();
 
 
-	private MockMvcResultMatchers() {
-	}
-
 	/**
 	 * Access to request-related assertions.
 	 */
@@ -82,12 +81,11 @@ public static FlashAttributeResultMatchers flash() {
 
 	/**
 	 * Asserts the request was forwarded to the given URL.
-	 * This methods accepts only exact matches.
+	 * <p>This methods accepts only exact matches.
 	 * @param expectedUrl the exact URL expected
 	 */
 	public static ResultMatcher forwardedUrl(final String expectedUrl) {
 		return new ResultMatcher() {
-
 			@Override
 			public void match(MvcResult result) {
 				assertEquals("Forwarded URL", expectedUrl, result.getResponse().getForwardedUrl());
@@ -97,14 +95,14 @@ public void match(MvcResult result) {
 
 	/**
 	 * Asserts the request was forwarded to the given URL.
-	 * This methods accepts {@link org.springframework.util.AntPathMatcher} expressions.
+	 * <p>This methods accepts {@link org.springframework.util.AntPathMatcher}
+	 * expressions.
 	 * @param urlPattern an AntPath expression to match against
-	 * @see org.springframework.util.AntPathMatcher
 	 * @since 4.0
+	 * @see org.springframework.util.AntPathMatcher
 	 */
 	public static ResultMatcher forwardedUrlPattern(final String urlPattern) {
 		return new ResultMatcher() {
-
 			@Override
 			public void match(MvcResult result) {
 				assertTrue("AntPath expression", pathMatcher.isPattern(urlPattern));
@@ -116,12 +114,11 @@ public void match(MvcResult result) {
 
 	/**
 	 * Asserts the request was redirected to the given URL.
-	 * This methods accepts only exact matches.
+	 * <p>This methods accepts only exact matches.
 	 * @param expectedUrl the exact URL expected
 	 */
 	public static ResultMatcher redirectedUrl(final String expectedUrl) {
 		return new ResultMatcher() {
-
 			@Override
 			public void match(MvcResult result) {
 				assertEquals("Redirected URL", expectedUrl, result.getResponse().getRedirectedUrl());
@@ -131,14 +128,14 @@ public void match(MvcResult result) {
 
 	/**
 	 * Asserts the request was redirected to the given URL.
-	 * This methods accepts {@link org.springframework.util.AntPathMatcher} expressions.
+	 * <p>This method accepts {@link org.springframework.util.AntPathMatcher}
+	 * expressions.
 	 * @param expectedUrl an AntPath expression to match against
 	 * @see org.springframework.util.AntPathMatcher
 	 * @since 4.0
 	 */
 	public static ResultMatcher redirectedUrlPattern(final String expectedUrl) {
 		return new ResultMatcher() {
-
 			@Override
 			public void match(MvcResult result) {
 				assertTrue("AntPath expression",pathMatcher.isPattern(expectedUrl));
@@ -170,25 +167,24 @@ public static ContentResultMatchers content() {
 	}
 
 	/**
-	 * Access to response body assertions using a <a
-	 * href="http://goessner.net/articles/JsonPath/">JSONPath</a> expression to
-	 * inspect a specific subset of the body. The JSON path expression can be a
-	 * parameterized string using formatting specifiers as defined in
+	 * Access to response body assertions using a
+	 * <a href="https://github.com/jayway/JsonPath">JsonPath</a> expression
+	 * to inspect a specific subset of the body.
+	 * <p>The JSON path expression can be a parameterized string using
+	 * formatting specifiers as defined in
 	 * {@link String#format(String, Object...)}.
-	 *
-	 * @param expression the JSON path optionally parameterized with arguments
+	 * @param expression the JSON path expression, optionally parameterized with arguments
 	 * @param args arguments to parameterize the JSON path expression with
 	 */
 	public static JsonPathResultMatchers jsonPath(String expression, Object ... args) {
 		return new JsonPathResultMatchers(expression, args);
 	}
 
 	/**
-	 * Access to response body assertions using a <a
-	 * href="http://goessner.net/articles/JsonPath/">JSONPath</a> expression to
-	 * inspect a specific subset of the body and a Hamcrest match for asserting
-	 * the value found at the JSON path.
-	 *
+	 * Access to response body assertions using a
+	 * <a href="https://github.com/jayway/JsonPath">JsonPath</a> expression
+	 * to inspect a specific subset of the body and a Hamcrest matcher for
+	 * asserting the value found at the JSON path.
 	 * @param expression the JSON path expression
 	 * @param matcher a matcher for the value expected at the JSON path
 	 */
@@ -197,25 +193,23 @@ public static <T> ResultMatcher jsonPath(String expression, Matcher<T> matcher)
 	}
 
 	/**
-	 * Access to response body assertions using an XPath to inspect a specific
-	 * subset of the body. The XPath expression can be a parameterized string
-	 * using formatting specifiers as defined in
-	 * {@link String#format(String, Object...)}.
-	 *
-	 * @param expression the XPath optionally parameterized with arguments
+	 * Access to response body assertions using an XPath expression to
+	 * inspect a specific subset of the body.
+	 * <p>The XPath expression can be a parameterized string using formatting
+	 * specifiers as defined in {@link String#format(String, Object...)}.
+	 * @param expression the XPath expression, optionally parameterized with arguments
 	 * @param args arguments to parameterize the XPath expression with
 	 */
 	public static XpathResultMatchers xpath(String expression, Object... args) throws XPathExpressionException {
 		return new XpathResultMatchers(expression, null, args);
 	}
 
 	/**
-	 * Access to response body assertions using an XPath to inspect a specific
-	 * subset of the body. The XPath expression can be a parameterized string
-	 * using formatting specifiers as defined in
-	 * {@link String#format(String, Object...)}.
-	 *
-	 * @param expression the XPath optionally parameterized with arguments
+	 * Access to response body assertions using an XPath expression to
+	 * inspect a specific subset of the body.
+	 * <p>The XPath expression can be a parameterized string using formatting
+	 * specifiers as defined in {@link String#format(String, Object...)}.
+	 * @param expression the XPath expression, optionally parameterized with arguments
 	 * @param namespaces namespaces referenced in the XPath expression
 	 * @param args arguments to parameterize the XPath expression with
 	 */