From 40e5da70f5bbff96ed27356bebb3e0c80f8fda1f Mon Sep 17 00:00:00 2001 From: buildmaster Date: Thu, 24 Oct 2019 21:38:37 +0000 Subject: [PATCH] Sync docs from v2.2.0.RC1 to gh-pages --- ...w-consumer-cdc-external-consumer.png.cache | 1 + ...w-consumer-cdc-external-producer.png.cache | 1 + .../flows-provider-non-jvm-consumer.png.cache | 1 + .../flows-provider-non-jvm-producer.png.cache | 1 + ...lows-provider-rest-docs-producer.png.cache | 1 + ...getting-started-cdc-client-final.png.cache | 1 + .../getting-started-cdc-client.png.cache | 1 + .../getting-started-cdc-server.png.cache | 1 + .../getting-started-three-second.png.cache | 1 + .../diagram/how-to-common-repo.png.cache | 1 + .../.asciidoctor/diagram/rest-docs.png.cache | 1 + .../2.2.0.RC1/reference/html/README.html | 661 + .../2.2.0.RC1/reference/html/advanced.html | 1200 + .../2.2.0.RC1/reference/html/appendix.html | 428 + .../2.2.0.RC1/reference/html/css/spring.css | 1 + .../reference/html/docker-project.html | 585 + .../html/documentation-overview.html | 372 + .../2.2.0.RC1/reference/html/favicon.ico | Bin 0 -> 111804 bytes .../reference/html/getting-started.html | 2626 + .../reference/html/gradle-project.html | 914 + .../2.2.0.RC1/reference/html/howto.html | 2502 + .../2.2.0.RC1/reference/html/images/Deps.png | Bin 0 -> 37192 bytes .../reference/html/images/Stubs1.png | Bin 0 -> 35170 bytes .../reference/html/images/Stubs2.png | Bin 0 -> 18143 bytes ...verview-consumer-cdc-external-consumer.png | Bin 0 -> 31889 bytes ...verview-consumer-cdc-external-producer.png | Bin 0 -> 64940 bytes .../flows-provider-non-jvm-consumer.png | Bin 0 -> 29633 bytes .../flows-provider-non-jvm-producer.png | Bin 0 -> 37247 bytes .../flows-provider-rest-docs-producer.png | Bin 0 -> 31169 bytes .../getting-started-cdc-client-final.png | Bin 0 -> 24504 bytes .../images/getting-started-cdc-client.png | Bin 0 -> 60273 bytes .../images/getting-started-cdc-server.png | Bin 0 -> 32463 bytes .../images/getting-started-three-second.png | Bin 0 -> 34156 bytes .../html/images/how-to-common-repo.png | Bin 0 -> 85738 bytes .../reference/html/images/rest-docs.png | Bin 0 -> 44865 bytes .../images/start_spring_io_dependencies.png | Bin 0 -> 347308 bytes .../2.2.0.RC1/reference/html/index.html | 184 + .../html/js/highlight/highlight.min.js | 2 + .../js/highlight/styles/a11y-dark.min.css | 99 + .../js/highlight/styles/an-old-hope.min.css | 89 + .../styles/atom-one-dark-reasonable.min.css | 77 + .../js/highlight/styles/atom-one-dark.min.css | 96 + .../highlight/styles/atom-one-light.min.css | 96 + .../html/js/highlight/styles/dracula.min.css | 76 + .../html/js/highlight/styles/github.min.css | 99 + .../highlight/styles/monokai-sublime.min.css | 83 + .../html/js/highlight/styles/monokai.min.css | 70 + .../highlight/styles/solarized-light.min.css | 84 + .../html/js/highlight/styles/zenburn.min.css | 80 + .../2.2.0.RC1/reference/html/js/toc.js | 107 + .../reference/html/js/tocbot/tocbot.css | 1 + .../reference/html/js/tocbot/tocbot.min.js | 1 + .../2.2.0.RC1/reference/html/legal.html | 121 + .../reference/html/maven-project.html | 1053 + .../reference/html/project-features.html | 10778 + .../2.2.0.RC1/reference/html/sagan-boot.html | 241 + .../2.2.0.RC1/reference/html/sagan-index.html | 247 + .../2.2.0.RC1/reference/html/using.html | 1217 + .../2.2.0.RC1/reference/html/yml-schema.html | 573 + ...w-consumer-cdc-external-consumer.png.cache | 1 + ...w-consumer-cdc-external-producer.png.cache | 1 + .../flows-provider-non-jvm-consumer.png.cache | 1 + .../flows-provider-non-jvm-producer.png.cache | 1 + ...lows-provider-rest-docs-producer.png.cache | 1 + ...getting-started-cdc-client-final.png.cache | 1 + .../getting-started-cdc-client.png.cache | 1 + .../getting-started-cdc-server.png.cache | 1 + .../getting-started-three-second.png.cache | 1 + .../diagram/how-to-common-repo.png.cache | 1 + .../.asciidoctor/diagram/rest-docs.png.cache | 1 + .../reference/htmlsingle/css/spring.css | 1 + .../reference/htmlsingle/favicon.ico | Bin 0 -> 111804 bytes .../reference/htmlsingle/images/Deps.png | Bin 0 -> 37192 bytes .../reference/htmlsingle/images/Stubs1.png | Bin 0 -> 35170 bytes .../reference/htmlsingle/images/Stubs2.png | Bin 0 -> 18143 bytes ...verview-consumer-cdc-external-consumer.png | Bin 0 -> 31889 bytes ...verview-consumer-cdc-external-producer.png | Bin 0 -> 64940 bytes .../flows-provider-non-jvm-consumer.png | Bin 0 -> 29633 bytes .../flows-provider-non-jvm-producer.png | Bin 0 -> 37247 bytes .../flows-provider-rest-docs-producer.png | Bin 0 -> 31169 bytes .../getting-started-cdc-client-final.png | Bin 0 -> 24504 bytes .../images/getting-started-cdc-client.png | Bin 0 -> 60273 bytes .../images/getting-started-cdc-server.png | Bin 0 -> 32463 bytes .../images/getting-started-three-second.png | Bin 0 -> 34156 bytes .../htmlsingle/images/how-to-common-repo.png | Bin 0 -> 85738 bytes .../reference/htmlsingle/images/rest-docs.png | Bin 0 -> 44865 bytes .../images/start_spring_io_dependencies.png | Bin 0 -> 347308 bytes .../2.2.0.RC1/reference/htmlsingle/index.html | 17262 ++ .../htmlsingle/js/highlight/highlight.min.js | 2 + .../js/highlight/styles/a11y-dark.min.css | 99 + .../js/highlight/styles/an-old-hope.min.css | 89 + .../styles/atom-one-dark-reasonable.min.css | 77 + .../js/highlight/styles/atom-one-dark.min.css | 96 + .../highlight/styles/atom-one-light.min.css | 96 + .../js/highlight/styles/dracula.min.css | 76 + .../js/highlight/styles/github.min.css | 99 + .../highlight/styles/monokai-sublime.min.css | 83 + .../js/highlight/styles/monokai.min.css | 70 + .../highlight/styles/solarized-light.min.css | 84 + .../js/highlight/styles/zenburn.min.css | 80 + .../2.2.0.RC1/reference/htmlsingle/js/toc.js | 107 + .../reference/htmlsingle/js/tocbot/tocbot.css | 1 + .../htmlsingle/js/tocbot/tocbot.min.js | 1 + ...w-consumer-cdc-external-consumer.png.cache | 1 + ...w-consumer-cdc-external-producer.png.cache | 1 + .../flows-provider-non-jvm-consumer.png.cache | 1 + .../flows-provider-non-jvm-producer.png.cache | 1 + ...lows-provider-rest-docs-producer.png.cache | 1 + ...getting-started-cdc-client-final.png.cache | 1 + .../getting-started-cdc-client.png.cache | 1 + .../getting-started-cdc-server.png.cache | 1 + .../getting-started-three-second.png.cache | 1 + .../diagram/how-to-common-repo.png.cache | 1 + .../.asciidoctor/diagram/rest-docs.png.cache | 1 + ...verview-consumer-cdc-external-consumer.png | Bin 0 -> 31889 bytes ...verview-consumer-cdc-external-producer.png | Bin 0 -> 64940 bytes .../flows-provider-non-jvm-consumer.png | Bin 0 -> 29633 bytes .../flows-provider-non-jvm-producer.png | Bin 0 -> 37247 bytes .../flows-provider-rest-docs-producer.png | Bin 0 -> 31169 bytes .../getting-started-cdc-client-final.png | Bin 0 -> 24504 bytes .../pdf/images/getting-started-cdc-client.png | Bin 0 -> 60273 bytes .../pdf/images/getting-started-cdc-server.png | Bin 0 -> 32463 bytes .../images/getting-started-three-second.png | Bin 0 -> 34156 bytes .../pdf/images/how-to-common-repo.png | Bin 0 -> 85738 bytes .../reference/pdf/images/rest-docs.png | Bin 0 -> 44865 bytes .../reference/pdf/spring-cloud-contract.pdf | 205581 +++++++++++++++ .../apidocs/allclasses-frame.html | 29 + .../apidocs/allclasses-noframe.html | 29 + .../apidocs/constant-values.html | 126 + .../apidocs/deprecated-list.html | 126 + .../apidocs/help-doc.html | 231 + .../apidocs/index-all.html | 319 + .../apidocs/index.html | 76 + .../maven/verifier/BaseClassMapping.html | 371 + .../contract/maven/verifier/ConvertMojo.html | 320 + .../maven/verifier/GenerateStubsMojo.html | 320 + .../maven/verifier/GenerateTestsMojo.html | 411 + .../contract/maven/verifier/HelpMojo.html | 318 + .../maven/verifier/PushStubsToScmMojo.html | 310 + .../contract/maven/verifier/RunMojo.html | 322 + .../verifier/class-use/BaseClassMapping.html | 126 + .../maven/verifier/class-use/ConvertMojo.html | 126 + .../verifier/class-use/GenerateStubsMojo.html | 126 + .../verifier/class-use/GenerateTestsMojo.html | 126 + .../maven/verifier/class-use/HelpMojo.html | 126 + .../class-use/PushStubsToScmMojo.html | 126 + .../maven/verifier/class-use/RunMojo.html | 126 + .../maven/verifier/package-frame.html | 27 + .../maven/verifier/package-summary.html | 185 + .../contract/maven/verifier/package-tree.html | 149 + .../contract/maven/verifier/package-use.html | 126 + .../AetherStubDownloaderFactory.html | 283 + .../verifier/stubrunner/LocalStubRunner.html | 281 + .../verifier/stubrunner/RemoteStubRunner.html | 282 + .../AetherStubDownloaderFactory.html | 164 + .../stubrunner/class-use/LocalStubRunner.html | 165 + .../class-use/RemoteStubRunner.html | 165 + .../verifier/stubrunner/package-frame.html | 23 + .../verifier/stubrunner/package-summary.html | 158 + .../verifier/stubrunner/package-tree.html | 141 + .../verifier/stubrunner/package-use.html | 187 + .../apidocs/overview-frame.html | 23 + .../apidocs/overview-summary.html | 144 + .../apidocs/overview-tree.html | 153 + .../apidocs/package-list | 2 + .../apidocs/script.js | 30 + .../apidocs/stylesheet.css | 574 + .../checkstyle.html | 3832 + .../checkstyle.rss | 222 + .../ci-management.html | 351 + .../complex.html | 471 + .../configs.html | 366 + .../convert-mojo.html | 827 + .../css/apache-maven-fluido-1.5.min.css | 9 + .../css/print.css | 23 + .../css/site.css | 1 + .../fonts/glyphicons-halflings-regular.eot | Bin 0 -> 35691 bytes .../fonts/glyphicons-halflings-regular.svg | 229 + .../fonts/glyphicons-halflings-regular.ttf | Bin 0 -> 55383 bytes .../fonts/glyphicons-halflings-regular.woff | Bin 0 -> 42340 bytes .../generateStubs-mojo.html | 472 + .../generateTests-mojo.html | 1158 + .../help-mojo.html | 423 + .../images/accessories-text-editor.png | Bin 0 -> 746 bytes .../images/add.gif | Bin 0 -> 397 bytes .../images/apache-maven-project-2.png | Bin 0 -> 43073 bytes .../images/application-certificate.png | Bin 0 -> 923 bytes .../images/contact-new.png | Bin 0 -> 736 bytes .../images/document-properties.png | Bin 0 -> 577 bytes .../images/drive-harddisk.png | Bin 0 -> 700 bytes .../images/fix.gif | Bin 0 -> 366 bytes .../images/icon_error_sml.gif | Bin 0 -> 633 bytes .../images/icon_help_sml.gif | Bin 0 -> 1072 bytes .../images/icon_info_sml.gif | Bin 0 -> 638 bytes .../images/icon_success_sml.gif | Bin 0 -> 604 bytes .../images/icon_warning_sml.gif | Bin 0 -> 625 bytes .../images/image-x-generic.png | Bin 0 -> 662 bytes .../images/internet-web-browser.png | Bin 0 -> 1017 bytes .../images/logos/build-by-maven-black.png | Bin 0 -> 2294 bytes .../images/logos/build-by-maven-white.png | Bin 0 -> 2260 bytes .../images/logos/maven-feather.png | Bin 0 -> 3330 bytes .../images/network-server.png | Bin 0 -> 536 bytes .../images/package-x-generic.png | Bin 0 -> 717 bytes .../images/profiles/pre-release.png | Bin 0 -> 32607 bytes .../images/profiles/retired.png | Bin 0 -> 22003 bytes .../images/profiles/sandbox.png | Bin 0 -> 33010 bytes .../images/remove.gif | Bin 0 -> 607 bytes .../images/rss.png | Bin 0 -> 474 bytes .../images/update.gif | Bin 0 -> 1090 bytes .../images/window-new.png | Bin 0 -> 583 bytes .../img/glyphicons-halflings-white.png | Bin 0 -> 8777 bytes .../img/glyphicons-halflings.png | Bin 0 -> 12799 bytes .../index.html | 394 + .../issue-management.html | 349 + .../js/apache-maven-fluido-1.5.min.js | 25 + .../junit.html | 355 + .../licenses.html | 971 + .../plugin-info.html | 378 + .../plugin-management.html | 434 + .../plugins.html | 444 + .../project-info.html | 378 + .../project-reports.html | 318 + .../pushStubsToScm-mojo.html | 551 + .../run-mojo.html | 571 + .../scm.html | 357 + .../sitemap.html | 344 + .../spock.html | 400 + .../summary.html | 391 + .../team.html | 377 + .../usage.html | 362 + 230 files changed, 271935 insertions(+) create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/rest-docs.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/README.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/advanced.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/appendix.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/css/spring.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/docker-project.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/documentation-overview.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/favicon.ico create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/getting-started.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/gradle-project.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/howto.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/Deps.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/Stubs1.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/Stubs2.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/flow-overview-consumer-cdc-external-consumer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/flow-overview-consumer-cdc-external-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/flows-provider-non-jvm-consumer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/flows-provider-non-jvm-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/flows-provider-rest-docs-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/getting-started-cdc-client-final.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/getting-started-cdc-client.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/getting-started-cdc-server.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/getting-started-three-second.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/how-to-common-repo.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/rest-docs.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/images/start_spring_io_dependencies.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/index.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/highlight.min.js create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/a11y-dark.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/an-old-hope.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/atom-one-dark-reasonable.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/atom-one-dark.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/atom-one-light.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/dracula.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/github.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/monokai-sublime.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/monokai.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/solarized-light.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/highlight/styles/zenburn.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/toc.js create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/tocbot/tocbot.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/js/tocbot/tocbot.min.js create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/legal.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/maven-project.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/project-features.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/sagan-boot.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/sagan-index.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/using.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/html/yml-schema.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-server.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/getting-started-three-second.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/how-to-common-repo.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/.asciidoctor/diagram/rest-docs.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/css/spring.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/favicon.ico create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/Deps.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/Stubs1.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/Stubs2.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/flow-overview-consumer-cdc-external-consumer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/flow-overview-consumer-cdc-external-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/flows-provider-non-jvm-consumer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/flows-provider-non-jvm-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/flows-provider-rest-docs-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/getting-started-cdc-client-final.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/getting-started-cdc-client.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/getting-started-cdc-server.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/getting-started-three-second.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/how-to-common-repo.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/rest-docs.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/images/start_spring_io_dependencies.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/index.html create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/highlight.min.js create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/a11y-dark.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/an-old-hope.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/atom-one-dark-reasonable.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/atom-one-dark.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/atom-one-light.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/dracula.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/github.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/monokai-sublime.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/monokai.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/solarized-light.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/highlight/styles/zenburn.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/toc.js create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/tocbot/tocbot.css create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/htmlsingle/js/tocbot/tocbot.min.js create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/getting-started-cdc-server.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/getting-started-three-second.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/how-to-common-repo.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/.asciidoctor/diagram/rest-docs.png.cache create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/flow-overview-consumer-cdc-external-consumer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/flow-overview-consumer-cdc-external-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/flows-provider-non-jvm-consumer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/flows-provider-non-jvm-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/flows-provider-rest-docs-producer.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/getting-started-cdc-client-final.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/getting-started-cdc-client.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/getting-started-cdc-server.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/getting-started-three-second.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/how-to-common-repo.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/images/rest-docs.png create mode 100644 spring-cloud-contract/2.2.0.RC1/reference/pdf/spring-cloud-contract.pdf create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/allclasses-frame.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/allclasses-noframe.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/constant-values.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/deprecated-list.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/help-doc.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/index-all.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/index.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/BaseClassMapping.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/ConvertMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/HelpMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/RunMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/BaseClassMapping.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/ConvertMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateStubsMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateTestsMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/HelpMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/PushStubsToScmMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/RunMojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-frame.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-summary.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-tree.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-use.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/AetherStubDownloaderFactory.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/LocalStubRunner.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/RemoteStubRunner.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-frame.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-summary.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-tree.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-use.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/overview-frame.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/overview-summary.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/overview-tree.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/package-list create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/script.js create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/apidocs/stylesheet.css create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/checkstyle.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/checkstyle.rss create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/ci-management.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/complex.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/configs.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/convert-mojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/css/apache-maven-fluido-1.5.min.css create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/css/print.css create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/css/site.css create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/fonts/glyphicons-halflings-regular.eot create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/fonts/glyphicons-halflings-regular.svg create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/fonts/glyphicons-halflings-regular.ttf create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/fonts/glyphicons-halflings-regular.woff create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/generateStubs-mojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/generateTests-mojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/help-mojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/accessories-text-editor.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/add.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/apache-maven-project-2.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/application-certificate.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/contact-new.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/document-properties.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/drive-harddisk.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/fix.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/icon_error_sml.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/icon_help_sml.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/icon_info_sml.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/icon_success_sml.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/icon_warning_sml.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/image-x-generic.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/internet-web-browser.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/logos/build-by-maven-black.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/logos/build-by-maven-white.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/logos/maven-feather.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/network-server.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/package-x-generic.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/profiles/pre-release.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/profiles/retired.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/profiles/sandbox.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/remove.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/rss.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/update.gif create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/images/window-new.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/img/glyphicons-halflings-white.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/img/glyphicons-halflings.png create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/index.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/issue-management.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/js/apache-maven-fluido-1.5.min.js create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/junit.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/licenses.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/plugin-info.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/plugin-management.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/plugins.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/project-info.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/project-reports.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/pushStubsToScm-mojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/run-mojo.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/scm.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/sitemap.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/spock.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/summary.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/team.html create mode 100644 spring-cloud-contract/2.2.0.RC1/spring-cloud-contract-maven-plugin/usage.html diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache new file mode 100644 index 00000000..ca898896 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache @@ -0,0 +1 @@ +{"checksum":"23a7e5a52b04e1a55f2d102255d7ea04","width":886,"height":676} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache new file mode 100644 index 00000000..a17e22fc --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache @@ -0,0 +1 @@ +{"checksum":"c9ffba1bc9383435e35a7973e5641dd8","width":1213,"height":1341} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache new file mode 100644 index 00000000..2f99cba6 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache @@ -0,0 +1 @@ +{"checksum":"30b3d3322b3ecb24a6c5346a8571ba98","width":815,"height":618} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache new file mode 100644 index 00000000..5a3310d3 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache @@ -0,0 +1 @@ +{"checksum":"37241bc45c73dbad7383a4733a05d559","width":930,"height":810} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache new file mode 100644 index 00000000..2d6b2f9d --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache @@ -0,0 +1 @@ +{"checksum":"b137ec966db7960885422f991695d28f","width":783,"height":677} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache new file mode 100644 index 00000000..eac3cd74 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache @@ -0,0 +1 @@ +{"checksum":"a46f733654d99c8861184f0e4e04bb95","width":590,"height":685} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache new file mode 100644 index 00000000..89ce0d96 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache @@ -0,0 +1 @@ +{"checksum":"b1418561d3b01d5d71885b4b7bb1be93","width":1138,"height":1223} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache new file mode 100644 index 00000000..0b7b2d78 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache @@ -0,0 +1 @@ +{"checksum":"7a8cb19e9d604071d61e4aa9201ee623","width":688,"height":903} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache new file mode 100644 index 00000000..3e5f4a8f --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache @@ -0,0 +1 @@ +{"checksum":"27396daead141eee677aa6311403d175","width":986,"height":704} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache new file mode 100644 index 00000000..c23499f9 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache @@ -0,0 +1 @@ +{"checksum":"89bbfd25e4c214245543ed34208e2afa","width":1588,"height":1421} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/rest-docs.png.cache b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/rest-docs.png.cache new file mode 100644 index 00000000..74da30c0 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/.asciidoctor/diagram/rest-docs.png.cache @@ -0,0 +1 @@ +{"checksum":"e3500a52c420af0a5337450779a25536","width":1237,"height":835} \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/README.html b/spring-cloud-contract/2.2.0.RC1/reference/html/README.html new file mode 100644 index 00000000..1bae4c5d --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/README.html @@ -0,0 +1,661 @@ + + + + + + + +Spring Cloud Contract + + + + + + + + + + +
+
+

Spring Cloud Contract

+
+
+

You always need confidence when pushing new features into a new application or service in +a distributed system. To that end, this project provides support for consumer-driven +contracts and service schemas in Spring applications, covering a range of options for +writing tests, publishing them as assets, and asserting that a contract is kept by +producers and consumers — for both HTTP and message-based interactions.

+
+
+

Spring Cloud Contract workshops

+
+

If you prefer to learn about the project by doing some tutorials, you can check out the +workshops under +this link.

+
+
+
+
+
+

Project page

+
+
+

You can read more about Spring Cloud Contract by going to the project page

+
+
+
+
+

Contributing

+
+
+

Spring Cloud is released under the non-restrictive Apache 2.0 license, +and follows a very standard Github development process, using Github +tracker for issues and merging pull requests into master. If you want +to contribute even something trivial please do not hesitate, but +follow the guidelines below.

+
+
+

Sign the Contributor License Agreement

+
+

Before we accept a non-trivial patch or pull request we will need you to sign the +Contributor License Agreement. +Signing the contributor’s agreement does not grant anyone commit rights to the main +repository, but it does mean that we can accept your contributions, and you will get an +author credit if we do. Active contributors might be asked to join the core team, and +given the ability to merge pull requests.

+
+
+
+

Code of Conduct

+
+

This project adheres to the Contributor Covenant code of +conduct. By participating, you are expected to uphold this code. Please report +unacceptable behavior to spring-code-of-conduct@pivotal.io.

+
+
+
+

Code Conventions and Housekeeping

+
+

None of these is essential for a pull request, but they will all help. They can also be +added after the original pull request but before a merge.

+
+
+
    +
  • +

    Use the Spring Framework code format conventions. If you use Eclipse +you can import formatter settings using the +eclipse-code-formatter.xml file from the +Spring +Cloud Build project. If using IntelliJ, you can use the +Eclipse Code Formatter +Plugin to import the same file.

    +
    • +
  • +

    Make sure all new .java files to have a simple Javadoc class comment with at least an +@author tag identifying you, and preferably at least a paragraph on what the class is +for.

    +
    • +
  • +

    Add the ASF license header comment to all new .java files (copy from existing files +in the project)

    +
    • +
  • +

    Add yourself as an @author to the .java files that you modify substantially (more +than cosmetic changes).

    +
    • +
  • +

    Add some Javadocs and, if you change the namespace, some XSD doc elements.

    +
    • +
  • +

    A few unit tests would help a lot as well — someone has to do it.

    +
    • +
  • +

    If no-one else is using your branch, please rebase it against the current master (or +other target branch in the main project).

    +
    • +
  • +

    When writing a commit message please follow these conventions, +if you are fixing an existing issue please add Fixes gh-XXXX at the end of the commit +message (where XXXX is the issue number).

    +
    • +
+
+
+
+

Checkstyle

+
+

Spring Cloud Build comes with a set of checkstyle rules. You can find them in the spring-cloud-build-tools module. The most notable files under the module are:

+
+
+
spring-cloud-build-tools/
+
+
└── src
+    ├── checkstyle
+    │   └── checkstyle-suppressions.xml (3)
+    └── main
+        └── resources
+            ├── checkstyle-header.txt (2)
+            └── checkstyle.xml (1)
+
+
+
+ + + + + + + + + + + + + +
1Default Checkstyle rules
2File header setup
3Default suppression rules
+
+
+

Checkstyle configuration

+
+

Checkstyle rules are disabled by default. To add checkstyle to your project just define the following properties and plugins.

+
+
+
pom.xml
+
+
<properties>
+<maven-checkstyle-plugin.failsOnError>true</maven-checkstyle-plugin.failsOnError> (1)
+        <maven-checkstyle-plugin.failsOnViolation>true
+        </maven-checkstyle-plugin.failsOnViolation> (2)
+        <maven-checkstyle-plugin.includeTestSourceDirectory>true
+        </maven-checkstyle-plugin.includeTestSourceDirectory> (3)
+</properties>
+
+<build>
+        <plugins>
+            <plugin> (4)
+                <groupId>io.spring.javaformat</groupId>
+                <artifactId>spring-javaformat-maven-plugin</artifactId>
+            </plugin>
+            <plugin> (5)
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-checkstyle-plugin</artifactId>
+            </plugin>
+        </plugins>
+
+    <reporting>
+        <plugins>
+            <plugin> (5)
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-checkstyle-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </reporting>
+</build>
+
+
+
+ + + + + + + + + + + + + + + + + + + + + +
1Fails the build upon Checkstyle errors
2Fails the build upon Checkstyle violations
3Checkstyle analyzes also the test sources
4Add the Spring Java Format plugin that will reformat your code to pass most of the Checkstyle formatting rules
5Add checkstyle plugin to your build and reporting phases
+
+
+

If you need to suppress some rules (e.g. line length needs to be longer), then it’s enough for you to define a file under ${project.root}/src/checkstyle/checkstyle-suppressions.xml with your suppressions. Example:

+
+
+
projectRoot/src/checkstyle/checkstyle-suppresions.xml
+
+
<?xml version="1.0"?>
+<!DOCTYPE suppressions PUBLIC
+		"-//Puppy Crawl//DTD Suppressions 1.1//EN"
+		"https://www.puppycrawl.com/dtds/suppressions_1_1.dtd">
+<suppressions>
+	<suppress files=".*ConfigServerApplication\.java" checks="HideUtilityClassConstructor"/>
+	<suppress files=".*ConfigClientWatch\.java" checks="LineLengthCheck"/>
+</suppressions>
+
+
+
+

It’s advisable to copy the ${spring-cloud-build.rootFolder}/.editorconfig and ${spring-cloud-build.rootFolder}/.springformat to your project. That way, some default formatting rules will be applied. You can do so by running this script:

+
+
+
+
$ curl https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/.editorconfig -o .editorconfig
+$ touch .springformat
+
+
+
+
+
+

IDE setup

+
+

Intellij IDEA

+
+

In order to setup Intellij you should import our coding conventions, inspection profiles and set up the checkstyle plugin. +The following files can be found in the Spring Cloud Build project.

+
+
+
spring-cloud-build-tools/
+
+
└── src
+    ├── checkstyle
+    │   └── checkstyle-suppressions.xml (3)
+    └── main
+        └── resources
+            ├── checkstyle-header.txt (2)
+            ├── checkstyle.xml (1)
+            └── intellij
+                ├── Intellij_Project_Defaults.xml (4)
+                └── Intellij_Spring_Boot_Java_Conventions.xml (5)
+
+
+
+ + + + + + + + + + + + + + + + + + + + + +
1Default Checkstyle rules
2File header setup
3Default suppression rules
4Project defaults for Intellij that apply most of Checkstyle rules
5Project style conventions for Intellij that apply most of Checkstyle rules
+
+
+
+Code style +
+
Figure 1. Code style
+
+
+

Go to File → Settings → Editor → Code style. There click on the icon next to the Scheme section. There, click on the Import Scheme value and pick the Intellij IDEA code style XML option. Import the spring-cloud-build-tools/src/main/resources/intellij/Intellij_Spring_Boot_Java_Conventions.xml file.

+
+
+
+Code style +
+
Figure 2. Inspection profiles
+
+
+

Go to File → Settings → Editor → Inspections. There click on the icon next to the Profile section. There, click on the Import Profile and import the spring-cloud-build-tools/src/main/resources/intellij/Intellij_Project_Defaults.xml file.

+
+
+
Checkstyle
+

To have Intellij work with Checkstyle, you have to install the Checkstyle plugin. It’s advisable to also install the Assertions2Assertj to automatically convert the JUnit assertions

+
+
+
+Checkstyle +
+
+
+

Go to File → Settings → Other settings → Checkstyle. There click on the + icon in the Configuration file section. There, you’ll have to define where the checkstyle rules should be picked from. In the image above, we’ve picked the rules from the cloned Spring Cloud Build repository. However, you can point to the Spring Cloud Build’s GitHub repository (e.g. for the checkstyle.xml : https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/spring-cloud-build-tools/src/main/resources/checkstyle.xml). We need to provide the following variables:

+
+
+ +
+
+ + + + + +
+ + +Remember to set the Scan Scope to All sources since we apply checkstyle rules for production and test sources. +
+
+
+
+
+
+
+

How to Build Spring Cloud Contract

+
+
+ + + + + +
+ + +You need to have all the necessary Groovy plugins +installed for your IDE to properly resolve the sources. For example, in +Intellij IDEA, having both the Eclipse Groovy Compiler Plugin and the GMavenPlus Intellij +Plugin results in properly imported project. +
+
+
+ + + + + +
+ + +Spring Cloud Contract builds Docker images. Remember to +have Docker installed. +
+
+
+ + + + + +
+ + +If you want to run the build in offline mode, you must have Maven 3.5.2+ installed. +
+
+
+

Project structure

+
+

The following listing shows the Spring Cloud Contract folder structure:

+
+
+
+
├── config
+├── docker
+├── samples
+├── scripts
+├── specs
+├── spring-cloud-contract-dependencies
+├── spring-cloud-contract-shade
+├── spring-cloud-contract-starters
+├── spring-cloud-contract-stub-runner
+├── spring-cloud-contract-stub-runner-boot
+├── spring-cloud-contract-tools
+├── spring-cloud-contract-verifier
+├── spring-cloud-contract-wiremock
+└── tests
+
+
+
+

The following list describes each of the top-level folders in the project structure:

+
+
+
    +
  • +

    config: Folder contains setup for Spring Cloud Release Tools automated release process

    +
    • +
  • +

    docker: Folder contains docker images

    +
    • +
  • +

    samples: Folder contains test samples together with standalone ones used also to build documentation

    +
    • +
  • +

    scripts: Contains scripts to build and test Spring Cloud Contract with Maven, Gradle and standalone projects

    +
    • +
  • +

    specs: Contains specifications for the Contract DSL.

    +
    • +
  • +

    spring-cloud-contract-dependencies: Contains Spring Cloud Contract BOM

    +
    • +
  • +

    spring-cloud-contract-shade: Shaded dependencies used by the plugins

    +
    • +
  • +

    spring-cloud-contract-starters: Contains Spring Cloud Contract Starters

    +
    • +
  • +

    spring-cloud-contract-spec: Contains specification modules (contains concept of a Contract)

    +
    • +
  • +

    spring-cloud-contract-stub-runner: Contains Stub Runner related modules

    +
    • +
  • +

    spring-cloud-contract-stub-runner-boot: Contains Stub Runner Boot app

    +
    • +
  • +

    spring-cloud-contract-tools: Gradle and Maven plugin for Spring Cloud Contract Verifier

    +
    • +
  • +

    spring-cloud-contract-verifier: Core of the Spring Cloud Contract Verifier functionality

    +
    • +
  • +

    spring-cloud-contract-wiremock: All WireMock related functionality

    +
    • +
  • +

    tests: Integration tests for different messaging technologies

    +
    • +
+
+
+
+

Commands

+
+

To build the core functionality together with the Maven Plugin, you can run the following +command:

+
+
+
+
./mvnw clean install -P integration
+
+
+
+

Calling that function builds the core, the Maven plugin, and the Gradle plugin and runs +end-to_end tests on the +standalone samples in the proper order (both for Maven and Gradle).

+
+
+

To build only the Gradle Plugin, you can run the following commands:

