From 0f4b49197ec17c10aaeb41e91720dbb1115c2fe5 Mon Sep 17 00:00:00 2001
From: buildmaster <buildmaster@springframework.org>
Date: Wed, 28 Dec 2016 19:10:31 +0000
Subject: [PATCH] Sync docs from master to gh-pages

---
 spring-cloud-contract.html | 106 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 104 insertions(+), 2 deletions(-)

diff --git a/spring-cloud-contract.html b/spring-cloud-contract.html
index 501101f1dc..077a7685b3 100644
--- a/spring-cloud-contract.html
+++ b/spring-cloud-contract.html
@@ -765,6 +765,7 @@ $(addBlockSwitches);
 </li>
 <li><a href="#_jax_rs_support">JAX-RS support</a></li>
 <li><a href="#_async_support">Async support</a></li>
+<li><a href="#_working_with_context_paths">Working with Context Paths</a></li>
 <li><a href="#_messaging_top_level_elements">Messaging Top-Level Elements</a>
 <ul class="sectlevel4">
 <li><a href="#_output_triggered_by_a_method">Output triggered by a method</a></li>
@@ -1827,7 +1828,7 @@ It&#8217;s really important that you understand the map notation to set up contr
 [INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ http-server ---
 [INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar
 [INFO]
-[INFO] --- spring-boot-maven-plugin:1.4.0.BUILD-SNAPSHOT:repackage (default) @ http-server ---
+[INFO] --- spring-boot-maven-plugin:1.5.0.BUILD-SNAPSHOT:repackage (default) @ http-server ---
 [INFO]
 [INFO] --- maven-install-plugin:2.5.2:install (default-install) @ http-server ---
 [INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.jar
@@ -2558,7 +2559,7 @@ one to one to the contents of the repo.</p>
 	&lt;parent&gt;
 		&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
 		&lt;artifactId&gt;spring-boot-starter-parent&lt;/artifactId&gt;
-		&lt;version&gt;1.4.2.BUILD-SNAPSHOT&lt;/version&gt;
+		&lt;version&gt;1.5.0.BUILD-SNAPSHOT&lt;/version&gt;
 		&lt;relativePath /&gt;
 	&lt;/parent&gt;
 
@@ -6782,6 +6783,107 @@ section a <code>async()</code> method. Example:</p>
 </div>
 </div>
 <div class="sect3">
+<h4 id="_working_with_context_paths">Working with Context Paths</h4>
+<div class="paragraph">
+<p>Spring Cloud Contract supports context paths.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Important</div>
+</td>
+<td class="content">
+The only thing that changes in order to fully support context paths is the switch
+on the <strong>PRODUCER</strong> side. The autogenerated tests need to be using the <strong>EXPLICIT</strong> mode.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The consumer side remains untouched, in order for the generated test to pass you have to switch the <strong>EXPLICIT</strong> mode.</p>
+</div>
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlight"><code class="language-groovy" data-lang="groovy">contracts {
+		testMode = 'EXPLICIT'
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>That way you&#8217;ll generate a test that <strong>DOES NOT</strong> use MockMvc. It means that you&#8217;re generating
+real requests and you need to setup your generated test&#8217;s base class to work on a real socket.</p>
+</div>
+<div class="paragraph">
+<p>Let&#8217;s imagine the following contract:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-groovy" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method 'GET'
+		url '/my-context-path/url'
+	}
+	response {
+		status 200
+	}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Here is an example of how to set up a base class and Rest Assured for everything to work correctly.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-groovy" data-lang="groovy">import com.jayway.restassured.RestAssured;
+import org.junit.Before;
+import org.springframework.boot.context.embedded.LocalServerPort;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest(classes = ContextPathTestingBaseClass.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+class ContextPathTestingBaseClass {
+
+	@LocalServerPort int port;
+
+	@Before
+	public void setup() {
+		RestAssured.baseURI = "http://localhost";
+		RestAssured.port = this.port;
+	}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>That way all:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>all your requests in the autogenerated tests will be sent to the real endpoint with your context path included (e.g. <code>/my-context-path/url</code>)</p>
+</li>
+<li>
+<p>your contracts reflect that you have a context path, thus your generated stubs will also
+have that information (e.g. in the stubs you&#8217;ll see that you have too call <code>/my-context-path/url</code>)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
 <h4 id="_messaging_top_level_elements">Messaging Top-Level Elements</h4>
 <div class="paragraph">
 <p>The DSL for messaging looks a little bit different than the one that focuses on HTTP.</p>