Improve handling of requests with both parameters and content

Previously, if a MockMvc request was made with parameters and body
content, the parameters were omitted from the resulting curl, HTTPie
and HTTP request snippets.

This commit updates the affected snippets to ensure that the
parameters are included. The user-provided content is interpreted
as indicating that the parameters should be sent in the query string
rather than as form-encoded content.

Closes gh-239

spring-restdocs-core/src/main/java/org/springframework/restdocs/cli/CurlRequestSnippet.java

@@ -69,7 +69,16 @@ public class CurlRequestSnippet extends TemplatedSnippet {
 	}
 
 	private String getUrl(Operation operation) {
-		return String.format("'%s'", operation.getRequest().getUri());
+		OperationRequest request = operation.getRequest();
+		if (!request.getParameters().isEmpty() && includeParametersInUri(request)) {
+			return String.format("'%s?%s'", request.getUri(),
+					request.getParameters().toQueryString());
+		}
+		return String.format("'%s'", request.getUri());
+	}
+
+	private boolean includeParametersInUri(OperationRequest request) {
+		return request.getMethod() == HttpMethod.GET || request.getContent().length > 0;
 	}
 
 	private String getOptions(Operation operation) {

spring-restdocs-core/src/main/java/org/springframework/restdocs/cli/HttpieRequestSnippet.java

@@ -24,6 +24,7 @@ import java.util.Map;
 import java.util.Map.Entry;
 
 import org.springframework.http.HttpHeaders;
+import org.springframework.http.HttpMethod;
 import org.springframework.http.MediaType;
 import org.springframework.restdocs.operation.Operation;
 import org.springframework.restdocs.operation.OperationRequest;
@@ -89,7 +90,11 @@ public class HttpieRequestSnippet extends TemplatedSnippet {
 		return options.toString();
 	}
 
-	private String getUrl(OperationRequest request) {
+	private String getUrl(CliOperationRequest request) {
+		if (!request.getUniqueParameters().isEmpty() && includeParametersInUri(request)) {
+			return String.format("'%s?%s'", request.getUri(),
+					request.getParameters().toQueryString());
+		}
 		return String.format("'%s'", request.getUri());
 	}
 
@@ -103,11 +108,16 @@ public class HttpieRequestSnippet extends TemplatedSnippet {
 	}
 
 	private void writeOptions(CliOperationRequest request, PrintWriter writer) {
-		if (!request.getParts().isEmpty() || !request.getUniqueParameters().isEmpty()) {
+		if (!request.getParts().isEmpty() || (!request.getUniqueParameters().isEmpty()
+				&& !includeParametersInUri(request))) {
 			writer.print("--form ");
 		}
 	}
 
+	private boolean includeParametersInUri(CliOperationRequest request) {
+		return request.getMethod() == HttpMethod.GET || request.getContent().length > 0;
+	}
+
 	private void writeUserOptionIfNecessary(CliOperationRequest request,
 			PrintWriter writer) {
 		String credentials = request.getBasicAuthCredentials();

spring-restdocs-core/src/main/java/org/springframework/restdocs/http/HttpRequestSnippet.java

@@ -66,14 +66,33 @@ public class HttpRequestSnippet extends TemplatedSnippet {
 	protected Map<String, Object> createModel(Operation operation) {
 		Map<String, Object> model = new HashMap<>();
 		model.put("method", operation.getRequest().getMethod());
-		model.put("path", operation.getRequest().getUri().getRawPath()
-				+ (StringUtils.hasText(operation.getRequest().getUri().getRawQuery())
-						? "?" + operation.getRequest().getUri().getRawQuery() : ""));
+		model.put("path", getPath(operation.getRequest()));
 		model.put("headers", getHeaders(operation.getRequest()));
 		model.put("requestBody", getRequestBody(operation.getRequest()));
 		return model;
 	}
 
+	private String getPath(OperationRequest request) {
+		String path = request.getUri().getRawPath();
+		String queryString = request.getUri().getRawQuery();
+		if (!request.getParameters().isEmpty() && includeParametersInUri(request)) {
+			if (StringUtils.hasText(queryString)) {
+				queryString = queryString + "&" + request.getParameters().toQueryString();
+			}
+			else {
+				queryString = request.getParameters().toQueryString();
+			}
+		}
+		if (StringUtils.hasText(queryString)) {
+			path = path + "?" + queryString;
+		}
+		return path;
+	}
+
+	private boolean includeParametersInUri(OperationRequest request) {
+		return request.getMethod() == HttpMethod.GET || request.getContent().length > 0;
+	}
+
 	private List<Map<String, String>> getHeaders(OperationRequest request) {
 		List<Map<String, String>> headers = new ArrayList<>();
 
@@ -172,7 +191,8 @@ public class HttpRequestSnippet extends TemplatedSnippet {
 
 	private boolean requiresFormEncodingContentTypeHeader(OperationRequest request) {
 		return request.getHeaders().get(HttpHeaders.CONTENT_TYPE) == null
-				&& isPutOrPost(request) && !request.getParameters().isEmpty();
+				&& isPutOrPost(request) && (!request.getParameters().isEmpty()
+						&& !includeParametersInUri(request));
 	}
 
 	private Map<String, String> header(String name, String value) {