+
+
+
+
cd spring-cloud-contract-tools/spring-cloud-contract-gradle-plugin
+./gradlew clean build
+
+
+
+
+

Helpful scripts

+
+

We provide a couple of helpful scripts to build the project.

+
+
+

To build the project in parallel (by default, it uses four cores, but you can change it), +run the following command:

+
+
+
+
./scripts/parallelBuild.sh
+
+
+
+

To use eight 8 cores, run thke following command:

+
+
+
+
CORES=8 ./scripts/parallelBuild.sh
+
+
+
+

To build the project without any integration tests (by default, this uses one core), run +the following command:

+
+
+
+
./scripts/noIntegration.sh
+
+
+
+

To use eight cores, run the following command:

+
+
+
+
CORES=8 ./scripts/noIntegration.sh
+
+
+
+

To generate the documentation (for both the root project and the maven plugin), run the +following command:

+
+
+
+
./scripts/generateDocs.sh
+
+
+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/advanced.html b/spring-cloud-contract/2.2.0.RC1/reference/html/advanced.html new file mode 100644 index 00000000..f824990e --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/advanced.html @@ -0,0 +1,1200 @@ + + + + + + + +Spring Cloud Contract customization + + + + + + + + + + +
+
+
+
+

In this section, we describe how to customize various parts of Spring Cloud Contract.

+
+
+
+
+

1. DSL Customization

+
+
+ + + + + +
+ + +This section is valid only for the Groovy DSL +
+
+
+

You can customize the Spring Cloud Contract Verifier by extending the DSL, as shown in +the remainder of this section.

+
+
+

1.1. Extending the DSL

+
+

You can provide your own functions to the DSL. The key requirement for this feature is to +maintain the static compatibility. Later in this document, you can see examples of:

+
+
+
    +
  • +

    Creating a JAR with reusable classes.

    +
    • +
  • +

    Referencing of these classes in the DSLs.

    +
    • +
+
+
+

You can find the full example +here.

+
+
+
+

1.2. Common JAR

+
+

The following examples show three classes that can be reused in the DSLs.

+
+
+

PatternUtils contains functions used by both the consumer and the producer. +The following listing shows the PatternUtils class:

+
+
+
+
+
+
package com.example;
+
+import java.util.regex.Pattern;
+
+/**
+ * If you want to use {@link Pattern} directly in your tests
+ * then you can create a class resembling this one. It can
+ * contain all the {@link Pattern} you want to use in the DSL.
+ *
+ * <pre>
+ * {@code
+ * request {
+ *     body(
+ *         [ age: $(c(PatternUtils.oldEnough()))]
+ *     )
+ * }
+ * </pre>
+ *
+ * Notice that we're using both {@code $()} for dynamic values
+ * and {@code c()} for the consumer side.
+ *
+ * @author Marcin Grzejszczak
+ */
+//tag::impl[]
+public class PatternUtils {
+
+    public static String tooYoung() {
+        //remove::start[]
+        return "[0-1][0-9]";
+        //remove::end[return]
+    }
+
+    public static Pattern oldEnough() {
+        //remove::start[]
+        return Pattern.compile("[2-9][0-9]");
+        //remove::end[return]
+    }
+
+    /**
+     * Makes little sense but it's just an example ;)
+     */
+    public static Pattern ok() {
+        //remove::start[]
+        return Pattern.compile("OK");
+        //remove::end[return]
+    }
+}
+//end::impl[]
+
+
+
+
+
+

ConsumerUtils contains functions used by the consumer. +The following listing shows the ConsumerUtils class:

+
+
+
+
+
+
package com.example;
+
+import org.springframework.cloud.contract.spec.internal.ClientDslProperty;
+
+/**
+ * DSL Properties passed to the DSL from the consumer's perspective.
+ * That means that on the input side {@code Request} for HTTP
+ * or {@code Input} for messaging you can have a regular expression.
+ * On the {@code Response} for HTTP or {@code Output} for messaging
+ * you have to have a concrete value.
+ *
+ * @author Marcin Grzejszczak
+ */
+//tag::impl[]
+public class ConsumerUtils {
+    /**
+     * Consumer side property. By using the {@link ClientDslProperty}
+     * you can omit most of boilerplate code from the perspective
+     * of dynamic values. Example
+     *
+     * <pre>
+     * {@code
+     * request {
+     *     body(
+     *         [ age: $(ConsumerUtils.oldEnough())]
+     *     )
+     * }
+     * </pre>
+     *
+     * That way it's in the implementation that we decide what value we will pass to the consumer
+     * and which one to the producer.
+     *
+     * @author Marcin Grzejszczak
+     */
+    public static ClientDslProperty oldEnough() {
+        //remove::start[]
+        // this example is not the best one and
+        // theoretically you could just pass the regex instead of `ServerDslProperty` but
+        // it's just to show some new tricks :)
+        return new ClientDslProperty(PatternUtils.oldEnough(), 40);
+        //remove::end[return]
+    }
+
+}
+//end::impl[]
+
+
+
+
+
+

ProducerUtils contains functions used by the producer. +The following listing shows the ProducerUtils class:

+
+
+
+
+
+
package com.example;
+
+import org.springframework.cloud.contract.spec.internal.ServerDslProperty;
+
+/**
+ * DSL Properties passed to the DSL from the producer's perspective.
+ * That means that on the input side {@code Request} for HTTP
+ * or {@code Input} for messaging you have to have a concrete value.
+ * On the {@code Response} for HTTP or {@code Output} for messaging
+ * you can have a regular expression.
+ *
+ * @author Marcin Grzejszczak
+ */
+//tag::impl[]
+public class ProducerUtils {
+
+    /**
+     * Producer side property. By using the {@link ProducerUtils}
+     * you can omit most of boilerplate code from the perspective
+     * of dynamic values. Example
+     *
+     * <pre>
+     * {@code
+     * response {
+     *     body(
+     *         [ status: $(ProducerUtils.ok())]
+     *     )
+     * }
+     * </pre>
+     *
+     * That way it's in the implementation that we decide what value we will pass to the consumer
+     * and which one to the producer.
+     */
+    public static ServerDslProperty ok() {
+        // this example is not the best one and
+        // theoretically you could just pass the regex instead of `ServerDslProperty` but
+        // it's just to show some new tricks :)
+        return new ServerDslProperty( PatternUtils.ok(), "OK");
+    }
+}
+//end::impl[]
+
+
+
+
+
+
+

1.3. Adding a Test Dependency in the Project’s Dependencies

+
+

To add a test dependency in the project’s dependencies, you must first add the common jar +dependency as a test dependency. Because your contracts files +are available on the test resources path, the common jar classes automatically become +visible in your Groovy files. The following examples show how to test the dependency:

+
+
+
+
+
Maven
+
+
<dependency>
+    <groupId>com.example</groupId>
+    <artifactId>beer-common</artifactId>
+    <version>${project.version}</version>
+    <scope>test</scope>
+</dependency>
+
+
+
+
Gradle
+
+
testCompile("com.example:beer-common:0.0.1.BUILD-SNAPSHOT")
+
+
+
+
+
+
+

1.4. Adding a Test Dependency in the Plugin’s Dependencies

+
+

Now, you must add the dependency for the plugin to reuse at runtime, as the +following example shows:

+
+
+
+
+
Maven
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${spring-cloud-contract.version}</version>
+    <extensions>true</extensions>
+    <configuration>
+        <packageWithBaseClasses>com.example</packageWithBaseClasses>
+        <baseClassMappings>
+            <baseClassMapping>
+                <contractPackageRegex>.*intoxication.*</contractPackageRegex>
+                <baseClassFQN>com.example.intoxication.BeerIntoxicationBase</baseClassFQN>
+            </baseClassMapping>
+        </baseClassMappings>
+    </configuration>
+    <dependencies>
+        <dependency>
+            <groupId>com.example</groupId>
+            <artifactId>beer-common</artifactId>
+            <version>${project.version}</version>
+            <scope>compile</scope>
+        </dependency>
+    </dependencies>
+</plugin>
+
+
+
+
Gradle
+
+
classpath "com.example:beer-common:0.0.1.BUILD-SNAPSHOT"
+
+
+
+
+
+
+

1.5. Referencing Classes in DSLs

+
+

You can now reference your classes in your DSL, as the following example shows:

+
+
+
+
+
+
package contracts.beer.rest
+
+import com.example.ConsumerUtils
+import com.example.ProducerUtils
+import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    description("""
+Represents a successful scenario of getting a beer
+
+```
+given:
+    client is old enough
+when:
+    he applies for a beer
+then:
+    we'll grant him the beer
+```
+
+""")
+    request {
+        method 'POST'
+        url '/check'
+        body(
+                age: $(ConsumerUtils.oldEnough())
+        )
+        headers {
+            contentType(applicationJson())
+        }
+    }
+    response {
+        status 200
+        body("""
+            {
+                "status": "${value(ProducerUtils.ok())}"
+            }
+            """)
+        headers {
+            contentType(applicationJson())
+        }
+    }
+}
+
+
+
+
+
+ + + + + +
+ + +You can set the Spring Cloud Contract plugin up by setting convertToYaml to +true. That way, you do NOT have to add the dependency with the extended functionality +to the consumer side, since the consumer side uses YAML contracts instead of Groovy contracts. +
+
+
+
+
+
+

2. WireMock Customization

+
+
+

In this section, we show how to customize the way you work with WireMock.

+
+
+

2.1. Registering Your Own WireMock Extension

+
+

WireMock lets you register custom extensions. By default, Spring Cloud Contract registers +the transformer, which lets you reference a request from a response. If you want to +provide your own extensions, you can register an implementation of the +org.springframework.cloud.contract.verifier.dsl.wiremock.WireMockExtensions interface. +Since we use the spring.factories extension approach, you can create an entry in +META-INF/spring.factories file similar to the following:

+
+
+
+
+
+
org.springframework.cloud.contract.verifier.dsl.wiremock.WireMockExtensions=\
+org.springframework.cloud.contract.stubrunner.provider.wiremock.TestWireMockExtensions
+org.springframework.cloud.contract.spec.ContractConverter=\
+org.springframework.cloud.contract.stubrunner.TestCustomYamlContractConverter
+
+
+
+
+
+

The following example shows a custom extension:

+
+
+
Example 1. TestWireMockExtensions.groovy
+
+
+
+
/*
+ * Copyright 2013-2019 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.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.cloud.contract.verifier.dsl.wiremock
+
+import com.github.tomakehurst.wiremock.extension.Extension
+
+/**
+ * Extension that registers the default transformer and the custom one
+ */
+class TestWireMockExtensions implements WireMockExtensions {
+    @Override
+    List<Extension> extensions() {
+        return [
+                new DefaultResponseTransformer(),
+                new CustomExtension()
+        ]
+    }
+}
+
+class CustomExtension implements Extension {
+
+    @Override
+    String getName() {
+        return "foo-transformer"
+    }
+}
+
+
+
+
+
+ + + + + +
+ + +Remember to override the applyGlobally() method and set it to false if you +want the transformation to be applied only for a mapping that explicitly requires it. +
+
+
+
+

2.2. Customization of WireMock Configuration

+
+

You can register a bean of type org.springframework.cloud.contract.wiremock.WireMockConfigurationCustomizer +to customize the WireMock configuration (for example, to add custom transformers). +The following example shows how to do so:

+
+
+
+
+
+
        @Bean
+        WireMockConfigurationCustomizer optionsCustomizer() {
+            return new WireMockConfigurationCustomizer() {
+                @Override
+                public void customize(WireMockConfiguration options) {
+// perform your customization here
+                }
+            };
+        }
+
+
+
+
+
+
+
+
+

3. Using the Pluggable Architecture

+
+
+

You may encounter cases where your contracts have been defined in other formats, +such as YAML, RAML, or PACT. In those cases, you still want to benefit from the automatic +generation of tests and stubs. You can add your own implementation for generating both +tests and stubs. Also, you can customize the way tests are generated (for example, you +can generate tests for other languages) and the way stubs are generated (for example, you +can generate stubs for other HTTP server implementations).

+
+
+

3.1. Custom Contract Converter

+
+

The ContractConverter interface lets you register your own implementation of a contract +structure converter. The following code listing shows the ContractConverter interface:

+
+
+
+
+
+
package org.springframework.cloud.contract.spec;
+
+import java.io.File;
+import java.util.Collection;
+
+/**
+ * Converter to be used to convert FROM {@link File} TO {@link Contract} and from
+ * {@link Contract} to {@code T}.
+ *
+ * @param <T> - type to which we want to convert the contract
+ * @author Marcin Grzejszczak
+ * @since 1.1.0
+ */
+public interface ContractConverter<T> extends ContractStorer<T> {
+
+    /**
+     * Should this file be accepted by the converter. Can use the file extension to check
+     * if the conversion is possible.
+     * @param file - file to be considered for conversion
+     * @return - {@code true} if the given implementation can convert the file
+     */
+    boolean isAccepted(File file);
+
+    /**
+     * Converts the given {@link File} to its {@link Contract} representation.
+     * @param file - file to convert
+     * @return - {@link Contract} representation of the file
+     */
+    Collection<Contract> convertFrom(File file);
+
+    /**
+     * Converts the given {@link Contract} to a {@link T} representation.
+     * @param contract - the parsed contract
+     * @return - {@link T} the type to which we do the conversion
+     */
+    T convertTo(Collection<Contract> contract);
+
+}
+
+
+
+
+
+

Your implementation must define the condition on which it should start the +conversion. Also, you must define how to perform that conversion in both directions.

+
+
+ + + + + +
+ + +Once you create your implementation, you must create a +/META-INF/spring.factories file in which you provide the fully qualified name of your +implementation. +
+
+
+

The following example shows a typical spring.factories file:

+
+
+
+
+
+
org.springframework.cloud.contract.spec.ContractConverter=\
+org.springframework.cloud.contract.verifier.converter.YamlContractConverter
+
+
+
+
+
+
+

3.2. Using the Custom Test Generator

+
+

If you want to generate tests for languages other than Java or you are not happy with the +way the verifier builds Java tests, you can register your own implementation.

+
+
+

The SingleTestGenerator interface lets you register your own implementation. The +following code listing shows the SingleTestGenerator interface:

+
+
+
+
+
+
package org.springframework.cloud.contract.verifier.builder;
+
+import java.nio.file.Path;
+import java.util.Collection;
+
+import org.springframework.cloud.contract.verifier.config.ContractVerifierConfigProperties;
+import org.springframework.cloud.contract.verifier.file.ContractMetadata;
+
+/**
+ * Builds a single test.
+ *
+ * @since 1.1.0
+ */
+public interface SingleTestGenerator {
+
+    /**
+     * Creates contents of a single test class in which all test scenarios from the
+     * contract metadata should be placed.
+     * @param properties - properties passed to the plugin
+     * @param listOfFiles - list of parsed contracts with additional metadata
+     * @param className - the name of the generated test class
+     * @param classPackage - the name of the package in which the test class should be
+     * stored
+     * @param includedDirectoryRelativePath - relative path to the included directory
+     * @return contents of a single test class
+     * @deprecated use{@link SingleTestGenerator#buildClass(ContractVerifierConfigProperties, Collection, String, GeneratedClassData)}
+     */
+    @Deprecated
+    String buildClass(ContractVerifierConfigProperties properties,
+            Collection<ContractMetadata> listOfFiles, String className,
+            String classPackage, String includedDirectoryRelativePath);
+
+    /**
+     * Creates contents of a single test class in which all test scenarios from the
+     * contract metadata should be placed.
+     * @param properties - properties passed to the plugin
+     * @param listOfFiles - list of parsed contracts with additional metadata
+     * @param generatedClassData - information about the generated class
+     * @param includedDirectoryRelativePath - relative path to the included directory
+     * @return contents of a single test class
+     */
+    default String buildClass(ContractVerifierConfigProperties properties,
+            Collection<ContractMetadata> listOfFiles,
+            String includedDirectoryRelativePath, GeneratedClassData generatedClassData) {
+        String className = generatedClassData.className;
+        String classPackage = generatedClassData.classPackage;
+        String path = includedDirectoryRelativePath;
+        return buildClass(properties, listOfFiles, className, classPackage, path);
+    }
+
+    /**
+     * Extension that should be appended to the generated test class. E.g. {@code .java}
+     * or {@code .php}
+     * @param properties - properties passed to the plugin
+     */
+    @Deprecated
+    String fileExtension(ContractVerifierConfigProperties properties);
+
+    class GeneratedClassData {
+
+        public final String className;
+
+        public final String classPackage;
+
+        public final Path testClassPath;
+
+        public GeneratedClassData(String className, String classPackage,
+                Path testClassPath) {
+            this.className = className;
+            this.classPackage = classPackage;
+            this.testClassPath = testClassPath;
+        }
+
+    }
+
+}
+
+
+
+
+
+

Again, you must provide a spring.factories file, such as the one shown in the following +example:

+
+
+
+
+
+
org.springframework.cloud.contract.verifier.builder.SingleTestGenerator=/
+com.example.MyGenerator
+
+
+
+
+
+
+

3.3. Using the Custom Stub Generator

+
+

If you want to generate stubs for stub servers other than WireMock, you can plug in your +own implementation of the StubGenerator interface. The following code listing shows the +StubGenerator interface:

+
+
+
+
+
+
package org.springframework.cloud.contract.verifier.converter;
+
+import java.util.Map;
+
+import org.springframework.cloud.contract.spec.Contract;
+import org.springframework.cloud.contract.verifier.file.ContractMetadata;
+
+/**
+ * Converts contracts into their stub representation.
+ *
+ * @since 1.1.0
+ */
+public interface StubGenerator {
+
+    /**
+     * @param fileName - file name
+     * @return {@code true} if the converter can handle the file to convert it into a
+     * stub.
+     */
+    default boolean canHandleFileName(String fileName) {
+        return fileName.endsWith(fileExtension());
+    }
+
+    /**
+     * @param rootName - root name of the contract
+     * @param content - metadata of the contract
+     * @return the collection of converted contracts into stubs. One contract can result
+     * in multiple stubs.
+     */
+    Map<Contract, String> convertContents(String rootName, ContractMetadata content);
+
+    /**
+     * @param inputFileName - name of the input file
+     * @return the name of the converted stub file. If you have multiple contracts in a
+     * single file then a prefix will be added to the generated file. If you provide the
+     * {@link Contract#name} field then that field will override the generated file name.
+     *
+     * Example: name of file with 2 contracts is {@code foo.groovy}, it will be converted
+     * by the implementation to {@code foo.json}. The recursive file converter will create
+     * two files {@code 0_foo.json} and {@code 1_foo.json}
+     */
+    String generateOutputFileNameForInput(String inputFileName);
+
+    /**
+     * Describes the file extension that this stub generator can handle.
+     * @return string describing the file extension
+     */
+    default String fileExtension() {
+        return ".json";
+    }
+
+}
+
+
+
+
+
+

Again, you must provide a spring.factories file, such as the one shown in the following +example:

+
+
+
+
+
+
# Stub converters
+org.springframework.cloud.contract.verifier.converter.StubGenerator=\
+org.springframework.cloud.contract.verifier.wiremock.DslToWireMockClientConverter
+
+
+
+
+
+

The default implementation is the WireMock stub generation.

+
+
+ + + + + +
+ + +You can provide multiple stub generator implementations. For example, from a single +DSL, you can produce both WireMock stubs and Pact files. +
+
+
+
+

3.4. Using the Custom Stub Runner

+
+

If you decide to use a custom stub generation, you also need a custom way of running +stubs with your different stub provider.

+
+
+

Assume that you use Moco to build your stubs and that +you have written a stub generator and placed your stubs in a JAR file.

+
+
+

In order for Stub Runner to know how to run your stubs, you have to define a custom +HTTP Stub server implementation, which might resemble the following example:

+
+
+
+
+
+
package org.springframework.cloud.contract.stubrunner.provider.moco
+
+import com.github.dreamhead.moco.bootstrap.arg.HttpArgs
+import com.github.dreamhead.moco.runner.JsonRunner
+import com.github.dreamhead.moco.runner.RunnerSetting
+import groovy.transform.CompileStatic
+import groovy.util.logging.Commons
+
+import org.springframework.cloud.contract.stubrunner.HttpServerStub
+import org.springframework.util.SocketUtils
+
+@Commons
+@CompileStatic
+class MocoHttpServerStub implements HttpServerStub {
+
+    private boolean started
+    private JsonRunner runner
+    private int port
+
+    @Override
+    int port() {
+        if (!isRunning()) {
+            return -1
+        }
+        return port
+    }
+
+    @Override
+    boolean isRunning() {
+        return started
+    }
+
+    @Override
+    HttpServerStub start() {
+        return start(SocketUtils.findAvailableTcpPort())
+    }
+
+    @Override
+    HttpServerStub start(int port) {
+        this.port = port
+        return this
+    }
+
+    @Override
+    HttpServerStub stop() {
+        if (!isRunning()) {
+            return this
+        }
+        this.runner.stop()
+        return this
+    }
+
+    @Override
+    HttpServerStub registerMappings(Collection<File> stubFiles) {
+        List<RunnerSetting> settings = stubFiles.findAll { it.name.endsWith("json") }
+            .collect {
+            log.info("Trying to parse [${it.name}]")
+            try {
+                return RunnerSetting.aRunnerSetting().addStream(it.newInputStream()).
+                    build()
+            }
+            catch (Exception e) {
+                log.warn("Exception occurred while trying to parse file [${it.name}]", e)
+                return null
+            }
+        }.findAll { it }
+        this.runner = JsonRunner.newJsonRunnerWithSetting(settings,
+            HttpArgs.httpArgs().withPort(this.port).build())
+        this.runner.run()
+        this.started = true
+        return this
+    }
+
+    @Override
+    String registeredMappings() {
+        return ""
+    }
+
+    @Override
+    boolean isAccepted(File file) {
+        return file.name.endsWith(".json")
+    }
+}
+
+
+
+
+
+

Then you can register it in your spring.factories file, as the following +example shows:

+
+
+
+
+
+
org.springframework.cloud.contract.stubrunner.HttpServerStub=\
+org.springframework.cloud.contract.stubrunner.provider.moco.MocoHttpServerStub
+
+
+
+
+
+

Now you can run stubs with Moco.

+
+
+ + + + + +
+ + +If you do not provide any implementation, the default (WireMock) +implementation is used. If you provide more than one, the first one on the list is used. +
+
+
+
+

3.5. Using the Custom Stub Downloader

+
+

You can customize the way your stubs are downloaded by creating an implementation of the +StubDownloaderBuilder interface, as the following example shows:

