SpringCloud/spring-cloud-contract
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Sync docs from master to gh-pages

Browse Source
This commit is contained in:
buildmaster
2020-01-30 13:53:46 +00:00
parent 00f9fe629a
commit 590410f6e6
71 changed files with 7292 additions and 7204 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
reference/htmlsingle/index.html
View File

@@ -218,7 +218,7 @@ $(addBlockSwitches);
<p>3.0.0.BUILD-SNAPSHOT</p>
</div>
<div class="paragraph">
<p>Copyright &#169; 2012-2019</p>
<p>Copyright &#169; 2012-2020</p>
</div>
<div class="paragraph">
<p>Copies of this document may be made for your own use and for distribution to
@@ -436,7 +436,7 @@ be marked as a fraud in both Groovy and YAML:</p>
<div class="title">groovy</div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
* Copyright 2013-2019 the original author or authors.
* Copyright 2013-2020 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.
@@ -1834,7 +1834,7 @@ is important because the producer&#8217;s test base class name references that f
<div class="title">groovy</div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
* Copyright 2013-2019 the original author or authors.
* Copyright 2013-2020 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.
@@ -2393,7 +2393,7 @@ start the server side <code>FraudDetectionController</code>. The following listi
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">/*
* Copyright 2013-2019 the original author or authors.
* Copyright 2013-2020 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.
@@ -4507,7 +4507,7 @@ following resources in your project:</p>
<div class="title">groovy</div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
* Copyright 2013-2019 the original author or authors.
* Copyright 2013-2020 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.
@@ -9463,8 +9463,8 @@ work.
</td>
<td class="content">
<div class="paragraph">
<p>If you want to use Spring Cloud Stream, remember to add a dependency on
<code>org.springframework.cloud:spring-cloud-stream-test-support</code>, as follows:</p>
<p>If you want to use Spring Cloud Stream, remember to add a test dependency on
<code>org.springframework.cloud:spring-cloud-stream</code>, as follows:</p>
</div>
<div class="exampleblock">
<div class="content">
@@ -9473,15 +9473,17 @@ work.
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
&lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
&lt;artifactId&gt;spring-cloud-stream&lt;/artifactId&gt;
&lt;type&gt;test-jar&lt;/type&gt;
&lt;scope&gt;test&lt;/scope&gt;
&lt;classifier&gt;test-binder&lt;/classifier&gt;
&lt;/dependency&gt;</code></pre>
</div>
</div>
<div class="listingblock secondary">
<div class="title">Gradle</div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testImplementation(group: 'org.springframework.cloud', name: 'spring-cloud-stream', classifier: 'test-binder')</code></pre>
</div>
</div>
</div>
@@ -10691,7 +10693,7 @@ destination is resolved as a channel name.
<td class="content">
<div class="paragraph">
<p>If you want to use Spring Cloud Stream, remember to add a dependency on
<code>org.springframework.cloud:spring-cloud-stream-test-support</code>, as follows:</p>
<code>org.springframework.cloud:spring-cloud-stream</code> test support, as follows:</p>
</div>
<div class="exampleblock">
<div class="content">
@@ -10700,15 +10702,17 @@ destination is resolved as a channel name.
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
&lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
&lt;artifactId&gt;spring-cloud-stream&lt;/artifactId&gt;
&lt;type&gt;test-jar&lt;/type&gt;
&lt;scope&gt;test&lt;/scope&gt;
&lt;classifier&gt;test-binder&lt;/classifier&gt;
&lt;/dependency&gt;</code></pre>
</div>
</div>
<div class="listingblock secondary">
<div class="title">Gradle</div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testImplementation(group: 'org.springframework.cloud', name: 'spring-cloud-stream', classifier: 'test-binder')</code></pre>
</div>
</div>
</div>
@@ -12782,12 +12786,12 @@ The following example achieves the same result by setting values on the annotati
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">//@AutoConfigureStubRunner(
// ids = ["org.springframework.cloud.contract.verifier.stubs:loanIssuance",
// "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer",
// "org.springframework.cloud.contract.verifier.stubs:bootService"],
// stubsMode = StubRunnerProperties.StubsMode.REMOTE,
// repositoryRoot = "classpath:m2repo/repository/")</code></pre>
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@AutoConfigureStubRunner(
ids = ["org.springframework.cloud.contract.verifier.stubs:loanIssuance",
"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer",
"org.springframework.cloud.contract.verifier.stubs:bootService"],
stubsMode = StubRunnerProperties.StubsMode.REMOTE,
repositoryRoot = "classpath:m2repo/repository/")</code></pre>
</div>
</div>
<div class="paragraph">
@@ -12881,14 +12885,14 @@ instead of calling the real Service Discovery tool.</p>
<div class="content">
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">// def 'should make service discovery work'() {
// expect: 'WireMocks are running'
// "${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
// "${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
// and: 'Stubs can be reached via load service discovery'
// restTemplate.getForObject('http://loanIssuance/name', String) == 'loanIssuance'
// restTemplate.getForObject('http://someNameThatShouldMapFraudDetectionServer/name', String) == 'fraudDetectionServer'
// }</code></pre>
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def 'should make service discovery work'() {
expect: 'WireMocks are running'
"${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
"${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
and: 'Stubs can be reached via load service discovery'
restTemplate.getForObject('http://loanIssuance/name', String) == 'loanIssuance'
restTemplate.getForObject('http://someNameThatShouldMapFraudDetectionServer/name', String) == 'fraudDetectionServer'
}</code></pre>
</div>
</div>
</div>
@@ -13372,6 +13376,7 @@ Alternatively, you can set the test as follows:</p>
repositoryRoot = "classpath:m2repo/repository/",
stubsMode = StubRunnerProperties.StubsMode.REMOTE,
stubsPerConsumer = true)
@ActiveProfiles("streamconsumer")
class StubRunnerStubsPerConsumerSpec extends Specification {
...
}</code></pre>
@@ -13397,6 +13402,7 @@ class StubRunnerStubsPerConsumerSpec extends Specification {
consumerName = "foo-consumer",
stubsMode = StubRunnerProperties.StubsMode.REMOTE,
stubsPerConsumer = true)
@ActiveProfiles("streamconsumer")
class StubRunnerStubsPerConsumerWithConsumerNameSpec extends Specification {
...
}</code></pre>
@@ -16695,7 +16701,7 @@ org.springframework.cloud.contract.stubrunner.TestCustomYamlContractConverter</c
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
* Copyright 2013-2019 the original author or authors.
* Copyright 2013-2020 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.
@@ -19497,8 +19503,8 @@ To do so, include the following dependencies (if you have not already done so):<
<div class="listingblock secondary">
<div class="title">gradle</div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
testCompile 'org.springframework.restdocs:spring-restdocs-mockmvc'</code></pre>
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testImplementation 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
testImplementation 'org.springframework.restdocs:spring-restdocs-mockmvc'</code></pre>
</div>
</div>
</div>
@@ -19715,9 +19721,9 @@ Also, you can define your own properties.
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable stubs registration in Eureka.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.cloud.ribbon.enabled</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.cloud.loadbalancer.enabled</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable Stub Runner&#8217;s Ribbon integration.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable Stub Runner&#8217;s Spring Cloud Load Balancer integration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.cloud.stubbed.discovery.enabled</p></td>