+
+
+
+
+
+
package com.example;
+
+class CustomStubDownloaderBuilder implements StubDownloaderBuilder {
+
+    @Override
+    public StubDownloader build(final StubRunnerOptions stubRunnerOptions) {
+        return new StubDownloader() {
+            @Override
+            public Map.Entry<StubConfiguration, File> downloadAndUnpackStubJar(
+                    StubConfiguration config) {
+                File unpackedStubs = retrieveStubs();
+                return new AbstractMap.SimpleEntry<>(
+                        new StubConfiguration(config.getGroupId(), config.getArtifactId(), version,
+                                config.getClassifier()), unpackedStubs);
+            }
+
+            File retrieveStubs() {
+                // here goes your custom logic to provide a folder where all the stubs reside
+            }
+}
+
+
+
+
+
+

Then you can register it in your spring.factories file, as the following +example shows:

+
+
+
+
+
+
# Example of a custom Stub Downloader Provider
+org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder=\
+com.example.CustomStubDownloaderBuilder
+
+
+
+
+
+

Now you can pick a folder with the source of your stubs.

+
+
+ + + + + +
+ + +If you do not provide any implementation, the default (scanning the classpath) is used. +If you provide the stubsMode = StubRunnerProperties.StubsMode.LOCAL or +stubsMode = StubRunnerProperties.StubsMode.REMOTE, the Aether implementation is used +If you provide more than one, the first one on the list is used. +
+
+
+
+

3.6. Using the SCM Stub Downloader

+
+

Whenever the repositoryRoot starts with a SCM protocol +(currently, we support only git://), the stub downloader tries +to clone the repository and use it as a source of contracts +to generate tests or stubs.

+
+
+

Through environment variables, system properties, or properties set +inside the plugin or the contracts repository configuration, you can +tweak the downloader’s behavior. The following table describes the available +properties:

+
+ + +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1. SCM Stub Downloader properties

Type of a property

Name of the property

Description

* git.branch (plugin prop)

+

* stubrunner.properties.git.branch (system prop)

+

* STUBRUNNER_PROPERTIES_GIT_BRANCH (env prop)

master

Which branch to checkout

* git.username (plugin prop)

+

* stubrunner.properties.git.username (system prop)

+

* STUBRUNNER_PROPERTIES_GIT_USERNAME (env prop)

Git clone username

* git.password (plugin prop)

+

* stubrunner.properties.git.password (system prop)

+

* STUBRUNNER_PROPERTIES_GIT_PASSWORD (env prop)

Git clone password

* git.no-of-attempts (plugin prop)

+

* stubrunner.properties.git.no-of-attempts (system prop)

+

* STUBRUNNER_PROPERTIES_GIT_NO_OF_ATTEMPTS (env prop)

10

Number of attempts to push the commits to origin

* git.wait-between-attempts (Plugin prop)

+

* stubrunner.properties.git.wait-between-attempts (system prop)

+

* STUBRUNNER_PROPERTIES_GIT_WAIT_BETWEEN_ATTEMPTS (env prop)

1000

Number of milliseconds to wait between attempts to push the commits to origin

+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/appendix.html b/spring-cloud-contract/2.2.0.RC1/reference/html/appendix.html new file mode 100644 index 00000000..b12fe8a6 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/appendix.html @@ -0,0 +1,428 @@ + + + + + + + +Common application properties + + + + + + + + + + +
+
+

Appendix A: Common application properties

+
+
+

Various properties can be specified inside your application.properties file, inside your application.yml file, or as command line switches. +This appendix provides a list of common Spring Cloud Contract properties and references to the underlying classes that consume them.

+
+
+ + + + + +
+ + +Property contributions can come from additional jar files on your classpath, so you should not consider this an exhaustive list. +Also, you can define your own properties. +
+
+
+

A.1. Default application properties

+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDefaultDescription

stubrunner.amqp.enabled

false

Whether to enable support for Stub Runner and AMQP.

stubrunner.amqp.mockCOnnection

true

Whether to enable support for Stub Runner and AMQP mocked connection factory.

stubrunner.classifier

stubs

The classifier to use by default in ivy co-ordinates for a stub.

stubrunner.cloud.consul.enabled

true

Whether to enable stubs registration in Consul.

stubrunner.cloud.delegate.enabled

true

Whether to enable DiscoveryClient’s Stub Runner implementation.

stubrunner.cloud.enabled

true

Whether to enable Spring Cloud support for Stub Runner.

stubrunner.cloud.eureka.enabled

true

Whether to enable stubs registration in Eureka.

stubrunner.cloud.ribbon.enabled

true

Whether to enable Stub Runner’s Ribbon integration.

stubrunner.cloud.stubbed.discovery.enabled

true

Whether Service Discovery should be stubbed for Stub Runner. If set to false, stubs will get registered in real service discovery.

stubrunner.cloud.zookeeper.enabled

true

Whether to enable stubs registration in Zookeeper.

stubrunner.consumer-name

You can override the default {@code spring.application.name} of this field by setting a value to this parameter.

stubrunner.delete-stubs-after-test

true

If set to {@code false} will NOT delete stubs from a temporary folder after running tests.

stubrunner.fail-on-no-stubs

true

When enabled, this flag will tell stub runner to throw an exception when no stubs / contracts were found.

stubrunner.generate-stubs

false

When enabled, this flag will tell stub runner to not load the generated stubs, but convert the found contracts at runtime to a stub format and run those stubs.

stubrunner.http-server-stub-configurer

Configuration for an HTTP server stub.

stubrunner.ids

[]

The ids of the stubs to run in "ivy" notation ([groupId]:artifactId:[version]:[classifier][:port]). {@code groupId}, {@code classifier}, {@code version} and {@code port} can be optional.

stubrunner.ids-to-service-ids

Mapping of Ivy notation based ids to serviceIds inside your application. Example "a:b" → "myService" "artifactId" → "myOtherService"

stubrunner.integration.enabled

true

Whether to enable Stub Runner integration with Spring Integration.

stubrunner.jms.enabled

true

Whether to enable Stub Runner integration with Spring JMS.

stubrunner.kafka.enabled

true

Whether to enable Stub Runner integration with Spring Kafka.

stubrunner.kafka.initializer.enabled

true

Whether to allow Stub Runner to take care of polling for messages instead of the KafkaStubMessages component. The latter should be used only on the producer side.

stubrunner.mappings-output-folder

Dumps the mappings of each HTTP server to the selected folder.

stubrunner.max-port

15000

Max value of a port for the automatically started WireMock server.

stubrunner.min-port

10000

Min value of a port for the automatically started WireMock server.

stubrunner.password

Repository password.

stubrunner.properties

Map of properties that can be passed to custom {@link org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder}.

stubrunner.proxy-host

Repository proxy host.

stubrunner.proxy-port

Repository proxy port.

stubrunner.stream.enabled

true

Whether to enable Stub Runner integration with Spring Cloud Stream.

stubrunner.stubs-mode

Pick where the stubs should come from.

stubrunner.stubs-per-consumer

false

Should only stubs for this particular consumer get registered in HTTP server stub.

stubrunner.username

Repository username.

wiremock.placeholders.enabled

true

Flag to indicate that http URLs in generated wiremock stubs should be filtered to add or resolve a placeholder for a dynamic port.

wiremock.rest-template-ssl-enabled

false

wiremock.server.files

[]

wiremock.server.https-port

-1

wiremock.server.https-port-dynamic

false

wiremock.server.port

8080

wiremock.server.port-dynamic

false

wiremock.server.stubs

[]

+
+
+

A.2. Additional application properties

+
+ + + + + +
+ + +The following properties can be passed as a system property (e.g. stubrunner.properties.git.branch) or via an environment variable (e.g. STUBRUNNER_PROPERTIES_GIT_BRANCH) or as a property inside stub runner’s annotation or a JUnit Rule / Extension. In the latter case you can pass git.branch property name instead of the stubrunner.properties.git.branch one. +
+
+ + +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1. Stubrunner Properties Options
NameDefaultDescription

stubrunner.properties.pactbroker.provider-name-with-group-id

false

When using the Pact Broker based approach, you can automatically group id to the provider name.

stubrunner.properties.git.branch

When using the SCM based approach, you can customize the branch name to check out.

stubrunner.properties.git.commit-message

Updating project [$project] with stubs

When using the SCM based approach, you can customize the commit message for created stubs. The $project text will be replaced with the project name.

stubrunner.properties.git.no-of-attempts

10

When using the SCM based approach, you can customize number of retries to push the stubs to Git.

stubrunner.properties.git.username

When using the SCM based approach, you can pass the username to connect to the Git repository.

stubrunner.properties.git.password

When using the SCM based approach, you can pass the password to connect to the Git repository.

stubrunner.properties.git.wait-between-attempts

1000

When using the SCM based approach, you can customize waiting time in ms between trying to push the stubs to Git.

stubrunner.properties.stubs.find-producer

false

When using the Stubs protocol, you can toggle this flag to search for contracts via the group id / artifact id instead of taking the stubs directly from the provided folder.

+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/css/spring.css b/spring-cloud-contract/2.2.0.RC1/reference/html/css/spring.css new file mode 100644 index 00000000..40821db3 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/css/spring.css @@ -0,0 +1 @@ +@import url("https://fonts.googleapis.com/css?family=Karla:400,700|Montserrat:400,700");/*! normalize.css v2.1.2 | MIT License | git.io/normalize */article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html,body{font-size:100%}html{font-family:Karla, sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}*,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body{background:white;color:#000;padding:0;margin:0;font-size:16px;font-family:Karla, sans-serif;font-weight:normal;font-style:normal;line-height:1.6em;position:relative;cursor:auto}a:hover{cursor:pointer}img,object,embed{max-width:100%;height:auto}object,embed{height:100%}img{-ms-interpolation-mode:bicubic}#map_canvas img,#map_canvas embed,#map_canvas object,.map_canvas img,.map_canvas embed,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}.antialiased{-webkit-font-smoothing:antialiased}img{display:inline-block;vertical-align:middle}textarea{height:auto;min-height:50px}select{width:100%}object,svg{display:inline-block;vertical-align:middle}.center{margin-left:auto;margin-right:auto}.spread{width:100%}p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{line-height:1.6}.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#0b0a0a;font-weight:bold;margin-top:0;margin-bottom:0.8em}div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}a{color:#097dff;line-height:inherit;text-decoration:none}a:hover,a:focus{color:#016be2;text-decoration:underline}a img{border:none}p{font-family:inherit;font-weight:normal;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}p aside{font-size:0.875em;line-height:1.35;font-style:italic}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:Montserrat, sans-serif;font-weight:400;font-style:normal;color:#000;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:0.5em;line-height:1.0125em}h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#867c74;line-height:0}h1{font-size:2.125em}h2{font-size:1.6875em}h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}h4{font-size:1.125em}h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #ddddd8;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic;line-height:inherit}strong,b{font-weight:bold;line-height:inherit}small{font-size:60%;line-height:inherit}code{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-weight:normal;color:#3d3d3c;word-break:break-word}ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}ul,ol{margin-left:1.5em}ul.no-bullet,ol.no-bullet{margin-left:1.5em}ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}ul.no-bullet{list-style:none}ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}dl dt{margin-bottom:0.3125em;font-weight:bold}dl dd{margin-bottom:1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#000;border-bottom:1px dotted #dddddd;cursor:help}abbr{text-transform:none}blockquote{margin:0 0 1.25em;padding:0.5625em 1.25em 0 1.1875em;border-left:1px solid #dddddd}blockquote cite{display:block;font-size:0.9375em;color:rgba(0,0,0,0.6)}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,0.6)}blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,0.85)}.vcard{display:inline-block;margin:0 0 1.25em 0;border:1px solid #dddddd;padding:0.625em 0.75em}.vcard li{margin:0;display:block}.vcard .fn{font-weight:bold;font-size:0.9375em}.vevent .summary{font-weight:bold}.vevent abbr{cursor:auto;text-decoration:none;font-weight:bold;border:none;padding:0 0.0625em}#tocbot{padding:0 0 1rem 0;line-height:1.5rem;padding-left:25px}.mobile-toc{padding:0 0 1rem 0;line-height:1.5rem}.mobile-toc li a{display:block;padding:.3rem 0}#tocbot ol li{list-style:none;padding:0;margin:0}#tocbot ol{margin:0;padding:0;padding-left:0.6rem}#tocbot .toc-link{display:block;padding-top:4px;padding-bottom:4px;outline:none}table{background:white;margin-bottom:1.25em;border:solid 1px #cacaca;border-spacing:0}table thead,table tfoot{background:#f7f8f7;font-weight:bold}table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:0.5em 0.625em 0.625em;font-size:inherit;color:#000;text-align:left}table tr th,table tr td{padding:0.5625em 0.625em;font-size:inherit;color:#000}table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}body{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;tab-size:4}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-0.05em}.clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}.clearfix:after,.float-group:after{clear:both}*:not(pre)>code{font-size:0.8525em;font-style:normal !important;letter-spacing:0;padding:0.1em 0.3em 0.2em;background-color:rgba(0,0,0,0.05);border-radius:4px;text-rendering:optimizeSpeed}pre,pre>code{line-height:1.85;color:rgba(0,0,0,0.9);font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-weight:normal;text-rendering:optimizeSpeed;word-break:normal}pre{overflow:auto}em em{font-style:normal}strong strong{font-weight:normal}.keyseq{color:#6b625c}kbd{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;display:inline-block;color:#000;font-size:0.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 0.1em white inset;box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 0.1em white inset;margin:0 0.15em;padding:0.2em 0.5em;vertical-align:middle;position:relative;top:-0.1em;white-space:nowrap}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menuseq,.menu{color:#191715}b.button:before,b.button:after{position:relative;top:-1px;font-weight:normal}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}p a>code:hover{color:rgba(0,0,0,0.9)}#toc{border-bottom:1px solid #ddddd8;padding-bottom:0.5em}#toc>ul{margin-left:0.125em}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0.5em 0}#toc ul{list-style-type:none}#toc li{line-height:1.3334}#toc a{text-decoration:none}#toc a:active{text-decoration:underline}#toctitle{color:#0b0a0a;font-size:1.2em;display:none}body.toc2{padding-top:90px;text-rendering:optimizeLegibility}#content #toc{border-style:solid;border-width:1px;border-color:#d7d7d7;margin-bottom:1.25em;padding:1.25em;background:#f1f1f1;-webkit-border-radius:4px;border-radius:4px}#content #toc>:first-child{margin-top:0}#content #toc>:last-child{margin-bottom:0}#footer{padding-bottom:2rem}#footer #footer-text{padding:2rem 0;border-top:1px solid #efefed}#footer-text{color:rgba(0,0,0,0.6);line-height:1.44}.sect1{padding-bottom:0.625em}.sect1+.sect1{border-top:1px solid #efefed}#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;margin-top:0.1rem;display:block;visibility:hidden;text-align:center;font-weight:normal;color:rgba(0,0,0,0.2)}#content h1>a.anchor:hover,h2>a.anchor:hover,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4>a.anchor:hover,h5>a.anchor:hover,h6>a.anchor:hover{color:#097dff;text-decoration:none}#content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\0023";font-size:0.85em;display:block;padding-top:0.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#000;text-decoration:none}#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#262321}.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:Karla, sans-serif;font-size:1rem}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0;padding:0.6rem 0}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}.admonitionblock>table td.icon{text-align:center;vertical-align:top;padding-top:0.8em;width:80px}.admonitionblock>table td.icon img{max-width:initial}.admonitionblock>table td.icon .title{font-weight:bold;font-family:Montserrat, sans-serif;text-transform:uppercase}.admonitionblock>table td.content{padding-left:0em;padding-right:1.25em;border-left:1px solid #ddddd8}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:0;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#f1f1f1;border-radius:4px}.exampleblock>.content>:first-child{margin-top:0}.exampleblock>.content>:last-child{margin-bottom:0}.sidebarblock{border-style:solid;border-width:0;border-color:#d7d7d7;margin-bottom:1.25em;padding:1.25em;background:#f1f1f1;border-radius:4px;overflow:scroll}.sidebarblock>:first-child{margin-top:0}.sidebarblock>:last-child{margin-bottom:0}.sidebarblock>.content>.title{color:#0b0a0a;margin-top:0;text-align:center}.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}.literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#282c33;color:#e6e1dc;border-radius:4px}.sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#282c33;color:#e6e1dc}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class],.listingblock pre:not(.highlight){padding:1em 1.5rem;font-size:0.8125em}.literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto}.literalblock.output pre{color:whitesmoke;background-color:rgba(0,0,0,0.9)}.listingblock{white-space:nowrap}.listingblock pre.highlightjs{padding:0.2rem 0}.listingblock pre.highlightjs>code{padding:1em 1.5rem;border-radius:4px}.listingblock>.content{position:relative}.listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:0.8em;font-weight:bold;top:0.425rem;right:0.5rem;line-height:1;text-transform:uppercase;color:#999}.listingblock code[data-lang]:before{display:block}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:0.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddddd8}pre.pygments .lineno{display:block;margin-right:.25em}table.pyhltable .linenodiv{background:none !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:block;text-align:left;padding-left:20px}.quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,0.85);line-height:1.75;letter-spacing:0}.quoteblock blockquote{margin:0;padding:0;border:0;position:relative}.quoteblock blockquote:before{content:"\201c";font-size:2.75em;font-weight:bold;line-height:0.6em;margin-left:0em;margin-right:1rem;margin-top:0.8rem;color:rgba(0,0,0,0.1);position:absolute;top:0;left:-30px}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-right:0.5ex}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:0.5em 0;border-left:3px solid rgba(0,0,0,0.6)}.quoteblock .quoteblock blockquote{padding:0 0 0 0.75em}.quoteblock .quoteblock blockquote:before{display:none}.verseblock{margin:0 1em 1.25em 0;background-color:#f1f1f1;padding:1rem 1.4rem;border-radius:4px}.verseblock pre{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-size:0.9rem;color:rgba(0,0,0,0.85);font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:0.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:0.9375em;line-height:1.45;font-style:italic}.quoteblock .attribution br,.verseblock .attribution br{display:none}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-0.025em;color:rgba(0,0,0,0.6)}.quoteblock.abstract{margin:0 0 1.25em 0;display:block}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}table.tableblock{max-width:100%;border-collapse:separate;overflow-x:scroll}table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}table.tableblock,th.tableblock,td.tableblock{border:0 solid #cacaca;background:white}table.grid-all th.tableblock,table.grid-all td.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>th.tableblock,table.grid-all tfoot>tr>td.tableblock{border-width:1px 1px 0 0}table.grid-cols th.tableblock,table.grid-cols td.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows th.tableblock,table.grid-rows td.tableblock{border-width:0 0 1px 0}table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>th.tableblock,table.grid-rows tfoot>tr>td.tableblock{border-width:1px 0 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}th.halign-left,td.halign-left{text-align:left}th.halign-right,td.halign-right{text-align:right}th.halign-center,td.halign-center{text-align:center}th.valign-top,td.valign-top{vertical-align:top}th.valign-bottom,td.valign-bottom{vertical-align:bottom}th.valign-middle,td.valign-middle{vertical-align:middle}table thead th,table tfoot th{font-weight:bold}tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#34302d;font-weight:bold}p.tableblock>code:only-child{background:none;padding:0}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:0.625em}ul.unstyled,ol.unnumbered,ul.checklist,ul.none{list-style-type:none}ul.unstyled,ol.unnumbered,ul.checklist{margin-left:0.625em}ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1em;font-size:0.85em}ul.checklist li>p:first-child>input[type="checkbox"]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 auto 0.625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}ul.inline>li>*{display:block}.unstyled dl dt{font-weight:normal;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.hdlist>table,.colist>table{border:0;background:none}.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 0.625em}td.hdlist1{font-weight:bold;padding-bottom:1.25em}.literalblock+.colist,.listingblock+.colist{margin-top:-0.5em}.colist>table tr>td:first-of-type{padding:0 0.75em;line-height:1}.colist>table tr>td:first-of-type img{max-width:initial}.colist>table tr>td:last-of-type{padding:0.25em 0}.thumb,.th{line-height:0;display:inline-block;border:solid 4px white;-webkit-box-shadow:0 0 0 1px #dddddd;box-shadow:0 0 0 1px #dddddd}.imageblock.left,.imageblock[style*="float: left"]{margin:0.25em 0.625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:0.25em 0 1.25em 0.625em}.imageblock>.title{margin-bottom:0}.imageblock.thumb,.imageblock.th{border-width:6px}.imageblock.thumb>.title,.imageblock.th>.title{padding:0 0.125em}.image.left,.image.right{margin-top:0.25em;margin-bottom:0.25em;display:inline-block;line-height:0}.image.left{margin-right:0.625em}.image.right{margin-left:0.625em}a.image{text-decoration:none;display:inline-block}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:0.875em;position:static;vertical-align:super}sup.footnote a,sup.footnoteref a{text-decoration:none}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:0.75em;padding-bottom:0.75em;margin-bottom:0.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-0.25em 0 0.75em 0;border-width:1px 0 0 0}#footnotes .footnote{padding:0 0.375em 0 0.225em;line-height:1.3334;font-size:0.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:0.2em}#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-0.625em;margin-bottom:0;padding:0.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:black}.black-background{background-color:black}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#fafafa}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;cursor:default}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#3f6a22}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";color:#0077b9}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#d88400}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value]{display:inline-block;color:#000 !important;background-color:#ffe157;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:0.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:bold}.conum[data-value] *{color:#fff !important}.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:0;color:#000 !important;background-color:#ffe157;font-size:12px}b.conum *{color:inherit !important}.conum:not([data-value]):empty{display:none}.admonitionblock{background-color:#ecf1e8;padding:0.8em 0;margin:30px 0;width:auto;border-radius:4px;overflow-x:scroll}.admonitionblock.important{border-left:0px solid #e20000;background-color:#f9ebeb}.admonitionblock.warning{border-left:0px solid #d88400;background-color:#fff9e4}.admonitionblock.tip{border-left:0px solid #0077b9;background-color:#e9f1f6}.admonitionblock.caution{border-left:0px solid #e20000;background-color:#f9ebeb}.admonitionblock .exampleblock>.content{border:0 none;background-color:#fff}#toc a:hover{text-decoration:underline}.admonitionblock>table{margin-bottom:0}.admonitionblock>table td.content{border-left:none}@media print{#tocbot a.toc-link.node-name--H4{display:none}}.is-collapsible{max-height:1000px;overflow:hidden;transition:all 200ms ease-in-out}.is-collapsed{max-height:0}div.back-action,#toc.toc2 div.back-action{padding:0.8rem 0 0 0}div.back-action a,#toc.toc2 div.back-action a{position:relative;display:inline-block;padding:0.6rem 1.2rem;padding-left:35px}div.back-action a span,#toc.toc2 div.back-action a span{position:absolute;left:5px;top:5px;display:block;color:#333;height:26px;width:26px;border-radius:13px}div.back-action a i,#toc.toc2 div.back-action a i{position:absolute;top:5px;left:5px}div.back-action a:hover span,#toc.toc2 div.back-action a:hover span{color:#000}#tocbot.desktop-toc{padding-top:0.8rem}#header-spring{position:absolute;text-rendering:optimizeLegibility;top:0;left:0;right:0;height:90px;margin:0 1rem;padding:0 1rem;border-bottom:1px solid #ddddd8;border-top:3px solid #6BB344}#header-spring h1{margin:0;padding:0;font-size:22px;text-align:left;line-height:86px;padding-left:0.6rem}#header-spring h1 svg{width:200px}#header-spring h1 svg .st0{fill:#6BB344}#header-spring h1 svg .st2{fill:#444}body.book #header-spring{position:relative;top:auto;left:auto;right:auto;margin:0}body.book #header>h1:only-child{border:0 none;padding-bottom:1.2rem;font-size:1.8rem}body.book #header,body.book #content,body.book #footnotes,body.book #footer{margin:0 auto}body.toc2 #header-spring{position:absolute;left:0;right:0;top:0}body.toc2 #header>h1:only-child{font-size:2.2rem}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{margin:0 auto}body.toc2 #content{padding-top:2rem}#header,#content,#footnotes,#footer{width:100%;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:0.9375em;padding-right:0.9375em}#header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}#header:after,#content:after,#footnotes:after,#footer:after{clear:both}#content{margin-top:1.25em}#content:before{content:none}#header>h1:first-child{margin-top:2.55rem;margin-bottom:0.5em;margin-bottom:0.5em}#header>h1:first-child+#toc{margin-top:8px;border-top:0 none}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddddd8;padding-bottom:8px}#header .details{border-bottom:1px solid #ddddd8;line-height:1.45;padding-top:0;padding-bottom:2.25em;padding-left:0.25em;color:rgba(0,0,0,0.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}#header .details span:first-child{margin-left:-0.125em}#header .details span.email a{color:rgba(0,0,0,0.85)}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,0.85)}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:rgba(0,0,0,0.85);border-bottom:1px solid #ddddd8;padding-bottom:8px;margin-top:0;padding-top:1.5rem;margin-bottom:1.25rem}h1{font-size:2.2rem;letter-spacing:-1px}h1,h2,h3,h4,h5,h6{font-weight:normal;font-family:Montserrat, Arial, Helvetica, sans-serif}h1:focus,h2:focus,h3:focus,h4:focus,h5:focus,h6:focus{box-shadow:none;outline:none}h2,h3,h4,h5,h6{padding:.8rem 0 .4rem}h1{font-size:1.75em}h2{font-size:1.6rem;letter-spacing:-1px}h3{font-size:1.5rem}h4{font-size:1.4rem}h5{font-size:1.3rem}h6{font-size:1.2rem}pre.highlight{background:#232323;color:#e6e1dc;border-radius:4px}pre.highlight code{color:#e6e1dc}pre.highlight a,#toc.toc2 a{color:#000;font-size:1rem}pre.highlight ul.sectlevel1,#toc.toc2 ul.sectlevel1{padding-left:0.2rem}pre.highlight ul.sectlevel1 li,#toc.toc2 ul.sectlevel1 li{line-height:1.4rem}::selection{background-color:#d1ff79}.literalblock pre::selection,.listingblock pre[class="highlight"]::selection,.highlight::selection,pre::selection,.highlight code::selection,.highlight code span::selection{background:rgba(255,255,255,0.2) !important}body.book #header{margin-bottom:2rem}body.toc2 #header{margin-bottom:0}.desktop-toc{display:none}.admonitionblock td.icon{display:none}.admonitionblock>table td.content{padding-left:1.25em}@media only screen and (min-width: 768px){#toctitle{font-size:1.375em}.sect1{padding-bottom:1.25em}.mobile-toc{display:none}.desktop-toc{display:block}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:0.90625em}.admonitionblock td.icon{display:table-cell}.admonitionblock>table td.content{padding-left:0}body.toc2{padding-right:0}body.toc2 #toc.toc2{position:absolute;margin-top:0 !important;width:15em;top:0;border-top-width:0 !important;border-bottom-width:0 !important;margin-left:-15.9375em;z-index:1000;padding:0 1em 1.25em 0em;overflow:auto}body.toc2 #toc.toc2 #toctitle{margin-top:0;margin-bottom:0.8rem;font-size:1.2em}body.toc2 #toc.toc2>ul{font-size:0.9em;margin-bottom:0}body.toc2 #toc.toc2 ul ul{margin-left:0;padding-left:1em}body.toc2 #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:0.5em;margin-bottom:0.5em}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{padding-left:15.9375em;max-width:none}body.book #header-spring h1{max-width:1400px;margin:0 auto}body.book #header,body.book #content,body.book #footnotes,body.book #footer{max-width:1400px}body.is-position-fixed #toc.toc2{position:fixed;height:100%}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}h1{font-size:1.75em}h2{font-size:1.6em}h3,#toctitle,.sidebarblock>.content>.title{font-size:1.5em}h4{font-size:1.4em}h5{font-size:1.2em}h6{font-size:1.2em}#tocbot a.toc-link.node-name--H1{font-style:italic}#tocbot ol{margin:0;padding:0;padding-left:0.6rem}#tocbot ol li{list-style:none;padding:0 0;margin:0;display:block}#tocbot{z-index:999}#tocbot .toc-link{position:relative;display:block;z-index:999;padding-right:5px;padding-top:4px;padding-bottom:4px}#tocbot .is-active-link{padding-right:3px;border-right:3px solid #6BB344}}@media only screen and (min-width: 768px){#tocbot>ul.toc-list{margin-bottom:0.5em;margin-left:0.125em}#tocbot ul.sectlevel0,#tocbot a.toc-link.node-name--H1+ul{padding-left:0}#tocbot a.toc-link{height:100%}.is-collapsible{max-height:3000px;overflow:hidden}.is-collapsed{max-height:0}.is-active-link{font-weight:700}}@media only screen and (min-width: 768px){body.toc2 #header,body.toc2 #content,body.toc2 #footer{background-repeat:repeat-y;background-position:14em 0;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAMAAAAoyzS7AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyhpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQwIDc5LjE2MDQ1MSwgMjAxNy8wNS8wNi0wMTowODoyMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTggKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6RDE0NUNENzNGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6RDE0NUNENzRGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDpEMTQ1Q0Q3MUYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDpEMTQ1Q0Q3MkYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjmGxxYAAAAGUExURd3d2AAAAJlCnKAAAAAMSURBVHjaYmAACDAAAAIAAU9tWeEAAAAASUVORK5CYII=)}}@media only screen and (min-width: 1280px){body.toc2{padding-right:0}body.toc2 #toc.toc2{width:25em;left:auto;margin-left:-26.9375em}body.toc2 #toc.toc2 #toctitle{font-size:1.375em}body.toc2 #toc.toc2>ul{font-size:0.95em}body.toc2 #toc.toc2 ul ul{padding-left:1.25em}body.toc2 body.toc2.toc-right{padding-left:0;padding-right:20em}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{padding-left:26.9375em;max-width:1400px}body.toc2 #header-spring h1{margin:0 auto;max-width:1400px}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:0.8125em}body.toc2 #header,body.toc2 #content,body.toc2 #footer{background-repeat:repeat-y;background-position:24em 0;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAMAAAAoyzS7AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyhpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQwIDc5LjE2MDQ1MSwgMjAxNy8wNS8wNi0wMTowODoyMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTggKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6RDE0NUNENzNGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6RDE0NUNENzRGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDpEMTQ1Q0Q3MUYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDpEMTQ1Q0Q3MkYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjmGxxYAAAAGUExURd3d2AAAAJlCnKAAAAAMSURBVHjaYmAACDAAAAIAAU9tWeEAAAAASUVORK5CYII=)}} diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/docker-project.html b/spring-cloud-contract/2.2.0.RC1/reference/html/docker-project.html new file mode 100644 index 00000000..dfd4342f --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/docker-project.html @@ -0,0 +1,585 @@ + + + + + + + +Docker Project + + + + + + + + + + +
+
+
+
+

In this section, we publish a springcloud/spring-cloud-contract Docker image +that contains a project that generates tests and runs them in EXPLICIT mode +against a running application.

+
+
+ + + + + +
+ + +The EXPLICIT mode means that the tests generated from contracts send +real requests and not the mocked ones. +
+
+
+

We also publish a spring-cloud/spring-cloud-contract-stub-runner Docker image +that starts the standalone version of Stub Runner.

+
+
+
+
+

1. A Short Introduction to Maven, JARs and Binary storage

+
+
+

Since non-JVM projects can use the Docker image, it is good to +explain the basic terms behind Spring Cloud Contract packaging defaults.

+
+
+

Parts of the following definitions were taken from the Maven Glossary:

+
+
+
    +
  • +

    Project: Maven thinks in terms of projects. Projects +are all you build. Those projects follow a well defined +“Project Object Model”. Projects can depend on other projects, +in which case the latter are called “dependencies”. A project may +consistent of several subprojects. However, these subprojects are still +treated equally as projects.

    +
    • +
  • +

    Artifact: An artifact is something that is either produced or used +by a project. Examples of artifacts produced by Maven for a project +include JAR files and source and binary distributions. Each artifact +is uniquely identified by a group ID and an artifact ID that is +unique within a group.

    +
    • +
  • +

    JAR: JAR stands for Java ARchive. Its format is based on +the ZIP file format. Spring Cloud Contract packages the contracts and generated +stubs in a JAR file.

    +
    • +
  • +

    GroupId: A group ID is a universally unique identifier for a project. +While this is often just the project name (for example, commons-collections), +it is helpful to use a fully-qualified package name to distinguish it +from other projects with a similar name (for example, org.apache.maven). +Typically, when published to the Artifact Manager, the GroupId gets +slash separated and forms part of the URL. For example, for a group ID of com.example +and an artifact ID of application, the result would be /com/example/application/.

    +
    • +
  • +

    Classifier: The Maven dependency notation looks as follows: +groupId:artifactId:version:classifier. The classifier is an additional suffix +passed to the dependency — for example, stubs or sources. The same dependency +(for example, com.example:application) can produce multiple artifacts that +differ from each other with the classifier.

    +
    • +
  • +

    Artifact manager: When you generate binaries, sources, or packages, you would +like them to be available for others to download, reference, or reuse. In the case +of the JVM world, those artifacts are generally JARs. For Ruby, those artifacts are gems. +For Docker, those artifacts are Docker images. You can store those artifacts +in a manager. Examples of such managers include Artifactory +or Nexus.

    +
    • +
+
+
+
+
+

2. Generating Tests on the Producer Side

+
+
+

The image searches for contracts under the /contracts folder. +The output from running the tests is available in the +/spring-cloud-contract/build folder (useful for debugging +purposes).

+
+
+

You can mount your contracts and pass the environment variables. +The image then:

+
+
+
    +
  • +

    Generates the contract tests

    +
    • +
  • +

    Runs the tests against the provided URL

    +
    • +
  • +

    Generates the WireMock stubs

    +
    • +
  • +

    Publishes the stubs to a Artifact Manager (optional - turned on by default)

    +
    • +
+
+
+

2.1. Environment Variables

+
+

The Docker image requires some environment variables to point to +your running application, to the Artifact manager instance, and so on. +The following list describes the environment variables:

+
+
+
    +
  • +

    PROJECT_GROUP: Your project’s group ID. Defaults to com.example.

    +
    • +
  • +

    PROJECT_VERSION: Your project’s version. Defaults to 0.0.1-SNAPSHOT.

    +
    • +
  • +

    PROJECT_NAME: Your project’s artifact id. Defaults to example.

    +
    • +
  • +

    PRODUCER_STUBS_CLASSIFIER: Archive classifier used for generated producer stubs. Defaults to stubs.

    +
    • +
  • +

    REPO_WITH_BINARIES_URL: URL of your Artifact Manager. Defaults to localhost:8081/artifactory/libs-release-local, +which is the default URL of Artifactory running locally.

    +
    • +
  • +

    REPO_WITH_BINARIES_USERNAME: (optional) Username when the Artifact Manager is secured. Defaults to admin.

    +
    • +
  • +

    REPO_WITH_BINARIES_PASSWORD: (optional) Password when the Artifact Manager is secured. Defaults to password.

    +
    • +
  • +

    PUBLISH_ARTIFACTS: If set to true, publishes the artifact to binary storage. Defaults to true.

    +
    • +
+
+
+

These environment variables are used when contracts lay in an external repository. To enable +this feature, you must set the EXTERNAL_CONTRACTS_ARTIFACT_ID environment variable.

+
+
+
    +
  • +

    EXTERNAL_CONTRACTS_GROUP_ID: Group ID of the project with contracts. Defaults to com.example

    +
    • +
  • +

    EXTERNAL_CONTRACTS_ARTIFACT_ID: Artifact ID of the project with contracts.

    +
    • +
  • +

    EXTERNAL_CONTRACTS_CLASSIFIER: Classifier of the project with contracts. Empty by default.

    +
    • +
  • +

    EXTERNAL_CONTRACTS_VERSION: Version of the project with contracts. Defaults to +, equivalent to picking the latest.

    +
    • +
  • +

    EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL: URL of your Artifact Manager. It defaults to +the value of REPO_WITH_BINARIES_URL environment variable. +If that is not set, it defaults to localhost:8081/artifactory/libs-release-local, +which is the default URL of Artifactory running locally.

    +
    • +
  • +

    EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_USERNAME: (optional) Username if the EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL +requires authentication. It defaults to REPO_WITH_BINARIES_USERNAME. If that is not set, it defaults to admin.

    +
    • +
  • +

    EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_PASSWORD: (optional) Password if the EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL +requires authentication. It defaults to REPO_WITH_BINARIES_PASSWORD. If that is not set, it defaults to password.

    +
    • +
  • +

    EXTERNAL_CONTRACTS_PATH: Path to contracts for the given project, inside the project with contracts. +Defaults to slash-separated EXTERNAL_CONTRACTS_GROUP_ID concatenated with / and EXTERNAL_CONTRACTS_ARTIFACT_ID. For example, +for group id cat-server-side.dog and artifact id fish, would result in cat/dog/fish for the contracts path.

    +
    • +
  • +

    EXTERNAL_CONTRACTS_WORK_OFFLINE; If set to true, retrieves the artifact with contracts +from the container’s .m2. Mount your local .m2 as a volume available at the container’s /root/.m2 path.

    +
    • +
+
+
+ + + + + +
+ + +You must not set both EXTERNAL_CONTRACTS_WORK_OFFLINE and EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL. +
+
+
+

The following environment variables are used when tests are executed:

+
+
+
    +
  • +

    APPLICATION_BASE_URL: URL against which tests should be run. +Remember that it has to be accessible from the Docker container (for example, localhost +does not work)

    +
    • +
  • +

    APPLICATION_USERNAME: (optional) Username for basic authentication to your application.

    +
    • +
  • +

    APPLICATION_PASSWORD: (optional) Password for basic authentication to your application.

    +
    • +
+
+
+
+

2.2. Example of Usage

+
+

In this section, we explore a simple MVC application. To get started, clone the following +git repository and cd to the resulting directory, by running the following commands:

+
+
+
+
+
+
$ git clone https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs
+$ cd bookstore
+
+
+
+
+
+

The contracts are available in the /contracts folder.

+
+
+

Since we want to run tests, we can run the following command:

+
+
+
+
+
+
$ npm test
+
+
+
+
+
+

However, for learning purposes, we split it into pieces, as follows:

+
+
+
+
+
+
# Stop docker infra (nodejs, artifactory)
+$ ./stop_infra.sh
+# Start docker infra (nodejs, artifactory)
+$ ./setup_infra.sh
+
+# Kill & Run app
+$ pkill -f "node app"
+$ nohup node app &
+
+# Prepare environment variables
+$ SC_CONTRACT_DOCKER_VERSION="..."
+$ APP_IP="192.168.0.100"
+$ APP_PORT="3000"
+$ ARTIFACTORY_PORT="8081"
+$ APPLICATION_BASE_URL="http://${APP_IP}:${APP_PORT}"
+$ ARTIFACTORY_URL="http://${APP_IP}:${ARTIFACTORY_PORT}/artifactory/libs-release-local"
+$ CURRENT_DIR="$( pwd )"
+$ CURRENT_FOLDER_NAME=${PWD##*/}
+$ PROJECT_VERSION="0.0.1.RELEASE"
+
+# Execute contract tests
+$ docker run  --rm -e "APPLICATION_BASE_URL=${APPLICATION_BASE_URL}" -e "PUBLISH_ARTIFACTS=true" -e "PROJECT_NAME=${CURRENT_FOLDER_NAME}" -e "REPO_WITH_BINARIES_URL=${ARTIFACTORY_URL}" -e "PROJECT_VERSION=${PROJECT_VERSION}" -v "${CURRENT_DIR}/contracts/:/contracts:ro" -v "${CURRENT_DIR}/node_modules/spring-cloud-contract/output:/spring-cloud-contract-output/" springcloud/spring-cloud-contract:"${SC_CONTRACT_DOCKER_VERSION}"
+
+# Kill app
+$ pkill -f "node app"
+
+
+
+
+
+

Through bash scripts, the following happens:

+
+
+
    +
  • +

    The infrastructure (MongoDb and Artifactory) is set up. +In a real-life scenario, you would run the NodeJS application +with a mocked database. In this example, we want to show how we can +benefit from Spring Cloud Contract in very little time.

    +
    • +
  • +

    Due to those constraints, the contracts also represent the +stateful situation.

    +
    +
      +
    • +

      The first request is a POST that causes data to get inserted to the database.

      +
      • +
    • +

      The second request is a GET that returns a list of data with 1 previously inserted element.

      +
      • +
    +
    +
    • +
  • +

    The NodeJS application is started (on port 3000).

    +
    • +
  • +

    The contract tests are generated through Docker, and tests +are run against the running application.

    +
    +
      +
    • +

      The contracts are taken from /contracts folder.

      +
      • +
    • +

      The output of the test execution is available under +node_modules/spring-cloud-contract/output.

      +
      • +
    +
    +
    • +
  • +

    The stubs are uploaded to Artifactory. You can find them in +localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/ . +The stubs are at localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/bookstore-0.0.1.RELEASE-stubs.jar.

    +
    • +
+
+
+
+
+
+

3. Running Stubs on the Consumer Side

+
+
+

This section describes how to use Docker on the consumer side to fetch and run stubs.

+
+
+

We publish a spring-cloud/spring-cloud-contract-stub-runner Docker image +that starts the standalone version of Stub Runner.

+
+
+

3.1. Environment Variables

+
+

You can run the docker image and pass any of the Common Properties for JUnit and Spring +as environment variables. The convention is that all the +letters should be upper case. +The dot (.) should be replaced with underscore (_) characters. For example, +the stubrunner.repositoryRoot property should be represented +as a STUBRUNNER_REPOSITORY_ROOT environment variable.

+
+
+
+

3.2. Example of Usage

+
+

We want to use the stubs created in this [docker-server-side] step. +Assume that we want to run the stubs on port 9876. You can see the NodeJS code +by cloning the repository and changing to the directory indicated in the following commands:

+
+
+
+
+
+
$ git clone https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs
+$ cd bookstore
+
+
+
+
+
+

Now we can run the Stub Runner Boot application with the stubs, by running the following +commands:

+
+
+
+
+
+
# Provide the Spring Cloud Contract Docker version
+$ SC_CONTRACT_DOCKER_VERSION="..."
+# The IP at which the app is running and Docker container can reach it
+$ APP_IP="192.168.0.100"
+# Spring Cloud Contract Stub Runner properties
+$ STUBRUNNER_PORT="8083"
+# Stub coordinates 'groupId:artifactId:version:classifier:port'
+$ STUBRUNNER_IDS="com.example:bookstore:0.0.1.RELEASE:stubs:9876"
+$ STUBRUNNER_REPOSITORY_ROOT="http://${APP_IP}:8081/artifactory/libs-release-local"
+# Run the docker with Stub Runner Boot
+$ docker run  --rm -e "STUBRUNNER_IDS=${STUBRUNNER_IDS}" -e "STUBRUNNER_REPOSITORY_ROOT=${STUBRUNNER_REPOSITORY_ROOT}" -e "STUBRUNNER_STUBS_MODE=REMOTE" -p "${STUBRUNNER_PORT}:${STUBRUNNER_PORT}" -p "9876:9876" springcloud/spring-cloud-contract-stub-runner:"${SC_CONTRACT_DOCKER_VERSION}"
+
+
+
+
+
+

When the preceding commands run,

+
+
+
    +
  • +

    A standalone Stub Runner application gets started.

    +
    • +
  • +

    It downloads the stub with coordinates com.example:bookstore:0.0.1.RELEASE:stubs on port 9876.

    +
    • +
  • +

    It gets downloads from Artifactory running at 192.168.0.100:8081/artifactory/libs-release-local.

    +
    • +
  • +

    After a whil, Stub Runner is running on port 8083.

    +
    • +
  • +

    The stubs are running at port 9876.

    +
    • +
+
+
+

On the server side, we built a stateful stub. We can use curl to assert +that the stubs are setup properly. To do so, run the following commands:

+
+
+
+
+
+
# let's execute the first request (no response is returned)
+$ curl -H "Content-Type:application/json" -X POST --data '{ "title" : "Title", "genre" : "Genre", "description" : "Description", "author" : "Author", "publisher" : "Publisher", "pages" : 100, "image_url" : "https://d213dhlpdb53mu.cloudfront.net/assets/pivotal-square-logo-41418bd391196c3022f3cd9f3959b3f6d7764c47873d858583384e759c7db435.svg", "buy_url" : "https://pivotal.io" }' http://localhost:9876/api/books
+# Now time for the second request
+$ curl -X GET http://localhost:9876/api/books
+# You will receive contents of the JSON
+
+
+
+
+
+ + + + + +
+ + +If you want use the stubs that you have built locally, on your host, +you should set the -e STUBRUNNER_STUBS_MODE=LOCAL environment variable and mount +the volume of your local m2 (-v "${HOME}/.m2/:/root/.m2:ro"). +
+
+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/documentation-overview.html b/spring-cloud-contract/2.2.0.RC1/reference/html/documentation-overview.html new file mode 100644 index 00000000..783af2c2 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/documentation-overview.html @@ -0,0 +1,372 @@ + + + + + + + +Spring Cloud Contract Documentation + + + + + + + + + + +
+
+
+
+

This section provides a brief overview of Spring Cloud Contract reference documentation. It serves +as a map for the rest of the document.

+
+
+
+
+

1. About the Documentation

+
+
+

The Spring Cloud Contract reference guide is available as

+
+
+ +
+
+

Copies of this document may be made for your own use and for distribution to others, +provided that you do not charge any fee for such copies and further provided that each +copy contains this Copyright Notice, whether distributed in print or electronically.

+
+
+
+
+

2. Getting Help

+
+
+

If you have trouble with Spring Cloud Contract, we would like to help.

+
+
+ +
+
+ + + + + +
+ + +All of Spring Cloud Contract is open source, including the documentation. If you find +problems with the docs or if you want to improve them, please get +involved. +
+
+
+
+
+

3. First Steps

+
+
+

If you are getting started with Spring Cloud Contract or 'Spring' in general, start with +the following topics:

+
+
+ +
+
+
+
+

4. Working with Spring Cloud Contract

+
+
+

Ready to actually start using Spring Cloud Contract? We have +you covered:

+
+
+ +
+
+ + + + + +
+ + +We talk about Provider Contracts when it is the producer of the API that defines the contracts and +publishes it for all its consumers to use. This approach is useful for producers that cannot +directly collaborate with their consumers — for example, when there are too many consumers or +the consumers are external (do not work within the same company). +
+
+
+ + + + + +
+ + +We use the term, Consumer-Driven Contracts, to refer to workflows where the consumers of an API +play a vital role in the process of creating the contracts. We recommended this approach, because it is easy +to implement when both producer and consumer teams work for the same organizations and the number +of consumers is not extremely large. +
+
+
+
+
+

5. Learning about Spring Cloud Contract Features

+
+
+

Need more details about Spring Cloud Contract’s core features? +The following content is for you:

+
+
+ +
+
+
+
+

6. Advanced Topics

+
+
+

Finally, we have a few topics for more advanced users:

+
+
+ +
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/favicon.ico b/spring-cloud-contract/2.2.0.RC1/reference/html/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..1a4956e64705230122da8c19d762a7f8e6971533 GIT binary patch literal 111804 zcmeDk2Rzl^_Zg*0(k?VKlp+nIjEXXol|<2^RLG9-q(Z|kLP(+_DLdq8$xf0aqs++2 z-rxVZqW??wO8vSY$NS#zU1!|y9p|2VFAhh78;?Vd1h){klNpCof@eJbyMM(55?mm> z&B-@@0PYjbEofk6lC?XakG`%^LnA8Hb2|y)UbNjo23;MJ1*|O=arAUO_;NA_N!B^ z*SU%*7Sg^ZvB00+CB7O@R;<-pgVW|+t^TxD`9`Vt`1cf28NPLtDQ+hDJU2veHezY^ zQi`lBX|+X1xgXRpo_)4ylGG=m2?Qm@CH^r=LG=?YMdw`*!BKBdvlmh1W}$HW+%(s; z+If?c7ETT?%1-liUaq8bTJ{o7mM@yDBon+;;^rvcELEmvu_*TWnq7k1O-dhTwEMkp z-R_hvFVq$BG5nt-ZXm){7iQGqL2u2 zEfMMx_N2p=<14Qvs;Et;-Q{aHaUq|S=-kQjB=YC03vc8*s}d+9a1qOxXKvlL48Krf z!x4t0N!U_FuVTG}0u+^Ex%|1JfZtM1_dSbfc=1xAYjaP0FixxW-mfLH){mrNNu_@NQC~j3lb#Rmmsu$Iy6l<6KGGR?3ZQvzbWPanFm1yd1Y?nGStAzcXj< zvD{P6Y5SKzvc)v`*;1k@WDcKw8#MW2mYjZTT3wYZ?ws~yn-)t7?=t+NJ5C3mW;~Cg zQC8c`$XP>%;fz!RKJZY}iZIwsButf-oQ`+K8(36Waz4zZ&D{?Pg|rsh2rR?fg|2K1 zB2eKUdgR%hEum+piQb)J(y%qnezW@;DKek@C97sjORkCLP%n@@TwujNo6K2Sw9(GT zZg*hAMt=sW^D%~#ftNzLr*fH69ts>tC2Jwod#w}{Vov#zMq1Jq|BMj7(Wmv@t_4d} zY4Gb!0CgJ$mCw3b=mnN5%RE^F^{zPs~f6+wZlmkxQsz#NAIX+gSWE#TgIqY>eaEku zRCk0oAp|ESdY#IbqI}10qhorvOmwA1PfMiPucs!tip6TS=0xDzeD&;n;hD6TW=L)%Q01$y(3(9l zm#+)sq$Qc|d9{pd;CfUg94%u}Ef`(9X!FYrQ+NzNE{)!-C=v*GGd{~WVVmA0!M=I& znJlFs-SIxWAaau%1a;At)f;^xS@**&s?`@BwBTmm z^SV6w-IiM$fzX4yHWYXheDM50*T?G5p*AS*GU4eNnXM@$+n6sa_LbA67lO$ zs9;Q(_49iEn8h!GmMytHCf`j^AT)irYRXnbTCL7Kt6und5Du!s!CmtdDcUY;?n+^Nd0RBs z_mR&9CPj(p%~Lo-gvIxgO=R+z4qt8kqE%5doZqNd7q5v`{4AVWzWu@c$5i4MIZVGD zv&$-b%wp}nco~SRYPHL{S|N##p%GsEJ;C{!`|bIxJO42;*Vh^;D$*EC`|p-lfEKHk|v zyds#%Eo#rRYas5qR4r@eW9&QycG>QYOVq^X+bvpq^vE(Ni8)12WZaYMNuJuGk1d)* z%~+q^a=D<5J4+Z|u8>>rLqnV5isb8`RI9K1)sBmpY*r}e+ZY>90qT-CDr+}xCwa}_@O|8g(`URP&vkm* zY_W@Oo9$vjK^4ZFJ(cm+yW2<#GE|pOw75*3tDlW+)<~mc+<94eRbFr-PmHbO%xih4 z^%k)2OS4~~7C+(0Pb4nKuT|E_yG$?c!X>V?!ajeu^--2L8R_fv(x)pXt5;C%g^p|n zZRMtqBBz-IA09lYKMo5jwlKfbg4-Tx@vuC69P_ur*60ZGhL!&8xe^SFTMcjKOQ`N^ z(0pV2h>V%Z{AE}amH%_+`teKQOR$~TB2`1NNbshjpg`gA)beM0Py6^g8*cliPOs?6 zR!?$Pdm|O@)0ftTf(OdWo+g9mNez2o|Fq0weZ&It0QSmbypv7Y{rqGeuo`>vYA%`kwczw`n5_NMwr@Q7t#Or?7G7NXFFIzM0br}}GK+<1?v%-!S^JS95_rTcEuC=%iTq@~?J_F_tHg~Ct_j&`jGteGu`8|QArv!(I4~F7 z^U^!RSD`tXP+P{_+$=1=sV!Lf4j=Y(_M?#AlT67xQx%x}^FLK;Co4@s5rVmBMUOtxT_~V4+8y;d(wh;$j ze{sBOFuv$&4sY=7U0Uo1)^Zx!hLh)>@={a){BZV-4RnH&R+;XMIolEtR)1MJR3|C& zlw>2xcIC&0ENq$DUySA{Fq7nmM9p|Og_Blu2h$PRj1BpFFY=i!IcG+>#e#iyUKWd< zSvu)Zr5MTERD^iV}rW zW?kEJT`Ck8x%2s?dYk*~CtZLNote~XayYg{%8gga9wT8Q6G9Q`Sufv}DqQ2qYP^W1N}0bFM=M_S=Az(6$72uOWFB<-=Eit=i6z4b1aJqz|NE5m3R13$cg6MBb zEW=VyYe(zLrxgvhP8WPRLqg;j!`#&j*O@#WQw3OW9}rBiXUq4H@?gArLUUQrzNx0V zq8yF0uj4$wODt}!(>!Yh~^ zmp4BWe(JgOh`~G>mIJxWoyt4Y^G%rQ*7QA}lcqP^Y`YI_IF@rsraXv$# zrhgeBH_=UW!3r8)ob8llg)>($&C^_a`q)yF*(+W|l)U7+oOENl-j@Awf@`!Ka39+n z*YPh;i>u1VufH7-n9o{h?@FIqogf@tP+XC>r@F0j8J;1;&Rb;Hh8IwQn#YIW4yWfV z%6AHo-Pk0gbcI`n+t2PyaHRgyyM>k66OshtG($2b%phxq0pixjYiB|`l`!AH#<#&X z=N+AqS%IYL~`pVkiIB_+qSM`D%0vGjsfw0i((H`(^}4W;l!zO_gLoax)d8( zR~p`lE?QL3U`TxwnKSLd$^fND5uZ!*Z_m6$$$yc==iYwr_tV?>gC0q2_Onx0Ati*J zJ^E31V=~L$(1;ctFU!3vIcG3#XK!k5$baR$;?R>Bb%&NaN%%7`q`t}I){|j$al#c& zXg;_2xl6>l(8FAVfDqI`~T&oTJ9)U5W3 zRWoEH&%UpJp4uYp>6+!Kmu02gxOw(4z9J`t22PY`%iI4*VltoE;ur3bG4BE%9HCO4 z;kt@x{H5j{R{XiBrDD*KsBqUiwL4{;JbS^$%ldZ3yFBOACS^O|R>a?6WV*24E|XkQ zYQs_k_i-%O*&mY}eLFu?UzhNu$&_)G^U9dpQ(+UQX3n`H5-p@HlNK6o9T~!J=XZO zzHw>MCCV@BEXIf2$a+)5`^4%9|9aZWg1GRxSNE-fx??HD_O-Be$p_^qD4(=Ry8&8C|uIrFMc@jzH_dTe$#p` z>!L%l)IO}om&M0LF>y{|O!9r-tXsFfqUCG-Vbkl^Z_P+KaAR>wuFgsg;e*ZN~ zPDW<(ypofAF1))Hq4VYn4?b*M5nud?l$VYIIL_RXxJ?4W7n>w)JQ7wp8)?VIZPKS@ zqBFQ#>>uGp;qk=aqb&byiT&&fT5}{^WP`*GNw$8F3>Hmv685_-pmo&y+iTXHmzrh~ z%sn@+xf8*UV%6PmvSF5IK6%8Z4NtrvmzQU>qVRsj1%MbJ%4`ow8t~+&k36{vFDavtG!S17|0(s zY9_0xt$&OD>q9IUsL$&u*svB=UDHBf9_|2wuRjA>8n`nMrRixnZDH(IhZ5NkV z8c{I&8aUGI)AlY~m3-&$)+eDHSVT&CPLZnS4ypa5D{eiQ&Kcu0!#F$Z+vfSD??SV5 zjWT5T%-DQY%`%1Y<#&W}9EBoZMUFS@g z!@Gz_EVvcDKyQm}{&||!W{r6--9EFoK5`?!L09VO%x6}7)zVIXm8<6tDy^nH*I0mF z%^mS!Ew?L+zp55w1W~>Im|3WUeYPpGaoD|>GvPojhyE9xP{S$j?@>HH!zAX|I8G>V z$|GwJms>f}lij!zZU%2tt(Ti_yKC9@m{+NFCh?msdSNotpe;#`Vt;LD6hn~x z`MhhFC{vH0+;_!Qht|r;86U9Sbu}kBBjpL7{n5gkjPp)KQHE+&l@)7`Pr0do|8_uh zsvnKM`))1#GeK5I$Gw4kQ1<0byTY#)ZESmcQY?yO^5i6o$J$Gsv$XbW+)X9Z=C)t@ z+}>pzbWbL;83gGToV@q>ZV(Uq$#XfetRlzuta`GNQ_5|s?!;-|R^u;HYdm+G!8!H* zj?*f&Ty*sHQ$qv4?v_YM3AwN{pom;ugvwt|e4-1u=Z4~dAtgM}&fE8$BUAEdpZDqOl=B5VJ;{8FZgg7VyDavslW z`3P+$mf1B~-4@k)~ba`KnO3Ae}@;ENqp^ z<7Rygk6LT*eQ7v-(5T|pU!;6{!?uPMVd-%K8G4k>C z$DM@V_y;d&vsPx~%0ISjL5RJr@ZC9K0uWy_H2P3bISJ*{qKS%j#flWdYz5|&TP{kh zs%yF7pwp)GO5D&?G|A;<+Co+f>NR#VB{{B+?p)oT-ZtFFN3 za@^VISrk?4Gw=F>rG@Hc2^BFPmlTm**~C@$fu(Xb7d}y?0;fZ%aJa#9`S#X(1rl?# zbwaAX#x)!IwOEW_!j_=7u*9uCT+{uCnfJa@iZ+cZ{<`rny>qA7BQh6pif^CrhA4$* z97QH&Lk%~r`o0(YW*m93-`FlMk>Xg%H}=`N-ekrcr-l5ddYE!w7hlu3`t*V1huSR~ zFUq)OjPRFU?vJtmypG>(tH4*Themg@=8tc)%~d_bAix@TJIeE>VPKK;{)|RBH`ThS zj&4!*M+(v{xX)W>$cDp*w-Qv~JeBdW6BRckEjr7Y5>2L2OCNj7&sArCcI6x&%gBoK z=J<79>IIi!wzT~fdlT(f)%Ur_>L1$~H-4Q?PzqwB-eN^YGv#3ljqoHtKv=J3Nm@l5 z&&u15^9wgmOEnasOe>qCq90(jv+YQwcO}U*YO>1aW?G86ufdzy=9g*x!uZ=PtDY1OcAyKVIIbR{l6 zm_ej?(`eM*-|+Q#M%l6Y9iTq9_o`)FMFvYMG<*VP?ygTL;d3D6XrgUVP8V)Tp0vR| zPVLS7&?8M&j7hF5n(Ut*%==V7_w)5v&8BRj;WSli7Dg!ZY07NNJue`B_hu`*u`ISi zjw>g&?xLVtZs9R17H;DU#gdbpMPqp8s?-}mB4OMEvJeYyn~llB^Mu!)C~FJR(~hAD ztQr4~bbYbbNA_9@``Is(Jy@a9%ErUryP4S+&`#9y34N}$ERG4diC{Nu@p)++#Q%JGh-BR{> zdW$5a_DI%_r!rR8+_f?aP`nTqejP@|#i^54?T9i>+s3mr<>SekxAQ-5Agru9r?ROf z>e~{2GZ5|RBdK{O)IKh-uNv>yn0GgWN3s5)7{|LWr)(am=AP8uw0S8$o!@QOHeH&1 zTxA;4xpUs;6&JSB8W$=wW1mwmb8Qn`KPT)|iQy^PMv~q1XO7>=!r+@zeQ>w7eB%e- zx+N~_5AQl>l)EROVo8MOtKeHo8>}L9*I^&)&%9n4wRDk1rc&#A)m6rlJ66wE;h`&8 zYFr(7=niEHGs)K3g`3{{-w@9zSiH^ptf${?r}W@fOEIxC3-k^wk7c?2El8H?Wxk`4 znqfq}n%1VK&1E{c2YMekq(~dqRjwnqq}=>IbW`P4hMSz>nR?1alOqg@)wVRhq_=i+ zj9;xux0rdgk+N0!SJk{*&$jJ<7gO$ODyY+$3l!E9<+m=-2Q=T^RV&rGvVNCB+ zcdVtR^+DwWGG>a%DyxT=^PDf8IJK{l2&Cp}X3JX+<)DJCoqc|seUBk0=0<`aY z@>}rYN8&$GoiAA)PMFLsB4)%~I?`;s5}95Z-jc}gecy!`sw(zR@+4|sN$85rK# zVT^M+?n-4Ap1Ps!D5^ypPR<>hNJZgcPr?s;#*lNU#b`AN%~}y-@`33z3Xg{`CdF=WqFhKj+Id3 zPNuEWQ?5{WpSqyQChwNS#W15ns#xJwvkXh9Z$X!+TNlOpG2V#HzbScF&9g|t1`~oB zziZ`(XBFm~BhCfHh8;}i(QAmD-&oc}Z+5#XId0#%$CWaVs;H{!EP1AGD57VVY1IGV z{3zn23=dh$glVkO6@`zl!r0I5#7>%14WaK|>)X$i#`5h-jHd>@=Gz52Kqh)!GUaRg z7@KOABzN9 z->u`ar+5!ZX041W%&M0O=CCXE&WbPo$mqdy!8{KJx+T}J+QOVXw(M(P;%@{kpJtE4 zac{1n0u|r+2(krRp=t8vsAS%q9+CJh>4QJLu}a+uKbN+B85Pe=gQV5`!%x5WW|G4_ zP!>z8ZMM#W^};!O7M75OKCD`UhAP?(j&HNm61<+#`}-9d>TEpulKKgAbFyR2_-j^C z7BBLcXSbf>^DVUGG-`8mK2~yUe);Y6Oy4>leL24e$?xd+6r=FQ6$UnUZ(Z|9pK4Gc zF>kA`!tzW@U&Sn&`iwXJ7wBUA*)DDKf(3-*-iB^AvU&W*Ow?rsQ=@9Us^||m`bC*G zI^nXPhh4~BPfh5Pp>s*n)31IAcgir*S~~wY_d$ba-dc6F6RzxdV0z?* zgL--X`~p_>XV5TR2nkrq1&gcUhK!ls!Z=u;^Lxr6vCAAZHuX%cWXr-pRv1j zt(@ikg9dr}H*;#1$BQKt2uoHR6j9}4+B!4El8rt$#Y)ZlmfCy$EOPrP>9x8n#*fn@ z$y?@3d!yu2s*+oF()jb)I61xr+@ERva$?^(%{<|=PgFX7Ke_xHgTt@Cu!rk$C^()m z70KOS3_XrjDIL&9wz=?l0R_)q989x6ng^)ir%mMK%DG;@=Oa@ci+xi0ZXH^=cuSh& z8M{L+Jf5&m?0}TeM46q9mM*z3D430!CeWuxlqCw!H%ak(xQY8)h-oW5ESo-D%}xIa|i3%N?4 zd%$=lPeTSN4i*(vT&l-S&_r{7&N8{h+a_H4aBay~?kCr>w4L8)`J234A-nE?PWHhy z_d>5;&X-TQ$#<1@gU@M=EW>Oa!aXvfle@zeveuK$Jy^fElFOa7h2AFBz)ZoL{T5SU z;pC%bCs0G5u`k3VtG1Mbv&ON)eBB4uYXx?ySJ@g{)B)GzlPwm^k<7-Q)e6jT?d);6 zRGs3^qGU)~;Oc@U7(UlFV0pGarIMPX5agM!~)FwyCT zEx0=u-}G*ttGqVbh9|4d>Tf2h@GNFRnN|M>6clJJYB18#V;e z-M*)~uDK-GKjak6jt^FRN9?j`lwT+$eLm$7dy(G#!?kCdA6D&Dh-z#$k%dL;8_a4N z%lAxNNb`PN{<#vtnfFPDf?K615oZdp_8Z2A3<;%p`_U)`oBvhPjrfxhfLCAO!&k*FU~t1Zxu-@0Oup%8Kf2FC2~BbF38 zRl9=na>Ma8lXoca$+n$H`Sjc#`>Jmtqsx<5!MBPHdVFQmnZmE9<6vRZPTg|W`tkQ) zYz_v8BoL;esnIZSRQuBn#TSi(2D0w6AfhueO-w8 zPWLxTK@}5~Ug_X1Ttw_gGgT8ab`$ zXtGa>VS1|8xM1$j^(S{XC!eL2drgB#PBlp*f0wprl8HFui-Z;Im%i{T$1gK7PYaT& zuJTfNw4w667f$pf+b;J~+=k8V7{9X3amMMi5(%ZJ zw5mV(IW)?oxtV@DcZb#y8c^Nyi{I@s+QvifLX|N2(^>{LEkZ+$#>(o#bw~2AS2=TE zM#4=yDc118M{PyUMCk&vX~C#2&ov8hR#$mNxtJu$*@b4EG7E>=M!U(gZLZm`=JX8J z2)uidEto65>G9QQrrppb&c47}Zr#piKavakUP@K%yO8oU-z7|hZmrd$vm6==Epa=X z@97y7Rr_*%b5pdcV7ILHGv3A7qBp&&y>eEV%-8SyXhqafx(Pc9%vgdDE3V^w$1$1MuUi{=Hs0%uX-m!8XHSB|Zds-W zZ=NZTylN3>z~cgxBy89m1kX_I1_wB>-+)Q8gmhCKR<)^DS)eo>3G*4Z6 zqFsW*c$rp1Y_`yvyq1e{XH@I_GB9S>oThmHH5y-hplP!UD3Xx%w|>-;q497^w0_g$ z_d5B9-Yq!oaKHBWvkeD?XR@R!1)1F!R@u{Dhj>WK>uU{*uE|rs-iw=0^(20sv(YT^ zdJ2ui45|DiZ&qXKLpwyS?o%IET5?QzN8-wj^v&n)Yx^86t2OXiZLEcx3^lSzolc5R zERz27*JWoOhN#_n6 zv#*@N7igD*!tNQTP5ouR$+`s;B&*T)CSgML?ckLyx3URbm)w@cu(Ian>C|giRT{9V zN2GdZ$dGOX>3&&~ba-!yEa-@*mOi{KnHKWSKT36S_;EIWp97KBM_y-55acmdn;?k# z+RM*5_PeX!NngE^-E5U|_T0ccBbd{+J<5x66wK#Dy$|k)5XJ z0V=cky8cnemQy%|NT#Q);Pj1lh040ffRB5@0aNW0yPK)O?h40^+f2#tEFH*nC+3ED z#O0{+GbCW zUFsY09fz7v&D&&|@>*Q@kn-v)`(o~v-SK)DQ=z?67(mu6q8 zzJ|j{=t#0K6TzLz$ow?pEm9#IC>A6i6|DGkDE1tk3ONUbsc=`5m^K>2q1;Pv1geF)`LJec7$lFKg!}%+cCj!%16sZU#d-QBiJ5t{e56 zIE!_(QqwZGD2r{PjXbGU7nqWgx!pi*)k&@^fpzOsKV;I0i>aPH%;C>{QVojZTvWWBNzk+g7Xq`F91F_l^k6jyZFUMtJqZt(oy`cbBy)hEJBEQX zf+i|LhdcX|ydHyl#)YM^J4#K2L3ku7Cgh7t9$bM&kmr;iPpGIClf*~8@q1>JU8O$= zt7FjP9?q5FRSYl_vQ<7wxWCbdOX=FuCm;@J#W&mLc*em+r!DoIL$dT|Le z$#`gGm~rdW{kAd)Mps4=BKG*SOfy}LCxL~zTo<`qqs2!*(=gs!K&lEOG@TTab3zHr zP@o8z>$9*q77V9LkL89#L0&PIF=x=w{>9~hrRuXEZCE(<{=5b-)imCxweZul+3ghB znJhQq2Xnl|JL!{-w>BSamBS97x{AvUpgX5PLPzolOj-HQT_v1^;iYLY@6*-g(+SW# zKQb{>ubXck=Do;PrbIn^h0zD4pqL~4=9%qu3FR8&HThx|pBH6QB%=dm0Vo}*8Ov!< z%A^;kWp^#&oW*#!$z(R39_&P0JxndgSxH=;r|IVI&7~mhN%jcvw%(zAG+&67WXhJb88qrklG?~vsrhD4g^@8Mr?tScc1zr~ zI0szL3yzvS7eyio@q{ISe`K+uhlvP|8;pY&RVol}zhVT#$cZjXc-;WS9efltqK8Q< z?d~xyB_tB25(HAdJ-@3>cwmAoV0X>3vS4E+A%CTPTAjO6I^FG&r1;S^(qyt^7=m5_ z0(2nI<{smD!c~GaVF4ty-k&R)TTdtj)6N}Qybrf7!%q|6aD+*HL((}GS*^|DcW4^e zDyJt2f!VD49tIlTIia@E=l$H)S#PuDI!5{x3_O(rKFIM?%qTrfI$<5G=$kO(Ci$Oh zC_nYyOp_ry)6Y#hCHT?KK)Z>&EYgw})t8;U%`Qjr&}AB@dQw`$#LBgmMw_ohTJf=x z@XY~v;bjRY6qm8gUNM8#fnHzTFU@~kQAmrBqA4hzXVN;>aDW8^)bH!O94yq1EwmebdlVc<8aS z2d9Zi()ugxF$w8;F6(d6Df2(jYz?DlpYYYn>$d;x)K;DlNs39|Xk9eGP97)7zmv~z ztK!)e@Qg<^0G9wH0cQVU z?E2%;1)fg?K;NSyKsLZ|%XlF9wL$r>0Z@I|0zmf1Gk6RV0DPqY5CgaafZFMS$Y?a< zqQ1om0M&(meZ>CY}_0QJFN0Y+1f!%-G$n~VYG4UrB1spP;f5`Y~5VF1G+hu@t? z6VTxWu<<`7$N>@y{6TUT2S@?<-7*`g@*e|jTmxjyUmqQKA^?#57t6hCeF_I!*Z%c_ z?Snwz!76~irJe68wY2djQdY*2LN|6;b3j^V}wgJdM_Q?Bn;I};_p!17JN3f$U;jVw?*Oe~{}F3TS5qD?{#y4fn^^9|&n>O3 zm~q^V|Jrvv9P}c4gb8E0Edc!JZoUtFPb}~5o@<)wF{v>9;o!-CEsrSR@#L{s2axOm zatms{b|>;*-Z`Z``mf1uxadW;Nt9!$4s^&qOFTrc`4>U=@ZxEH%5d@HznISp;Q5$n z2LO**02u(7OqgL?590pibxdJek8;}{sER2QE@9TmKA7i+FwE-p9n2u+I;IkR8Iun; z!NfyPW1_*@m_X1e$m8TM`RoW(!vupgu$>_~m}ICvw&$@Cwm;%5cIe3k>}b?Q?8H+` z?9_8xOy}jb_IyoXJaQr7CU!B&6T6b^h1sOs#q8erw8OQx_pz&~zU|Leuf5yD%@c27 zrtxl=!K>?-2IQj*c_O@a2J8HS3*yTNK`7)q{&%(mQ2rDEq_=FR5y`EpvF;aHclY8> zW@NwkvOm%kb4w4#vMLL^%Vx~IYiw!43aY#luHH>*eUzY-}_n7eafV@tqnUIW!5kGcjk+J4?H>FUKet{757=jSd4(? zJ|8OzvB2CI>{8NgOb*%%V)_R8eBpPr0f6h}?(mfe)y4W61A1jd44Li&k>{}+?*g&( zvQJpQJDo9DDe|jJF~6**nC5dk4E0;x@w6ZB6h^ZS06u$r!)b505tjP(R~0~0YYXNM zZFzTnc5nIh6($S)yWJaK40KLdGnDbCy0ZEz%;#g&VA@8spMiBW>Hw63)^hq`gL@Lj zST@+r_rch`tSHR(%{@%!vEg9rcfZr^f-&DY=x-zQlCbKg{*6V(Vtq*}`GB2)@#O%% zm28j;^+?tM$RDlY{xR!#0)gt7_6vLLLH1LusHSWzin&jm-j{#IPRBU*xBmN%u>6r8 zy1%%Lxp+qj7qQzJkFifxU;5=f${0u1gx>8-|EXAWi%QAi7+;h z?tT3v71-J9@9{!&+Y?q5iqN z3&2Y2D!ZaJ=KLjqqjL1c-sqPdjtT&>WCR$Joh}-Og?@@16c5o_VO;Th%pK+tXe=iZ ztl1mQ!xAPKqz<~^+gKjV&BwBF`!xsdLyKr17mLAsZz%ZnmKNz_ETA5Y<+%guv-F_v?17FU=>{QBv=6VRy!-V& z2y~qz=~~-bv3H;Y^!o4^`f+>Ev1{}TuYu4d2zqrtV3AcZuwHn)!@ z(L7|R_GhS{LArXhmN}Ljs_WgzJ-R0ZuJ7lLZ)*X^t(w9u^GT3|U3eoMB zj{fjK19S&yE;g22H}j1<>`h!99Bq~37EU}|cT+kRAtrsCZ&;Zt3e(*;k zR1bSm^tR7(Mk@l?Ut?k+zvx%Z`Xhgk`x1cG!OCAc%%EMjH(Im~cR9IWTVe(FUjx-M zpmC;iS^(Ap^O3RO?tdiwsGl9OEQMc+zUlzPxinbWqjXnO{l)_ML&l-9p$2S?f-vy` z_6^9U5RJuuw?q1M#mIAA>p-tML69FhJMqg<tp7CaS2(+jD*E1=? zJZvoJ4pBecMV3!``~D%WV3+t^)A#B}ZRVeBf74sVLG1x*+mLR!KRiNXf;ZjRK=oF} zaEG;lrlO0TC0f5-&{G|NFwg$b)>9nyXV$|_!kEi157ws)W1ad{2hbex*)Zz92g3}c zuj(Q%&FrdCyGNHzu(XP+0TC$nZKo6q-#cF{=V#Xk&Qt>&dc9|BP!G>?IE!YQ6Dg;YaM`h z=xi3^cmsZZ3440}i!P%guWLWs4ew53kFsC<7WN=}w=S|h*p2)%yTs|5rcZy`*H6EN zzOhg!YG=_JVQ;osC@duR)o(!;t%VWE_b##g;r%?KFyeRvdd{va`Yp7Lr9u-+GQiIL zr~dXQ9wK|D=z^3{M;Y0@63H0N@qe684bOXs!ieJy=sB-yY}?C>7SqeYuCW)poc4Wy z$)%&KCqersyT}+_5z_A9y?vLku5tV2&#C+~_vMX5y+C#;uCPC?r}YGJ&?lkw+R=0} zVP}Ztc!)^;FNZ_^@BYL6e@}8G2Wy}IT<;t}I>R%u&cE;&*(Q$0nxPWxdn1xJ zFFe~2`H8~@{EYT*jV)`q-evK-LQ#K@k8}Nnzba2JkN8*s?Tsgr_W^kJBk~i64eI$% zJ)32;>jG+v&&Ip`!eewk#z;E1_d&#E>Vxdjd2+<>hV<+Uc1QnQ|2Tl!0mCkR0a{B! z>j@*}x~vDI{ru^}DSvd1%|F+F4j|i8P1v_YECVHi#fbF-XfGvES@+->*##268`3k< zZ;v&5=>ALN_ryf=0_A9npZI>~L&S(6lUY$fTuv0ozIr(2kMct2D*ST;;{ehRpmVc2 zWr6nbl++FX*%Zh&yt54WeG4$`_a*NQH~yn-zy~I|;fsy*gv55|=ip4z;dW@9nn?ad zM9;+Uhy0B8Q~YxS=fHQH-S21GqCExa<->1NL8JphcaIHO*4^cS&gvX1dm#och2NXP zG1dQvOwgXB;dWyG-_wBF{vn<1(Vgr&-;MO%|KaA#Sji9R22MV+`cVhac|XJH(3#ks zGJ@Y>S^Fc(??>KJpbz{u2KK@XC+|ipFLdSzI?EFARRh)thtuu(c`dS}JJ}7_yNj^D z_MaOZ2f~QUZaJ=GFJLB7B_7u%SZK{-b^2 z&%2Y^aK1xlf{*1hl!lG5Baji&rJ=ptNH08GJlqwc*V#v-{XP$dQ`SA@bp&i5`a1h> z1ladiWa;}cx?NtbupfCi9MKtB`5-Uro@6%M?{#9XVMzb*&kc+NXg+}UaiVeCP|uq| z>51g}4xZJC{KR1+@@xeC*l5|i4UEfUJ9b=gdb>Ol;f{l$I5Zz4l6MR|ixK&W!$$1+ zG@NT+-`qG9GX9fk(fOxCJyQ?u(IArdLwH_FMDl9CTO9mD-uq3ICvpD$envJg z@5*uqOV)oT9kQ>zlz4a0^rHI+iDb2-|NcbpQ*seKP9_-TpW5r_YlXLL`db;>=g@DIJSX{75QI*SV3BRLp{>@z!L zjm`m?h`xX1;CaaBKMZ#rLbim)pf5mkU$me0pZh-t2D`2*7mn|ge{Q?rJN|*}kS%a$ z*qHm>4SSc-`BKSnzTm&H;{WTxK%UV3n?z?7g?5qukk0-a&ANlmVnlZ%qB}s)J0{+wW<31$T>~ zGl|fhQmD@ys_y(xuM^SvDa8CfN-Tf$3^E$h`Hv$j$oU>!^b>>tqm(JF+? z?e{LDyCG1$aY=uO-T4^Venu0jJIGcZ-LdqyxLX-v#Pa9tM*bpWU538{KeVq^^{EwR z1@}hyXFqGdZ|F}PgP8t*zabj?Pw7Vfqgg!a5#gY%)&#;6VxojX7@_W$YpzfResUyvI*4+gal zopt5k?*Msm@W}=2Zf0crm~*U*9a6!5lt`x9#4_*t4DmvU;u5F(_dI~QAPjv3TCdNB zv-f_tdyxHC$N|KV)^PGUx|&mWz?^t&9<*>C7>pI+~Ug>cjlB>k%c z!&wJVUf=5hI*)m@9no3!Z-~G3o}NMWL%RR*U)|}s?w~u7ty6qPZG2D$c2-34aOg?q z#P1?Pg|DFdh4(N%8l5j^%5S#~&?r9lG_Y}^XCc;6USkApYLmC01bi{f5 zdmaY)ck&jU0h&L8cg;J#eLyU)MZL+qYZ&18Z!R#5vhI|5*I#tr$3wV3Wh7dH>eEaePo+|**9m1V?{QDh2Ug*QRCR(c+E{Dz*BGUVK^d;}^!a?@`bb=!&^RC|( zItOUDY$3bY`~Gt8OLy|_`VR1$1d!Dg&wu`rYZK8KE$FPip}MPY?-RGzi@VCUzkZN4 z(h2?33y)$ufW9x6w7?z~|)lTU_V2Rl%kZ{qVq02k^0%DK0AkPj2Uh@BZUoILy6 z@-l#XX9rRTi0nO(&Yz|?xeg=@@{;}Ac>AZ&gU$@^j~yf0BPtI1#SXfVG+4%z6npWlnVd31k> z#&cU@{x0mAX0-f(7t#-m+S#H|7BSs_%QLdOIo6xZAeMh-9 zg#li20KesYImDAc7|`83T>X&~#B=P1PNV*$9gR4E+ZuqhZgBjQ6;nhQj{?QwtaXvn&^G62Wz0NF&i z{^>FsF8tA1%qx52U2kEKb~*q$&mZAq-do(?9R~PK2Dk!%#y7*ozdtpfO5lMyz%S$b zfyxQ;xZJ_d^#e`&JK_Vbs{kH%;QXh`Z?JeHTS`}e*~7(q$ZG+>M*x!H%5yaG0epo4 z{!2QeV4#+_7eH4% zM_0c8PCv4>aRA^381Nkack}sAC?EKW_M(XbTmu*jdW1KChdBU}Ir*Q!!@mhf;5o86 zKx+)BKEwmm0gO}|fadB?0Z^ZW+M}6&6EFV;T0kab0LuZy0W<(?0sH~bI_Y}=)JCH| z1dYo&>j~1kBHbCXt9lDS0PqDs`jq1ULICstf7HCXKk{rh8o(-XII8bY-~XeOM1BbV zDFPn(Nq$6VLtY%txbsDObR3Sp(@$s*#!+ zB5tCby87w6gwy{-9uU~opZhaDR9*ZOUHt^yPmZFCpR6xG{-@+Pl7aevPLBKQ+J`Rm zjX7@@dEo}?C;Uti$w2+NUDEgAC+kw*fAM$uUda0JQ*`-0fAM$uo+-L~?^M6|@jnqn z^>h0Hy#(Q>aC$7a5C6{u(_=pq#Pf6ei2K$5GXceet*@TfVe|PEcg){9w0(T@Cpdw1;7K4;12RE_@(%L31i%I`3>c0~7J%Dy06l<_oV%w({;B}Io^v`f6n390;DYEzdV(5& z&Uwd3|CU2pMgYH@_1`^~!~Yh_M)R=~0A&CpO>a;67eU$k0Y-Iv2IZl7=qrGp@EYy+ z$gYfT_@(@7j!+Kb_h{Dj{_+xi6Joz&JUnmSmgbI+%1^cp`yAWi{ywO6SBQ3h@fyu| zZNLN6E)47U0QphCT^K)IPMcYoj|swFRR|l4-~xCJ+3p6_97MZdka{q>XQ8V*{mNl1 z(%y;F?V<7jr3dgs_jb0l{(4WNQJhm}S@3%jQ;al)bMd|4E}f^C&&MZlhe{ackrDg@ zkpCXM_s@>T0&`zr@GW6a@)NOVg(+A}Q7RVuB@K)F@(z1d{1$sr^ahK{Pr`z8UqYHl z%qh(uJD=c=op^Q`6YKxC=LGlO4KXm^gszcf@f82pej2k*5M_?d4fcU6?AND>D zo!NE#>81AX;!{=ei16ZVS$6w3(nSs>;GfeU9zZ83>&SLM%bNiQRAF)td)j=E5GmY|(MfCh-5gjz91)O>i6X_wcglZD)Qjy3oI=H`>KR zb%%6T>rX`X!-K{K2CM(`Roc-3GK*G9BPX@Xl3Z+0r-E6bGze%)=S%=6glX$ zsQ-|QFzUp&{r6DR`5}!L9)FJO%ukPq{><*^?tEu4gm!<>#CIe__taXY-08%*{Z|pb z51;n_twDwvET}8zG8^(PQ0{WzB8EfgF`;WbmqYgdG$KxL1mf1Tz0IuI`|&W5Vegq zgQ%ORpXuPC8vH)!cCF3-Khk5B zH+(;fso#Z+Qbg1yB3%m7!}RxFd!&~Iy3zR^{h}Z7=o;KPF;-oEO=-Jc_~!ecmMMBf z_fBR6q94)TulkSZNAvRRZ@>S}*Pe)qfPMh!I?&xfeL18bLo@;OtNrVUiz!E&V~s7% zeP#dK!i`}bjcDu3b;uvt3isLnb<*DXi*$8JhcOo2m%55}{bOIa-2xpZ(1X@Y`yBst z(oOtpnd05A^UC|eV$A)5-cHh|XihUz-z zzV|z6N54P=TK^i$dyqTpEOz?UH7vdS)1cWP_uY0wmze$z9t?UcG#Yh)xD2#bd;x4< z25M7MT36Z0$6wCtfc*Ph|0c#^EIgz6Ug!Yy9)yA3n6wL_NqVi`#sT)-UFV<7S4Y(@EwUVPCUH~_X@VOvjDC8qA?VdbGSE} zyM{sh2>@Xuf!_${iS$|(&hH+z)Bh6ei@}fdy>q+L*q0yDARhcl_235Ji|Xz^WJ`ne z5*L%(^*wQY(b`jZM}Btj+u4SW#a|>}BY^h(5Ach=;c%T8drTbe(tu}!p6KiEd&olp zU@Z2H-R^$@T$un`01*AF`b%eT@gSe&0Ap$Y(__G=$Nf(b<^k}&H<|_-2Kk}y>m&f; z`|tV|ilA&XPU&^O4}`A-I5$ul`x77Xr2#;Ddq;EbjCg(qpx^r+AueTq=oxGr$REue zM|%G&+6$}-&~Lg2OV41_0dBNa87QGJIO;e;p!4hi0uD!phD<0Y_-Q{jfv4j* z1^SLt5a5sjh}IqvkAC5d0`vn3+P?o9cm8&qy1>(MSVHGHF`ehbQ00D)Pto~H`0npK z--Qg{;qUnEJjdn7@Au%}_rC+L_Hz~x7G3;vhF&p`Z;9~x^X0SpwM!Nz|HWev;M3VV~JVUJ9u z%F~PJTO2GtgGpBo8nwgzND~a{d(mD)L@$b?3-esGHlz=r z2hW=DP6hUR?2E(`?}7V~cV`(Lzo?zsKM?#Oz9c{kTD$GEheG?Ay6(f3gmp}$e?T_0 zgRvb$mR60Rze4&vv_Bl#E~-7Z>~6mlvgzmR4-F6xeXFP)Xy*sADfi2cYUf?&yY7CG zt?}6ev?d!jo(+kX zZ(!?z_Pr9_QAYs$$a|sz!chB8Omq7);w|DUvgt*6CW2j&=ZDaCnV`E+yGzsg4(T?L zU0%iz_NhHBeBG%dMP+q+KOekD{pv4$6XGS>8{d;d-v!#=dp|3xeg8sld-jo@`hUfp z*^d=P6ogs2bV4rtUD9{|M{jSvTe0+C@4;2>a7NKgVQ zQ5IP)APmShGQz;H%%H5!03%_EfLwoHO;^)Xx4LilojaFG&aJNQT2AeCPMvdZsruo_ znGBJvvT#I?*T^?S`$6w!3kuru>%(i}Q1`xPKGwG$kq+m|JbIdLp5VYbcKyHXvZ9Q~ zAiqx>-23Q#0iOXmi8ObA-iqiYy4(jZH0NvTmqz>F;4n&S>zOOrbPHGu1Nk!a?n7Hu zdgjbw>lXS`>X*c!miaw8y66rwmuy+AFZ)`XGUe5L>9n2CZ_o$Ii}U*~n`hL=9z?m_ zxvLk9Z42)CDU0#M-E|g+EU?nT8wCHpf}4V{UF>s1Tl~DuQl2j^vPQ22I?jWC8lB&8 za2WW$T6ZYuSS6acBH7F5(&XJYYh+yAFPo6VXoNK+- z&OQcB8#{h%pP(CFX?I>aW$%cFW3BYLwhsJh``Gzw@y9OKk@l|3NBZzcdWZbkrkK5% zeO!AuJgC_9)8dbh{7zGa>j1s+Rij^T3^^L%#r%!kzoPi_{9HiC6kFSp+BEC8UFRCT zGQynugcIks*z<#nKVi;Y@DiH3Ku=|<1AH5w>>Bi-@L4YCEAXD*z&8oTY@426CHrHi zb&jX6yUTILa9yBhIZ^nV* zO)VS@Ur7G@QGB}V89u`El3|0Ng{(UI`lUMTlnKvA0vg6kKXz9=Y`*jx{3^~pS#&?p z;}YEi&%G!3K+mwZ zCOPqC!GBVSeDI)mW8FOOM0lv^dg#kI_rVUMLb2O~H*_ZEh9qj$lFz#~TVXHq*fLj#T zq-VutEQR+Odal$S5#HaaOy=cU?B&RxnS`(Jo62o{YXv z`>b@Vt>Xj*cLaJ@u6l7Mcu#PTiw@IpjC$l+Q>(#pE~KI;w2eseXbHg4u#if@T4H4c1?P`F~8XUNA%Os^C6B>UG2| z*M>X9#3bM)!KB9#9Wr7>@^eUm$*)EVOg;(p(;+r?+c)xG{i>>zO#e|+Rn>y85o-M$ zVOeaqel=lXZGD1w(p3kATR#_sjW0Y~2uFNVPu0iNTfS+Jh;Q0yV$g1N@|Dru__XUq z`L>-Ek+w%ptH0n0K`5uyTY(at#zb$yFu?)=cgfrrGKM&hv+6OT>l#>Yt`9 zWCMGk>_eUBTo=$YZkfc$h`E1- zciD33jOhJy`IDFbHqVV0Tg-hEvKh#bpw~qn0f0kaUpweM{rv~=Mu^A#>7GUQUfiZN zJ~R~hVn6=c&EhuhI9u+~9XmWF@)j^p3gpQ2jd1HUzQv{<<9_=h)aCQ#H)FrCh4`$>{4!cT zHb}bau*bpJoS-=r$J5^1YUthRDtk|~eEuh*9FDQUIA+c8Ir>a}y;)_mkC`^ZhpsJ` z-E!6?)}I5C74bREX=pa~(6D@-SL**x%H?PWWKw+mU9Cxs`-1YZv7TmaON%2sd7sP& z{92XYsr_wRu;!K1Vb9%l((_|~?lk^v`S`PB^U>FCZa!(kr(|!?)v;E;oKrcRr#kh2 zG>okq?u5(X-1`#kbJV@l`V%cX`aJ5_n*6e(znHz3`-0NsGH-K%xxWnD7mG>srn3g4&^_VeNcX<{ij&D#lCarvQ+HSe_X*^@aBe&4*A^1X7$djFW9J8w0=&slM?^j8mCj`A2J zc*%x~`HK6HV3D8{`tyEY{>m#>*4Y=IcS;kbzgf4>3z)+``a6^%jmyuz&*!A%6|fJ) zdqCf=SBp3;Ik6XjYOxQ1s*Fx)3@;|9v_OkMdEccn&{Z3xGH*~edC#Hd|~4%L$gAIxp$OHn$|Ezxcj253{CGlOCXD|UgtFQMvne-`+ucw z+`5^Uj?YY`rJeK8kV)>MXvFcdZF%;pVIi2P!hyAf{xR*7l%8*#&8d?;Ev){t4t|bF zPrE|%7jw|6_S~)WC;e&g2M5mN^=-xFn>pv;barK~nf4>S1=}_$gxPm>9x>~k;y`b1apT5? zb$&R!`ownDmynOGXY!aYNSZ&4IWvEr`FV`jhK9b!&0p>i!uhLbv-Y%$2b>c>v|1sc Pn5$L + + + + + + +Getting Started + + + + + + + + + + +
+
+
+
+

If you are getting started with Spring Cloud Contract, or Spring in general, start by reading +this section. It answers the basic “what?”, “how?” and “why?” questions. It +includes an introduction to Spring Cloud Contract, along with installation instructions. We then +walk you through building your first Spring Cloud Contract application, discussing some core +principles as we go.

+
+
+
+
+

1. Introducing Spring Cloud Contract

+
+
+

Spring Cloud Contract moves TDD to the level of software architecture. +It lets you perform consumer-driven and producer-driven contract testing.

+
+
+

1.1. History

+
+

Before becoming Spring Cloud Contract, this project was called Accurest. +It was created by Marcin Grzejszczak and Jakub Kubrynski +from (Codearte).

+
+
+

The 0.1.0 release took place on 26 Jan 2015 and it became stable with 1.0.0 release on 29 Feb 2016.

+
+
+

1.1.1. Why Do You Need It?

+
+

Assume that we have a system that consists of multiple microservices, as the following +image shows:

+
+
+
+Microservices Architecture +
+
+
+
+

1.1.2. Testing Issues

+
+

If we want to test the application in the top left corner of the image in the preceding +section to determine whether it can communicate with other services, we could do one of +two things:

+
+
+
    +
  • +

    Deploy all microservices and perform end-to-end tests.

    +
    • +
  • +

    Mock other microservices in unit and integration tests.

    +
    • +
+
+
+

Both have their advantages but also a lot of disadvantages.

+
+
+

Deploy all microservices and perform end to end tests

+
+
+

Advantages:

+
+
+
    +
  • +

    Simulates production.

    +
    • +
  • +

    Tests real communication between services.

    +
    • +
+
+
+

Disadvantages:

+
+
+
    +
  • +

    To test one microservice, we have to deploy six microservices, a couple of databases, +and other items.

    +
    • +
  • +

    The environment where the tests run is locked for a single suite of tests (nobody else +would be able to run the tests in the meantime).

    +
    • +
  • +

    They take a long time to run.

    +
    • +
  • +

    The feedback comes very late in the process.

    +
    • +
  • +

    They are extremely hard to debug.

    +
    • +
+
+
+

Mock other microservices in unit and integration tests

+
+
+

Advantages:

+
+
+
    +
  • +

    They provide very fast feedback.

    +
    • +
  • +

    They have no infrastructure requirements.

    +
    • +
+
+
+

Disadvantages:

+
+
+
    +
  • +

    The implementor of the service creates stubs that might have nothing to do with +reality.

    +
    • +
  • +

    You can go to production with passing tests and failing production.

    +
    • +
+
+
+

To solve the aforementioned issues, Spring Cloud Contract was created. The main idea is to +give you very fast feedback, without the need to set up the +whole world of microservices. If you work on stubs, then the only applications you need +are those that your application directly uses. The following image shows the relationship +of stubs to an application:

+
+
+
+Stubbed Services +
+
+
+

Spring Cloud Contract gives you the certainty that the stubs that you use were +created by the service that you call. Also, if you can use them, it means that they +were tested against the producer’s side. In short, you can trust those stubs.

+
+
+
+
+

1.2. Purposes

+
+

The main purposes of Spring Cloud Contract are:

+
+
+
    +
  • +

    To ensure that HTTP and Messaging stubs (used when developing the client) do exactly +what the actual server-side implementation does.

    +
    • +
  • +

    To promote the ATDD (acceptance test-driven developement) method and the microservices architectural style.

    +
    • +
  • +

    To provide a way to publish changes in contracts that are immediately visible on both sides.

    +
    • +
  • +

    To generate boilerplate test code to be used on the server side.

    +
    • +
+
+
+

By default, Spring Cloud Contract integrates with Wiremock as the HTTP server stub.

+
+
+ + + + + +
+ + +Spring Cloud Contract’s purpose is NOT to start writing business +features in the contracts. Assume that we have a business use case of fraud check. If a +user can be a fraud for 100 different reasons, we would assume that you would create two +contracts, one for the positive case and one for the negative case. Contract tests are +used to test contracts between applications and not to simulate full behavior. +
+
+
+
+

1.3. What Is a Contract?

+
+

As consumers of services, we need to define what exactly we want to achieve. We need to +formulate our expectations. That is why we write contracts. In other words, a contract is +an agreement on how the API or message communication should look. Consider the following example:

+
+
+

Assume that you want to send a request that contains the ID of a client company and the +amount it wants to borrow from us. You also want to send it to the /fraudcheck URL via +the PUT method. The following listing shows a contract to check whether a client should +be marked as a fraud in both Groovy and YAML:

+
+
+
+
+
groovy
+
+
/*
+ * Copyright 2013-2019 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.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request { // (1)
+        method 'PUT' // (2)
+        url '/fraudcheck' // (3)
+        body([ // (4)
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount : 99999
+        ])
+        headers { // (5)
+            contentType('application/json')
+        }
+    }
+    response { // (6)
+        status OK() // (7)
+        body([ // (8)
+               fraudCheckStatus  : "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers { // (9)
+            contentType('application/json')
+        }
+    }
+}
+
+/*
+From the Consumer perspective, when shooting a request in the integration test:
+
+(1) - If the consumer sends a request
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the response will be sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` equal to `application/json`
+
+From the Producer perspective, in the autogenerated producer-side test:
+
+(1) - A request will be sent to the producer
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the test will assert if the response has been sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` matching `application/json.*`
+ */
+
+
+
+
yaml
+
+
request: # (1)
+  method: PUT # (2)
+  url: /yamlfraudcheck # (3)
+  body: # (4)
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers: # (5)
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id'] # (6)
+        type: by_regex
+        value: "[0-9]{10}"
+response: # (7)
+  status: 200 # (8)
+  body:  # (9)
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers: # (10)
+    Content-Type: application/json
+
+
+#From the Consumer perspective, when shooting a request in the integration test:
+#
+#(1) - If the consumer sends a request
+#(2) - With the "PUT" method
+#(3) - to the URL "/yamlfraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
+#(7) - then the response will be sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+#
+#From the Producer perspective, in the autogenerated producer-side test:
+#
+#(1) - A request will be sent to the producer
+#(2) - With the "PUT" method
+#(3) - to the URL "/yamlfraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id` `1234567890`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(7) - then the test will assert if the response has been sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+
+
+
+
+
+
+
+
+

2. A Three-second Tour

+
+
+

This very brief tour walks through using Spring Cloud Contract. It consists of the +following topics:

+
+
+ +
+
+

You can find a somewhat longer tour +here.

+
+
+

The following UML diagram shows the relationship of the parts within Spring Cloud Contract:

+
+
+
+getting started three second +
+
+
+

2.1. On the Producer Side

+
+

To start working with Spring Cloud Contract, you can add files with REST or messaging contracts +expressed in either Groovy DSL or YAML to the contracts directory, which is set by the +contractsDslDir property. By default, it is $rootDir/src/test/resources/contracts.

+
+
+

Then you can add the Spring Cloud Contract Verifier dependency and plugin to your build file, as +the following example shows:

+
+
+
+
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-contract-verifier</artifactId>
+    <scope>test</scope>
+</dependency>
+
+
+
+
+
+

The following listing shows how to add the plugin, which should go in the build/plugins +portion of the file:

+
+
+
+
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${spring-cloud-contract.version}</version>
+    <extensions>true</extensions>
+</plugin>
+
+
+
+
+
+

Running ./mvnw clean install automatically generates tests that verify the application +compliance with the added contracts. By default, the tests get generated under +org.springframework.cloud.contract.verifier.tests..

+
+
+

As the implementation of the functionalities described by the contracts is not yet +present, the tests fail.

+
+
+

To make them pass, you must add the correct implementation of either handling HTTP +requests or messages. Also, you must add a base test class for auto-generated +tests to the project. This class is extended by all the auto-generated tests, and it +should contain all the setup information necessary to run them (for example RestAssuredMockMvc +controller setup or messaging test setup).

+
+
+

The following example, from pom.xml, shows how to specify the base test class:

+
+
+
+
+
+
<build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+                <version>2.1.2.RELEASE</version>
+                <extensions>true</extensions>
+                <configuration>
+                    <baseClassForTests>com.example.contractTest.BaseTestClass</baseClassForTests> (1)
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
+
+
+ + + + + +
1The baseClassForTests element lets you specify your base test class. It must be a child +of a configuration element within spring-cloud-contract-maven-plugin.
+
+
+
+
+

Once the implementation and the test base class are in place, the tests pass, and both the +application and the stub artifacts are built and installed in the local Maven repository. +You can now merge the changes, and you can publish both the application and the stub artifacts +in an online repository.

+
+
+
+

2.2. On the Consumer Side

+
+

You can use Spring Cloud Contract Stub Runner in the integration tests to get a running +WireMock instance or messaging route that simulates the actual service.

+
+
+

To do so, add the dependency to Spring Cloud Contract Stub Runner, as the +following example shows:

+
+
+
+
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-contract-stub-runner</artifactId>
+    <scope>test</scope>
+</dependency>
+
+
+
+
+
+

You can get the Producer-side stubs installed in your Maven repository in either of two +ways:

+
+
+
    +
  • +

    By checking out the Producer side repository and adding contracts and generating the stubs +by running the following commands:

    +
    +
    +
    +
    +
    $ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests
    +
    +
    +
    +
    +
    + + + + + +
    + + +The tests are being skipped because the producer-side contract implementation is not +in place yet, so the automatically-generated contract tests fail. +
    +
    +
    • +
  • +

    By getting already-existing producer service stubs from a remote repository. To do so, +pass the stub artifact IDs and artifact repository URL as Spring Cloud Contract +Stub Runner properties, as the following example shows:

    +
    +
    +
    +
    +
    stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot
    +
    +
    +
    +
    +
    • +
+
+
+

Now you can annotate your test class with @AutoConfigureStubRunner. In the annotation, +provide the group-id and artifact-id values for Spring Cloud Contract Stub Runner to +run the collaborators' stubs for you, as the following example shows:

+
+
+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
+        stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {
+
+
+
+
+
+ + + + + +
+ + +Use the REMOTE stubsMode when downloading stubs from an online repository and +LOCAL for offline work. +
+
+
+

Now, in your integration test, you can receive stubbed versions of HTTP responses or +messages that are expected to be emitted by the collaborator service.

+
+
+
+
+
+

3. Developing Your First Spring Cloud Contract-based Application

+
+
+

This brief tour walks through using Spring Cloud Contract. It consists of the following topics:

+
+
+ +
+
+

You can find an even more brief tour +here.

+
+
+

For the sake of this example, the Stub Storage is Nexus/Artifactory.

+
+
+

The following UML diagram shows the relationship of the parts of Spring Cloud Contract:

+
+
+
+Getting started first application +
+
+
+

3.1. On the Producer Side

+
+

To start working with Spring Cloud Contract, you can add Spring Cloud Contract Verifier +dependency and plugin to your build file, as the following example shows:

+
+
+
+
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-contract-verifier</artifactId>
+    <scope>test</scope>
+</dependency>
+
+
+
+
+
+

The following listing shows how to add the plugin, which should go in the build/plugins +portion of the file:

+
+
+
+
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${spring-cloud-contract.version}</version>
+    <extensions>true</extensions>
+</plugin>
+
+
+
+
+
+ + + + + +
+ + +
+

The easiest way to get started is to go to the Spring Initializr +and add “Web” and “Contract Verifier” as dependencies. Doing so pulls in the previously +mentioned dependencies and everything else you need in the pom.xml file (except for +setting the base test class, which we cover later in this section). The following image +shows the settings to use in the Spring Initializr:

+
+
+
+Spring Initializr with Web and Contract Verifier +
+
+
+
+
+

Now you can add files with REST/ messaging contracts +expressed in either Groovy DSL or YAML to the contracts directory, which is set by the +contractsDslDir property. By default, it is $rootDir/src/test/resources/contracts. +Note that the file name does not matter. You can organize your contracts within this +directory with whatever naming scheme you like.

+
+
+

For the HTTP stubs, a contract defines what kind of response should be returned for a +given request (taking into account the HTTP methods, URLs, headers, status codes, and so +on). The following example shows an HTTP stub contract in both Groovy and YAML:

+
+
+
+
+
groovy
+
+
package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url '/fraudcheck'
+        body([
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount: 99999
+        ])
+        headers {
+            contentType('application/json')
+        }
+    }
+    response {
+        status OK()
+        body([
+               fraudCheckStatus: "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers {
+            contentType('application/json')
+        }
+    }
+}
+
+
+
+
yaml
+
+
request:
+  method: PUT
+  url: /fraudcheck
+  body:
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers:
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id']
+        type: by_regex
+        value: "[0-9]{10}"
+response:
+  status: 200
+  body:
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers:
+    Content-Type: application/json;charset=UTF-8
+
+
+
+
+
+

If you need to use messaging, you can define:

+
+
+
    +
  • +

    The input and output messages (taking into account from and where it +was sent, the message body, and the header).

    +
    • +
  • +

    The methods that should be called after the message is received.

    +
    • +
  • +

    The methods that, when called, should trigger a message.

    +
    • +
+
+
+

The following example shows a Camel messaging contract:

+
+
+
+
+
groovy
+
+
def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        messageFrom('jms:delete')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+        assertThat('bookWasDeleted()')
+    }
+}
+
+
+
+
yaml
+
+
label: some_label
+input:
+  messageFrom: jms:delete
+  messageBody:
+    bookName: 'foo'
+  messageHeaders:
+    sample: header
+  assertThat: bookWasDeleted()
+
+
+
+
+
+

Running ./mvnw clean install automatically generates tests that verify the application +compliance with the added contracts. By default, the generated tests are under +org.springframework.cloud.contract.verifier.tests..

+
+
+

The generated tests may differ, depending on which framework and test type you have setup +in your plugin.

+
+
+

In the next listing, you can find:

+
+
+
    +
  • +

    The default test mode for HTTP contracts in MockMvc

    +
    • +
  • +

    A JAX-RS client with the JAXRS test mode

    +
    • +
  • +

    A WebTestClient-based test (this is particularly recommended while working with +Reactive, Web-Flux-based applications) set with the WEBTESTCLIENT test mode

    +
    • +
  • +

    A Spock-based test with the testFramework property set to SPOCK

    +
    • +
+
+
+ + + + + +
+ + +You need only one of these test frameworks. MockMvc is the default. To use one +of the other frameworks, add its library to your classpath. +
+
+
+

The following listing shows samples for all frameworks:

+
+
+
+
+
mockmvc
+
+
@Test
+public void validate_shouldMarkClientAsFraud() throws Exception {
+    // given:
+        MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/vnd.fraud.v1+json")
+                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
+
+    // when:
+        ResponseOptions response = given().spec(request)
+                .put("/fraudcheck");
+
+    // then:
+        assertThat(response.statusCode()).isEqualTo(200);
+        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
+    // and:
+        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
+        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
+}
+
+
+
+
jaxrs
+
+
@SuppressWarnings("rawtypes")
+public class FooTest {
+  WebTarget webTarget;
+
+  @Test
+  public void validate_() throws Exception {
+
+    // when:
+      Response response = webTarget
+              .path("/users")
+              .queryParam("limit", "10")
+              .queryParam("offset", "20")
+              .queryParam("filter", "email")
+              .queryParam("sort", "name")
+              .queryParam("search", "55")
+              .queryParam("age", "99")
+              .queryParam("name", "Denis.Stepanov")
+              .queryParam("email", "bob@email.com")
+              .request()
+              .build("GET")
+              .invoke();
+      String responseAsString = response.readEntity(String.class);
+
+    // then:
+      assertThat(response.getStatus()).isEqualTo(200);
+
+    // and:
+      DocumentContext parsedJson = JsonPath.parse(responseAsString);
+      assertThatJson(parsedJson).field("['property1']").isEqualTo("a");
+  }
+
+}
+
+
+
+
webtestclient
+
+
@Test
+    public void validate_shouldRejectABeerIfTooYoung() throws Exception {
+        // given:
+            WebTestClientRequestSpecification request = given()
+                    .header("Content-Type", "application/json")
+                    .body("{\"age\":10}");
+
+        // when:
+            WebTestClientResponse response = given().spec(request)
+                    .post("/check");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+            assertThat(response.header("Content-Type")).matches("application/json.*");
+        // and:
+            DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+            assertThatJson(parsedJson).field("['status']").isEqualTo("NOT_OK");
+    }
+
+
+
+
spock
+
+
given:
+     ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+        \'\'\'{"bookName":"foo"}\'\'\',
+        ['sample': 'header']
+    )
+
+when:
+     contractVerifierMessaging.send(inputMessage, 'jms:delete')
+
+then:
+     noExceptionThrown()
+     bookWasDeleted()
+
+
+
+
+
+

As the implementation of the functionalities described by the contracts is not yet +present, the tests fail.

+
+
+

To make them pass, you must add the correct implementation of handling either HTTP +requests or messages. Also, you must add a base test class for auto-generated +tests to the project. This class is extended by all the auto-generated tests and should +contain all the setup necessary information needed to run them (for example, +RestAssuredMockMvc controller setup or messaging test setup).

+
+
+

The following example, from pom.xml, shows how to specify the base test class:

+
+
+
+
+
+
<build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+                <version>2.1.2.RELEASE</version>
+                <extensions>true</extensions>
+                <configuration>
+                    <baseClassForTests>com.example.contractTest.BaseTestClass</baseClassForTests> (1)
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
+
+
+ + + + + +
1The baseClassForTests element lets you specify your base test class. It must be a child +of a configuration element within spring-cloud-contract-maven-plugin.
+
+
+
+
+

The following example shows a minimal (but functional) base test class:

+
+
+
+
+
+
package com.example.contractTest;
+
+import org.junit.Before;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+
+public class BaseTestClass {
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.standaloneSetup(new FraudController());
+    }
+}
+
+
+
+
+
+

This minimal class really is all you need to get your tests to work. It serves as a +starting place to which the automatically generated tests attach.

+
+
+

Now we can move on to the implementation. For that, we first need a data class, which we +then use in our controller. The following listing shows the data class:

+
+
+
+
+
+
package com.example.Test;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public class LoanRequest {
+
+    @JsonProperty("client.id")
+    private String clientId;
+
+    private Long loanAmount;
+
+    public String getClientId() {
+        return clientId;
+    }
+
+    public void setClientId(String clientId) {
+        this.clientId = clientId;
+    }
+
+    public Long getLoanAmount() {
+        return loanAmount;
+    }
+
+    public void setLoanRequestAmount(Long loanAmount) {
+        this.loanAmount = loanAmount;
+    }
+}
+
+
+
+
+
+

The preceding class provides an object in which we can store the parameters. Because the +client ID in the contract is called client.id, we need to use the +@JsonProperty("client.id") parameter to map it to the clientId field.

+
+
+

Now we can move along to the controller, which the following listing shows:

+
+
+
+
+
+
package com.example.docTest;
+
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+public class FraudController {
+
+    @PutMapping(value = "/fraudcheck", consumes="application/json", produces="application/json")
+    public String check(@RequestBody LoanRequest loanRequest) { (1)
+
+        if (loanRequest.getLoanAmount() > 10000) { (2)
+            return "{fraudCheckStatus: FRAUD, rejection.reason: Amount too high}"; (3)
+        } else {
+            return "{fraudCheckStatus: OK, acceptance.reason: Amount OK}"; (4)
+        }
+    }
+}
+
+
+
+ + + + + + + + + + + + + + + + + +
1We map the incoming parameters to a LoanRequest object.
2We check the requested loan amount to see if it is too much.
3If it is too much, we return the JSON (created with a simple string here) that the +test expects.
4If we had a test to catch when the amount is allowable, we could match it to this output.
+
+
+
+
+

The FraudController is about as simple as things get. You can do much more, including +logging, validating the client ID, and so on.

+
+
+

Once the implementation and the test base class are in place, the tests pass, and both the +application and the stub artifacts are built and installed in the local Maven repository +Information about installing the stubs jar to the local repository appears in the logs, as +the following example shows:

+
+
+
+
+
+
[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
+[INFO]
+[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.5.5.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
+[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+
+
+
+
+
+

You can now merge the changes and publish both the application and the stub artifacts +in an online repository.

+
+
+
+

3.2. On the Consumer Side

+
+

You can use Spring Cloud Contract Stub Runner in the integration tests to get a running +WireMock instance or messaging route that simulates the actual service.

+
+
+

To get started, add the dependency to Spring Cloud Contract Stub Runner, as follows:

+
+
+
+
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-contract-stub-runner</artifactId>
+    <scope>test</scope>
+</dependency>
+
+
+
+
+
+

You can get the Producer-side stubs installed in your Maven repository in either of two +ways:

+
+
+
    +
  • +

    By checking out the Producer side repository and adding contracts and generating the +stubs by running the following commands:

    +
    +
    +
    +
    +
    $ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests
    +
    +
    +
    +
    +
    + + + + + +
    + + +The tests are skipped because the Producer-side contract implementation is not yet +in place, so the automatically-generated contract tests fail. +
    +
    +
    • +
  • +

    Getting already existing producer service stubs from a remote repository. To do so, +pass the stub artifact IDs and artifact repository URl as Spring Cloud Contract Stub +Runner properties, as the following example shows:

    +
    +
    +
    +
    +
    stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot
    +
    +
    +
    +
    +
    • +
+
+
+

Now you can annotate your test class with @AutoConfigureStubRunner. In the annotation, +provide the group-id and artifact-id for Spring Cloud Contract Stub Runner to run +the collaborators' stubs for you, as the following example shows:

+
+
+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
+        stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {
+
+
+
+
+
+ + + + + +
+ + +Use the REMOTE stubsMode when downloading stubs from an online repository and +LOCAL for offline work. +
+
+
+

In your integration test, you can receive stubbed versions of HTTP responses or messages +that are expected to be emitted by the collaborator service. You can see entries similar +to the following in the build logs:

+
+
+
+
+
+
2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
+2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
+2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
+2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
+2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
+2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]
+
+
+
+
+
+
+
+
+

4. Step-by-step Guide to Consumer Driven Contracts (CDC) with Contracts on the Producer Side

+
+
+

Consider an example of fraud detection and the loan issuance process. The business +scenario is such that we want to issue loans to people but do not want them to steal from +us. The current implementation of our system grants loans to everybody.

+
+
+

Assume that Loan Issuance is a client to the Fraud Detection server. In the current +sprint, we must develop a new feature: if a client wants to borrow too much money, +we mark the client as a fraud.

+
+
+

Technical remarks

+
+
+
    +
  • +

    Fraud Detection has an artifact-id of http-server

    +
    • +
  • +

    Loan Issuance has an artifact-id of http-client

    +
    • +
  • +

    Both have a group-id of com.example

    +
    • +
  • +

    For the sake of this example the Stub Storage is Nexus/Artifactory

    +
    • +
+
+
+

Social remarks

+
+
+
    +
  • +

    Both the client and the server development teams need to communicate directly and +discuss changes while going through the process

    +
    • +
  • +

    CDC is all about communication

    +
    • +
+
+
+

The server-side +code is available here and the client code is available here.

+
+
+ + + + + +
+ + +In this case, the producer owns the contracts. Physically, all of the contracts are +in the producer’s repository. +
+
+
+

4.1. Technical Note

+
+

If you use the SNAPSHOT, Milestone, or Release Candidate versions you need to add the +following section to your build:

+
+
+
+
+
Maven
+
+
<repositories>
+    <repository>
+        <id>spring-snapshots</id>
+        <name>Spring Snapshots</name>
+        <url>https://repo.spring.io/snapshot</url>
+        <snapshots>
+            <enabled>true</enabled>
+        </snapshots>
+    </repository>
+    <repository>
+        <id>spring-milestones</id>
+        <name>Spring Milestones</name>
+        <url>https://repo.spring.io/milestone</url>
+        <snapshots>
+            <enabled>false</enabled>
+        </snapshots>
+    </repository>
+    <repository>
+        <id>spring-releases</id>
+        <name>Spring Releases</name>
+        <url>https://repo.spring.io/release</url>
+        <snapshots>
+            <enabled>false</enabled>
+        </snapshots>
+    </repository>
+</repositories>
+<pluginRepositories>
+    <pluginRepository>
+        <id>spring-snapshots</id>
+        <name>Spring Snapshots</name>
+        <url>https://repo.spring.io/snapshot</url>
+        <snapshots>
+            <enabled>true</enabled>
+        </snapshots>
+    </pluginRepository>
+    <pluginRepository>
+        <id>spring-milestones</id>
+        <name>Spring Milestones</name>
+        <url>https://repo.spring.io/milestone</url>
+        <snapshots>
+            <enabled>false</enabled>
+        </snapshots>
+    </pluginRepository>
+    <pluginRepository>
+        <id>spring-releases</id>
+        <name>Spring Releases</name>
+        <url>https://repo.spring.io/release</url>
+        <snapshots>
+            <enabled>false</enabled>
+        </snapshots>
+    </pluginRepository>
+</pluginRepositories>
+
+
+
+
Gradle
+
+
repositories {
+    mavenCentral()
+    mavenLocal()
+    maven { url "https://repo.spring.io/snapshot" }
+    maven { url "https://repo.spring.io/milestone" }
+    maven { url "https://repo.spring.io/release" }
+}
+
+
+
+
+
+

For simplicity, we use the following acronyms:

+
+
+
    +
  • +

    Loan Issuance (LI): The HTTP client

    +
    • +
  • +

    Fraud Detection (FD): The HTTP server

    +
    • +
  • +

    Spring Cloud Contract (SCC)

    +
    • +
+
+
+
+

4.2. The Consumer Side (Loan Issuance)

+
+

As a developer of the Loan Issuance service (a consumer of the Fraud Detection server), you might do the following steps:

+
+
+
    +
  1. +

    Start doing TDD by writing a test for your feature.

    +
    2. +
  2. +

    Write the missing implementation.

    +
    3. +
  3. +

    Clone the Fraud Detection service repository locally.

    +
    4. +
  4. +

    Define the contract locally in the repo of the fraud detection service.

    +
    5. +
  5. +

    Add the Spring Cloud Contract (SCC) plugin.

    +
    6. +
  6. +

    Run the integration tests.

    +
    7. +
  7. +

    File a pull request.

    +
    8. +
  8. +

    Create an initial implementation.

    +
    9. +
  9. +

    Take over the pull request.

    +
    10. +
  10. +

    Write the missing implementation.

    +
    11. +
  11. +

    Deploy your app.

    +
    12. +
  12. +

    Work online.

    +
    13. +
+
+
+

We start with the loan issuance flow, which the following UML diagram shows:

+
+
+
+getting started cdc client +
+
+
+

4.2.1. Start Doing TDD by Writing a Test for Your Feature

+
+

The following listing shows a test that we might use to check whether a loan amount is too +large:

+
+
+
+
+
+
@Test
+public void shouldBeRejectedDueToAbnormalLoanAmount() {
+    // given:
+    LoanApplication application = new LoanApplication(new Client("1234567890"),
+            99999);
+    // when:
+    LoanApplicationResult loanApplication = service.loanApplication(application);
+    // then:
+    assertThat(loanApplication.getLoanApplicationStatus())
+            .isEqualTo(LoanApplicationStatus.LOAN_APPLICATION_REJECTED);
+    assertThat(loanApplication.getRejectionReason()).isEqualTo("Amount too high");
+}
+
+
+
+
+
+

Assume that you have written a test of your new feature. If a loan application for a big +amount is received, the system should reject that loan application with some description.

+
+
+
+

4.2.2. Write the Missing Implementation

+
+

At some point in time, you need to send a request to the Fraud Detection service. Assume +that you need to send the request containing the ID of the client and the amount the +client wants to borrow. You want to send it to the /fraudcheck URL by using the PUT method. +To do so, you might use code similar to the following:

+
+
+
+
+
+
ResponseEntity<FraudServiceResponse> response = restTemplate.exchange(
+        "http://localhost:" + port + "/fraudcheck", HttpMethod.PUT,
+        new HttpEntity<>(request, httpHeaders), FraudServiceResponse.class);
+
+
+
+
+
+

For simplicity, the port of the Fraud Detection service is set to 8080, and the +application runs on 8090.

+
+
+ + + + + +
+ + +If you start the test at this point, it breaks, because no service currently runs on port +8080. +
+
+
+
+

4.2.3. Clone the Fraud Detection service repository locally

+
+

You can start by playing around with the server side contract. To do so, you must first +clone it, by running the following command:

+
+
+
+
+
+
$ git clone https://your-git-server.com/server-side.git local-http-server-repo
+
+
+
+
+
+
+

4.2.4. Define the Contract Locally in the Repository of the Fraud Detection Service

+
+

As a consumer, you need to define what exactly you want to achieve. You need to formulate +your expectations. To do so, write the following contract:

+
+
+ + + + + +
+ + +Place the contract in the src/test/resources/contracts/fraud folder. The fraud folder +is important because the producer’s test base class name references that folder. +
+
+
+

The following example shows our contract, in both Groovy and YAML:

+
+
+
+
+
groovy
+
+
/*
+ * Copyright 2013-2019 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.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request { // (1)
+        method 'PUT' // (2)
+        url '/fraudcheck' // (3)
+        body([ // (4)
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount : 99999
+        ])
+        headers { // (5)
+            contentType('application/json')
+        }
+    }
+    response { // (6)
+        status OK() // (7)
+        body([ // (8)
+               fraudCheckStatus  : "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers { // (9)
+            contentType('application/json')
+        }
+    }
+}
+
+/*
+From the Consumer perspective, when shooting a request in the integration test:
+
+(1) - If the consumer sends a request
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the response will be sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` equal to `application/json`
+
+From the Producer perspective, in the autogenerated producer-side test:
+
+(1) - A request will be sent to the producer
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the test will assert if the response has been sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` matching `application/json.*`
+ */
+
+
+
+
yaml
+
+
request: # (1)
+  method: PUT # (2)
+  url: /yamlfraudcheck # (3)
+  body: # (4)
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers: # (5)
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id'] # (6)
+        type: by_regex
+        value: "[0-9]{10}"
+response: # (7)
+  status: 200 # (8)
+  body:  # (9)
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers: # (10)
+    Content-Type: application/json
+
+
+#From the Consumer perspective, when shooting a request in the integration test:
+#
+#(1) - If the consumer sends a request
+#(2) - With the "PUT" method
+#(3) - to the URL "/yamlfraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
+#(7) - then the response will be sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+#
+#From the Producer perspective, in the autogenerated producer-side test:
+#
+#(1) - A request will be sent to the producer
+#(2) - With the "PUT" method
+#(3) - to the URL "/yamlfraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id` `1234567890`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(7) - then the test will assert if the response has been sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+
+
+
+
+
+

The YML contract is quite straightforward. However, when you take a look at the Contract +written with a statically typed Groovy DSL, you might wonder what the +value(client(…​), server(…​)) parts are. By using this notation, Spring Cloud +Contract lets you define parts of a JSON block, a URL, or other structure that is dynamic. In case +of an identifier or a timestamp, you need not hardcode a value. You want to allow some +different ranges of values. To enable ranges of values, you can set regular expressions +that match those values for the consumer side. You can provide the body by means of either +a map notation or String with interpolations. We highly recommend using the map notation.

+
+
+ + + + + +
+ + +You must understand the map notation in order to set up contracts. See the +Groovy docs regarding JSON. +
+
+
+

The previously shown contract is an agreement between two sides that:

+
+
+
    +
  • +

    If an HTTP request is sent with all of

    +
    +
      +
    • +

      A PUT method on the /fraudcheck endpoint

      +
      • +
    • +

      A JSON body with a client.id that matches the regular expression [0-9]{10} and +loanAmount equal to 99999,

      +
      • +
    • +

      A Content-Type header with a value of application/vnd.fraud.v1+json

      +
      • +
    +
    +
    • +
  • +

    Then an HTTP response is sent to the consumer that

    +
    +
      +
    • +

      Has status 200

      +
      • +
    • +

      Contains a JSON body with the fraudCheckStatus field containing a value of FRAUD and +the rejectionReason field having a value of Amount too high

      +
      • +
    • +

      Has a Content-Type header with a value of application/vnd.fraud.v1+json

      +
      • +
    +
    +
    • +
+
+
+

Once you are ready to check the API in practice in the integration tests, you need to +install the stubs locally.

+
+
+
+

4.2.5. Add the Spring Cloud Contract Verifier Plugin

+
+

We can add either a Maven or a Gradle plugin. In this example, we show how to add Maven. +First, we add the Spring Cloud Contract BOM, as the following example shows:

+
+
+
+
+
+
<dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-dependencies</artifactId>
+            <version>${spring-cloud-release.version}</version>
+            <type>pom</type>
+            <scope>import</scope>
+        </dependency>
+    </dependencies>
+</dependencyManagement>
+
+
+
+
+
+

Next, add the Spring Cloud Contract Verifier Maven plugin, as the following example shows:

+
+
+
+
+
+
            <plugin>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+                <version>${spring-cloud-contract.version}</version>
+                <extensions>true</extensions>
+                <configuration>
+                    <packageWithBaseClasses>com.example.fraud</packageWithBaseClasses>
+<!--                    <convertToYaml>true</convertToYaml>-->
+                </configuration>
+                <!-- if additional dependencies are needed e.g. for Pact -->
+                <dependencies>
+                    <dependency>
+                        <groupId>org.springframework.cloud</groupId>
+                        <artifactId>spring-cloud-contract-pact</artifactId>
+                        <version>${spring-cloud-contract.version}</version>
+                    </dependency>
+                </dependencies>
+            </plugin>
+
+
+
+
+
+

Since the plugin was added, you get the Spring Cloud Contract Verifier features, which, +from the provided contracts:

+
+
+
    +
  • +

    Generate and run tests

    +
    • +
  • +

    Produce and install stubs

    +
    • +
+
+
+

You do not want to generate tests, since you, as the consumer, want only to play with the +stubs. You need to skip the test generation and execution. To do so, run the following commands:

+
+
+
+
+
+
$ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests
+
+
+
+
+
+

Once you run those commands, you should you see something like the following content in the logs:

+
+
+
+
+
+
[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
+[INFO]
+[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.5.5.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
+[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+
+
+
+
+
+

The following line is extremely important:

+
+
+
+
+
+
[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+
+
+
+
+
+

It confirms that the stubs of the http-server have been installed in the local +repository.

+
+
+
+

4.2.6. Running the Integration Tests

+
+

In order to profit from the Spring Cloud Contract Stub Runner functionality of automatic +stub downloading, you must do the following in your consumer side project (Loan +Application service):

+
+
+
    +
  1. +

    Add the Spring Cloud Contract BOM, as follows:

    +
    +
    +
    +
    +
    <dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-dependencies</artifactId>
+            <version>${spring-cloud-release-train.version}</version>
+            <type>pom</type>
+            <scope>import</scope>
+        </dependency>
+    </dependencies>
+</dependencyManagement>
    +
    +
    +
    +
    +
    2. +
  2. +

    Add the dependency to Spring Cloud Contract Stub Runner, as follows:

    +
    +
    +
    +
    +
    <dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-contract-stub-runner</artifactId>
+    <scope>test</scope>
+</dependency>
    +
    +
    +
    +
    +
    3. +
  3. +

    Annotate your test class with @AutoConfigureStubRunner. In the annotation, provide the +group-id and artifact-id for the Stub Runner to download the stubs of your +collaborators. (Optional step) Because you are playing with the collaborators offline, you +can also provide the offline work switch (StubRunnerProperties.StubsMode.LOCAL).

    +
    +
    +
    +
    +
    @RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {
+        "com.example:http-server-dsl:0.0.1:stubs" }, stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {
    +
    +
    +
    +
    +
    4. +
+
+
+

Now, when you run your tests, you see something like the following output in the logs:

+
+
+
+
+
+
2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
+2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
+2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
+2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
+2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
+2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]
+
+
+
+
+
+

This output means that Stub Runner has found your stubs and started a server for your application +with a group ID of com.example and an artifact ID of http-server with version 0.0.1-SNAPSHOT of +the stubs and with the stubs classifier on port 8080.

+
+
+
+

4.2.7. Filing a Pull Request

+
+

What you have done until now is an iterative process. You can play around with the +contract, install it locally, and work on the consumer side until the contract works as +you wish.

+
+
+

Once you are satisfied with the results and the test passes, you can publish a pull request to +the server side. Currently, the consumer side work is done.

+
+
+
+
+

4.3. The Producer Side (Fraud Detection server)

+
+

As a developer of the Fraud Detection server (a server to the Loan Issuance service), you +might want to do the following

+
+
+
    +
  • +

    Take over the pull request

    +
    • +
  • +

    Write the missing implementation

    +
    • +
  • +

    Deploy the application

    +
    • +
+
+
+

The following UML diagram shows the fraud detection flow:

+
+
+
+getting started cdc server +
+
+
+

4.3.1. Taking over the Pull Request

+
+

As a reminder, the following listing shows the initial implementation:

+
+
+
+
+
+
@RequestMapping(value = "/fraudcheck", method = PUT)
+public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
+return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
+}
+
+
+
+
+
+

Then you can run the following commands:

+
+
+
+
+
+
$ git checkout -b contract-change-pr master
+$ git pull https://your-git-server.com/server-side-fork.git contract-change-pr
+
+
+
+
+
+

You must add the dependencies needed by the autogenerated tests, as follows:

+
+
+
+
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-contract-verifier</artifactId>
+    <scope>test</scope>
+</dependency>
+
+
+
+
+
+

In the configuration of the Maven plugin, you must pass the packageWithBaseClasses property, as follows:

+
+
+
+
+
+
            <plugin>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+                <version>${spring-cloud-contract.version}</version>
+                <extensions>true</extensions>
+                <configuration>
+                    <packageWithBaseClasses>com.example.fraud</packageWithBaseClasses>
+<!--                    <convertToYaml>true</convertToYaml>-->
+                </configuration>
+                <!-- if additional dependencies are needed e.g. for Pact -->
+                <dependencies>
+                    <dependency>
+                        <groupId>org.springframework.cloud</groupId>
+                        <artifactId>spring-cloud-contract-pact</artifactId>
+                        <version>${spring-cloud-contract.version}</version>
+                    </dependency>
+                </dependencies>
+            </plugin>
+
+
+
+
+
+ + + + + +
+ + +This example uses “convention-based” naming by setting the +packageWithBaseClasses property. Doing so means that the two last packages combine to +make the name of the base test class. In our case, the contracts were placed under +src/test/resources/contracts/fraud. Since you do not have two packages starting from +the contracts folder, pick only one, which should be fraud. Add the Base suffix and +capitalize fraud. That gives you the FraudBase test class name. +
+
+
+

All the generated tests extend that class. Over there, you can set up your Spring Context +or whatever is necessary. In this case, you should use Rest Assured MVC to +start the server side FraudDetectionController. The following listing shows the +FraudBase class:

+
+
+
+
+
+
/*
+ * Copyright 2013-2019 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.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+
+public class FraudBase {
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.standaloneSetup(new FraudDetectionController(),
+                new FraudStatsController(stubbedStatsProvider()));
+    }
+
+    private StatsProvider stubbedStatsProvider() {
+        return fraudType -> {
+            switch (fraudType) {
+            case DRUNKS:
+                return 100;
+            case ALL:
+                return 200;
+            }
+            return 0;
+        };
+    }
+
+    public void assertThatRejectionReasonIsNull(Object rejectionReason) {
+        assert rejectionReason == null;
+    }
+
+}
+
+
+
+
+
+

Now, if you run the ./mvnw clean install, you get something like the following output:

+
+
+
+
+
+
Results :
+
+Tests in error:
+  ContractVerifierTest.validate_shouldMarkClientAsFraud:32 » IllegalState Parsed...
+
+
+
+
+
+

This error occurs because you have a new contract from which a test was generated and it +failed since you have not implemented the feature. The auto-generated test would look +like the following test method:

+
+
+
+
+
+
@Test
+public void validate_shouldMarkClientAsFraud() throws Exception {
+    // given:
+        MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/vnd.fraud.v1+json")
+                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
+
+    // when:
+        ResponseOptions response = given().spec(request)
+                .put("/fraudcheck");
+
+    // then:
+        assertThat(response.statusCode()).isEqualTo(200);
+        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
+    // and:
+        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
+        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
+}
+
+
+
+
+
+

If you used the Groovy DSL, you can see that all of the producer() parts of the Contract that were present in the +value(consumer(…​), producer(…​)) blocks got injected into the test. +In case of using YAML, the same applied for the matchers sections of the response.

+
+
+

Note that, on the producer side, you are also doing TDD. The expectations are expressed +in the form of a test. This test sends a request to our own application with the URL, +headers, and body defined in the contract. It is also expecting precisely defined values +in the response. In other words, you have the red part of red, green, and +refactor. It is time to convert the red into the green.

+
+
+
+

4.3.2. Write the Missing Implementation

+
+

Because you know the expected input and expected output, you can write the missing +implementation as follows:

+
+
+
+
+
+
@RequestMapping(value = "/fraudcheck", method = PUT)
+public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
+if (amountGreaterThanThreshold(fraudCheck)) {
+    return new FraudCheckResult(FraudCheckStatus.FRAUD, AMOUNT_TOO_HIGH);
+}
+return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
+}
+
+
+
+
+
+

When you run ./mvnw clean install again, the tests pass. Since the Spring Cloud +Contract Verifier plugin adds the tests to the generated-test-sources, you can +actually run those tests from your IDE.

+
+
+
+

4.3.3. Deploying Your Application

+
+

Once you finish your work, you can deploy your changes. To do so, you must first merge the +branch by running the following commands:

+
+
+
+
+
+
$ git checkout master
+$ git merge --no-ff contract-change-pr
+$ git push origin master
+
+
+
+
+
+

Your CI might run something a command such as ./mvnw clean deploy, which would publish both the +application and the stub artifacts.

+
+
+
+
+

4.4. Consumer Side (Loan Issuance), Final Step

+
+

As a developer of the loan issuance service (a consumer of the Fraud Detection server), I want to:

+
+
+
    +
  • +

    Merge our feature branch to master

    +
    • +
  • +

    Switch to online mode of working

    +
    • +
+
+
+

The following UML diagram shows the final state of the process:

+
+
+
+getting started cdc client final +
+
+
+

4.4.1. Merging a Branch to Master

+
+

The following commands show one way to merge a branch into master with Git:

+
+
+
+
+
+
$ git checkout master
+$ git merge --no-ff contract-change-pr
+
+
+
+
+
+
+

4.4.2. Working Online

+
+

Now you can disable the offline work for Spring Cloud Contract Stub Runner and indicate +where the repository with your stubs is located. At this moment, the stubs of the server +side are automatically downloaded from Nexus/Artifactory. You can set the value of +stubsMode to REMOTE. The following code shows an example of +achieving the same thing by changing the properties:

+
+
+
+
+
+
stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot
+
+
+
+
+
+

That’s it. You have finished the tutorial.

+
+
+
+
+
+
+

5. Next Steps

+
+
+

Hopefully, this section provided some of the Spring Cloud Contract basics and got you on your way +to writing your own applications. If you are a task-oriented type of developer, you might +want to jump over to spring.io and check out some of the +getting started guides that solve specific “How do I do that +with Spring?” problems. We also have Spring Cloud Contract-specific +“how-to” reference documentation.

+
+
+

Otherwise, the next logical step is to read Using Spring Cloud Contract. If +you are really impatient, you could also jump ahead and read about +Spring Cloud Contract features.

+
+
+

In addition to that you can check out the following videos:

+
+
+
    +
  • +

    "Consumer Driven Contracts and Your Microservice Architecture" by Olga Maciaszek-Sharma and Marcin Grzejszczak

    +
    • +
+
+
+
+ +
+
+
+
    +
  • +

    "Contract Tests in the Enterprise" by Marcin Grzejszczak

    +
    • +
+
+
+
+ +
+
+
+
    +
  • +

    "Why Contract Tests Matter?" by Marcin Grzejszczak

    +
    • +
+
+
+
+ +
+
+
+

You can find the default project samples at +samples.

+
+
+

You can find the Spring Cloud Contract workshops here.

+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/gradle-project.html b/spring-cloud-contract/2.2.0.RC1/reference/html/gradle-project.html new file mode 100644 index 00000000..1eb01fb4 --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/gradle-project.html @@ -0,0 +1,914 @@ + + + + + + + +Gradle Project + + + + + + + + + + +
+ +
+

1. Prerequisites

+
+
+

In order to use Spring Cloud Contract Verifier with WireMock, you must use either a +Gradle or a Maven plugin.

+
+
+ + + + + +
+ + +If you want to use Spock in your projects, you must separately add the +spock-core and spock-spring modules. See Spock’s +documnetation for more information +
+
+
+
+
+

2. Add Gradle Plugin with Dependencies

+
+
+

To add a Gradle plugin with dependencies, you can use code similar to the following:

+
+
+
+
+
Plugin DSL GA versions
+
+
// build.gradle
+plugins {
+  id "groovy"
+  // this will work only for GA versions of Spring Cloud Contract
+  id "org.springframework.cloud.contract" version "${GAVerifierVersion}"
+}
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${GAVerifierVersion}"
+    }
+}
+
+dependencies {
+    testCompile "org.codehaus.groovy:groovy-all:${groovyVersion}"
+    // example with adding Spock core and Spock Spring
+    testCompile "org.spockframework:spock-core:${spockVersion}"
+    testCompile "org.spockframework:spock-spring:${spockVersion}"
+    testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+}
+
+
+
+
Plugin DSL non GA versions
+
+
// settings.gradle
+pluginManagement {
+    plugins {
+        id "org.springframework.cloud.contract" version "${verifierVersion}"
+    }
+    repositories {
+        // to pick from local .m2
+        mavenLocal()
+        // for snapshots
+        maven { url "https://repo.spring.io/snapshot" }
+        // for milestones
+        maven { url "https://repo.spring.io/milestone" }
+        // for GA versions
+        gradlePluginPortal()
+    }
+}
+
+// build.gradle
+plugins {
+  id "groovy"
+  id "org.springframework.cloud.contract"
+}
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${verifierVersion}"
+    }
+}
+
+dependencies {
+    testCompile "org.codehaus.groovy:groovy-all:${groovyVersion}"
+    // example with adding Spock core and Spock Spring
+    testCompile "org.spockframework:spock-core:${spockVersion}"
+    testCompile "org.spockframework:spock-spring:${spockVersion}"
+    testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+}
+
+
+
+
Legacy Plugin Application
+
+
// build.gradle
+buildscript {
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        classpath "org.springframework.boot:spring-boot-gradle-plugin:${springboot_version}"
+        classpath "org.springframework.cloud:spring-cloud-contract-gradle-plugin:${verifier_version}"
+        // here you can also pass additional dependencies such as Pact or Kotlin spec e.g.:
+        // classpath "org.springframework.cloud:spring-cloud-contract-spec-kotlin:${verifier_version}"
+    }
+}
+
+apply plugin: 'groovy'
+apply plugin: 'spring-cloud-contract'
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${verifier_version}"
+    }
+}
+
+dependencies {
+    testCompile "org.codehaus.groovy:groovy-all:${groovyVersion}"
+    // example with adding Spock core and Spock Spring
+    testCompile "org.spockframework:spock-core:${spockVersion}"
+    testCompile "org.spockframework:spock-spring:${spockVersion}"
+    testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+}
+
+
+
+
+
+
+
+

3. Gradle and Rest Assured 2.0

+
+
+

By default, Rest Assured 3.x is added to the classpath. However, to use Rest Assured 2.x +you can add it to the plugins classpath, as the following listing shows:

+
+
+
+
+
+
buildscript {
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        classpath "org.springframework.boot:spring-boot-gradle-plugin:${springboot_version}"
+        classpath "org.springframework.cloud:spring-cloud-contract-gradle-plugin:${verifier_version}"
+        classpath "com.jayway.restassured:rest-assured:2.5.0"
+        classpath "com.jayway.restassured:spring-mock-mvc:2.5.0"
+    }
+}
+
+depenendencies {
+    // all dependencies
+    // you can exclude rest-assured from spring-cloud-contract-verifier
+    testCompile "com.jayway.restassured:rest-assured:2.5.0"
+    testCompile "com.jayway.restassured:spring-mock-mvc:2.5.0"
+}
+
+
+
+
+
+

That way, the plugin automatically sees that Rest Assured 2.x is present on the classpath +and modifies the imports accordingly.

+
+
+
+
+

4. Snapshot Versions for Gradle

+
+
+

You can add the additional snapshot repository to your build.gradle to use snapshot versions, +which are automatically uploaded after every successful build, as the following listing shows:

+
+
+
+
+
+
/*
+ We need to use the [buildscript {}] section when we have to modify
+ the classpath for the plugins. If that's not the case this section
+ can be skipped.
+
+ If you don't need to modify the classpath (e.g. add a Pact dependency),
+ then you can just set the [pluginManagement {}] section in [settings.gradle] file.
+
+ // settings.gradle
+ pluginManagement {
+    repositories {
+        // for snapshots
+        maven {url "https://repo.spring.io/snapshot"}
+        // for milestones
+        maven {url "https://repo.spring.io/milestone"}
+        // for GA versions
+        gradlePluginPortal()
+    }
+ }
+
+ */
+buildscript {
+    repositories {
+        mavenCentral()
+        mavenLocal()
+        maven { url "https://repo.spring.io/snapshot" }
+        maven { url "https://repo.spring.io/milestone" }
+        maven { url "https://repo.spring.io/release" }
+    }
+}
+
+
+
+
+
+
+
+

5. Add stubs

+
+
+

By default, Spring Cloud Contract Verifier looks for stubs in the +src/test/resources/contracts directory.

+
+
+

The directory that contains stub definitions is treated as a class name, and each stub +definition is treated as a single test. Spring Cloud Contract Verifier assumes that it +contains at least one level of directories that are to be used as the test class name. +If more than one level of nested directories is present, all except the last one is used +as the package name. Consider the following structure:

+
+
+
+
+
+
src/test/resources/contracts/myservice/shouldCreateUser.groovy
+src/test/resources/contracts/myservice/shouldReturnUser.groovy
+
+
+
+
+
+

Given the preceding structure, Spring Cloud Contract Verifier creates a test class named +defaultBasePackage.MyService with two methods:

+
+
+
    +
  • +

    shouldCreateUser()

    +
    • +
  • +

    shouldReturnUser()

    +
    • +
+
+
+
+
+

6. Running the Plugin

+
+
+

The plugin registers itself to be invoked before a check task. If you want it to be +part of your build process, you need do nothing more. If you just want to generate +tests, invoke the generateContractTests task.

+
+
+
+
+

7. Default Setup

+
+
+

The default Gradle Plugin setup creates the following Gradle part of the build (in +pseudocode):

+
+
+
+
+
+
contracts {
+    testFramework ='JUNIT'
+    testMode = 'MockMvc'
+    generatedTestSourcesDir = project.file("${project.buildDir}/generated-test-sources/contracts")
+    generatedTestResourcesDir = project.file("${project.buildDir}/generated-test-resources/contracts")
+    contractsDslDir = project.file("${project.rootDir}/src/test/resources/contracts")
+    basePackageForTests = 'org.springframework.cloud.verifier.tests'
+    stubsOutputDir = project.file("${project.buildDir}/stubs")
+    sourceSet = null
+
+    // the following properties are used when you want to provide where the JAR with contract lays
+    contractDependency {
+        stringNotation = ''
+    }
+    contractsPath = ''
+    contractsWorkOffline = false
+    contractRepository {
+        cacheDownloadedContracts(true)
+    }
+}
+
+tasks.create(type: Jar, name: 'verifierStubsJar', dependsOn: 'generateClientStubs') {
+    baseName = project.name
+    classifier = contracts.stubsSuffix
+    from contractVerifier.stubsOutputDir
+}
+
+project.artifacts {
+    archives task
+}
+
+tasks.create(type: Copy, name: 'copyContracts') {
+    from contracts.contractsDslDir
+    into contracts.stubsOutputDir
+}
+
+verifierStubsJar.dependsOn 'copyContracts'
+
+publishing {
+    publications {
+        stubs(MavenPublication) {
+            artifactId project.name
+            artifact verifierStubsJar
+        }
+    }
+}
+
+
+
+
+
+
+
+

8. Configuring the Plugin

+
+
+

To change the default configuration, you can add a contracts snippet to your Gradle +configuration, as the following listing shows:

+
+
+
+
+
+
contracts {
+    testMode = 'MockMvc'
+    baseClassForTests = 'org.mycompany.tests'
+    generatedTestSourcesDir = project.file('src/generatedContract')
+}
+
+
+
+
+
+
+
+

9. Configuration Options

+
+
+
    +
  • +

    testMode: Defines the mode for acceptance tests. By default, the mode is MockMvc, +which is based on Spring’s MockMvc. It can also be changed to WebTestClient, JaxRsClient, or +Explicit (for real HTTP calls).

    +
    • +
  • +

    imports: Creates an array with imports that should be included in the generated tests +(for example, ['org.myorg.Matchers']). By default, it creates an empty array.

    +
    • +
  • +

    staticImports: Creates an array with static imports that should be included in +generated tests(for example, ['org.myorg.Matchers.*']). By default, it creates an empty +array.

    +
    • +
  • +

    basePackageForTests: Specifies the base package for all generated tests. If not set, +the value is picked from the package of baseClassForTests and from packageWithBaseClasses. +If neither of these values are set, the value is set to +org.springframework.cloud.contract.verifier.tests.

    +
    • +
  • +

    baseClassForTests: Creates a base class for all generated tests. By default, if you +use Spock classes, the class is spock.lang.Specification.

    +
    • +
  • +

    packageWithBaseClasses: Defines a package where all the base classes reside. This +setting takes precedence over baseClassForTests.

    +
    • +
  • +

    baseClassMappings: Explicitly maps a contract package to a FQN of a base class. This +setting takes precedence over packageWithBaseClasses and baseClassForTests.

    +
    • +
  • +

    ruleClassForTests: Specifies a rule that should be added to the generated test +classes.

    +
    • +
  • +

    ignoredFiles: Uses an Antmatcher to allow defining stub files for which processing +should be skipped. By default, it is an empty array.

    +
    • +
  • +

    contractsDslDir: Specifies the directory that contains contracts written by using the +GroovyDSL. By default, its value is $rootDir/src/test/resources/contracts.

    +
    • +
  • +

    generatedTestSourcesDir: Specifies the test source directory where tests generated +from the Groovy DSL should be placed. By default, its value is +$buildDir/generated-test-sources/contracts.

    +
    • +
  • +

    generatedTestResourcesDir: Specifies the test resource directory where resources used by the tests generated +from the Groovy DSL should be placed. By default, its value is +$buildDir/generated-test-resources/contracts.

    +
    • +
  • +

    stubsOutputDir: Specifies the directory where the generated WireMock stubs from +the Groovy DSL should be placed.

    +
    • +
  • +

    testFramework: Specifies the target test framework to be used. Currently, Spock, JUnit 4 (TestFramework.JUNIT), and +JUnit 5 are supported, with JUnit 4 being the default framework.

    +
    • +
  • +

    contractsProperties: A map that contains properties to be passed to Spring Cloud Contract +components. Those properties might be used by (for example) built-in or custom Stub Downloaders.

    +
    • +
  • +

    sourceSet: Source set where the contracts are stored. If not provided will assume test (e.g. project.sourceSets.test.java for JUnit or project.sourceSets.test.groovy for Spock).

    +
    • +
+
+
+

You can use the following properties when you want to specify the location of the JAR +that contains the contracts:

+
+
+
    +
  • +

    contractDependency: Specifies the Dependency that provides +groupid:artifactid:version:classifier coordinates. You can use the contractDependency +closure to set it up.

    +
    • +
  • +

    contractsPath: Specifies the path to the jar. If contract dependencies are +downloaded, the path defaults to groupid/artifactid where groupid is slash +separated. Otherwise, it scans contracts under the provided directory.

    +
    • +
  • +

    contractsMode: Specifies the mode for downloading contracts (whether the +JAR is available offline, remotely, and so on).

    +
    • +
  • +

    deleteStubsAfterTest: If set to false, do not remove any downloaded +contracts from temporary directories.

    +
    • +
  • +

    failOnNoContracts: When enabled, will throw an exception when no contracts were found. Defaults to true.

    +
    • +
  • +

    failOnInProgress: If set to true then if any contracts that are in progress are found, will break the build. On the producer side you need to be explicit about the fact that you have contracts in progress and take into consideration that you might be causing false positive test execution results on the consumer side.. Defaults to true.

    +
    • +
+
+
+

There is also the contractRepository { …​ } closure that contains the following properties

+
+
+
    +
  • +

    repositoryUrl: the URL to the repository with contract definitions

    +
    • +
  • +

    username : Repository username

    +
    • +
  • +

    password : Repository password

    +
    • +
  • +

    proxyPort : the port of the proxy

    +
    • +
  • +

    proxyHost : the host of the proxy

    +
    • +
  • +

    cacheDownloadedContracts : If set to true then will cache the folder where non snapshot contract artifacts got downloaded. Defaults to true.

    +
    • +
+
+
+

You can also turn on the following experimental features in the plugin:

+
+
+
    +
  • +

    convertToYaml: Converts all DSLs to the declarative YAML format. This can be extremely +useful when you use external libraries in your Groovy DSLs. By turning this feature on +(by setting it to true) you need not add the library dependency on the consumer side.

    +
    • +
  • +

    assertJsonSize: You can check the size of JSON arrays in the generated tests. This +feature is disabled by default.

    +
    • +
+
+
+
+
+

10. Single Base Class for All Tests

+
+
+

When using Spring Cloud Contract Verifier in default MockMvc, you need to create a base +specification for all generated acceptance tests. In this class, you need to point to an +endpoint, which should be verified. The following example shows how to do so:

+
+
+
+
+
+
abstract class BaseMockMvcSpec extends Specification {
+
+    def setup() {
+        RestAssuredMockMvc.standaloneSetup(new PairIdController())
+    }
+
+    void isProperCorrelationId(Integer correlationId) {
+        assert correlationId == 123456
+    }
+
+    void isEmpty(String value) {
+        assert value == null
+    }
+
+}
+
+
+
+
+
+

If you use Explicit mode, you can use a base class to initialize the whole tested application, +as you might see in regular integration tests. If you use the JAXRSCLIENT mode, this +base class should also contain a protected WebTarget webTarget field. Right now, the +only option to test the JAX-RS API is to start a web server.

+
+
+
+
+

11. Different Base Classes for Contracts

+
+
+

If your base classes differ between contracts, you can tell the Spring Cloud Contract +plugin which class should get extended by the autogenerated tests. You have two options:

+
+
+
    +
  • +

    Follow a convention by providing the packageWithBaseClasses

    +
    • +
  • +

    Provide explicit mapping by using baseClassMappings

    +
    • +
+
+
+

11.1. By Convention

+
+

The convention is such that if you have a contract in (for example) +src/test/resources/contract/foo/bar/baz/ and set the value of the +packageWithBaseClasses property to com.example.base, then Spring Cloud Contract +Verifier assumes that there is a BarBazBase class under the com.example.base package. +In other words, the system takes the last two parts of the package, if they exist, and +forms a class with a Base suffix. This rule takes precedence over baseClassForTests. +The following example shows how it works in the contracts closure:

+
+
+
+
+
+
packageWithBaseClasses = 'com.example.base'
+
+
+
+
+
+
+

11.2. By Mapping

+
+

You can manually map a regular expression of the contract’s package to the fully qualified +name of the base class for the matched contract. You have to provide a list called +baseClassMappings that consists of baseClassMapping objects that take a +contractPackageRegex to baseClassFQN mapping. Consider the following example:

+
+
+
+
+
+
baseClassForTests = "com.example.FooBase"
+baseClassMappings {
+    baseClassMapping('.*/com/.*', 'com.example.ComBase')
+    baseClassMapping('.*/bar/.*': 'com.example.BarBase')
+}
+
+
+
+
+
+

Let’s assume that you have contracts in the following directories: + - src/test/resources/contract/com/ + - src/test/resources/contract/foo/

+
+
+

By providing baseClassForTests, we have a fallback in case mapping did not succeed. +(You could also provide the packageWithBaseClasses as a fallback.) That way, the tests +generated from src/test/resources/contract/com/ contracts extend the +com.example.ComBase, whereas the rest of the tests extend com.example.FooBase.

+
+
+
+
+
+

12. Invoking Generated Tests

+
+
+

To ensure that the provider side is compliant with your defined contracts, you need to run +the following command:

+
+
+
+
+
+
./gradlew generateContractTests test
+
+
+
+
+
+
+
+

13. Pushing Stubs to SCM

+
+
+

If you use the SCM repository to keep the contracts and +stubs, you might want to automate the step of pushing stubs to +the repository. To do that, you can call the pushStubsToScm +task by running the following command:

+
+
+
+
+
+
$ ./gradlew pushStubsToScm
+
+
+
+
+
+

Under [scm-stub-downloader] you can find all possible +configuration options that you can pass either through +the contractsProperties field (for example, contracts { contractsProperties = [foo:"bar"] }), +through the contractsProperties method (for example, contracts { contractsProperties([foo:"bar"]) }), +or through a system property or an environment variable.

+
+
+
+
+

14. Spring Cloud Contract Verifier on the Consumer Side

+
+
+

In a consuming service, you need to configure the Spring Cloud Contract Verifier plugin +in exactly the same way as in the case of a provider. If you do not want to use Stub Runner, +you need to copy the contracts stored in src/test/resources/contracts and generate +WireMock JSON stubs by using the following command:

+
+
+
+
+
+
./gradlew generateClientStubs
+
+
+
+
+
+ + + + + +
+ + +The stubsOutputDir option has to be set for stub generation to work. +
+
+
+

When present, JSON stubs can be used in automated tests to consume a service. The +following example shows how to do so:

+
+
+
+
+
+
@ContextConfiguration(loader == SpringApplicationContextLoader, classes == Application)
+class LoanApplicationServiceSpec extends Specification {
+
+ @ClassRule
+ @Shared
+ WireMockClassRule wireMockRule == new WireMockClassRule()
+
+ @Autowired
+ LoanApplicationService sut
+
+ def 'should successfully apply for loan'() {
+   given:
+    LoanApplication application =
+            new LoanApplication(client: new Client(clientPesel: '12345678901'), amount: 123.123)
+   when:
+    LoanApplicationResult loanApplication == sut.loanApplication(application)
+   then:
+    loanApplication.loanApplicationStatus == LoanApplicationStatus.LOAN_APPLIED
+    loanApplication.rejectionReason == null
+ }
+}
+
+
+
+
+
+

In the preceding example, LoanApplication makes a call to the FraudDetection service. +This request is handled by a WireMock server configured with stubs that were generated by +Spring Cloud Contract Verifier.

+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/howto.html b/spring-cloud-contract/2.2.0.RC1/reference/html/howto.html new file mode 100644 index 00000000..8394834f --- /dev/null +++ b/spring-cloud-contract/2.2.0.RC1/reference/html/howto.html @@ -0,0 +1,2502 @@ + + + + + + + +“How-to” Guides + + + + + + + + + + +
+
+
+
+

This section provides answers to some common “how do I do that…​” questions +that often arise when using Spring Cloud Contract. Its coverage is not exhaustive, but it +does cover quite a lot.

+
+
+

If you have a specific problem that we do not cover here, you might want to check out +stackoverflow.com to see if someone has +already provided an answer. Stack Overflow is also a great place to ask new questions (please use +the spring-cloud-contract tag).

+
+
+

We are also more than happy to extend this section. If you want to add a “how-to”, +send us a pull request.

+
+
+
+
+

1. Why use Spring Cloud Contract?

+
+
+

Spring Cloud Contract works great in a polyglot environment. This project has a lot of +really interesting features. Quite a few of these features definitely make +Spring Cloud Contract Verifier stand out on the market of Consumer Driven Contract +(CDC) tooling. The most interesting features include the following:

+
+
+
    +
  • +

    Ability to do CDC with messaging.

    +
    • +
  • +

    Clear and easy to use, statically typed DSL.

    +
    • +
  • +

    Ability to copy-paste your current JSON file to the contract and only edit its elements.

    +
    • +
  • +

    Automatic generation of tests from the defined Contract.

    +
    • +
  • +

    Stub Runner functionality: The stubs are automatically downloaded at runtime from Nexus/Artifactory.

    +
    • +
  • +

    Spring Cloud integration: No discovery service is needed for integration tests.

    +
    • +
  • +

    Spring Cloud Contract integrates with Pact and provides easy hooks to extend its functionality.

    +
    • +
  • +

    Ability to add support for any language & framework through Docker.

    +
    • +
+
+
+
+
+

2. How Can I Write Contracts in a Language Other than Groovy?

+
+
+

You can write a contract in YAML. See this section for more information.

+
+
+

We are working on allowing more ways of describing the contracts. You can check the github-issues for more information.

+
+
+
+
+

3. How Can I Provide Dynamic Values to a Contract?

+
+
+

One of the biggest challenges related to stubs is their reusability. Only if they can be widely used can they serve their purpose. +The hard-coded values (such as dates and IDs) of request and response elements generally make that difficult. +Consider the following JSON request:

+
+
+
+
+
+
{
+    "time" : "2016-10-10 20:10:15",
+    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
+    "body" : "foo"
+}
+
+
+
+
+
+

Now consider the following JSON response:

+
+
+
+
+
+
{
+    "time" : "2016-10-10 21:10:15",
+    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
+    "body" : "bar"
+}
+
+
+
+
+
+

Imagine the pain required to set the proper value of the time field (assume that this content is generated by the +database) by changing the clock in the system or by providing stub implementations of data providers. The same is related +to the field called id. You could create a stubbed implementation of UUID generator, but doing so makes little sense.

+
+
+

So, as a consumer, you want to send a request that matches any form of a time or any UUID. That way, your system +works as usual, generating data without you having to stub out anything. Assume that, in case of the aforementioned +JSON, the most important part is the body field. You can focus on that and provide matching for other fields. In other words, +you would like the stub to work as follows:

+
+
+
+
+
+
{
+    "time" : "SOMETHING THAT MATCHES TIME",
+    "id" : "SOMETHING THAT MATCHES UUID",
+    "body" : "foo"
+}
+
+
+
+
+
+

As far as the response goes, as a consumer, you need a concrete value on which you can operate. +Consequently, the following JSON is valid:

+
+
+
+
+
+
{
+    "time" : "2016-10-10 21:10:15",
+    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
+    "body" : "bar"
+}
+
+
+
+
+
+

In the previous sections, we generated tests from contracts. So, from the producer’s side, the situation looks +much different. We parse the provided contract, and, in the test, we want to send a real request to your endpoints. +So, for the case of a producer for the request, we cannot have any sort of matching. We need concrete values on which the +producer’s backend can work. Consequently, the following JSON would be valid:

+
+
+
+
+
+
{
+    "time" : "2016-10-10 20:10:15",
+    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
+    "body" : "foo"
+}
+
+
+
+
+
+

On the other hand, from the point of view of the validity of the contract, the response does not necessarily have to +contain concrete values for time or id. Suppose you generate those on the producer side. Again, you +have to do a lot of stubbing to ensure that you always return the same values. That is why, from the producer’s side +you might want the following response:

+
+
+
+
+
+
{
+    "time" : "SOMETHING THAT MATCHES TIME",
+    "id" : "SOMETHING THAT MATCHES UUID",
+    "body" : "bar"
+}
+
+
+
+
+
+

How can you then provide a matcher for the consumer and a concrete value for the producer (and the opposite at some other time)? +Spring Cloud Contract lets you provide a dynamic value. That means that it can differ for both +sides of the communication.

+
+
+

You can read more about this in the Contract DSL section.

+
+
+ + + + + +
+ + +Read the Groovy docs related to JSON to understand how to +properly structure the request and response bodies. +
+
+
+
+
+

4. How to Do Stubs versioning?

+
+
+

This section covers version of the stubs, which you can handle in a number of different ways:

+
+
+ +
+
+

4.1. API Versioning

+
+

What does versioning really mean? If you refer to the API version, there are +different approaches:

+
+
+
    +
  • +

    Use hypermedia links and do not version your API by any means

    +
    • +
  • +

    Pass the version through headers and URLs

    +
    • +
+
+
+

We do not try to answer the question of which approach is better. You should pick whatever +suits your needs and lets you generate business value.

+
+
+

Assume that you do version your API. In that case, you should provide as many contracts with as many versions as you support. +You can create a subfolder for every version or append it to the contract name — whatever suits you best.

+
+
+
+

4.2. JAR versioning

+
+

If, by versioning, you mean the version of the JAR that contains the stubs, then there are essentially two main approaches.

+
+
+

Assume that you do continuous delivery and deployment, which means that you generate a new version of +the jar each time you go through the pipeline and that the jar can go to production at any time. For example, your jar version +looks like the following (because it got built on the 20.10.2016 at 20:15:21) :

+
+
+
+
+
+
1.0.0.20161020-201521-RELEASE
+
+
+
+
+
+

In that case your, generated stub jar should look like the following:

+
+
+
+
+
+
1.0.0.20161020-201521-RELEASE-stubs.jar
+
+
+
+
+
+

In this case, you should, inside your application.yml or @AutoConfigureStubRunner when +referencing stubs, provide the latest version of the stubs. You can do that by passing the ++ sign. the following example shows how to do so:

+
+
+
+
+
+
@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})
+
+
+
+
+
+

If the versioning, however, is fixed (for example, 1.0.4.RELEASE or 2.1.1), you have to set the concrete value of the jar +version. The following example shows how to do so for version 2.1.1:

+
+
+
+
+
+
@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:2.1.1:stubs:8080"})
+
+
+
+
+
+
+

4.3. Development or Production Stubs

+
+

You can manipulate the classifier to run the tests against current the development version +of the stubs of other services or the ones that were deployed to production. If you alter +your build to deploy the stubs with the prod-stubs classifier once you reach production +deployment, you can run tests in one case with development stubs and one with production stubs.

+
+
+

The following example works for tests that use the development version of the stubs:

+
+
+
+
+
+
@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})
+
+
+
+
+
+

The following example works for tests that use the production version of stubs:

+
+
+
+
+
+
@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:prod-stubs:8080"})
+
+
+
+
+
+

You can also pass those values also in properties from your deployment pipeline.

+
+
+
+
+
+

5. How Can I use a Common Repository with Contracts Instead of Storing Them with the Producer?

+
+
+

Another way of storing contracts, rather than having them with the producer, is to keep +them in a common place. This situation can be related to security issues (where the +consumers cannot clone the producer’s code). Also if you keep contracts in a single place, +then you, as a producer, know how many consumers you have and which consumer you may break +with your local changes.

+
+
+

5.1. Repo Structure

+
+

Assume that we have a producer with coordinates of com.example:server and three +consumers: client1, client2, and client3. Then, in the repository with common +contracts, you could have the following setup (which you can check out +here). +The following listing shows such a structure:

+
+
+
+
+
+
├── com
+│   └── example
+│       └── server
+│           ├── client1
+│           │   └── expectation.groovy
+│           ├── client2
+│           │   └── expectation.groovy
+│           ├── client3
+│           │   └── expectation.groovy
+│           └── pom.xml
+├── mvnw
+├── mvnw.cmd
+├── pom.xml
+└── src
+    └── assembly
+        └── contracts.xml
+
+
+
+
+
+

As you can see under the slash-delimited groupid/artifact id folder (com/example/server) you have +expectations of the three consumers (client1, client2, and client3). Expectations are the standard Groovy DSL +contract files, as described throughout this documentation. This repository has to produce a JAR file that maps +one-to-one to the contents of the repository.

+
+
+

The following example shows a pom.xml inside the server folder:

+
+
+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.example</groupId>
+    <artifactId>server</artifactId>
+    <version>0.0.1</version>
+
+    <name>Server Stubs</name>
+    <description>POM used to install locally stubs for consumer side</description>
+
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>2.2.0.BUILD-SNAPSHOT</version>
+        <relativePath/>
+    </parent>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <java.version>1.8</java.version>
+        <spring-cloud-contract.version>2.2.0.BUILD-SNAPSHOT</spring-cloud-contract.version>
+        <spring-cloud-release.version>Hoxton.BUILD-SNAPSHOT</spring-cloud-release.version>
+        <excludeBuildFolders>true</excludeBuildFolders>
+    </properties>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-dependencies</artifactId>
+                <version>${spring-cloud-release.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+                <version>${spring-cloud-contract.version}</version>
+                <extensions>true</extensions>
+                <configuration>
+                    <!-- By default it would search under src/test/resources/ -->
+                    <contractsDirectory>${project.basedir}</contractsDirectory>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+    <repositories>
+        <repository>
+            <id>spring-snapshots</id>
+            <name>Spring Snapshots</name>
+            <url>https://repo.spring.io/snapshot</url>
+            <snapshots>
+                <enabled>true</enabled>
+            </snapshots>
+        </repository>
+        <repository>
+            <id>spring-milestones</id>
+            <name>Spring Milestones</name>
+            <url>https://repo.spring.io/milestone</url>
+            <snapshots>
+                <enabled>false</enabled>
+            </snapshots>
+        </repository>
+        <repository>
+            <id>spring-releases</id>
+            <name>Spring Releases</name>
+            <url>https://repo.spring.io/release</url>
+            <snapshots>
+                <enabled>false</enabled>
+            </snapshots>
+        </repository>
+    </repositories>
+    <pluginRepositories>
+        <pluginRepository>
+            <id>spring-snapshots</id>
+            <name>Spring Snapshots</name>
+            <url>https://repo.spring.io/snapshot</url>
+            <snapshots>
+                <enabled>true</enabled>
+            </snapshots>
+        </pluginRepository>
+        <pluginRepository>
+            <id>spring-milestones</id>
+            <name>Spring Milestones</name>
+            <url>https://repo.spring.io/milestone</url>
+            <snapshots>
+                <enabled>false</enabled>
+            </snapshots>
+        </pluginRepository>
+        <pluginRepository>
+            <id>spring-releases</id>
+            <name>Spring Releases</name>
+            <url>https://repo.spring.io/release</url>
+            <snapshots>
+                <enabled>false</enabled>
+            </snapshots>
+        </pluginRepository>
+    </pluginRepositories>
+
+</project>
+
+
+
+
+
+

There are no dependencies other than the Spring Cloud Contract Maven Plugin. +Those pom files are necessary for the consumer side to run mvn clean install -DskipTests to locally install +the stubs of the producer project.

+
+
+

The pom.xml in the root folder can look like the following:

+
+
+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.example.standalone</groupId>
+    <artifactId>contracts</artifactId>
+    <version>0.0.1</version>
+
+    <name>Contracts</name>
+    <description>Contains all the Spring Cloud Contracts, well, contracts. JAR used by the
+        producers to generate tests and stubs
+    </description>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <id>contracts</id>
+                        <phase>prepare-package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <attach>true</attach>
+                            <descriptor>${basedir}/src/assembly/contracts.xml</descriptor>
+                            <!-- If you want an explicit classifier remove the following line -->
+                            <appendAssemblyId>false</appendAssemblyId>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>
+
+
+
+
+
+

It uses the assembly plugin to build the JAR with all the contracts. The following example +shows such a setup:

+
+
+
+
+
+
<assembly xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd">
+    <id>project</id>
+    <formats>
+        <format>jar</format>
+    </formats>
+    <includeBaseDirectory>false</includeBaseDirectory>
+    <fileSets>
+        <fileSet>
+            <directory>${project.basedir}</directory>
+            <outputDirectory>/</outputDirectory>
+            <useDefaultExcludes>true</useDefaultExcludes>
+            <excludes>
+                <exclude>**/${project.build.directory}/**</exclude>
+                <exclude>mvnw</exclude>
+                <exclude>mvnw.cmd</exclude>
+                <exclude>.mvn/**</exclude>
+                <exclude>src/**</exclude>
+            </excludes>
+        </fileSet>
+    </fileSets>
+</assembly>
+
+
+
+
+
+
+

5.2. Workflow

+
+

The workflow assumes that Spring Cloud Contract is set up both on the consumer and on the +producer side. There is also the proper plugin setup in the common repository with +contracts. The CI jobs are set for a common repository to build an artifact of all +contracts and upload it to Nexus/Artifactory. The following image shows the UML for this +workflow:

+
+
+
+how to common repo +
+
+
+
+

5.3. Consumer

+
+

When the consumer wants to work on the contracts offline, instead of cloning the producer +code, the consumer team clones the common repository, goes to the required producer’s +folder (for example, com/example/server) and runs mvn clean install -DskipTests to +locally install the stubs converted from the contracts.

+
+
+ + + + + +
+ + +You need to have Maven installed locally +
+
+
+
+

5.4. Producer

+
+

As a producer, you can to alter the Spring Cloud Contract Verifier to provide the URL and +the dependency of the JAR that contains the contracts, as follows:

+
+
+
+
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <configuration>
+        <contractsMode>REMOTE</contractsMode>
+        <contractsRepositoryUrl>
+            https://link/to/your/nexus/or/artifactory/or/sth
+        </contractsRepositoryUrl>
+        <contractDependency>
+            <groupId>com.example.standalone</groupId>
+            <artifactId>contracts</artifactId>
+        </contractDependency>
+    </configuration>
+</plugin>
+
+
+
+
+
+

With this setup, the JAR with a groupid of com.example.standalone and artifactid +contracts is downloaded from link/to/your/nexus/or/artifactory/or/sth. It is +then unpacked in a local temporary folder, and the contracts present in +com/example/server are picked as the ones used to generate the tests and the stubs. Due +to this convention, the producer team can know which consumer teams will be broken when +some incompatible changes are made.

+
+
+

The rest of the flow looks the same.

+
+
+
+

5.5. How Can I Define Messaging Contracts per Topic Rather than per Producer?

+
+

To avoid messaging contracts duplication in the common repository, when a few producers write messages to one topic, +we could create a structure in which the REST contracts are placed in a folder per producer and messaging +contracts are placed in the folder per topic.

+
+
+

5.5.1. For Maven Projects

+
+

To make it possible to work on the producer side, we should specify an inclusion pattern for +filtering common repository jar files by messaging topics we are interested in. The +includedFiles property of the Maven Spring Cloud Contract plugin +lets us do so. Also, contractsPath need to be specified, since the default path would be +the common repository groupid/artifactid. The following example shows a Maven +plugin for Spring Cloud Contract:

+
+
+
+
+
+
<plugin>
+   <groupId>org.springframework.cloud</groupId>
+   <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+   <version>${spring-cloud-contract.version}</version>
+   <configuration>
+      <contractsMode>REMOTE</contractsMode>
+      <contractsRepositoryUrl>https://link/to/your/nexus/or/artifactory/or/sth</contractsRepositoryUrl>
+      <contractDependency>
+         <groupId>com.example</groupId>
+         <artifactId>common-repo-with-contracts</artifactId>
+         <version>+</version>
+      </contractDependency>
+      <contractsPath>/</contractsPath>
+      <baseClassMappings>
+         <baseClassMapping>
+            <contractPackageRegex>.*messaging.*</contractPackageRegex>
+            <baseClassFQN>com.example.services.MessagingBase</baseClassFQN>
+         </baseClassMapping>
+         <baseClassMapping>
+            <contractPackageRegex>.*rest.*</contractPackageRegex>
+            <baseClassFQN>com.example.services.TestBase</baseClassFQN>
+         </baseClassMapping>
+      </baseClassMappings>
+      <includedFiles>
+         <includedFile>**/${project.artifactId}/**</includedFile>
+         <includedFile>**/${first-topic}/**</includedFile>
+         <includedFile>**/${second-topic}/**</includedFile>
+      </includedFiles>
+   </configuration>
+</plugin>
+
+
+
+
+
+ + + + + +
+ + +Many of the values in the preceding Maven plugin can be changed. We included it for +illustration purposes rather than trying to provide a “typical” example. +
+
+
+
+

5.5.2. For Gradle Projects

+
+

To work with a Gradle project:

+
+
+
    +
  1. +

    Add a custom configuration for the common repository dependency, as follows:

    +
    +
    +
    +
    +
    ext {
+    conractsGroupId = "com.example"
+    contractsArtifactId = "common-repo"
+    contractsVersion = "1.2.3"
+}
+
+configurations {
+    contracts {
+        transitive = false
+    }
+}
    +
    +
    +
    +
    +
    2. +
  2. +

    Add the common repository dependency to your classpath, as follows:

    +
    +
    +
    +
    +
    dependencies {
+    contracts "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
+    testCompile "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
+}
    +
    +
    +
    +
    +
    3. +
  3. +

    Download the dependency to an appropriate folder, as follows:

    +
    +
    +
    +
    +
    task getContracts(type: Copy) {
+    from configurations.contracts
+    into new File(project.buildDir, "downloadedContracts")
+}
    +
    +
    +
    +
    +
    4. +
  4. +

    Unzip the JAR, as follows:

    +
    +
    +
    +
    +
    task unzipContracts(type: Copy) {
+    def zipFile = new File(project.buildDir, "downloadedContracts/${contractsArtifactId}-${contractsVersion}.jar")
+    def outputDir = file("${buildDir}/unpackedContracts")
+
+    from zipTree(zipFile)
+    into outputDir
+}
    +
    +
    +
    +
    +
    5. +
  5. +

    Cleanup unused contracts, as follows:

    +
    +
    +
    +
    +
    task deleteUnwantedContracts(type: Delete) {
+    delete fileTree(dir: "${buildDir}/unpackedContracts",
+        include: "**/*",
+        excludes: [
+            "**/${project.name}/**"",
+            "**/${first-topic}/**",
+            "**/${second-topic}/**"])
+}
    +
    +
    +
    +
    +
    6. +
  6. +

    Create task dependencies, as follows:

    +
    +
    +
    +
    +
    unzipContracts.dependsOn("getContracts")
+deleteUnwantedContracts.dependsOn("unzipContracts")
+build.dependsOn("deleteUnwantedContracts")
    +
    +
    +
    +
    +
    7. +
  7. +

    Configure the plugin by specifying the directory that contains the contracts, by setting +the contractsDslDir property, as follows:

    +
    +
    +
    +
    +
    contracts {
+    contractsDslDir = new File("${buildDir}/unpackedContracts")
+}
    +
    +
    +
    +
    +
    8. +
+
+
+
+
+
+
+

6. How Can I Use Git as the Storage for Contracts and Stubs?

+
+
+

In the polyglot world, there are languages that do not use binary storages, as +Artifactory or Nexus do. Starting from Spring Cloud Contract version 2.0.0, we provide +mechanisms to store contracts and stubs in a SCM (Source Control Management) repository. Currently, the +only supported SCM is Git.

+
+
+

The repository would have to have the following setup +(which you can checkout from here):

+
+
+
+
+
+
.
+└── META-INF
+    └── com.example
+        └── beer-api-producer-git
+            └── 0.0.1-SNAPSHOT
+                ├── contracts
+                │   └── beer-api-consumer
+                │       ├── messaging
+                │       │   ├── shouldSendAcceptedVerification.groovy
+                │       │   └── shouldSendRejectedVerification.groovy
+                │       └── rest
+                │           ├── shouldGrantABeerIfOldEnough.groovy
+                │           └── shouldRejectABeerIfTooYoung.groovy
+                └── mappings
+                    └── beer-api-consumer
+                        └── rest
+                            ├── shouldGrantABeerIfOldEnough.json
+                            └── shouldRejectABeerIfTooYoung.json
+
+
+
+
+
+

Under the META-INF folder:

+
+
+
    +
  • +

    We group applications by groupId (such as com.example).

    +
    • +
  • +

    Each application is represented by its artifactId (for example, beer-api-producer-git).

    +
    • +
  • +

    Next, each application is organized by its version (such as 0.0.1-SNAPSHOT). Starting +from Spring Cloud Contract version 2.1.0, you can specify the versions as follows +(assuming that your versions follow semantic versioning):

    +
    +
      +
    • +

      + or latest: To find the latest version of your stubs (assuming that the snapshots +are always the latest artifact for a given revision number). That means:

      +
      +
        +
      • +

        If you have 1.0.0.RELEASE, 2.0.0.BUILD-SNAPSHOT, and 2.0.0.RELEASE, we assume +that the latest is 2.0.0.BUILD-SNAPSHOT.

        +
        • +
      • +

        If you have 1.0.0.RELEASE and 2.0.0.RELEASE, we assume that the latest is 2.0.0.RELEASE.

        +
        • +
      • +

        If you have a version called latest or +, we will pick that folder.

        +
        • +
      +
      +
      • +
    • +

      release: To find the latest release version of your stubs. That means:

      +
      +
        +
      • +

        If you have 1.0.0.RELEASE, 2.0.0.BUILD-SNAPSHOT, and 2.0.0.RELEASE we assume +that the latest is 2.0.0.RELEASE.

        +
        • +
      • +

        If you have a version called release, we pick that folder.

        +
        • +
      +
      +
      • +
    +
    +
    • +
+
+
+

Finally, there are two folders:

+
+
+
    +
  • +

    contracts: The good practice is to store the contracts required by each +consumer in the folder with the consumer name (such as beer-api-consumer). That way, you +can use the stubs-per-consumer feature. Further directory structure is arbitrary.

    +
    • +
  • +

    mappings: The Maven or Gradle Spring Cloud Contract plugins push +the stub server mappings in this folder. On the consumer side, Stub Runner scans this folder +to start stub servers with stub definitions. The folder structure is a copy +of the one created in the contracts subfolder.

    +
    • +
+
+
+

6.1. Protocol Convention

+
+

To control the type and location of the source of contracts (whether +binary storage or an SCM repository), you can use the protocol in the URL of +the repository. Spring Cloud Contract iterates over registered protocol resolvers +and tries to fetch the contracts (by using a plugin) or stubs (from Stub Runner).

+
+
+

For the SCM functionality, currently, we support the Git repository. To use it, +in the property where the repository URL needs to be placed, you have to prefix +the connection URL with git://. The following listing shows some examples:

+
+
+
+
+
+
git://file:///foo/bar
+git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git
+git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git
+
+
+
+
+
+
+

6.2. Producer

+
+

For the producer, to use the SCM (Source Control Management) approach, we can reuse the +same mechanism we use for external contracts. We route Spring Cloud Contract +to use the SCM implementation from the URL that starts with +the git:// protocol.

+
+
+ + + + + +
+ + +You have to manually add the pushStubsToScm +goal in Maven or execute (bind) the pushStubsToScm task in +Gradle. We do not push stubs to the origin of your git +repository. +
+
+
+

The following listing includes the relevant parts both Maven and Gradle build files:

+
+
+
+
+
maven
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${spring-cloud-contract.version}</version>
+    <extensions>true</extensions>
+    <configuration>
+        <!-- Base class mappings etc. -->
+
+        <!-- We want to pick contracts from a Git repository -->
+        <contractsRepositoryUrl>git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git</contractsRepositoryUrl>
+
+        <!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts -->
+        <contractDependency>
+            <groupId>${project.groupId}</groupId>
+            <artifactId>${project.artifactId}</artifactId>
+            <version>${project.version}</version>
+        </contractDependency>
+
+        <!-- The contracts mode can't be classpath -->
+        <contractsMode>REMOTE</contractsMode>
+    </configuration>
+    <executions>
+        <execution>
+            <phase>package</phase>
+            <goals>
+                <!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal -->
+                <goal>pushStubsToScm</goal>
+            </goals>
+        </execution>
+    </executions>
+</plugin>
+
+
+
+
gradle
+
+
contracts {
+    // We want to pick contracts from a Git repository
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:${project.version}"
+    }
+    /*
+    We reuse the contract dependency section to set up the path
+    to the folder that contains the contract definitions. In our case the
+    path will be /groupId/artifactId/version/contracts
+     */
+    contractRepository {
+        repositoryUrl = "git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publish.dependsOn("publishStubsToScm")
+
+
+
+
+
+

With such a setup:

+
+
+
    +
  • +

    A git project is cloned to a temporary directory

    +
    • +
  • +

    The SCM stub downloader goes to META-INF/groupId/artifactId/version/contracts folder +to find contracts. For example, for com.example:foo:1.0.0, the path would be +META-INF/com.example/foo/1.0.0/contracts.

    +
    • +
  • +

    Tests are generated from the contracts.

    +
    • +
  • +

    Stubs are created from the contracts.

    +
    • +
  • +

    Once the tests pass, the stubs are committed in the cloned repository.

    +
    • +
  • +

    Finally, a push is sent to that repo’s origin.

    +
    • +
+
+
+
+

6.3. Producer with Contracts Stored Locally

+
+

Another option to use the SCM as the destination for stubs and contracts is to store the +contracts locally, with the producer, and only push the contracts and the stubs to SCM. +The following listing shows the setup required to achieve this with Maven and Gradle:

+
+
+
+
+
maven
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${spring-cloud-contract.version}</version>
+    <extensions>true</extensions>
+    <!-- In the default configuration, we want to use the contracts stored locally -->
+    <configuration>
+        <baseClassMappings>
+            <baseClassMapping>
+                <contractPackageRegex>.*messaging.*</contractPackageRegex>
+                <baseClassFQN>com.example.BeerMessagingBase</baseClassFQN>
+            </baseClassMapping>
+            <baseClassMapping>
+                <contractPackageRegex>.*rest.*</contractPackageRegex>
+                <baseClassFQN>com.example.BeerRestBase</baseClassFQN>
+            </baseClassMapping>
+        </baseClassMappings>
+        <basePackageForTests>com.example</basePackageForTests>
+    </configuration>
+    <executions>
+        <execution>
+            <phase>package</phase>
+            <goals>
+                <!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal -->
+                <goal>pushStubsToScm</goal>
+            </goals>
+            <configuration>
+                <!-- We want to pick contracts from a Git repository -->
+                <contractsRepositoryUrl>git://file://${env.ROOT}/target/contract_empty_git/
+                </contractsRepositoryUrl>
+                <!-- Example of URL via git protocol -->
+                <!--<contractsRepositoryUrl>git://git@github.com:spring-cloud-samples/spring-cloud-contract-samples.git</contractsRepositoryUrl>-->
+                <!-- Example of URL via http protocol -->
+                <!--<contractsRepositoryUrl>git://https://github.com/spring-cloud-samples/spring-cloud-contract-samples.git</contractsRepositoryUrl>-->
+                <!-- We reuse the contract dependency section to set up the path
+                to the folder that contains the contract definitions. In our case the
+                path will be /groupId/artifactId/version/contracts -->
+                <contractDependency>
+                    <groupId>${project.groupId}</groupId>
+                    <artifactId>${project.artifactId}</artifactId>
+                    <version>${project.version}</version>
+                </contractDependency>
+                <!-- The mode can't be classpath -->
+                <contractsMode>LOCAL</contractsMode>
+            </configuration>
+        </execution>
+    </executions>
+</plugin>
+
+
+
+
gradle
+
+
contracts {
+        // Base package for generated tests
+    basePackageForTests = "com.example"
+    baseClassMappings {
+        baseClassMapping(".*messaging.*", "com.example.BeerMessagingBase")
+        baseClassMapping(".*rest.*", "com.example.BeerRestBase")
+    }
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publishStubsToScm {
+    // We want to modify the default set up of the plugin when publish stubs to scm is called
+    customize {
+        // We want to pick contracts from a Git repository
+        contractDependency {
+            stringNotation = "${project.group}:${project.name}:${project.version}"
+        }
+        /*
+        We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts
+         */
+        contractRepository {
+            repositoryUrl = "git://file://${new File(project.rootDir, "../target")}/contract_empty_git/"
+        }
+        // The mode can't be classpath
+        contractsMode = "LOCAL"
+    }
+}
+
+publish.dependsOn("publishStubsToScm")
+publishToMavenLocal.dependsOn("publishStubsToScm")
+
+
+
+
+
+

With such a setup:

+
+
+
    +
  • +

    Contracts from the default src/test/resources/contracts directory are picked.

    +
    • +
  • +

    Tests are generated from the contracts.

    +
    • +
  • +

    Stubs are created from the contracts.

    +
    • +
  • +

    Once the tests pass:

    +
    +
      +
    • +

      The git project is cloned to a temporary directory.

      +
      • +
    • +

      The stubs and contracts are committed in the cloned repository.

      +
      • +
    +
    +
    • +
  • +

    Finally, a push is done to that repository’s origin.

    +
    • +
+
+
+
+

6.4. Keeping Contracts with the Producer and Stubs in an External Repository

+
+

You can also keep the contracts in the producer repository but keep the stubs in an external git repository. +This is most useful when you want to use the base consumer-producer collaboration flow but cannot +use an artifact repository to store the stubs.

+
+
+

To do so, use the usual producer setup and then add the pushStubsToScm goal and set +contractsRepositoryUrl to the repository where you want to keep the stubs.

+
+
+
+

6.5. Consumer

+
+

On the consumer side, when passing the repositoryRoot parameter, +either from the @AutoConfigureStubRunner annotation, the +JUnit rule, JUnit 5 extension, or properties, you can pass the URL of the +SCM repository, prefixed with the git:// protocol. The following example shows how to do so:

+
+
+
+
+
+
@AutoConfigureStubRunner(
+    stubsMode="REMOTE",
+    repositoryRoot="git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git",
+    ids="com.example:bookstore:0.0.1.RELEASE"
+)
+
+
+
+
+
+

With such a setup:

+
+
+
    +
  • +

    The git project is cloned to a temporary directory.

    +
    • +
  • +

    The SCM stub downloader goes to thje META-INF/groupId/artifactId/version/ folder +to find stub definitions and contracts. For example, for com.example:foo:1.0.0, the path would be +META-INF/com.example/foo/1.0.0/.

    +
    • +
  • +

    Stub servers are started and fed with mappings.

    +
    • +
  • +

    Messaging definitions are read and used in the messaging tests.

    +
    • +
+
+
+
+
+
+

7. How Can I Use the Pact Broker?

+
+
+

When using Pact, you can use the Pact Broker +to store and share Pact definitions. Starting from Spring Cloud Contract +2.0.0, you can fetch Pact files from the Pact Broker to generate +tests and stubs.

+
+
+ + + + + +
+ + +Pact follows the consumer contract convention. That means +that the consumer creates the Pact definitions first and then +shares the files with the Producer. Those expectations are generated +from the Consumer’s code and can break the Producer if the expectations +are not met. +
+
+
+

7.1. How to Work with Pact

+
+

Spring Cloud Contract includes support for the Pact representation of +contracts up until version 4. Instead of using the DSL, you can use Pact files. In this section, we +show how to add Pact support for your project. Note, however, that not all functionality is supported. +Starting with version 3, you can combine multiple matchers for the same element; +you can use matchers for the body, headers, request and path; and you can use value generators. +Spring Cloud Contract currently only supports multiple matchers that are combined by using the AND rule logic. +Next to that, the request and path matchers are skipped during the conversion. +When using a date, time, or datetime value generator with a given format, +the given format is skipped and the ISO format is used.

+
+
+
+

7.2. Pact Converter

+
+

In order to properly support the Spring Cloud Contract way of doing messaging +with Pact, you have to provide some additional meta data entries.

+
+
+

To define the destination to which a message gets sent, you have to +set a metaData entry in the Pact file with the sentTo key equal to the destination to + which a message is to be sent (for example, "metaData": { "sentTo": "activemq:output" }).

+
+
+
+

7.3. Pact Contract

+
+

Spring Cloud Contract can read the Pact JSON definition. You can place the file in the +src/test/resources/contracts folder. Remember to put the spring-cloud-contract-pact dependency to your classpath. The following example shows such a Pact contract:

+
+
+
+
+
+
{
+  "provider": {
+    "name": "Provider"
+  },
+  "consumer": {
+    "name": "Consumer"
+  },
+  "interactions": [
+    {
+      "description": "",
+      "request": {
+        "method": "PUT",
+        "path": "/pactfraudcheck",
+        "headers": {
+          "Content-Type": "application/json"
+        },
+        "body": {
+          "clientId": "1234567890",
+          "loanAmount": 99999
+        },
+        "generators": {
+          "body": {
+            "$.clientId": {
+              "type": "Regex",
+              "regex": "[0-9]{10}"
+            }
+          }
+        },
+        "matchingRules": {
+          "header": {
+            "Content-Type": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "application/json.*"
+                }
+              ],
+              "combine": "AND"
+            }
+          },
+          "body": {
+            "$.clientId": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "[0-9]{10}"
+                }
+              ],
+              "combine": "AND"
+            }
+          }
+        }
+      },
+      "response": {
+        "status": 200,
+        "headers": {
+          "Content-Type": "application/json"
+        },
+        "body": {
+          "fraudCheckStatus": "FRAUD",
+          "rejection.reason": "Amount too high"
+        },
+        "matchingRules": {
+          "header": {
+            "Content-Type": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "application/json.*"
+                }
+              ],
+              "combine": "AND"
+            }
+          },
+          "body": {
+            "$.fraudCheckStatus": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "FRAUD"
+                }
+              ],
+              "combine": "AND"
+            }
+          }
+        }
+      }
+    }
+  ],
+  "metadata": {
+    "pact-specification": {
+      "version": "3.0.0"
+    },
+    "pact-jvm": {
+      "version": "3.5.13"
+    }
+  }
+}
+
+
+
+
+
+
+

7.4. Pact for Producers

+
+

On the producer side, you must add two additional dependencies to your plugin +configuration. One is the Spring Cloud Contract Pact support, and the other represents +the current Pact version that you use. The following listing shows how to do so for both +Maven and Gradle:

+
+
+
+
+
Maven
+
+
+
+
+
+
Gradle
+
+
// if additional dependencies are needed e.g. for Pact
+classpath "org.springframework.cloud:spring-cloud-contract-pact:${findProperty('verifierVersion') ?: verifierVersion}"
+
+
+
+
+
+

When you execute the build of your application, a test and stub is generated. The following +example shows a test and stub that came from this process:

+
+
+
+
+
test
+
+
@Test
+    public void validate_shouldMarkClientAsFraud() throws Exception {
+        // given:
+            MockMvcRequestSpecification request = given()
+                    .header("Content-Type", "application/vnd.fraud.v1+json")
+                    .body("{\"clientId\":\"1234567890\",\"loanAmount\":99999}");
+
+        // when:
+            ResponseOptions response = given().spec(request)
+                    .put("/fraudcheck");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+            assertThat(response.header("Content-Type")).matches("application/vnd\\.fraud\\.v1\\+json.*");
+        // and:
+            DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+            assertThatJson(parsedJson).field("['rejectionReason']").isEqualTo("Amount too high");
+        // and:
+            assertThat(parsedJson.read("$.fraudCheckStatus", String.class)).matches("FRAUD");
+    }
+
+
+
+
stub
+
+
{
+  "id" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
+  "uuid" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
+  "request" : {
+    "url" : "/fraudcheck",
+    "method" : "PUT",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "application/vnd\\.fraud\\.v1\\+json.*"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['loanAmount'] = 99999)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.clientId =~ /([0-9]{10})/)]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\"fraudCheckStatus\":\"FRAUD\",\"rejectionReason\":\"Amount too high\"}",
+    "headers" : {
+      "Content-Type" : "application/vnd.fraud.v1+json;charset=UTF-8"
+    },
+    "transformers" : [ "response-template" ]
+  },
+}
+
+
+
+
+
+
+

7.5. Pact for Consumers

+
+

On the consumer side, you must add two additional dependencies to your project +dependencies. One is the Spring Cloud Contract Pact support, and the other represents the +current Pact version that you use. The following listing shows how to do so for both +Maven and Gradle:

+
+
+
+
+
Maven
+
+
+
+
+
+
Gradle
+
+
+
+
+
+
+
+
+

7.6. Communicating with the Pact Broker

+
+

Whenever the repositoryRoot property starts with a Pact protocol +(starts with pact://), the stub downloader tries +to fetch the Pact contract definitions from the Pact Broker. +Whatever is set after pact:// is parsed as the Pact Broker URL.

+
+
+

By setting environment variables, system properties, or properties set +inside the plugin or contracts repository configuration, you can +tweak the downloader’s behavior. The following table describes the +properties:

+
+ + +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1. Pact Stub Downloader properties

Name of a property

Default

Description

* pactbroker.host (plugin prop)

+

* stubrunner.properties.pactbroker.host (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_HOST (env prop)

Host from URL passed to repositoryRoot

The URL of the Pact Broker.

* pactbroker.port (plugin prop)

+

* stubrunner.properties.pactbroker.port (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_PORT (env prop)

Port from URL passed to repositoryRoot

The port of Pact Broker.

* pactbroker.protocol (plugin prop)

+

* stubrunner.properties.pactbroker.protocol (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_PROTOCOL (env prop)

Protocol from URL passed to repositoryRoot

The protocol of Pact Broker.

* pactbroker.tags (plugin prop)

+

* stubrunner.properties.pactbroker.tags (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_TAGS (env prop)

Version of the stub, or latest if version is +

The tags that should be used to fetch the stub.

* pactbroker.auth.scheme (plugin prop)

+

* stubrunner.properties.pactbroker.auth.scheme (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_SCHEME (env prop)

Basic

The kind of authentication that should be used to connect to the Pact Broker.

* pactbroker.auth.username (plugin prop)

+

* stubrunner.properties.pactbroker.auth.username (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_USERNAME (env prop)

The username passed to contractsRepositoryUsername (maven) or contractRepository.username (gradle)

The username to use when connecting to the Pact Broker.

* pactbroker.auth.password (plugin prop)

+

* stubrunner.properties.pactbroker.auth.password (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_PASSWORD (env prop)

The password passed to contractsRepositoryPassword (maven) or contractRepository.password (gradle)

The password to use when connecting to the Pact Broker.

* pactbroker.provider-name-with-group-id (plugin prop)

+

* stubrunner.properties.pactbroker.provider-name-with-group-id (system prop)

+

* STUBRUNNER_PROPERTIES_PACTBROKER_PROVIDER_NAME_WITH_GROUP_ID (env prop)

false

When true, the provider name is a combination of groupId:artifactId. If false, only artifactId is used.

+
+
+

7.7. Flow: Consumer Contract approach with Pact Broker | Consumer Side

+
+

The consumer uses the Pact framework to generate Pact files. The +Pact files are sent to the Pact Broker. You can find an example of such a setup +here.

+
+
+
+

7.8. Flow: Consumer Contract Approach with Pact Broker on the Producer Side

+
+

For the producer to use the Pact files from the Pact Broker, we can reuse the +same mechanism we use for external contracts. We route Spring Cloud Contract +to use the Pact implementation with the URL that contains +the pact:// protocol. You can pass the URL to the +Pact Broker. You can find an example of such a setup +here. +The following listing shows the configuration details for both Maven and Gradle:

+
+
+
+
+
maven
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${spring-cloud-contract.version}</version>
+    <extensions>true</extensions>
+    <configuration>
+        <!-- Base class mappings etc. -->
+
+        <!-- We want to pick contracts from a Git repository -->
+        <contractsRepositoryUrl>pact://http://localhost:8085</contractsRepositoryUrl>
+
+        <!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts -->
+        <contractDependency>
+            <groupId>${project.groupId}</groupId>
+            <artifactId>${project.artifactId}</artifactId>
+            <!-- When + is passed, a latest tag will be applied when fetching pacts -->
+            <version>+</version>
+        </contractDependency>
+
+        <!-- The contracts mode can't be classpath -->
+        <contractsMode>REMOTE</contractsMode>
+    </configuration>
+    <!-- Don't forget to add spring-cloud-contract-pact to the classpath! -->
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-contract-pact</artifactId>
+            <version>${spring-cloud-contract.version}</version>
+        </dependency>
+    </dependencies>
+</plugin>
+
+
+
+
gradle
+
+
buildscript {
+    repositories {
+        //...
+    }
+
+    dependencies {
+        // ...
+        // Don't forget to add spring-cloud-contract-pact to the classpath!
+        classpath "org.springframework.cloud:spring-cloud-contract-pact:${contractVersion}"
+    }
+}
+
+contracts {
+    // When + is passed, a latest tag will be applied when fetching pacts
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:+"
+    }
+    contractRepository {
+        repositoryUrl = "pact://http://localhost:8085"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}
+
+
+
+
+
+

With such a setup:

+
+
+
    +
  • +

    Pact files are downloaded from the Pact Broker.

    +
    • +
  • +

    Spring Cloud Contract converts the Pact files into tests and stubs.

    +
    • +
  • +

    The JAR with the stubs gets automatically created, as usual.

    +
    • +
+
+
+
+

7.9. Flow: Producer Contract approach with Pact on the Consumer Side

+
+

In the scenario where you do not want to do the consumer contract approach +(for every single consumer, define the expectations) but you prefer +to do producer contracts (the producer provides the contracts and +publishes stubs), you can use Spring Cloud Contract with the +Stub Runner option. You can find an example of such a setup +here.

+
+
+

Remember to add the Stub Runner and Spring Cloud Contract Pact modules +as test dependencies.

+
+
+

The following listing shows the configuration details for both Maven and Gradle:

+
+
+
+
+
maven
+
+
<dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-dependencies</artifactId>
+            <version>${spring-cloud.version}</version>
+            <type>pom</type>
+            <scope>import</scope>
+        </dependency>
+    </dependencies>
+</dependencyManagement>
+
+<!-- Don't forget to add spring-cloud-contract-pact to the classpath! -->
+<dependencies>
+    <!-- ... -->
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-starter-contract-stub-runner</artifactId>
+        <scope>test</scope>
+    </dependency>
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-contract-pact</artifactId>
+        <scope>test</scope>
+    </dependency>
+</dependencies>
+
+
+
+
gradle
+
+
dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
+    }
+}
+
+dependencies {
+    //...
+    testCompile("org.springframework.cloud:spring-cloud-starter-contract-stub-runner")
+    // Don't forget to add spring-cloud-contract-pact to the classpath!
+    testCompile("org.springframework.cloud:spring-cloud-contract-pact")
+}
+
+
+
+
+
+

Next, you can pass the URL of the Pact Broker to repositoryRoot, prefixed +with pact:// protocol (for example, pact://http://localhost:8085), as the following +example shows:

+
+
+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureStubRunner(stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        ids = "com.example:beer-api-producer-pact",
+        repositoryRoot = "pact://http://localhost:8085")
+public class BeerControllerTest {
+    //Inject the port of the running stub
+    @StubRunnerPort("beer-api-producer-pact") int producerPort;
+    //...
+}
+
+
+
+
+
+

With such a setup:

+
+
+
    +
  • +

    Pact files are downloaded from the Pact Broker.

    +
    • +
  • +

    Spring Cloud Contract converts the Pact files into stub definitions.

    +
    • +
  • +

    The stub servers are started and fed with stubs.

    +
    • +
+
+
+
+
+
+

8. How Can I Debug the Request/Response Being Sent by the Generated Tests Client?

+
+
+

The generated tests all boil down to RestAssured in some form or fashion. RestAssured +relies on the Apache HttpClient. +HttpClient has a facility called +wire logging, +which logs the entire request and response to HttpClient. Spring Boot has a logging +common application property +for doing this sort of thing. To use it, add this to your application properties, as follows:

+
+
+
+
+
+
logging.level.org.apache.http.wire=DEBUG
+
+
+
+
+
+
+
+

9. How Can I Debug the Mapping, Request, or Response Being Sent by WireMock?

+
+
+

Starting from version 1.2.0, we turn on WireMock logging to +info and set the WireMock notifier to being verbose. Now you can +exactly know what request was received by the WireMock server and which +matching response definition was picked.

+
+
+

To turn off this feature, set WireMock logging to ERROR, as follows:

+
+
+
+
+
+
logging.level.com.github.tomakehurst.wiremock=ERROR
+
+
+
+
+
+
+
+

10. How Can I See What Got Registered in the HTTP Server Stub?

+
+
+

You can use the mappingsOutputFolder property on @AutoConfigureStubRunner, StubRunnerRule, or +`StubRunnerExtension`to dump all mappings per artifact ID. Also the port at which the given stub server +was started is attached.

+
+
+
+
+

11. How Can I Reference Text from File?

+
+
+

In version 1.2.0, we added this ability. You can call a file(…​) method in the +DSL and provide a path relative to where the contract lies. +If you use YAML, you can use the bodyFromFile property.

+
+
+
+
+

12. How Can I Generate Pact, YAML, or X files from Spring Cloud Contract Contracts?

+
+
+

Spring Cloud Contract comes with a ToFileContractsTransformer class that lets you dump +contracts as files for the given ContractConverter. It contains a static void main +method that lets you execute the transformer as an executable. It takes the following +arguments:

+
+
+
    +
  • +

    argument 1 : FQN: Fully qualified name of the ContractConverter (for example, PactContractConverter). REQUIRED.

    +
    • +
  • +

    argument 2 : path: Path where the dumped files should be stored. OPTIONAL — defaults to target/converted-contracts.

    +
    • +
  • +

    argument 3 : path: Path were the contracts should be searched for. OPTIONAL — defaults to src/test/resources/contracts.

    +
    • +
+
+
+

After executing the transformer, the Spring Cloud Contract files are processed and, +depending on the provided FQN of the ContractTransformer, the contracts are transformed +to the required format and dumped to the provided folder.

+
+
+

The following example shows how to configure Pact integration for both Maven and Gradle:

+
+
+
+
+
maven
+
+
<plugin>
+    <groupId>org.codehaus.mojo</groupId>
+    <artifactId>exec-maven-plugin</artifactId>
+    <version>1.6.0</version>
+    <executions>
+        <execution>
+            <id>convert-dsl-to-pact</id>
+            <phase>process-test-classes</phase>
+            <configuration>
+                <classpathScope>test</classpathScope>
+                <mainClass>
+                    org.springframework.cloud.contract.verifier.util.ToFileContractsTransformer
+                </mainClass>
+                <arguments>
+                    <argument>
+                        org.springframework.cloud.contract.verifier.spec.pact.PactContractConverter
+                    </argument>
+                    <argument>${project.basedir}/target/pacts</argument>
+                    <argument>
+                        ${project.basedir}/src/test/resources/contracts
+                    </argument>
+                </arguments>
+            </configuration>
+            <goals>
+                <goal>java</goal>
+            </goals>
+        </execution>
+    </executions>
+</plugin>
+
+
+
+
gradle
+
+
task convertContracts(type: JavaExec) {
+    main = "org.springframework.cloud.contract.verifier.util.ToFileContractsTransformer"
+    classpath = sourceSets.test.compileClasspath
+    args("org.springframework.cloud.contract.verifier.spec.pact.PactContractConverter",
+            "${project.rootDir}/build/pacts", "${project.rootDir}/src/test/resources/contracts")
+}
+
+test.dependsOn("convertContracts")
+
+
+
+
+
+
+
+

13. How Can I Work with Transitive Dependencies?

+
+
+

The Spring Cloud Contract plugins add the tasks that create the stubs jar for you. One +problem that arises is that, when reusing the stubs, you can mistakenly import all of +that stub’s dependencies. When building a Maven artifact, even though you have a couple +of different jars, all of them share one pom, as the following listing shows:

+
+
+
+
+
+
├── producer-0.0.1.BUILD-20160903.075506-1-stubs.jar
+├── producer-0.0.1.BUILD-20160903.075506-1-stubs.jar.sha1
+├── producer-0.0.1.BUILD-20160903.075655-2-stubs.jar
+├── producer-0.0.1.BUILD-20160903.075655-2-stubs.jar.sha1
+├── producer-0.0.1.BUILD-SNAPSHOT.jar
+├── producer-0.0.1.BUILD-SNAPSHOT.pom
+├── producer-0.0.1.BUILD-SNAPSHOT-stubs.jar
+├── ...
+└── ...
+
+
+
+
+
+

There are three possibilities of working with those dependencies so as not to have any +issues with transitive dependencies:

+
+
+
    +
  • +

    Mark all application dependencies as optional

    +
    • +
  • +

    Create a separate artifactid for the stubs

    +
    • +
  • +

    Exclude dependencies on the consumer side

    +
    • +
+
+
+

13.1. How Can I Mark All Application Dependencies as Optional?

+
+

If, in the producer application, you mark all of your dependencies as optional, +when you include the producer stubs in another application (or when that +dependency gets downloaded by Stub Runner) then, since all of the dependencies are +optional, they do not get downloaded.

+
+
+
+

13.2. How can I Create a Separate artifactid for the Stubs?

+
+

If you create a separate artifactid, you can set it up in whatever way you wish. +For example, you might decide to have no dependencies at all.

+
+
+
+

13.3. How can I Exclude Dependencies on the Consumer Side?

+
+

As a consumer, if you add the stub dependency to your classpath, you can explicitly exclude the unwanted dependencies.

+
+
+
+
+
+

14. How can I Generate Spring REST Docs Snippets from the Contracts?

+
+
+

When you want to include the requests and responses of your API by using Spring REST Docs, +you only need to make some minor changes to your setup if you are using MockMvc and RestAssuredMockMvc. +To do so, include the following dependencies (if you have not already done so):

+
+
+
+
+
maven
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-contract-verifier</artifactId>
+    <scope>test</scope>
+</dependency>
+<dependency>
+    <groupId>org.springframework.restdocs</groupId>
+    <artifactId>spring-restdocs-mockmvc</artifactId>
+    <optional>true</optional>
+</dependency>
+
+
+
+
gradle
+
+
testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+testCompile 'org.springframework.restdocs:spring-restdocs-mockmvc'
+
+
+
+
+
+

Next, you need to make some changes to your base class. The following examples use +WebAppContext and the standalone option with RestAssured:

+
+
+
+
+
WebAppContext
+
+
package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.rules.TestName;
+import org.junit.runner.RunWith;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.restdocs.JUnitRestDocumentation;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+import org.springframework.web.context.WebApplicationContext;
+
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest(classes = Application.class)
+public abstract class FraudBaseWithWebAppSetup {
+
+    private static final String OUTPUT = "target/generated-snippets";
+
+    @Rule
+    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
+
+    @Rule
+    public TestName testName = new TestName();
+
+    @Autowired
+    private WebApplicationContext context;
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.mockMvc(MockMvcBuilders.webAppContextSetup(this.context)
+                .apply(documentationConfiguration(this.restDocumentation))
+                .alwaysDo(document(
+                        getClass().getSimpleName() + "_" + testName.getMethodName()))
+                .build());
+    }
+
+    protected void assertThatRejectionReasonIsNull(Object rejectionReason) {
+        assert rejectionReason == null;
+    }
+
+}
+
+
+
+
Standalone
+
+
package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.rules.TestName;
+
+import org.springframework.restdocs.JUnitRestDocumentation;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
+
+public abstract class FraudBaseWithStandaloneSetup {
+
+    private static final String OUTPUT = "target/generated-snippets";
+
+    @Rule
+    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
+
+    @Rule
+    public TestName testName = new TestName();
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.standaloneSetup(MockMvcBuilders
+                .standaloneSetup(new FraudDetectionController())
+                .apply(documentationConfiguration(this.restDocumentation))
+                .alwaysDo(document(
+                        getClass().getSimpleName() + "_" + testName.getMethodName())));
+    }
+
+}
+
+
+
+
+
+ + + + + +
+ + +You need not specify the output directory for the generated snippets (since version 1.2.0.RELEASE of Spring REST Docs). +
+
+
+
+
+

15. How can I Use Stubs from a Location

+
+
+

If you want to fetch contracts or stubs from a given location without cloning a repo or fetching a JAR, just use the stubs:// protocol when providing the repository root argument for Stub Runner or the Spring Cloud Contract plugin. You can read more about this in this section of the documentation.

+
+
+
+
+

16. How can I Generate Stubs at Runtime

+
+
+

If you want to generate stubs at runtime for contracts, it’s enough to switch the generateStubs property in the @AutoConfigureStubRunner annotation, or call the withGenerateStubs(true) method on the JUnit Rule or Extension. You can read more about this in this section of the documentation.

+
+
+
+
+

17. How can I Make The Build Pass if There Are No Contracts or Stubs

+
+
+

If you want Stub Runner not to fail if no stubs were found, it’s enough to switch the generateStubs property in the @AutoConfigureStubRunner annotation, or call the withFailOnNoStubs(false) method on the JUnit Rule or Extension. You can read more about this in this section of the documentation.

+
+
+

If you want the plugins not to fail the build when no contracts were found, you can set the failOnNoStubs flag in Maven or call the contractRepository { failOnNoStubs(false) } Closure in Gradle.

+
+
+
+
+

18. How can I Mark that a Contract Is in Progress

+
+
+

If a contract is in progress, it means that the on the producer side tests will not be generated, but the stub will be. You can read more about this in this section of the documentation.

+
+
+

In a CI build, before going to production, you would like to ensure that no in progress contracts are there on the classpath. That’s because you may lead to false positives. That’s why, by default, in the Spring Cloud Contract plugin, we set the value of failOnInProgress to true. If you want to allow such contracts when tests are to be generated, just set the flag to false.

+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/images/Deps.png b/spring-cloud-contract/2.2.0.RC1/reference/html/images/Deps.png new file mode 100644 index 0000000000000000000000000000000000000000..1426814308101b8ccf6ef95fd195e37c0a180392 GIT binary patch literal 37192 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 A(f|Me literal 0 HcmV?d00001 diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/images/Stubs1.png b/spring-cloud-contract/2.2.0.RC1/reference/html/images/Stubs1.png new file mode 100644 index 0000000000000000000000000000000000000000..ebadfdb91014284b917367e3d9c9c8a137da3993 GIT binary patch literal 35170 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 literal 0 HcmV?d00001 diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/images/flow-overview-consumer-cdc-external-consumer.png b/spring-cloud-contract/2.2.0.RC1/reference/html/images/flow-overview-consumer-cdc-external-consumer.png new file mode 100644 index 0000000000000000000000000000000000000000..19db41fa117d3b8ed730ad569ca8ee6856305e26 GIT binary patch literal 31889 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 NlTnc_k~Dt)e*iG5s}TSI literal 0 HcmV?d00001 diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/images/flow-overview-consumer-cdc-external-producer.png b/spring-cloud-contract/2.2.0.RC1/reference/html/images/flow-overview-consumer-cdc-external-producer.png new file mode 100644 index 0000000000000000000000000000000000000000..c08b20b8d24920960ceb0a92522dc2455ebcbbab GIT binary patch literal 64940 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ʂ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 Q4ox8=sc=2(n!%s{3y~;m<^TWy literal 0 HcmV?d00001 diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/images/flows-provider-non-jvm-consumer.png b/spring-cloud-contract/2.2.0.RC1/reference/html/images/flows-provider-non-jvm-consumer.png new file mode 100644 index 0000000000000000000000000000000000000000..54100c620c631e3236969c267f0553c47cc859b1 GIT binary patch literal 29633 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 MlE&E_MT>y{1H80h0RR91 literal 0 HcmV?d00001 diff --git a/spring-cloud-contract/2.2.0.RC1/reference/html/images/flows-provider-rest-docs-producer.png b/spring-cloud-contract/2.2.0.RC1/reference/html/images/flows-provider-rest-docs-producer.png new file mode 100644 index 0000000000000000000000000000000000000000..5d544bbc9b74b4ce805cc47643b467b2d7689287 GIT binary patch literal 31169 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