From deb7ac73c50e9867ca69a9096cf3edd7c3c2dbcb Mon Sep 17 00:00:00 2001 From: Ryan Baxter Date: Tue, 29 Aug 2017 11:25:37 -0400 Subject: [PATCH] Sync docs from vEdgware.M1 to gh-pages --- Edgware.M1/configprops.groovy | 71 + Edgware.M1/ghpages.sh | 348 + Edgware.M1/images/.gitkeep | 0 Edgware.M1/images/Deps.png | Bin 0 -> 37192 bytes Edgware.M1/images/Hystrix.png | Bin 0 -> 230655 bytes Edgware.M1/images/HystrixFallback.png | Bin 0 -> 44880 bytes Edgware.M1/images/HystrixGraph.png | Bin 0 -> 39829 bytes Edgware.M1/images/RequestLatency.png | Bin 0 -> 14722 bytes Edgware.M1/images/SCSt-groups.png | Bin 0 -> 17392 bytes Edgware.M1/images/SCSt-partitioning.png | Bin 0 -> 18068 bytes Edgware.M1/images/SCSt-sensors.png | Bin 0 -> 16910 bytes Edgware.M1/images/SCSt-with-binder.png | Bin 0 -> 18899 bytes Edgware.M1/images/Stubs1.png | Bin 0 -> 35170 bytes Edgware.M1/images/Stubs2.png | Bin 0 -> 18143 bytes Edgware.M1/images/background.png | Bin 0 -> 6267 bytes Edgware.M1/images/caution.png | Bin 0 -> 2099 bytes Edgware.M1/images/dependencies.png | Bin 0 -> 24824 bytes Edgware.M1/images/important.png | Bin 0 -> 2085 bytes Edgware.M1/images/kibana.png | Bin 0 -> 186955 bytes Edgware.M1/images/logo.png | Bin 0 -> 4387 bytes Edgware.M1/images/note.png | Bin 0 -> 2257 bytes Edgware.M1/images/parents.png | Bin 0 -> 10299 bytes Edgware.M1/images/producers-consumers.png | Bin 0 -> 15947 bytes Edgware.M1/images/pws.png | Bin 0 -> 13783 bytes Edgware.M1/images/rabbit-binder.png | Bin 0 -> 12440 bytes Edgware.M1/images/redis-binder.png | Bin 0 -> 13731 bytes Edgware.M1/images/registration.png | Bin 0 -> 22405 bytes Edgware.M1/images/schema_reading.png | Bin 0 -> 45621 bytes Edgware.M1/images/schema_resolution.png | Bin 0 -> 27718 bytes Edgware.M1/images/sts_exception.png | Bin 0 -> 66176 bytes Edgware.M1/images/tip.png | Bin 0 -> 931 bytes Edgware.M1/images/trace-id.png | Bin 0 -> 53518 bytes Edgware.M1/images/warning.png | Bin 0 -> 2130 bytes .../images/zipkin-error-trace-screenshot.png | Bin 0 -> 211220 bytes Edgware.M1/images/zipkin-error-traces.png | Bin 0 -> 118843 bytes Edgware.M1/images/zipkin-trace-screenshot.png | Bin 0 -> 169484 bytes Edgware.M1/images/zipkin-traces.png | Bin 0 -> 152669 bytes Edgware.M1/images/zipkin-ui.png | Bin 0 -> 111015 bytes Edgware.M1/index.html | 30509 ++++++++++++++++ 39 files changed, 30928 insertions(+) create mode 100644 Edgware.M1/configprops.groovy create mode 100644 Edgware.M1/ghpages.sh create mode 100644 Edgware.M1/images/.gitkeep create mode 100644 Edgware.M1/images/Deps.png create mode 100644 Edgware.M1/images/Hystrix.png create mode 100644 Edgware.M1/images/HystrixFallback.png create mode 100644 Edgware.M1/images/HystrixGraph.png create mode 100644 Edgware.M1/images/RequestLatency.png create mode 100644 Edgware.M1/images/SCSt-groups.png create mode 100644 Edgware.M1/images/SCSt-partitioning.png create mode 100644 Edgware.M1/images/SCSt-sensors.png create mode 100644 Edgware.M1/images/SCSt-with-binder.png create mode 100644 Edgware.M1/images/Stubs1.png create mode 100644 Edgware.M1/images/Stubs2.png create mode 100644 Edgware.M1/images/background.png create mode 100644 Edgware.M1/images/caution.png create mode 100644 Edgware.M1/images/dependencies.png create mode 100644 Edgware.M1/images/important.png create mode 100644 Edgware.M1/images/kibana.png create mode 100644 Edgware.M1/images/logo.png create mode 100644 Edgware.M1/images/note.png create mode 100644 Edgware.M1/images/parents.png create mode 100644 Edgware.M1/images/producers-consumers.png create mode 100644 Edgware.M1/images/pws.png create mode 100644 Edgware.M1/images/rabbit-binder.png create mode 100644 Edgware.M1/images/redis-binder.png create mode 100644 Edgware.M1/images/registration.png create mode 100644 Edgware.M1/images/schema_reading.png create mode 100644 Edgware.M1/images/schema_resolution.png create mode 100644 Edgware.M1/images/sts_exception.png create mode 100644 Edgware.M1/images/tip.png create mode 100644 Edgware.M1/images/trace-id.png create mode 100644 Edgware.M1/images/warning.png create mode 100644 Edgware.M1/images/zipkin-error-trace-screenshot.png create mode 100644 Edgware.M1/images/zipkin-error-traces.png create mode 100644 Edgware.M1/images/zipkin-trace-screenshot.png create mode 100644 Edgware.M1/images/zipkin-traces.png create mode 100644 Edgware.M1/images/zipkin-ui.png create mode 100644 Edgware.M1/index.html diff --git a/Edgware.M1/configprops.groovy b/Edgware.M1/configprops.groovy new file mode 100644 index 00000000..4da119a4 --- /dev/null +++ b/Edgware.M1/configprops.groovy @@ -0,0 +1,71 @@ +/** + * Run this file with groovy and collect the result as an asciidoctor source file: + * 
+ * $ groovy configprops.groovy | egrep -v PathMatchingResourcePatternResolver | tee configprops.adoc
+ *
+ */ + +@GrabResolver(name='milestone', root='http://repo.spring.io/milestone/') +@Grab('org.codehaus.groovy:groovy-json:2.4.3') +@Grab('org.springframework.cloud:spring-cloud-stream:1.2.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-bus-amqp:1.3.1.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-config:1.3.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-config-server:1.3.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-netflix-eureka-server:1.3.4.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-eureka:1.3.4.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-aws:1.2.1.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-security:1.2.1.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-consul-all:1.2.1.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-zookeeper-all:1.1.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-sleuth:1.2.4.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-starter-cloudfoundry:1.1.0.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-cloudfoundry-discovery:1.1.0.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-contract-stub-runner:1.1.3.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-vault-config:1.0.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-vault-config-aws:1.0.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-vault-config-databases:1.0.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-vault-config-consul:1.0.2.RELEASE') +@Grab('org.springframework.cloud:spring-cloud-vault-config-rabbitmq:1.0.2.RELEASE') + +import org.springframework.core.io.support.PathMatchingResourcePatternResolver +import org.springframework.core.io.Resource +import groovy.json.JsonSlurper + +def resources = new PathMatchingResourcePatternResolver().getResources("classpath*:/META-INF/spring-configuration-metadata.json") + +TreeSet names = new TreeSet() +def descriptions = [:] +resources.each { it -> + if (it.url.toString().contains("cloud")) { + def slurper = new JsonSlurper() + slurper.parseText(it.inputStream.text).properties.each { val -> + names.add val.name + descriptions[val.name] = new ConfigValue(val.name, val.description, val.defaultValue) + } + } +} +println "|===" +println "|Name | Default | Description" +println "" +names.each { it -> + println descriptions[it] + println "" +} +println "|===" + + +class ConfigValue { + String name + String description + Object defaultValue + ConfigValue(){} + ConfigValue(String name, String description, Object defaultValue) { + this.name = name + this.description = description + this.defaultValue = defaultValue + } + String toString() { + def value = defaultValue==null?'':"${defaultValue}" + "|${name} | ${value} | ${description?:''}" + } +} diff --git a/Edgware.M1/ghpages.sh b/Edgware.M1/ghpages.sh new file mode 100644 index 00000000..e0e69be3 --- /dev/null +++ b/Edgware.M1/ghpages.sh @@ -0,0 +1,348 @@ +#!/bin/bash -x + +set -e + +# Set default props like MAVEN_PATH, ROOT_FOLDER etc. +function set_default_props() { + # The script should be executed from the root folder + ROOT_FOLDER=`pwd` + echo "Current folder is ${ROOT_FOLDER}" + + if [[ ! -e "${ROOT_FOLDER}/.git" ]]; then + echo "You're not in the root folder of the project!" + exit 1 + fi + + # Prop that will let commit the changes + COMMIT_CHANGES="no" + MAVEN_PATH=${MAVEN_PATH:-} + echo "Path to Maven is [${MAVEN_PATH}]" + REPO_NAME=${PWD##*/} + echo "Repo name is [${REPO_NAME}]" + SPRING_CLOUD_STATIC_REPO=${SPRING_CLOUD_STATIC_REPO:-git@github.com:spring-cloud/spring-cloud-static.git} + echo "Spring Cloud Static repo is [${SPRING_CLOUD_STATIC_REPO}" +} + +# Check if gh-pages exists and docs have been built +function check_if_anything_to_sync() { + git remote set-url --push origin `git config remote.origin.url | sed -e 's/^git:/https:/'` + + if ! (git remote set-branches --add origin gh-pages && git fetch -q) && [[ "${RELEASE_TRAIN}" != "yes" ]] ; then + echo "No gh-pages, so not syncing" + exit 0 + fi + + if ! [ -d docs/target/generated-docs ] && ! [ "${BUILD}" == "yes" ]; then + echo "No gh-pages sources in docs/target/generated-docs, so not syncing" + exit 0 + fi +} + +function retrieve_current_branch() { + # Code getting the name of the current branch. For master we want to publish as we did until now + # http://stackoverflow.com/questions/1593051/how-to-programmatically-determine-the-current-checked-out-git-branch + # If there is a branch already passed will reuse it - otherwise will try to find it + CURRENT_BRANCH=${BRANCH} + if [[ -z "${CURRENT_BRANCH}" ]] ; then + CURRENT_BRANCH=$(git symbolic-ref -q HEAD) + CURRENT_BRANCH=${CURRENT_BRANCH##refs/heads/} + CURRENT_BRANCH=${CURRENT_BRANCH:-HEAD} + fi + echo "Current branch is [${CURRENT_BRANCH}]" + git checkout ${CURRENT_BRANCH} || echo "Failed to check the branch... continuing with the script" +} + +# Switches to the provided value of the release version. We always prefix it with `v` +function switch_to_tag() { + if [[ "${RELEASE_TRAIN}" != "yes" ]] ; then + git checkout v${VERSION} + fi +} + +# Build the docs if switch is on +function build_docs_if_applicable() { + if [[ "${BUILD}" == "yes" ]] ; then + ./mvnw clean install -P docs -pl docs -DskipTests + fi +} + +# Get the name of the `docs.main` property +# Get whitelisted branches - assumes that a `docs` module is available under `docs` profile +function retrieve_doc_properties() { + MAIN_ADOC_VALUE=$("${MAVEN_PATH}"mvn -q \ + -Dexec.executable="echo" \ + -Dexec.args='${docs.main}' \ + org.codehaus.mojo:exec-maven-plugin:1.3.1:exec \ + -P docs \ + -pl docs) + echo "Extracted 'main.adoc' from Maven build [${MAIN_ADOC_VALUE}]" + + + WHITELIST_PROPERTY=${WHITELIST_PROPERTY:-"docs.whitelisted.branches"} + WHITELISTED_BRANCHES_VALUE=$("${MAVEN_PATH}"mvn -q \ + -Dexec.executable="echo" \ + -Dexec.args="\${${WHITELIST_PROPERTY}}" \ + org.codehaus.mojo:exec-maven-plugin:1.3.1:exec \ + -P docs \ + -pl docs) + echo "Extracted '${WHITELIST_PROPERTY}' from Maven build [${WHITELISTED_BRANCHES_VALUE}]" +} + +# Stash any outstanding changes +function stash_changes() { + git diff-index --quiet HEAD && dirty=$? || (echo "Failed to check if the current repo is dirty. Assuming that it is." && dirty="1") + if [ "$dirty" != "0" ]; then git stash; fi +} + +# Switch to gh-pages branch to sync it with current branch +function add_docs_from_target() { + local DESTINATION_REPO_FOLDER + if [[ -z "${DESTINATION}" && -z "${CLONE}" ]] ; then + DESTINATION_REPO_FOLDER=${ROOT_FOLDER} + elif [[ "${CLONE}" == "yes" ]]; then + mkdir -p ${ROOT_FOLDER}/target + local clonedStatic=${ROOT_FOLDER}/target/spring-cloud-static + if [[ ! -e "${clonedStatic}/.git" ]]; then + echo "Cloning Spring Cloud Static to target" + git clone ${SPRING_CLOUD_STATIC_REPO} ${clonedStatic} && cd ${clonedStatic} && git checkout gh-pages + else + echo "Spring Cloud Static already cloned - will pull changes" + cd ${clonedStatic} && git checkout gh-pages && git pull origin gh-pages + fi + if [[ -z "${RELEASE_TRAIN}" ]] ; then + DESTINATION_REPO_FOLDER=${clonedStatic}/${REPO_NAME} + else + DESTINATION_REPO_FOLDER=${clonedStatic} + fi + mkdir -p ${DESTINATION_REPO_FOLDER} + else + if [[ ! -e "${DESTINATION}/.git" ]]; then + echo "[${DESTINATION}] is not a git repository" + exit 1 + fi + if [[ -z "${RELEASE_TRAIN}" ]] ; then + DESTINATION_REPO_FOLDER=${DESTINATION}/${REPO_NAME} + else + DESTINATION_REPO_FOLDER=${DESTINATION} + fi + mkdir -p ${DESTINATION_REPO_FOLDER} + echo "Destination was provided [${DESTINATION}]" + fi + cd ${DESTINATION_REPO_FOLDER} + git checkout gh-pages + git pull origin gh-pages + + # Add git branches + ################################################################### + if [[ -z "${VERSION}" && -z "${RELEASE_TRAIN}" ]] ; then + copy_docs_for_current_version + else + copy_docs_for_provided_version + fi + commit_changes_if_applicable +} + + +# Copies the docs by using the retrieved properties from Maven build +function copy_docs_for_current_version() { + if [[ "${CURRENT_BRANCH}" == "master" ]] ; then + echo -e "Current branch is master - will copy the current docs only to the root folder" + for f in docs/target/generated-docs/*; do + file=${f#docs/target/generated-docs/*} + if ! git ls-files -i -o --exclude-standard --directory | grep -q ^$file$; then + # Not ignored... + cp -rf $f ${ROOT_FOLDER}/ + git add -A ${ROOT_FOLDER}/$file + fi + done + COMMIT_CHANGES="yes" + else + echo -e "Current branch is [${CURRENT_BRANCH}]" + # http://stackoverflow.com/questions/29300806/a-bash-script-to-check-if-a-string-is-present-in-a-comma-separated-list-of-strin + if [[ ",${WHITELISTED_BRANCHES_VALUE}," = *",${CURRENT_BRANCH},"* ]] ; then + mkdir -p ${ROOT_FOLDER}/${CURRENT_BRANCH} + echo -e "Branch [${CURRENT_BRANCH}] is whitelisted! Will copy the current docs to the [${CURRENT_BRANCH}] folder" + for f in docs/target/generated-docs/*; do + file=${f#docs/target/generated-docs/*} + if ! git ls-files -i -o --exclude-standard --directory | grep -q ^$file$; then + # Not ignored... + # We want users to access 1.0.0.RELEASE/ instead of 1.0.0.RELEASE/spring-cloud.sleuth.html + if [[ "${file}" == "${MAIN_ADOC_VALUE}.html" ]] ; then + # We don't want to copy the spring-cloud-sleuth.html + # we want it to be converted to index.html + cp -rf $f ${ROOT_FOLDER}/${CURRENT_BRANCH}/index.html + git add -A ${ROOT_FOLDER}/${CURRENT_BRANCH}/index.html + else + cp -rf $f ${ROOT_FOLDER}/${CURRENT_BRANCH} + git add -A ${ROOT_FOLDER}/${CURRENT_BRANCH}/$file + fi + fi + done + COMMIT_CHANGES="yes" + else + echo -e "Branch [${CURRENT_BRANCH}] is not on the white list! Check out the Maven [${WHITELIST_PROPERTY}] property in + [docs] module available under [docs] profile. Won't commit any changes to gh-pages for this branch." + fi + fi +} + +# Copies the docs by using the explicitly provided version +function copy_docs_for_provided_version() { + local FOLDER=${DESTINATION_REPO_FOLDER}/${VERSION} + mkdir -p ${FOLDER} + echo -e "Current tag is [v${VERSION}] Will copy the current docs to the [${FOLDER}] folder" + for f in ${ROOT_FOLDER}/docs/target/generated-docs/*; do + file=${f#${ROOT_FOLDER}/docs/target/generated-docs/*} + copy_docs_for_branch ${file} ${FOLDER} + done + COMMIT_CHANGES="yes" + CURRENT_BRANCH="v${VERSION}" +} + +# Copies the docs from target to the provided destination +# Params: +# $1 - file from target +# $2 - destination to which copy the files +function copy_docs_for_branch() { + local file=$1 + local destination=$2 + if ! git ls-files -i -o --exclude-standard --directory | grep -q ^${file}$; then + # Not ignored... + # We want users to access 1.0.0.RELEASE/ instead of 1.0.0.RELEASE/spring-cloud.sleuth.html + if [[ ("${file}" == "${MAIN_ADOC_VALUE}.html") || ("${file}" == "${REPO_NAME}.html") ]] ; then + # We don't want to copy the spring-cloud-sleuth.html + # we want it to be converted to index.html + cp -rf $f ${destination}/index.html + git add -A ${destination}/index.html + else + cp -rf $f ${destination} + git add -A ${destination}/$file + fi + fi +} + +function commit_changes_if_applicable() { + if [[ "${COMMIT_CHANGES}" == "yes" ]] ; then + COMMIT_SUCCESSFUL="no" + git commit -a -m "Sync docs from ${CURRENT_BRANCH} to gh-pages" && COMMIT_SUCCESSFUL="yes" || echo "Failed to commit changes" + + # Uncomment the following push if you want to auto push to + # the gh-pages branch whenever you commit to master locally. + # This is a little extreme. Use with care! + ################################################################### + if [[ "${COMMIT_SUCCESSFUL}" == "yes" ]] ; then + git push origin gh-pages + fi + fi +} + +# Switch back to the previous branch and exit block +function checkout_previous_branch() { + # If -version was provided we need to come back to root project + cd ${ROOT_FOLDER} + git checkout ${CURRENT_BRANCH} || echo "Failed to check the branch... continuing with the script" + if [ "$dirty" != "0" ]; then git stash pop; fi + exit 0 +} + +# Assert if properties have been properly passed +function assert_properties() { +echo "VERSION [${VERSION}], RELEASE_TRAIN [${RELEASE_TRAIN}], DESTINATION [${DESTINATION}], CLONE [${CLONE}]" +if [[ "${VERSION}" != "" && (-z "${DESTINATION}" && -z "${CLONE}") ]] ; then echo "Version was set but destination / clone was not!"; exit 1;fi +if [[ ("${DESTINATION}" != "" && "${CLONE}" != "") && -z "${VERSION}" ]] ; then echo "Destination / clone was set but version was not!"; exit 1;fi +if [[ "${DESTINATION}" != "" && "${CLONE}" == "yes" ]] ; then echo "Destination and clone was set. Pick one!"; exit 1;fi +if [[ "${RELEASE_TRAIN}" != "" && -z "${VERSION}" ]] ; then echo "Release train was set but no version was passed!"; exit 1;fi +} + +# Prints the usage +function print_usage() { +cat </` +- if the destination switch is passed (-d) then the script will check if the provided dir is a git repo and then will + switch to gh-pages of that repo and copy the generated docs to `docs//` +- if the release train switch is passed (-r) then the script will check if the provided dir is a git repo and then will + switch to gh-pages of that repo and copy the generated docs to `docs/` + +USAGE: + +You can use the following options: + +-v|--version - the script will apply the whole procedure for a particular library version +-r|--releasetrain - instead of nesting the docs under the project_name/version folder the docs will end up in version +-d|--destination - the root of destination folder where the docs should be copied. You have to use the full path. + E.g. point to spring-cloud-static folder. Can't be used with (-c) +-b|--build - will run the standard build process after checking out the branch +-c|--clone - will automatically clone the spring-cloud-static repo instead of providing the destination. + Obviously can't be used with (-d) + +EOF +} + + +# ========================================== +# ____ ____ _____ _____ _____ _______ +# / ____|/ ____| __ \|_ _| __ \__ __| +# | (___ | | | |__) | | | | |__) | | | +# \___ \| | | _ / | | | ___/ | | +# ____) | |____| | \ \ _| |_| | | | +# |_____/ \_____|_| \_\_____|_| |_| +# +# ========================================== + +while [[ $# > 0 ]] +do +key="$1" +case ${key} in + -v|--version) + VERSION="$2" + shift # past argument + ;; + -r|--releasetrain) + RELEASE_TRAIN="yes" + ;; + -d|--destination) + DESTINATION="$2" + shift # past argument + ;; + -b|--build) + BUILD="yes" + ;; + -c|--clone) + CLONE="yes" + ;; + -h|--help) + print_usage + exit 0 + ;; + *) + echo "Invalid option: [$1]" + print_usage + exit 1 + ;; +esac +shift # past argument or value +done + +assert_properties +set_default_props +check_if_anything_to_sync +if [[ -z "${VERSION}" ]] ; then + retrieve_current_branch +else + switch_to_tag +fi +build_docs_if_applicable +retrieve_doc_properties +stash_changes +add_docs_from_target +checkout_previous_branch diff --git a/Edgware.M1/images/.gitkeep b/Edgware.M1/images/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Edgware.M1/images/Deps.png b/Edgware.M1/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/Edgware.M1/images/Hystrix.png b/Edgware.M1/images/Hystrix.png new file mode 100644 index 0000000000000000000000000000000000000000..7d4e17ed45e1470a3e04839f9dde212c18679d7a GIT binary patch literal 230655 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

l{il$etinb*nx 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ℜ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

4eAUb5&wLqtZuY7re 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

5}#RqxVs7h`ZB?z;F&XNYU8t1n(S>v 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/SCSt-partitioning.png b/Edgware.M1/images/SCSt-partitioning.png new file mode 100644 index 0000000000000000000000000000000000000000..833d2ac66002952e3e5728aeb7389cac1cf2d0cf GIT binary patch literal 18068 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°DGR+bsvb*2Ql|1)1Th9#fwhk@@7 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/background.png b/Edgware.M1/images/background.png new file mode 100644 index 0000000000000000000000000000000000000000..349d29a9f856381e13caaf86efcefcf7f971e1c2 GIT binary patch literal 6267 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 T{ot!l1%R%mfkv&G{i}Zi$k78c literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/caution.png b/Edgware.M1/images/caution.png new file mode 100644 index 0000000000000000000000000000000000000000..8a5e4fca039d0247dcf55ae0e719cdb457509422 GIT binary patch literal 2099 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ðKaSt6${Em8qL^}$*2L(~nn@pQ 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 F{tY&r2nzrJ literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/important.png b/Edgware.M1/images/important.png new file mode 100644 index 0000000000000000000000000000000000000000..ec54df65cee2de118b8865a16c1b5d757e33709d GIT binary patch literal 2085 zcmbVNdr%Yk9ZyB)kUM)fy*ZWlX7hkR9=mxg$&&EMiv$RUB!mDWS(1gskWEOIB!Cwl zf?{PTT2XP%yB;V#^%U9;pe+^T>{&UE>x@@VD|&aWW35hWduOkAqaC|ZvHiolKf1HK zzu)h>-_Pg!p50|ED_WP3lt81=*6DR>6SZ!PJ@IkW`;%iIE>KG%sj-n}UjrG&0ywSE z>8r;9y%%f5O*rOkZN7-hX|y<(+hQYahEmkw^YXEn4nN}cQ)n7Zo*(gJ4i8QO^?0M3 zP=NP-H46f6rvj{$7$AdRg}dCkwg7H!E3-J-JPw%?%+CYl5tJhE;v@z{yiG(9jVQp! zyePGgi3K3=ScUW`z$Z@G3`RiZ3*dl+FXA~M7zPl84~r!T0&@W&1PcWabt61jj7ktx zm;*e$K+0Oc*?^kV+NZXtlLB;+q#qRs!r?GKEaLkDjRIIElf^iMLLQ~T3$_v@7U2;= z#tMTP4>|&FKk4=nK#UQq_qC7;kn;3N2wuOz@Qj!UK1~#rGC>6M3t&DZ@Ooo$J=PAA zCj7r{JXbqtY4zg*6CU)n1RPX78W<~JDtF&)D5gkxgKi4AsiI&_YM-OUixZ??tpKSn ze5c!qLLw=Z#T+q|BZLqs3`%u1gPQQ^_OJRXsZqwOD&qLO2*a!%fyU`U&AilhSE!u zf#RfW8Nca8?LYcmzi;^J0$aTLuk(_I7B(1E%i{iHi|z|Ja9*KR}4%unPJ zFw4TowlS1#GO3H7Q31*c7>im^52SWUc{QwoqtQYKQqqoI_}z^Db(y?bEU3*;g(Uk< zbhQt9Q;Rl4_Xd*GuUR{_5VHeEE0C#yNL!dhWt>(;lnbF3j@_RUxGA zhlU&%fA8^*!l1Y?gk+ci-WE<{Z}q7&M>qEshlgBmoET)9!8{*KHv&6`TU&?mta6qd z7iwD&9iFFcM~&TiU^y@_(iItM%&Y+Q4fzTJHodO2br<#Qk8o=Fh6?xiG;t(<^tVlGN*YwHYbN*+ux#qerwpu9`;s z-h^IVXo>ux{&d`$r9Z!%mi_6zmY=<_(Aa4VWq+kPR9x~xOWlpzJxnYGn>;_NtFFtp z54GGsQk4p=t-Lq$;+whBb8|*17xjJKQ38{*G>h8VSmBGr5-Z@b}+_3*Xjg7`HBiDzyy{&6?adFeNk#BLg0d5b-3 z9p!F+xWNDCwRfkhhF=kO!^16Ky!0x2slrhor)q_mdPk(;+PiMET zz5h+ansg!r=$v-@J7+7{oa2j2pl#+KRU%es&<_a|W z!QKDvpGsto{Bi1?F{rbP{YmvHRmJgSd->g=lhdE>DT$9i&DZ~hSKGgD<3Nr~x0crR x@l@~8v%fudb7|Fs)}6WGzYSl#_Wjpr@eu7sVJhKCFm=a%+M#HR literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/kibana.png b/Edgware.M1/images/kibana.png new file mode 100644 index 0000000000000000000000000000000000000000..bc44a43f9b96daf9d96b32761c3731c0a76e1948 GIT binary patch literal 186955 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/logo.png b/Edgware.M1/images/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..ade2ce6ed9d9e9f2f4d9c5729a252ee618a0a5a7 GIT binary patch literal 4387 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 WFPXHi0zU=*VW49SDZKg5lm7wBZ`=z2 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/producers-consumers.png b/Edgware.M1/images/producers-consumers.png new file mode 100644 index 0000000000000000000000000000000000000000..9990897dd2d428d7f2b80126e5b29841040e3237 GIT binary patch literal 15947 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/pws.png b/Edgware.M1/images/pws.png new file mode 100644 index 0000000000000000000000000000000000000000..a791bd74269202835733e13e17a5e1360db9e0ce GIT binary patch literal 13783 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/rabbit-binder.png b/Edgware.M1/images/rabbit-binder.png new file mode 100644 index 0000000000000000000000000000000000000000..aabf698b3a9873395764d1d974996a22436188a9 GIT binary patch literal 12440 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/redis-binder.png b/Edgware.M1/images/redis-binder.png new file mode 100644 index 0000000000000000000000000000000000000000..1832bd2e31af35537088abd41f7092e5c63e3b66 GIT binary patch literal 13731 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/registration.png b/Edgware.M1/images/registration.png new file mode 100644 index 0000000000000000000000000000000000000000..d2c044c1e62a9536f94362c8dc7ad89f0231f9b4 GIT binary patch literal 22405 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/sts_exception.png b/Edgware.M1/images/sts_exception.png new file mode 100644 index 0000000000000000000000000000000000000000..8607c38a5230cb7221d98f2070bc1a5fb0e377d6 GIT binary patch literal 66176 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 Gh5jGOsoGNj literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/tip.png b/Edgware.M1/images/tip.png new file mode 100644 index 0000000000000000000000000000000000000000..6530abb4b5a5d68e3b1c98de512d264c1f8ba883 GIT binary patch literal 931 zcmV;U16=%xP)bSEogsT%F|x0xuT7xdRv7>Rev?4wv{qrDN}+xS$8V5!!ga&#Y1*BgqL?&c}jPc zG_JlfMSD5I%DQQcHXTbGWQtKpeL6yAB|UI5CQ=~#`}=c}Um;E%R)9u^qI0>&GHQ-g zOm;DCkym+{WF$}@UWrV1mtnTPtu!WtY$r7BOpo|N_#mqWGhK#KR0MD7eW*yPaY&xBTRfcG-E5p&`2dq z875XFdy+3GStd(wD_Mg`dys8Xd_houJju_&*4)mZt2Tk1H)DTRJY^_lf>>*ZU2Th5 zWQ3Ly{;kf91GM2s4Vfv8a-fcsXpb+4t> zmM%11X*>M&PQZNVdARf4d*2x!aq1>jOzQ?>>R)(Ok;sOJ)7jfk$Fdif23? z-}3V78&9qod*O;uGk%fEW^;|k`Lo>bOq2iF72o-IGb2gTw+4B~#iYz(oL}sS7|$R2 zDGfrR{|@~AQJ&v(#4u|ZtJP}t520N48P!$8U;|Vfuq=8>E$w`o2Jf`%eqhqbr%IH1zV?O3uDWqKZId-wMQ*MFefpD5X*w@ zok{kNA?%%$F{M!OUcE^^x{~(wkHK|_*9Yg`KNS88FaVH_sda1Xfs6nE002ovPDHLk FV1jwin)(0$ literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/trace-id.png b/Edgware.M1/images/trace-id.png new file mode 100644 index 0000000000000000000000000000000000000000..0603bb085fd9fd111247a5de1a6754e57a357b85 GIT binary patch literal 53518 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 TbH{lI_@i-0SG8E#>goRnq|Ye{ literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/warning.png b/Edgware.M1/images/warning.png new file mode 100644 index 0000000000000000000000000000000000000000..0d5b5244605adbb7ab05a1549746a9c35490f95b GIT binary patch literal 2130 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͕Y$7MUW4?O++6bLy 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%0A_}B|`pUb7QeGd9E@=YiLA6`NCA*_%;Y7Ezc3;oT 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%0DulG6m1i{s!ruAXx}z+ylAD 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 SuhmZhKPpO^4>9*G0{;)S$IR~l literal 0 HcmV?d00001 diff --git a/Edgware.M1/images/zipkin-trace-screenshot.png b/Edgware.M1/images/zipkin-trace-screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..b230a19a39318da5c43a299ee086650a32bde944 GIT binary patch literal 169484 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 gHa5D?`^f0^D)(c(OizMN8C9Rw(yZRSLjsH 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%0AKSB|mV0)vF_p6XU3b75F9R_yzJ&&44-dqb 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 OAnna(v@CAhd?0I&>^4#QbP$K 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 literal 0 HcmV?d00001 diff --git a/Edgware.M1/index.html b/Edgware.M1/index.html new file mode 100644 index 00000000..9110cf32 --- /dev/null +++ b/Edgware.M1/index.html @@ -0,0 +1,30509 @@ + + + + + + + +Spring Cloud + + + + +

+
+
+
+
+

Spring Cloud provides tools for developers to quickly build some of +the common patterns in distributed systems (e.g. configuration +management, service discovery, circuit breakers, intelligent routing, +micro-proxy, control bus). Coordination of +distributed systems leads to boiler plate patterns, and using Spring +Cloud developers can quickly stand up services and applications that +implement those patterns. They will work well in any distributed +environment, including the developer’s own laptop, bare metal data +centres, and managed platforms such as Cloud Foundry.

+
+
+

Version: Edgware.M1

+
+
+
+
+

Features

+
+
+

Spring Cloud focuses on providing good out of box experience for typical use cases +and extensibility mechanism to cover others.

+
+
+
    +
  • +

    Distributed/versioned configuration

    +
    • +
  • +

    Service registration and discovery

    +
    • +
  • +

    Routing

    +
    • +
  • +

    Service-to-service calls

    +
    • +
  • +

    Load balancing

    +
    • +
  • +

    Circuit Breakers

    +
    • +
  • +

    Distributed messaging

    +
    • +
+
+
+
+

Cloud Native Applications

+
+
+
+

Cloud Native is a style of application development that encourages easy adoption of best practices in the areas of continuous delivery and value-driven development. A related discipline is that of building 12-factor Apps in which development practices are aligned with delivery and operations goals, for instance by using declarative programming and management and monitoring. Spring Cloud facilitates these styles of development in a number of specific ways and the starting point is a set of features that all components in a distributed system either need or need easy access to when required.

+
+
+

Many of those features are covered by Spring Boot, which we build on in Spring Cloud. Some more are delivered by Spring Cloud as two libraries: Spring Cloud Context and Spring Cloud Commons. Spring Cloud Context provides utilities and special services for the ApplicationContext of a Spring Cloud application (bootstrap context, encryption, refresh scope and environment endpoints). Spring Cloud Commons is a set of abstractions and common classes used in different Spring Cloud implementations (eg. Spring Cloud Netflix vs. Spring Cloud Consul).

+
+
+

If you are getting an exception due to "Illegal key size" and you are using Sun’s JDK, you need to install the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files. See the following links for more information:

+
+
+ +
+
+

Extract files into JDK/jre/lib/security folder (whichever version of JRE/JDK x64/x86 you are using).

+
+
+ + + + + +
+
Note
+		 +Spring Cloud is released under the non-restrictive Apache 2.0 license. If you would like to contribute to this section of the documentation or if you find an error, please find the source code and issue trackers in the project at github. +
+
+
+
+
+

Spring Cloud Context: Application Context Services

+
+
+

Spring Boot has an opinionated view of how to build an application +with Spring: for instance it has conventional locations for common +configuration file, and endpoints for common management and monitoring +tasks. Spring Cloud builds on top of that and adds a few features that +probably all components in a system would use or occasionally need.

+
+
+

The Bootstrap Application Context

+
+

A Spring Cloud application operates by creating a "bootstrap" +context, which is a parent context for the main application. Out of +the box it is responsible for loading configuration properties from +the external sources, and also decrypting properties in the local +external configuration files. The two contexts share an Environment +which is the source of external properties for any Spring +application. Bootstrap properties are added with high precedence, so +they cannot be overridden by local configuration, by default.

+
+
+

The bootstrap context uses a different convention for locating +external configuration than the main application context, so instead +of application.yml (or .properties) you use bootstrap.yml, +keeping the external configuration for bootstrap and main context +nicely separate. Example:

+
+
+
bootstrap.yml
+
+
spring:
+  application:
+    name: foo
+  cloud:
+    config:
+      uri: ${SPRING_CONFIG_URI:http://localhost:8888}
+
+
+
+

It is a good idea to set the spring.application.name (in +bootstrap.yml or application.yml) if your application needs any +application-specific configuration from the server.

+
+
+

You can disable the bootstrap process completely by setting +spring.cloud.bootstrap.enabled=false (e.g. in System properties).

+
+
+
+

Application Context Hierarchies

+
+

If you build an application context from SpringApplication or +SpringApplicationBuilder, then the Bootstrap context is added as a +parent to that context. It is a feature of Spring that child contexts +inherit property sources and profiles from their parent, so the "main" +application context will contain additional property sources, compared +to building the same context without Spring Cloud Config. The +additional property sources are:

+
+
+
    +
  • +

    "bootstrap": an optional CompositePropertySource appears with high +priority if any PropertySourceLocators are found in the Bootstrap +context, and they have non-empty properties. An example would be +properties from the Spring Cloud Config Server. See +below for instructions +on how to customize the contents of this property source.

    +
    • +
  • +

    "applicationConfig: [classpath:bootstrap.yml]" (and friends if +Spring profiles are active). If you have a bootstrap.yml (or +properties) then those properties are used to configure the Bootstrap +context, and then they get added to the child context when its parent +is set. They have lower precedence than the application.yml (or +properties) and any other property sources that are added to the child +as a normal part of the process of creating a Spring Boot +application. See below for +instructions on how to customize the contents of these property +sources.

    +
    • +
+
+
+

Because of the ordering rules of property sources the "bootstrap" +entries take precedence, but note that these do not contain any data +from bootstrap.yml, which has very low precedence, but can be used +to set defaults.

+
+
+

You can extend the context hierarchy by simply setting the parent +context of any ApplicationContext you create, e.g. using its own +interface, or with the SpringApplicationBuilder convenience methods +(parent(), child() and sibling()). The bootstrap context will be +the parent of the most senior ancestor that you create yourself. +Every context in the hierarchy will have its own "bootstrap" property +source (possibly empty) to avoid promoting values inadvertently from +parents down to their descendants. Every context in the hierarchy can +also (in principle) have a different spring.application.name and +hence a different remote property source if there is a Config +Server. Normal Spring application context behaviour rules apply to +property resolution: properties from a child context override those in +the parent, by name and also by property source name (if the child has +a property source with the same name as the parent, the one from the +parent is not included in the child).

+
+
+

Note that the SpringApplicationBuilder allows you to share an +Environment amongst the whole hierarchy, but that is not the +default. Thus, sibling contexts in particular do not need to have the +same profiles or property sources, even though they will share common +things with their parent.

+
+
+
+

Changing the Location of Bootstrap Properties

+
+

The bootstrap.yml (or .properties) location can be specified using +spring.cloud.bootstrap.name (default "bootstrap") or +spring.cloud.bootstrap.location (default empty), e.g. in System +properties. Those properties behave like the spring.config.* +variants with the same name, in fact they are used to set up the +bootstrap ApplicationContext by setting those properties in its +Environment. If there is an active profile (from +spring.profiles.active or through the Environment API in the +context you are building) then properties in that profile will be +loaded as well, just like in a regular Spring Boot app, e.g. from +bootstrap-development.properties for a "development" profile.

+
+
+
+

Overriding the Values of Remote Properties

+
+

The property sources that are added to you application by the +bootstrap context are often "remote" (e.g. from a Config Server), and +by default they cannot be overridden locally, except on the command +line. If you want to allow your applications to override the remote +properties with their own System properties or config files, the +remote property source has to grant it permission by setting +spring.cloud.config.allowOverride=true (it doesn’t work to set this +locally). Once that flag is set there are some finer grained settings +to control the location of the remote properties in relation to System +properties and the application’s local configuration: +spring.cloud.config.overrideNone=true to override with any local +property source, and +spring.cloud.config.overrideSystemProperties=false if only System +properties and env vars should override the remote settings, but not +the local config files.

+
+
+
+

Customizing the Bootstrap Configuration

+
+

The bootstrap context can be trained to do anything you like by adding +entries to /META-INF/spring.factories under the key +org.springframework.cloud.bootstrap.BootstrapConfiguration. This is +a comma-separated list of Spring @Configuration classes which will +be used to create the context. Any beans that you want to be available +to the main application context for autowiring can be created here, +and also there is a special contract for @Beans of type +ApplicationContextInitializer. Classes can be marked with an @Order +if you want to control the startup sequence (the default order is +"last").

+
+
+ + + + + +
+
Warning
+		 +Be careful when adding custom BootstrapConfiguration that the +classes you add are not @ComponentScanned by mistake into your +"main" application context, where they might not be needed. +Use a separate package name for boot configuration classes that is +not already covered by your @ComponentScan or @SpringBootApplication +annotated configuration classes. +
+
+
+

The bootstrap process ends by injecting initializers into the main +SpringApplication instance (i.e. the normal Spring Boot startup +sequence, whether it is running as a standalone app or deployed in an +application server). First a bootstrap context is created from the +classes found in spring.factories and then all @Beans of type +ApplicationContextInitializer are added to the main +SpringApplication before it is started.

+
+
+
+

Customizing the Bootstrap Property Sources

+
+

The default property source for external configuration added by the +bootstrap process is the Config Server, but you can add additional +sources by adding beans of type PropertySourceLocator to the +bootstrap context (via spring.factories). You could use this to +insert additional properties from a different server, or from a +database, for instance.

+
+
+

As an example, consider the following trivial custom locator:

+
+
+
+
@Configuration
+public class CustomPropertySourceLocator implements PropertySourceLocator {
+
+    @Override
+    public PropertySource<?> locate(Environment environment) {
+        return new MapPropertySource("customProperty",
+                Collections.<String, Object>singletonMap("property.from.sample.custom.source", "worked as intended"));
+    }
+
+}
+
+
+
+

The Environment that is passed in is the one for the +ApplicationContext about to be created, i.e. the one that we are +supplying additional property sources for. It will already have its +normal Spring Boot-provided property sources, so you can use those to +locate a property source specific to this Environment (e.g. by +keying it on the spring.application.name, as is done in the default +Config Server property source locator).

+
+
+

If you create a jar with this class in it and then add a +META-INF/spring.factories containing:

+
+
+
+
org.springframework.cloud.bootstrap.BootstrapConfiguration=sample.custom.CustomPropertySourceLocator
+
+
+
+

then the "customProperty" PropertySource will show up in any +application that includes that jar on its classpath.

+
+
+
+

Environment Changes

+
+

The application will listen for an EnvironmentChangeEvent and react +to the change in a couple of standard ways (additional +ApplicationListeners can be added as @Beans by the user in the +normal way). When an EnvironmentChangeEvent is observed it will +have a list of key values that have changed, and the application will +use those to:

+
+
+
    +
  • +

    Re-bind any @ConfigurationProperties beans in the context

    +
    • +
  • +

    Set the logger levels for any properties in logging.level.*

    +
    • +
+
+
+

Note that the Config Client does not by default poll for changes in +the Environment, and generally we would not recommend that approach +for detecting changes (although you could set it up with a +@Scheduled annotation). If you have a scaled-out client application +then it is better to broadcast the EnvironmentChangeEvent to all +the instances instead of having them polling for changes (e.g. using +the Spring Cloud +Bus).

+
+
+

The EnvironmentChangeEvent covers a large class of refresh use +cases, as long as you can actually make a change to the Environment +and publish the event (those APIs are public and part of core +Spring). You can verify the changes are bound to +@ConfigurationProperties beans by visiting the /configprops +endpoint (normal Spring Boot Actuator feature). For instance a +DataSource can have its maxPoolSize changed at runtime (the +default DataSource created by Spring Boot is an +@ConfigurationProperties bean) and grow capacity +dynamically. Re-binding @ConfigurationProperties does not cover +another large class of use cases, where you need more control over the +refresh, and where you need a change to be atomic over the whole +ApplicationContext. To address those concerns we have +@RefreshScope.

+
+
+
+

Refresh Scope

+
+

A Spring @Bean that is marked as @RefreshScope will get special +treatment when there is a configuration change. This addresses the +problem of stateful beans that only get their configuration injected +when they are initialized. For instance if a DataSource has open +connections when the database URL is changed via the Environment, we +probably want the holders of those connections to be able to complete +what they are doing. Then the next time someone borrows a connection +from the pool he gets one with the new URL.

+
+
+

Refresh scope beans are lazy proxies that initialize when they are +used (i.e. when a method is called), and the scope acts as a cache of +initialized values. To force a bean to re-initialize on the next +method call you just need to invalidate its cache entry.

+
+
+

The RefreshScope is a bean in the context and it has a public method +refreshAll() to refresh all beans in the scope by clearing the +target cache. There is also a refresh(String) method to refresh an +individual bean by name. This functionality is exposed in the +/refresh endpoint (over HTTP or JMX).

+
+
+ + + + + +
+
Note
+		 +@RefreshScope works (technically) on an @Configuration +class, but it might lead to surprising behaviour: e.g. it does not +mean that all the @Beans defined in that class are themselves +@RefreshScope. Specifically, anything that depends on those beans +cannot rely on them being updated when a refresh is initiated, unless +it is itself in @RefreshScope (in which it will be rebuilt on a +refresh and its dependencies re-injected, at which point they will be +re-initialized from the refreshed @Configuration). +
+
+
+
+

Encryption and Decryption

+
+

Spring Cloud has an Environment pre-processor for decrypting +property values locally. It follows the same rules as the Config +Server, and has the same external configuration via encrypt.*. Thus +you can use encrypted values in the form {cipher}* and as long as +there is a valid key then they will be decrypted before the main +application context gets the Environment. To use the encryption +features in an application you need to include Spring Security RSA in +your classpath (Maven co-ordinates +"org.springframework.security:spring-security-rsa") and you also need +the full strength JCE extensions in your JVM.

+
+
+

If you are getting an exception due to "Illegal key size" and you are using Sun’s JDK, you need to install the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files. See the following links for more information:

+
+
+ +
+
+

Extract files into JDK/jre/lib/security folder (whichever version of JRE/JDK x64/x86 you are using).

+
+
+
+

Endpoints

+
+

For a Spring Boot Actuator application there are some additional management endpoints:

+
+
+
    +
  • +

    POST to /env to update the Environment and rebind @ConfigurationProperties and log levels

    +
    • +
  • +

    /refresh for re-loading the boot strap context and refreshing the @RefreshScope beans

    +
    • +
  • +

    /restart for closing the ApplicationContext and restarting it (disabled by default)

    +
    • +
  • +

    /pause and /resume for calling the Lifecycle methods (stop() and start() on the ApplicationContext)

    +
    • +
+
+
+
+
+
+

Spring Cloud Commons: Common Abstractions

+
+
+

Patterns such as service discovery, load balancing and circuit breakers lend themselves to a common abstraction layer that can be consumed by all Spring Cloud clients, independent of the implementation (e.g. discovery via Eureka or Consul).

+
+
+

@EnableDiscoveryClient

+
+

Commons provides the @EnableDiscoveryClient annotation. This looks for implementations of the DiscoveryClient interface via META-INF/spring.factories. Implementations of Discovery Client will add a configuration class to spring.factories under the org.springframework.cloud.client.discovery.EnableDiscoveryClient key. Examples of DiscoveryClient implementations: are Spring Cloud Netflix Eureka, Spring Cloud Consul Discovery and Spring Cloud Zookeeper Discovery.

+
+
+

By default, implementations of DiscoveryClient will auto-register the local Spring Boot server with the remote discovery server. This can be disabled by setting autoRegister=false in @EnableDiscoveryClient.

+
+
+

Health Indicator

+
+

Commons creates a Spring Boot HealthIndicator that DiscoveryClient implementations can participate in by implementing DiscoveryHealthIndicator. To disable the composite HealthIndicator set spring.cloud.discovery.client.composite-indicator.enabled=false. A generic HealthIndicator based on DiscoveryClient is auto-configured (DiscoveryClientHealthIndicator). To disable it, set `spring.cloud.discovery.client.health-indicator.enabled=false. To disable the description field of the DiscoveryClientHealthIndicator set spring.cloud.discovery.client.health-indicator.include-description=false, otherwise it can bubble up as the description of the rolled up HealthIndicator.

+
+
+
+
+

ServiceRegistry

+
+

Commons now provides a ServiceRegistry interface which provides methods like register(Registration) and deregister(Registration) which allow you to provide custom registered services. Registration is a marker interface.

+
+
+
+
@Configuration
+@EnableDiscoveryClient(autoRegister=false)
+public class MyConfiguration {
+    private ServiceRegistry registry;
+
+    public MyConfiguration(ServiceRegistry registry) {
+        this.registry = registry;
+    }
+
+    // called via some external process, such as an event or a custom actuator endpoint
+    public void register() {
+        Registration registration = constructRegistration();
+        this.registry.register(registration);
+    }
+}
+
+
+
+

Each ServiceRegistry implementation has its own Registry implementation.

+
+
+

ServiceRegistry Auto-Registration

+
+

By default, the ServiceRegistry implementation will auto-register the running service. To disable that behavior, there are two methods. You can set @EnableDiscoveryClient(autoRegister=false) to permanently disable auto-registration. You can also set spring.cloud.service-registry.auto-registration.enabled=false to disable the behavior via configuration.

+
+
+
+

Service Registry Actuator Endpoint

+
+

A /service-registry actuator endpoint is provided by Commons. This endpoint relys on a Registration bean in the Spring Application Context. Calling /service-registry/instance-status via a GET will return the status of the Registration. A POST to the same endpoint with a String body will change the status of the current Registration to the new value. Please see the documentation of the ServiceRegistry implementation you are using for the allowed values for updating the status and the values retured for the status.

+
+
+
+
+

Spring RestTemplate as a Load Balancer Client

+
+

RestTemplate can be automatically configured to use ribbon. To create a load balanced RestTemplate create a RestTemplate @Bean and use the @LoadBalanced qualifier.

+
+
+ + + + + +
+
Warning
+		 +A RestTemplate bean is no longer created via auto configuration. It must be created by individual applications. +
+
+
+
+
@Configuration
+public class MyConfiguration {
+
+    @LoadBalanced
+    @Bean
+    RestTemplate restTemplate() {
+        return new RestTemplate();
+    }
+}
+
+public class MyClass {
+    @Autowired
+    private RestTemplate restTemplate;
+
+    public String doOtherStuff() {
+        String results = restTemplate.getForObject("http://stores/stores", String.class);
+        return results;
+    }
+}
+
+
+
+

The URI needs to use a virtual host name (ie. service name, not a host name). +The Ribbon client is used to create a full physical address. See +RibbonAutoConfiguration +for details of how the RestTemplate is set up.

+
+
+

Retrying Failed Requests

+
+

A load balanced RestTemplate can be configured to retry failed requests. +By default this logic is disabled, you can enable it by adding Spring Retry to your application’s classpath. The load balanced RestTemplate will +honor some of the Ribbon configuration values related to retrying failed requests. If +you would like to disable the retry logic with Spring Retry on the classpath +you can set spring.cloud.loadbalancer.retry.enabled=false. +The properties you can use are client.ribbon.MaxAutoRetries, +client.ribbon.MaxAutoRetriesNextServer, and client.ribbon.OkToRetryOnAllOperations. +See the Ribbon documentation +for a description of what there properties do.

+
+
+ + + + + +
+
Note
+		 +client in the above examples should be replaced with your Ribbon client’s +name. +
+
+
+
+
+

Multiple RestTemplate objects

+
+

If you want a RestTemplate that is not load balanced, create a RestTemplate +bean and inject it as normal. To access the load balanced RestTemplate use +the @LoadBalanced qualifier when you create your @Bean.

+
+
+ + + + + +
+
Important
+		 +Notice the @Primary annotation on the plain RestTemplate declaration in the example below, to disambiguate the unqualified @Autowired injection. +
+
+
+
+
@Configuration
+public class MyConfiguration {
+
+    @LoadBalanced
+    @Bean
+    RestTemplate loadBalanced() {
+        return new RestTemplate();
+    }
+
+    @Primary
+    @Bean
+    RestTemplate restTemplate() {
+        return new RestTemplate();
+    }
+}
+
+public class MyClass {
+    @Autowired
+    private RestTemplate restTemplate;
+
+    @Autowired
+    @LoadBalanced
+    private RestTemplate loadBalanced;
+
+    public String doOtherStuff() {
+        return loadBalanced.getForObject("http://stores/stores", String.class);
+    }
+
+    public String doStuff() {
+        return restTemplate.getForObject("http://example.com", String.class);
+    }
+}
+
+
+
+ + + + + +
+
Tip
+		 +If you see errors like java.lang.IllegalArgumentException: Can not set org.springframework.web.client.RestTemplate field com.my.app.Foo.restTemplate to com.sun.proxy.$Proxy89 try injecting RestOperations instead or setting spring.aop.proxyTargetClass=true. +
+
+
+
+

Ignore Network Interfaces

+
+

Sometimes it is useful to ignore certain named network interfaces so they can be excluded from Service Discovery registration (eg. running in a Docker container). A list of regular expressions can be set that will cause the desired network interfaces to be ignored. The following configuration will ignore the "docker0" interface and all interfaces that start with "veth".

+
+
+
application.yml
+
+
spring:
+  cloud:
+    inetutils:
+      ignoredInterfaces:
+        - docker0
+        - veth.*
+
+
+
+

You can also force to use only specified network addresses using list of regular expressions:

+
+
+
application.yml
+
+
spring:
+  cloud:
+    inetutils:
+      preferredNetworks:
+        - 192.168
+        - 10.0
+
+
+
+

You can also force to use only site local addresses. See Inet4Address.html.isSiteLocalAddress() for more details what is site local address.

+
+
+
application.yml
+
+
spring:
+  cloud:
+    inetutils:
+      useOnlySiteLocalInterfaces: true
+
+
+
+
+

HTTP Client Factories

+
+

Spring Cloud Commons provides beans for creating both Apache HTTP clients (ApacheHttpClientFactory) +as well as OK HTTP clients (OkHttpClientFactory). The OkHttpClientFactory bean will only be created +if the OK HTTP jar is on the classpath. In addition, Spring Cloud Commons provides beans for creating +the connection managers used by both clients, ApacheHttpClientConnectionManagerFactory for the Apache +HTTP client and OkHttpClientConnectionPoolFactory for the OK HTTP client. You can provide +your own implementation of these beans if you would like to customize how the HTTP clients are created +in downstream projects. You can also disable the creation of these beans by setting +spring.cloud.httpclientfactories.apache.enabled or spring.cloud.httpclientfactories.ok.enabled to +false.

+
+
+
+
+

Spring Cloud Config

+
+
+
+

Edgware.M1

+
+
+

Spring Cloud Config provides server and client-side support for externalized configuration in a distributed system. With the Config Server you have a central place to manage external properties for applications across all environments. The concepts on both client and server map identically to the Spring Environment and PropertySource abstractions, so they fit very well with Spring applications, but can be used with any application running in any language. As an application moves through the deployment pipeline from dev to test and into production you can manage the configuration between those environments and be certain that applications have everything they need to run when they migrate. The default implementation of the server storage backend uses git so it easily supports labelled versions of configuration environments, as well as being accessible to a wide range of tooling for managing the content. It is easy to add alternative implementations and plug them in with Spring configuration.

+
+
+
+
+

Quick Start

+
+
+

Start the server:

+
+
+
+
$ cd spring-cloud-config-server
+$ ../mvnw spring-boot:run
+
+
+
+

The server is a Spring Boot application so you can run it from your +IDE instead if you prefer (the main class is +ConfigServerApplication). Then try out a client:

+
+
+
+
$ curl localhost:8888/foo/development
+{"name":"foo","label":"master","propertySources":[
+  {"name":"https://github.com/scratches/config-repo/foo-development.properties","source":{"bar":"spam"}},
+  {"name":"https://github.com/scratches/config-repo/foo.properties","source":{"foo":"bar"}}
+]}
+
+
+
+

The default strategy for locating property sources is to clone a git +repository (at spring.cloud.config.server.git.uri) and use it to +initialize a mini SpringApplication. The mini-application’s +Environment is used to enumerate property sources and publish them +via a JSON endpoint.

+
+
+

The HTTP service has resources in the form:

+
+
+
+
/{application}/{profile}[/{label}]
+/{application}-{profile}.yml
+/{label}/{application}-{profile}.yml
+/{application}-{profile}.properties
+/{label}/{application}-{profile}.properties
+
+
+
+

where the "application" is injected as the spring.config.name in the +SpringApplication (i.e. what is normally "application" in a regular +Spring Boot app), "profile" is an active profile (or comma-separated +list of properties), and "label" is an optional git label (defaults to +"master".)

+
+
+

Spring Cloud Config Server pulls configuration for remote clients +from a git repository (which must be provided):

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/spring-cloud-samples/config-repo
+
+
+
+

Client Side Usage

+
+

To use these features in an application, just build it as a Spring +Boot application that depends on spring-cloud-config-client (e.g. see +the test cases for the config-client, or the sample app). The most +convenient way to add the dependency is via a Spring Boot starter +org.springframework.cloud:spring-cloud-starter-config. There is also a +parent pom and BOM (spring-cloud-starter-parent) for Maven users and a +Spring IO version management properties file for Gradle and Spring CLI +users. Example Maven configuration:

+
+
+
pom.xml
+
+
   <parent>
+       <groupId>org.springframework.boot</groupId>
+       <artifactId>spring-boot-starter-parent</artifactId>
+       <version>1.3.5.RELEASE</version>
+       <relativePath /> <!-- lookup parent from repository -->
+   </parent>
+
+<dependencyManagement>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.cloud</groupId>
+			<artifactId>spring-cloud-dependencies</artifactId>
+			<version>Brixton.RELEASE</version>
+			<type>pom</type>
+			<scope>import</scope>
+		</dependency>
+	</dependencies>
+</dependencyManagement>
+
+<dependencies>
+	<dependency>
+		<groupId>org.springframework.cloud</groupId>
+		<artifactId>spring-cloud-starter-config</artifactId>
+	</dependency>
+	<dependency>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-test</artifactId>
+		<scope>test</scope>
+	</dependency>
+</dependencies>
+
+<build>
+	<plugins>
+           <plugin>
+               <groupId>org.springframework.boot</groupId>
+               <artifactId>spring-boot-maven-plugin</artifactId>
+           </plugin>
+	</plugins>
+</build>
+
+   <!-- repositories also needed for snapshots and milestones -->
+
+
+
+

Then you can create a standard Spring Boot application, like this simple HTTP server:

+
+
+
+
@SpringBootApplication
+@RestController
+public class Application {
+
+    @RequestMapping("/")
+    public String home() {
+        return "Hello World!";
+    }
+
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+
+}
+
+
+
+

When it runs it will pick up the external configuration from the +default local config server on port 8888 if it is running. To modify +the startup behaviour you can change the location of the config server +using bootstrap.properties (like application.properties but for +the bootstrap phase of an application context), e.g.

+
+
+
+
spring.cloud.config.uri: http://myconfigserver.com
+
+
+
+

The bootstrap properties will show up in the /env endpoint as a +high-priority property source, e.g.

+
+
+
+
$ curl localhost:8080/env
+{
+  "profiles":[],
+  "configService:https://github.com/spring-cloud-samples/config-repo/bar.properties":{"foo":"bar"},
+  "servletContextInitParams":{},
+  "systemProperties":{...},
+  ...
+}
+
+
+
+

(a property source called "configService:<URL of remote +repository>/<file name>" contains the property "foo" with value +"bar" and is highest priority).

+
+
+ + + + + +
+
Note
+		 +the URL in the property source name is the git repository not +the config server URL. +
+
+
+
+
+
+

Spring Cloud Config Server

+
+
+

The Server provides an HTTP, resource-based API for external +configuration (name-value pairs, or equivalent YAML content). The +server is easily embeddable in a Spring Boot application using the +@EnableConfigServer annotation. So this app is a config server:

+
+
+
ConfigServer.java
+
+
@SpringBootApplication
+@EnableConfigServer
+public class ConfigServer {
+  public static void main(String[] args) {
+    SpringApplication.run(ConfigServer.class, args);
+  }
+}
+
+
+
+

Like all Spring Boot apps it runs on port 8080 by default, but you +can switch it to the conventional port 8888 in various ways. The +easiest, which also sets a default configuration repository, +is by launching it with spring.config.name=configserver (there +is a configserver.yml in the Config Server jar). Another is +to use your own application.properties, e.g.

+
+
+
application.properties
+
+
server.port: 8888
+spring.cloud.config.server.git.uri: file://${user.home}/config-repo
+
+
+
+

where ${user.home}/config-repo is a git repository containing +YAML and properties files.

+
+
+ + + + + +
+
Note
+		 +in Windows you need an extra "/" in the file URL if it is +absolute with a drive prefix, e.g. file:///${user.home}/config-repo. +
+
+
+ + + + + +
+
Tip
+		 +
+

Here’s a recipe for creating the git repository in the example +above:

+
+
+
+
$ cd $HOME
+$ mkdir config-repo
+$ cd config-repo
+$ git init .
+$ echo info.foo: bar > application.properties
+$ git add -A .
+$ git commit -m "Add application.properties"
+
+
+
+
+
+ + + + + +
+
Warning
+		 +using the local filesystem for your git repository is +intended for testing only. Use a server to host your +configuration repositories in production. +
+
+
+ + + + + +
+
Warning
+		 +the initial clone of your configuration repository will +be quick and efficient if you only keep text files in it. If you start +to store binary files, especially large ones, you may experience +delays on the first request for configuration and/or out of memory +errors in the server. +
+
+
+

Environment Repository

+
+

Where do you want to store the configuration data for the Config +Server? The strategy that governs this behaviour is the +EnvironmentRepository, serving Environment objects. This +Environment is a shallow copy of the domain from the Spring +Environment (including propertySources as the main feature). The +Environment resources are parametrized by three variables:

+
+
+
    +
  • +

    {application} maps to "spring.application.name" on the client side;

    +
    • +
  • +

    {profile} maps to "spring.profiles.active" on the client (comma separated list); and

    +
    • +
  • +

    {label} which is a server side feature labelling a "versioned" set of config files.

    +
    • +
+
+
+

Repository implementations generally behave just like a Spring Boot +application loading configuration files from a "spring.config.name" +equal to the {application} parameter, and "spring.profiles.active" +equal to the {profiles} parameter. Precedence rules for profiles are +also the same as in a regular Boot application: active profiles take +precedence over defaults, and if there are multiple profiles the last +one wins (like adding entries to a Map).

+
+
+

Example: a client application has this bootstrap configuration:

+
+
+
bootstrap.yml
+
+
spring:
+  application:
+    name: foo
+  profiles:
+    active: dev,mysql
+
+
+
+

(as usual with a Spring Boot application, these properties could also +be set as environment variables or command line arguments).

+
+
+

If the repository is file-based, the server will create an +Environment from application.yml (shared between all clients), and +foo.yml (with foo.yml taking precedence). If the YAML files have +documents inside them that point to Spring profiles, those are applied +with higher precedence (in order of the profiles listed), and if +there are profile-specific YAML (or properties) files these are also +applied with higher precedence than the defaults. Higher precedence +translates to a PropertySource listed earlier in the +Environment. (These are the same rules as apply in a standalone +Spring Boot application.)

+
+
+

Git Backend

+
+

The default implementation of EnvironmentRepository uses a Git +backend, which is very convenient for managing upgrades and physical +environments, and also for auditing changes. To change the location of +the repository you can set the "spring.cloud.config.server.git.uri" +configuration property in the Config Server (e.g. in +application.yml). If you set it with a file: prefix it should work +from a local repository so you can get started quickly and easily +without a server, but in that case the server operates directly on the +local repository without cloning it (it doesn’t matter if it’s not +bare because the Config Server never makes changes to the "remote" +repository). To scale the Config Server up and make it highly +available, you would need to have all instances of the server pointing +to the same repository, so only a shared file system would work. Even +in that case it is better to use the ssh: protocol for a shared +filesystem repository, so that the server can clone it and use a local +working copy as a cache.

+
+
+

This repository implementation maps the {label} parameter of the +HTTP resource to a git label (commit id, branch name or tag). If the +git branch or tag name contains a slash ("/") then the label in the +HTTP URL should be specified with the special string "(_)" instead (to +avoid ambiguity with other URL paths). For example, if the label is +foo/bar, replacing the slash would result in a label that looks like +foo(_)bar. Be careful with the brackets in +the URL if you are using a command line client like curl (e.g. escape +them from the shell with quotes '').

+
+
+
Placeholders in Git URI
+
+

Spring Cloud Config Server supports a git repository URL with +placeholders for the {application} and {profile} (and {label} if +you need it, but remember that the label is applied as a git label +anyway). So you can easily support a "one repo per application" policy +using (for example):

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/myorg/{application}
+
+
+
+

or a "one repo per profile" policy using a similar pattern but with +{profile}.

+
+
+
+
Pattern Matching and Multiple Repositories
+
+

There is also support for more complex requirements with pattern +matching on the application and profile name. The pattern format is a +comma-separated list of {application}/{profile} names with wildcards +(where a pattern beginning with a wildcard may need to be +quoted). Example:

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/spring-cloud-samples/config-repo
+          repos:
+            simple: https://github.com/simple/config-repo
+            special:
+              pattern: special*/dev*,*special*/dev*
+              uri: https://github.com/special/config-repo
+            local:
+              pattern: local*
+              uri: file:/home/configsvc/config-repo
+
+
+
+

If {application}/{profile} does not match any of the patterns, it +will use the default uri defined under +"spring.cloud.config.server.git.uri". In the above example, for the +"simple" repository, the pattern is simple/* (i.e. it only matches +one application named "simple" in all profiles). The "local" +repository matches all application names beginning with "local" in all +profiles (the /* suffix is added automatically to any pattern that +doesn’t have a profile matcher).

+
+
+ + + + + +
+
Note
+		 +the "one-liner" short cut used in the "simple" example above can +only be used if the only property to be set is the URI. If you need to +set anything else (credentials, pattern, etc.) you need to use the full +form. +
+
+
+

The pattern property in the repo is actually an array, so you can +use a YAML array (or [0], [1], etc. suffixes in properties files) +to bind to multiple patterns. You may need to do this if you are going +to run apps with multiple profiles. Example:

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/spring-cloud-samples/config-repo
+          repos:
+            development:
+              pattern:
+                - '*/development'
+                - '*/staging'
+              uri: https://github.com/development/config-repo
+            staging:
+              pattern:
+                - '*/qa'
+                - '*/production'
+              uri: https://github.com/staging/config-repo
+
+
+
+ + + + + +
+
Note
+		 +Spring Cloud will guess that a pattern containing a profile that +doesn’t end in * implies that you actually want to match a list of +profiles starting with this pattern (so */staging is a shortcut for +["*/staging", "*/staging,*"]). This is common where you need to run +apps in the "development" profile locally but also the "cloud" profile +remotely, for instance. +
+
+
+

Every repository can also optionally store config files in +sub-directories, and patterns to search for those directories can be +specified as searchPaths. For example at the top level:

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/spring-cloud-samples/config-repo
+          searchPaths: foo,bar*
+
+
+
+

In this example the server searches for config files in the top level +and in the "foo/" sub-directory and also any sub-directory whose name +begins with "bar".

+
+
+

By default the server clones remote repositories when configuration +is first requested. The server can be configured to clone the repositories +at startup. For example at the top level:

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://git/common/config-repo.git
+          repos:
+            team-a:
+                pattern: team-a-*
+                cloneOnStart: true
+                uri: http://git/team-a/config-repo.git
+            team-b:
+                pattern: team-b-*
+                cloneOnStart: false
+                uri: http://git/team-b/config-repo.git
+            team-c:
+                pattern: team-c-*
+                uri: http://git/team-a/config-repo.git
+
+
+
+

In this example the server clones team-a’s config-repo on startup before it +accepts any requests. All other repositories will not be cloned until +configuration from the repository is requested.

+
+
+ + + + + +
+
Note
+		 +Setting a repository to be cloned when the Config Server starts up can +help to identify a misconfigured configuration source (e.g., an invalid +repository URI) quickly, while the Config Server is starting up. With +cloneOnStart not enabled for a configuration source, the Config Server may +start successfully with a misconfigured or invalid configuration source and +not detect an error until an application requests configuration from that +configuration source. +
+
+
+
+
Authentication
+
+

To use HTTP basic authentication on the remote repository add the +"username" and "password" properties separately (not in the URL), +e.g.

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/spring-cloud-samples/config-repo
+          username: trolley
+          password: strongpassword
+
+
+
+

If you don’t use HTTPS and user credentials, SSH should also work out +of the box when you store keys in the default directories (~/.ssh) +and the uri points to an SSH location, +e.g. "git@github.com:configuration/cloud-configuration". It is important that an entry for the Git server be present in the ~/.ssh/known_hosts file and that it is in ssh-rsa format. Other formats (like ecdsa-sha2-nistp256) are not supported. To avoid surprises, you should ensure that only one entry is present in the known_hosts file for the Git server and that it is matching with the URL you provided to the config server. If you used a hostname in the URL, you want to have exactly that in the known_hosts file, not the IP. +The repository is accessed using JGit, so any documentation you find on +that should be applicable. HTTPS proxy settings can be set in +~/.git/config or in the same way as for any other JVM process via +system properties (-Dhttps.proxyHost and -Dhttps.proxyPort).

+
+
+ + + + + +
+
Tip
+		 +If you don’t know where your ~/.git directory is use git config +--global to manipulate the settings (e.g. git config --global +http.sslVerify false). +
+
+
+
+
Authentication with AWS CodeCommit
+
+

AWS CodeCommit authentication can also be +done. AWS CodeCommit uses an authentication helper when using Git from the command line. This helper is not +used with the JGit library, so a JGit CredentialProvider for AWS CodeCommit will be created if the Git +URI matches the AWS CodeCommit pattern. AWS CodeCommit URIs always look like +https://git-codecommit.${AWS_REGION}.amazonaws.com/${repopath}.

+
+
+

If you provide a username and password with an AWS CodeCommit URI, then these must be +the AWS accessKeyId and secretAccessKey +to be used to access the repository. If you do not specify a username and password, +then the accessKeyId and secretAccessKey will be retrieved using the +AWS Default Credential Provider Chain.

+
+
+

If your Git URI matches the CodeCommit URI pattern (above) then you must provide +valid AWS credentials in the username and password, or in one of the locations supported +by the default credential provider chain. AWS EC2 instances may use +IAM Roles for EC2 Instances.

+
+
+

Note: The aws-java-sdk-core jar is an optional dependency. If the aws-java-sdk-core jar is not on your +classpath, then the AWS Code Commit credential provider will not be created regardless of the git server URI.

+
+
+
+
Git SSH configuration using properties
+
+

By default, the JGit library used by Spring Cloud Config Server uses SSH configuration files such as ~/.ssh/known_hosts and /etc/ssh/ssh_config when connecting to Git repositories using an SSH URI. +In cloud environments such as Cloud Foundry, the local filesystem may be ephemeral or not easily accessible. For cases such as these, SSH configuration can be set using +Java properties. In order to activate property based SSH configuration, the property spring.cloud.config.server.git.ignoreLocalSshSettings must be set to true. +Example:

+
+
+
+
  spring:
+    cloud:
+      config:
+        server:
+          git:
+            uri: git@gitserver.com:team/repo1.git
+            ignoreLocalSshSettings: true
+            hostKey: someHostKey
+            hostKeyAlgorithm: ssh-rsa
+            privateKey: |
+                         -----BEGIN RSA PRIVATE KEY-----
+                         MIIEpgIBAAKCAQEAx4UbaDzY5xjW6hc9jwN0mX33XpTDVW9WqHp5AKaRbtAC3DqX
+                         IXFMPgw3K45jxRb93f8tv9vL3rD9CUG1Gv4FM+o7ds7FRES5RTjv2RT/JVNJCoqF
+                         ol8+ngLqRZCyBtQN7zYByWMRirPGoDUqdPYrj2yq+ObBBNhg5N+hOwKjjpzdj2Ud
+                         1l7R+wxIqmJo1IYyy16xS8WsjyQuyC0lL456qkd5BDZ0Ag8j2X9H9D5220Ln7s9i
+                         oezTipXipS7p7Jekf3Ywx6abJwOmB0rX79dV4qiNcGgzATnG1PkXxqt76VhcGa0W
+                         DDVHEEYGbSQ6hIGSh0I7BQun0aLRZojfE3gqHQIDAQABAoIBAQCZmGrk8BK6tXCd
+                         fY6yTiKxFzwb38IQP0ojIUWNrq0+9Xt+NsypviLHkXfXXCKKU4zUHeIGVRq5MN9b
+                         BO56/RrcQHHOoJdUWuOV2qMqJvPUtC0CpGkD+valhfD75MxoXU7s3FK7yjxy3rsG
+                         EmfA6tHV8/4a5umo5TqSd2YTm5B19AhRqiuUVI1wTB41DjULUGiMYrnYrhzQlVvj
+                         5MjnKTlYu3V8PoYDfv1GmxPPh6vlpafXEeEYN8VB97e5x3DGHjZ5UrurAmTLTdO8
+                         +AahyoKsIY612TkkQthJlt7FJAwnCGMgY6podzzvzICLFmmTXYiZ/28I4BX/mOSe
+                         pZVnfRixAoGBAO6Uiwt40/PKs53mCEWngslSCsh9oGAaLTf/XdvMns5VmuyyAyKG
+                         ti8Ol5wqBMi4GIUzjbgUvSUt+IowIrG3f5tN85wpjQ1UGVcpTnl5Qo9xaS1PFScQ
+                         xrtWZ9eNj2TsIAMp/svJsyGG3OibxfnuAIpSXNQiJPwRlW3irzpGgVx/AoGBANYW
+                         dnhshUcEHMJi3aXwR12OTDnaLoanVGLwLnkqLSYUZA7ZegpKq90UAuBdcEfgdpyi
+                         PhKpeaeIiAaNnFo8m9aoTKr+7I6/uMTlwrVnfrsVTZv3orxjwQV20YIBCVRKD1uX
+                         VhE0ozPZxwwKSPAFocpyWpGHGreGF1AIYBE9UBtjAoGBAI8bfPgJpyFyMiGBjO6z
+                         FwlJc/xlFqDusrcHL7abW5qq0L4v3R+FrJw3ZYufzLTVcKfdj6GelwJJO+8wBm+R
+                         gTKYJItEhT48duLIfTDyIpHGVm9+I1MGhh5zKuCqIhxIYr9jHloBB7kRm0rPvYY4
+                         VAykcNgyDvtAVODP+4m6JvhjAoGBALbtTqErKN47V0+JJpapLnF0KxGrqeGIjIRV
+                         cYA6V4WYGr7NeIfesecfOC356PyhgPfpcVyEztwlvwTKb3RzIT1TZN8fH4YBr6Ee
+                         KTbTjefRFhVUjQqnucAvfGi29f+9oE3Ei9f7wA+H35ocF6JvTYUsHNMIO/3gZ38N
+                         CPjyCMa9AoGBAMhsITNe3QcbsXAbdUR00dDsIFVROzyFJ2m40i4KCRM35bC/BIBs
+                         q0TY3we+ERB40U8Z2BvU61QuwaunJ2+uGadHo58VSVdggqAo0BSkH58innKKt96J
+                         69pcVH/4rmLbXdcmNYGm6iu+MlPQk4BUZknHSmVHIFdJ0EPupVaQ8RHT
+                         -----END RSA PRIVATE KEY-----
+
+
+ + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1. SSH Configuration properties
Property NameRemarks

ignoreLocalSshSettings

If true, use property based SSH config instead of file based. Must be set at as spring.cloud.config.server.git.ignoreLocalSshSettings, not inside a repository definition.

privateKey

Valid SSH private key. Must be set if ignoreLocalSshSettings is true and Git URI is SSH format

hostKey

Valid SSH host key. Must be set if hostKeyAlgorithm is also set

hostKeyAlgorithm

One of ssh-dss, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 ,ecdsa-sha2-nistp521. Must be set if hostKey is also set

strictHostKeyChecking

true or false. If false, ignore errors with host key

+
+
+
Placeholders in Git Search Paths
+
+

Spring Cloud Config Server also supports a search path with +placeholders for the {application} and {profile} (and {label} if +you need it). Example:

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/spring-cloud-samples/config-repo
+          searchPaths: '{application}'
+
+
+
+

searches the repository for files in the same name as the directory +(as well as the top level). Wildcards are also valid in a search +path with placeholders (any matching directory is included in the +search).

+
+
+
+
Force pull in Git Repositories
+
+

As mentioned before Spring Cloud Config Server makes a clone of the +remote git repository and if somehow the local copy gets dirty (e.g. +folder content changes by OS process) so Spring Cloud Config Server +cannot update the local copy from remote repository.

+
+
+

To solve this there is a force-pull property that will make Spring Cloud +Config Server force pull from remote repository if the local copy is dirty. +Example:

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/spring-cloud-samples/config-repo
+          force-pull: true
+
+
+
+

If you have a multiple repositories configuration you can configure the +force-pull property per repository. Example:

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://git/common/config-repo.git
+          force-pull: true
+          repos:
+            team-a:
+                pattern: team-a-*
+                uri: http://git/team-a/config-repo.git
+                force-pull: true
+            team-b:
+                pattern: team-b-*
+                uri: http://git/team-b/config-repo.git
+                force-pull: true
+            team-c:
+                pattern: team-c-*
+                uri: http://git/team-a/config-repo.git
+
+
+
+ + + + + +
+
Note
+		 +The default value for force-pull property is false. +
+
+
+
+
+

Version Control Backend Filesystem Use

+
+ + + + + +
+
Warning
+		 +With VCS based backends (git, svn) files are checked out or cloned to the local filesystem. By default they are put in the system temporary directory with a prefix of config-repo-. On linux, for example it could be /tmp/config-repo-<randomid>. Some operating systems routinely clean out temporary directories. This can lead to unexpected behaviour such as missing properties. To avoid this problem, change the directory Config Server uses, by setting spring.cloud.config.server.git.basedir or spring.cloud.config.server.svn.basedir to a directory that does not reside in the system temp structure. +
+
+
+
+

File System Backend

+
+

There is also a "native" profile in the Config Server that doesn’t use +Git, but just loads the config files from the local classpath or file +system (any static URL you want to point to with +"spring.cloud.config.server.native.searchLocations"). To use the +native profile just launch the Config Server with +"spring.profiles.active=native".

+
+
+ + + + + +
+
Note
+		 +Remember to use the file: prefix for file resources (the +default without a prefix is usually the classpath). Just as with any +Spring Boot configuration you can embed ${}-style environment +placeholders, but remember that absolute paths in Windows require an +extra "/", e.g. file:///${user.home}/config-repo +
+
+
+ + + + + +
+
Warning
+		 +The default value of the searchLocations is identical to a +local Spring Boot application (so [classpath:/, classpath:/config, +file:./, file:./config]). This does not expose the +application.properties from the server to all clients because any +property sources present in the server are removed before being sent +to the client. +
+
+
+ + + + + +
+
Tip
+		 +A filesystem backend is great for getting started quickly and +for testing. To use it in production you need to be sure that the +file system is reliable, and shared across all instances of the +Config Server. +
+
+
+

The search locations can contain placeholders for {application}, +{profile} and {label}. In this way you can segregate the +directories in the path, and choose a strategy that makes sense for +you (e.g. sub-directory per application, or sub-directory per +profile).

+
+
+

If you don’t use placeholders in the search locations, this repository +also appends the {label} parameter of the HTTP resource to a suffix +on the search path, so properties files are loaded from each search +location and a subdirectory with the same name as the label (the +labelled properties take precedence in the Spring Environment). Thus +the default behaviour with no placeholders is the same as adding a +search location ending with /{label}/. For example file:/tmp/config +is the same as file:/tmp/config,file:/tmp/config/{label}. This behavior can be +disabled by setting spring.cloud.config.server.native.addLabelLocations=false.

+
+
+
+

Vault Backend

+
+

Spring Cloud Config Server also supports Vault as a backend.

+
+
+
+
+

Vault is a tool for securely accessing secrets. A secret is anything +that you want to tightly control access to, such as API keys, passwords, +certificates, and more. Vault provides a unified interface to any secret, +while providing tight access control and recording a detailed audit log.

+
+
+
+
+

For more information on Vault see the Vault quickstart guide.

+
+
+

To enable the config server to use a Vault backend you must run your config server +with the vault profile. For example in your config server’s application.properties +you can add spring.profiles.active=vault.

+
+
+

By default the config server will assume your Vault server is running at +http://127.0.0.1:8200. It also will assume that the name of backend +is secret and the key is application. All of these defaults can be +configured in your config server’s application.properties. Below is a +table of configurable Vault properties. All properties are prefixed with +spring.cloud.config.server.vault.

+
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDefault Value

host

127.0.0.1

port

8200

scheme

http

backend

secret

defaultKey

application

profileSeparator

,

+
+

All configurable properties can be found in +org.springframework.cloud.config.server.environment.VaultEnvironmentRepository.

+
+
+

With your config server running you can make HTTP requests to the server to retrieve +values from the Vault backend. To do this you will need a token for your Vault server.

+
+
+

First place some data in you Vault. For example

+
+
+
+
$ vault write secret/application foo=bar baz=bam
+$ vault write secret/myapp foo=myappsbar
+
+
+
+

Now make the HTTP request to your config server to retrieve the values.

+
+
+

$ curl -X "GET" "http://localhost:8888/myapp/default" -H "X-Config-Token: yourtoken"

+
+
+

You should see a response similar to this after making the above request.

+
+
+
+
{
+   "name":"myapp",
+   "profiles":[
+      "default"
+   ],
+   "label":null,
+   "version":null,
+   "state":null,
+   "propertySources":[
+      {
+         "name":"vault:myapp",
+         "source":{
+            "foo":"myappsbar"
+         }
+      },
+      {
+         "name":"vault:application",
+         "source":{
+            "baz":"bam",
+            "foo":"bar"
+         }
+      }
+   ]
+}
+
+
+
+
Multiple Properties Sources
+
+

When using Vault you can provide your applications with multiple properties sources. +For example, assume you have written data to the following paths in Vault.

+
+
+
+
secret/myApp,dev
+secret/myApp
+secret/application,dev
+secret/application
+
+
+
+

Properties written to secret/application are available to +all applications using the Config Server. An +application with the name myApp would have any properties +written to secret/myApp and secret/application available to it. +When myApp has the dev profile enabled then properties written to +all of the above paths would be available to it, with properties in +the first path in the list taking priority over the others.

+
+
+
+
+

Sharing Configuration With All Applications

+
+
File Based Repositories
+
+

With file-based (i.e. git, svn and native) repositories, resources +with file names in application* are shared between all client +applications (so application.properties, application.yml, +application-*.properties etc.). You can use resources with these +file names to configure global defaults and have them overridden by +application-specific files as necessary.

+
+
+

The #_property_overrides[property overrides] feature can also be used +for setting global defaults, and with placeholders applications are +allowed to override them locally.

+
+
+ + + + + +
+
Tip
+		 +With the "native" profile (local file system backend) it is +recommended that you use an explicit search location that isn’t part +of the server’s own configuration. Otherwise the application* +resources in the default search locations are removed because they are +part of the server. +
+
+
+
+
Vault Server
+
+

When using Vault as a backend you can share configuration with +all applications by placing configuration in +secret/application. For example, if you run this Vault command

+
+
+
+
$ vault write secret/application foo=bar baz=bam
+
+
+
+

All applications using the config server will have the properties +foo and baz available to them.

+
+
+
+
+

Composite Environment Repositories

+
+

In some scenarios you may wish to pull configuration data from multiple +environment repositories. To do this just enable +multiple profiles in your config server’s application properties or YAML file. +If, for example, you want to pull configuration data from a Git repository +as well as a SVN repository you would set the following properties for your +configuration server.

+
+
+
+
spring:
+  profiles:
+    active: git, svn
+  cloud:
+    config:
+      server:
+        svn:
+          uri: file:///path/to/svn/repo
+          order: 2
+        git:
+          uri: file:///path/to/git/repo
+          order: 1
+
+
+
+

In addition to each repo specifying a URI, you can also specify an order property. +The order property allows you to specify the priority order for all your repositories. +The lower the numerical value of the order property the higher priority it will have. +The priority order of a repository will help resolve any potential conflicts between +repositories that contain values for the same properties.

+
+
+ + + + + +
+
Note
+		 +Any type of failure when retrieving values from an environment repositoy +will result in a failure for the entire composite environment. +
+
+
+ + + + + +
+
Note
+		 +When using a composite environment it is important that all repos contain +the same label(s). If you have an environment similar to the one above and you request +configuration data with the label master but the SVN +repo does not contain a branch called master the entire request will fail. +
+
+
+
Custom Composite Environment Repositories
+
+

It is also possible to provide your own EnvironmentRepository bean +to be included as part of a composite environment in addition to +using one of the environment repositories from Spring Cloud. To do this your bean +must implement the EnvironmentRepository interface. If you would like to control +the priority of you custom EnvironmentRepository within the composite +environment you should also implement the Ordered interface and override the +getOrdered method. If you do not implement the Ordered interface then your +EnvironmentRepository will be given the lowest priority.

+
+
+
+
+

Property Overrides

+
+

The Config Server has an "overrides" feature that allows the operator +to provide configuration properties to all applications that cannot be +accidentally changed by the application using the normal Spring Boot +hooks. To declare overrides just add a map of name-value pairs to +spring.cloud.config.server.overrides. For example

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        overrides:
+          foo: bar
+
+
+
+

will cause all applications that are config clients to read foo=bar +independent of their own configuration. (Of course an application can +use the data in the Config Server in any way it likes, so overrides +are not enforceable, but they do provide useful default behaviour if +they are Spring Cloud Config clients.)

+
+
+ + + + + +
+
Tip
+		 +Normal, Spring environment placeholders with "${}" can be escaped +(and resolved on the client) by using backslash ("\") to escape the +"$" or the "{", e.g. \${app.foo:bar} resolves to "bar" unless the +app provides its own "app.foo". Note that in YAML you don’t need to +escape the backslash itself, but in properties files you do, when you +configure the overrides on the server. +
+
+
+

You can change the priority of all overrides in the client to be more +like default values, allowing applications to supply their own values +in environment variables or System properties, by setting the flag +spring.cloud.config.overrideNone=true (default is false) in the +remote repository.

+
+
+
+
+

Health Indicator

+
+

Config Server comes with a Health Indicator that checks if the configured +EnvironmentRepository is working. By default it asks the EnvironmentRepository +for an application named app, the default profile and the default +label provided by the EnvironmentRepository implementation.

+
+
+

You can configure the Health Indicator to check more applications +along with custom profiles and custom labels, e.g.

+
+
+
+
spring:
+  cloud:
+    config:
+      server:
+        health:
+          repositories:
+            myservice:
+              label: mylabel
+            myservice-dev:
+              name: myservice
+              profiles: development
+
+
+
+

You can disable the Health Indicator by setting spring.cloud.config.server.health.enabled=false.

+
+
+
+

Security

+
+

You are free to secure your Config Server in any way that makes sense +to you (from physical network security to OAuth2 bearer +tokens), and Spring Security and Spring Boot make it easy to do pretty +much anything.

+
+
+

To use the default Spring Boot configured HTTP Basic security, just +include Spring Security on the classpath (e.g. through +spring-boot-starter-security). The default is a username of "user" +and a randomly generated password, which isn’t going to be very useful +in practice, so we recommend you configure the password (via +security.user.password) and encrypt it (see below for instructions +on how to do that).

+
+
+
+

Encryption and Decryption

+
+ + + + + +
+
Important
+		 +Prerequisites: to use the encryption and decryption features +you need the full-strength JCE installed in your JVM (it’s not there by default). +You can download the "Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files" +from Oracle, and follow instructions for installation (essentially replace the 2 policy files +in the JRE lib/security directory with the ones that you downloaded). +
+
+
+

If the remote property sources contain encrypted content (values +starting with {cipher}) they will be decrypted before sending to +clients over HTTP. The main advantage of this set up is that the +property values don’t have to be in plain text when they are "at rest" +(e.g. in a git repository). If a value cannot be decrypted it is +removed from the property source and an additional property is added +with the same key, but prefixed with "invalid." and a value that means +"not applicable" (usually "<n/a>"). This is largely to prevent cipher +text being used as a password and accidentally leaking.

+
+
+

If you are setting up a remote config repository for config client +applications it might contain an application.yml like this, for +instance:

+
+
+
application.yml
+
+
spring:
+  datasource:
+    username: dbuser
+    password: '{cipher}FKSAJDFGYOS8F7GLHAKERGFHLSAJ'
+
+
+
+

Encrypted values in a .properties file must not be wrapped in quotes, otherwise the value will not be decrypted:

+
+
+
application.properties
+
+
spring.datasource.username: dbuser
+spring.datasource.password: {cipher}FKSAJDFGYOS8F7GLHAKERGFHLSAJ
+
+
+
+

You can safely push this plain text to a shared git repository and the +secret password is protected.

+
+
+

The server also exposes /encrypt and /decrypt endpoints (on the +assumption that these will be secured and only accessed by authorized +agents). If you are editing a remote config file you can use the Config Server +to encrypt values by POSTing to the /encrypt endpoint, e.g.

+
+
+
+
$ curl localhost:8888/encrypt -d mysecret
+682bc583f4641835fa2db009355293665d2647dade3375c0ee201de2a49f7bda
+
+
+
+ + + + + +
+
Note
+		 +If the value you are encrypting has characters in it that need to be URL encoded you should use +the --data-urlencode option to curl to make sure they are encoded properly. +
+
+
+ + + + + +
+
Tip
+		 +Be sure not to include any of the curl command statistics in the encrypted value. +Outputting the value to a file can help avoid this problem. +
+
+
+

The inverse operation is also available via /decrypt (provided the server is +configured with a symmetric key or a full key pair):

+
+
+
+
$ curl localhost:8888/decrypt -d 682bc583f4641835fa2db009355293665d2647dade3375c0ee201de2a49f7bda
+mysecret
+
+
+
+ + + + + +
+
Tip
+		 +If you are testing like this with curl, then use +--data-urlencode (instead of -d) or set an explicit Content-Type: +text/plain to make sure curl encodes the data correctly when there +are special characters ('+' is particularly tricky). +
+
+
+

Take the encrypted value and add the {cipher} prefix before you put +it in the YAML or properties file, and before you commit and push it +to a remote, potentially insecure store.

+
+
+

The /encrypt and /decrypt endpoints also both accept paths of the +form /*/{name}/{profiles} which can be used to control cryptography +per application (name) and profile when clients call into the main +Environment resource.

+
+
+ + + + + +
+
Note
+		 +to control the cryptography in this granular way you must also +provide a @Bean of type TextEncryptorLocator that creates a +different encryptor per name and profiles. The one that is provided +by default does not do this (so all encryptions use the same key). +
+
+
+

The spring command line client (with Spring Cloud CLI extensions +installed) can also be used to encrypt and decrypt, e.g.

+
+
+
+
$ spring encrypt mysecret --key foo
+682bc583f4641835fa2db009355293665d2647dade3375c0ee201de2a49f7bda
+$ spring decrypt --key foo 682bc583f4641835fa2db009355293665d2647dade3375c0ee201de2a49f7bda
+mysecret
+
+
+
+

To use a key in a file (e.g. an RSA public key for encryption) prepend +the key value with "@" and provide the file path, e.g.

+
+
+
+
$ spring encrypt mysecret --key @${HOME}/.ssh/id_rsa.pub
+AQAjPgt3eFZQXwt8tsHAVv/QHiY5sI2dRcR+...
+
+
+
+

The key argument is mandatory (despite having a -- prefix).

+
+
+
+

Key Management

+
+

The Config Server can use a symmetric (shared) key or an asymmetric +one (RSA key pair). The asymmetric choice is superior in terms of +security, but it is often more convenient to use a symmetric key since +it is just a single property value to configure.

+
+
+

To configure a symmetric key you just need to set encrypt.key to a +secret String (or use an enviroment variable ENCRYPT_KEY to keep it +out of plain text configuration files).

+
+
+

To configure an asymmetric key you can either set the key as a +PEM-encoded text value (in encrypt.key), or via a keystore (e.g. as +created by the keytool utility that comes with the JDK). The +keystore properties are encrypt.keyStore.* with * equal to

+
+
+
    +
  • +

    location (a Resource location),

    +
    • +
  • +

    password (to unlock the keystore) and

    +
    • +
  • +

    alias (to identify which key in the store is to be +used).

    +
    • +
+
+
+

The encryption is done with the public key, and a private key is +needed for decryption. Thus in principle you can configure only the +public key in the server if you only want to do encryption (and are +prepared to decrypt the values yourself locally with the private +key). In practice you might not want to do that because it spreads the +key management process around all the clients, instead of +concentrating it in the server. On the other hand it’s a useful option +if your config server really is relatively insecure and only a +handful of clients need the encrypted properties.

+
+
+
+

Creating a Key Store for Testing

+
+

To create a keystore for testing you can do something like this:

+
+
+
+
$ keytool -genkeypair -alias mytestkey -keyalg RSA \
+  -dname "CN=Web Server,OU=Unit,O=Organization,L=City,S=State,C=US" \
+  -keypass changeme -keystore server.jks -storepass letmein
+
+
+
+

Put the server.jks file in the classpath (for instance) and then in +your application.yml for the Config Server:

+
+
+
+
encrypt:
+  keyStore:
+    location: classpath:/server.jks
+    password: letmein
+    alias: mytestkey
+    secret: changeme
+
+
+
+
+

Using Multiple Keys and Key Rotation

+
+

In addition to the {cipher} prefix in encrypted property values, the +Config Server looks for {name:value} prefixes (zero or many) before +the start of the (Base64 encoded) cipher text. The keys are passed to +a TextEncryptorLocator which can do whatever logic it needs to +locate a TextEncryptor for the cipher. If you have configured a +keystore (encrypt.keystore.location) the default locator will look +for keys in the store with aliases as supplied by the "key" prefix, +i.e. with a cipher text like this:

+
+
+
+
foo:
+  bar: `{cipher}{key:testkey}...`
+
+
+
+

the locator will look for a key named "testkey". A secret can also be +supplied via a {secret:…​} value in the prefix, but if it is not +the default is to use the keystore password (which is what you get +when you build a keytore and don’t specify a secret). If you do +supply a secret it is recommended that you also encrypt the secrets +using a custom SecretLocator.

+
+
+

Key rotation is hardly ever necessary on cryptographic grounds if the +keys are only being used to encrypt a few bytes of configuration data +(i.e. they are not being used elsewhere), but occasionally you might +need to change the keys if there is a security breach for instance. In +that case all the clients would need to change their source config +files (e.g. in git) and use a new {key:…​} prefix in all the +ciphers, checking beforehand of course that the key alias is available +in the Config Server keystore.

+
+
+ + + + + +
+
Tip
+		 +the {name:value} prefixes can also be added to plaintext posted +to the /encrypt endpoint, if you want to let the Config Server +handle all encryption as well as decryption. +
+
+
+
+

Serving Encrypted Properties

+
+

Sometimes you want the clients to decrypt the configuration locally, +instead of doing it in the server. In that case you can still have +/encrypt and /decrypt endpoints (if you provide the encrypt.* +configuration to locate a key), but you need to explicitly switch off +the decryption of outgoing properties using +spring.cloud.config.server.encrypt.enabled=false. If you don’t care +about the endpoints, then it should work if you configure neither the +key nor the enabled flag.

+
+
+
+
+
+

Serving Alternative Formats

+
+
+

The default JSON format from the environment endpoints is perfect for +consumption by Spring applications because it maps directly onto the +Environment abstraction. If you prefer you can consume the same data +as YAML or Java properties by adding a suffix to the resource path +(".yml", ".yaml" or ".properties"). This can be useful for consumption +by applications that do not care about the structure of the JSON +endpoints, or the extra metadata they provide, for example an +application that is not using Spring might benefit from the simplicity +of this approach.

+
+
+

The YAML and properties representations have an additional flag +(provided as a boolean query parameter resolvePlaceholders) to +signal that placeholders in the source documents, in the standard +Spring ${…​} form, should be resolved in the output where possible +before rendering. This is a useful feature for consumers that don’t +know about the Spring placeholder conventions.

+
+
+ + + + + +
+
Note
+		 +there are limitations in using the YAML or properties formats, +mainly in relation to the loss of metadata. The JSON is structured as +an ordered list of property sources, for example, with names that +correlate with the source. The YAML and properties forms are coalesced +into a single map, even if the origin of the values has multiple +sources, and the names of the original source files are lost. The YAML +representation is not necessarily a faithful representation of the +YAML source in a backing repository either: it is constructed from a +list of flat property sources, and assumptions have to be made about +the form of the keys. +
+
+
+
+
+

Serving Plain Text

+
+
+

Instead of using the Environment abstraction (or one of the +alternative representations of it in YAML or properties format) your +applications might need generic plain text configuration files, +tailored to their environment. The Config Server provides these +through an additional endpoint at /{name}/{profile}/{label}/{path} +where "name", "profile" and "label" have the same meaning as the +regular environment endpoint, but "path" is a file name +(e.g. log.xml). The source files for this endpoint are located in +the same way as for the environment endpoints: the same search path is +used as for properties or YAML files, but instead of aggregating all +matching resources, only the first one to match is returned.

+
+
+

After a resource is located, placeholders in the normal format +(${…​}) are resolved using the effective Environment for the +application name, profile and label supplied. In this way the resource +endpoint is tightly integrated with the environment +endpoints. Example, if you have this layout for a GIT (or SVN) +repository:

+
+
+
+
application.yml
+nginx.conf
+
+
+
+

where nginx.conf looks like this:

+
+
+
+
server {
+    listen              80;
+    server_name         ${nginx.server.name};
+}
+
+
+
+

and application.yml like this:

+
+
+
+
nginx:
+  server:
+    name: example.com
+---
+spring:
+  profiles: development
+nginx:
+  server:
+    name: develop.com
+
+
+
+

then the /foo/default/master/nginx.conf resource looks like this:

+
+
+
+
server {
+    listen              80;
+    server_name         example.com;
+}
+
+
+
+

and /foo/development/master/nginx.conf like this:

+
+
+
+
server {
+    listen              80;
+    server_name         develop.com;
+}
+
+
+
+ + + + + +
+
Note
+		 +just like the source files for environment configuration, the +"profile" is used to resolve the file name, so if you want a +profile-specific file then /*/development/*/logback.xml will be +resolved by a file called logback-development.xml (in preference +to logback.xml). +
+
+
+
+
+

Embedding the Config Server

+
+
+

The Config Server runs best as a standalone application, but if you +need to you can embed it in another application. Just use the +@EnableConfigServer annotation. An optional property that can be +useful in this case is spring.cloud.config.server.bootstrap which is +a flag to indicate that the server should configure itself from its +own remote repository. The flag is off by default because it can delay +startup, but when embedded in another application it makes sense to +initialize the same way as any other application.

+
+
+ + + + + +
+
Note
+		 +It should be obvious, but remember that if you use the bootstrap +flag the config server will need to have its name and repository URI +configured in bootstrap.yml. +
+
+
+

To change the location of the server endpoints you can (optionally) +set spring.cloud.config.server.prefix, e.g. "/config", to serve the +resources under a prefix. The prefix should start but not end with a +"/". It is applied to the @RequestMappings in the Config Server +(i.e. underneath the Spring Boot prefixes server.servletPath and +server.contextPath).

+
+
+

If you want to read the configuration for an application directly from +the backend repository (instead of from the config server) that’s +basically an embedded config server with no endpoints. You can switch +off the endpoints entirely if you don’t use the @EnableConfigServer +annotation (just set spring.cloud.config.server.bootstrap=true).

+
+
+
+
+

Push Notifications and Spring Cloud Bus

+
+
+

Many source code repository providers (like Github, Gitlab or Bitbucket +for instance) will notify you of changes in a repository through a +webhook. You can configure the webhook via the provider’s user +interface as a URL and a set of events in which you are +interested. For instance +Github +will POST to the webhook with a JSON body containing a list of +commits, and a header "X-Github-Event" equal to "push". If you add a +dependency on the spring-cloud-config-monitor library and activate +the Spring Cloud Bus in your Config Server, then a "/monitor" endpoint +is enabled.

+
+
+

When the webhook is activated the Config Server will send a +RefreshRemoteApplicationEvent targeted at the applications it thinks +might have changed. The change detection can be strategized, but by +default it just looks for changes in files that match the application +name (e.g. "foo.properties" is targeted at the "foo" application, and +"application.properties" is targeted at all applications). The strategy +if you want to override the behaviour is PropertyPathNotificationExtractor +which accepts the request headers and body as parameters and returns a list +of file paths that changed.

+
+
+

The default configuration works out of the box with Github, Gitlab or +Bitbucket. In addition to the JSON notifications from Github, Gitlab +or Bitbucket you can trigger a change notification by POSTing to +"/monitor" with a form-encoded body parameters path={name}. This will +broadcast to applications matching the "{name}" pattern (can contain +wildcards).

+
+
+ + + + + +
+
Note
+		 +the RefreshRemoteApplicationEvent will only be transmitted if +the spring-cloud-bus is activated in the Config Server and in the +client application. +
+
+
+ + + + + +
+
Note
+		 +the default configuration also detects filesystem changes in +local git repositories (the webhook is not used in that case but as +soon as you edit a config file a refresh will be broadcast). +
+
+
+
+
+

Spring Cloud Config Client

+
+
+

A Spring Boot application can take immediate advantage of the Spring +Config Server (or other external property sources provided by the +application developer), and it will also pick up some additional +useful features related to Environment change events.

+
+
+

Config First Bootstrap

+
+

This is the default behaviour for any application which has the Spring +Cloud Config Client on the classpath. When a config client starts up +it binds to the Config Server (via the bootstrap configuration +property spring.cloud.config.uri) and initializes Spring +Environment with remote property sources.

+
+
+

The net result of this is that all client apps that want to consume +the Config Server need a bootstrap.yml (or an environment variable) +with the server address in spring.cloud.config.uri (defaults to +"http://localhost:8888").

+
+
+
+

Discovery First Bootstrap

+
+

If you are using a `DiscoveryClient implementation, such as Spring Cloud Netflix +and Eureka Service Discovery or Spring Cloud Consul (Spring Cloud Zookeeper does +not support this yet), then you can have the Config Server register with the +Discovery Service if you want to, but in the default "Config First" mode, +clients won’t be able to take advantage of the registration.

+
+
+

If you prefer to use DiscoveryClient to locate the Config Server, you can do +that by setting spring.cloud.config.discovery.enabled=true (default +"false"). The net result of that is that client apps all need a +bootstrap.yml (or an environment variable) with the appropriate discovery +configuration. For example, with Spring Cloud Netflix, you need to define the +Eureka server address, e.g. in eureka.client.serviceUrl.defaultZone. The +price for using this option is an extra network round trip on start up to +locate the service registration. The benefit is that the Config Server +can change its co-ordinates, as long as the Discovery Service is a fixed point. The +default service id is "configserver" but you can change that on the +client with spring.cloud.config.discovery.serviceId (and on the server +in the usual way for a service, e.g. by setting spring.application.name).

+
+
+

The discovery client implementations all support some kind of metadata +map (e.g. for Eureka we have eureka.instance.metadataMap). Some +additional properties of the Config Server may need to be configured +in its service registration metadata so that clients can connect +correctly. If the Config Server is secured with HTTP Basic you can +configure the credentials as "username" and "password". And if the +Config Server has a context path you can set "configPath". Example, +for a Config Server that is a Eureka client:

+
+
+
bootstrap.yml
+
+
eureka:
+  instance:
+    ...
+    metadataMap:
+      user: osufhalskjrtl
+      password: lviuhlszvaorhvlo5847
+      configPath: /config
+
+
+
+
+

Config Client Fail Fast

+
+

In some cases, it may be desirable to fail startup of a service if +it cannot connect to the Config Server. If this is the desired +behavior, set the bootstrap configuration property +spring.cloud.config.failFast=true and the client will halt with +an Exception.

+
+
+
+

Config Client Retry

+
+

If you expect that the config server may occasionally be unavailable when +your app starts, you can ask it to keep trying after a failure. First you need +to set spring.cloud.config.failFast=true, and then you need to add +spring-retry and spring-boot-starter-aop to your classpath. The default +behaviour is to retry 6 times with an initial backoff interval of 1000ms and an +exponential multiplier of 1.1 for subsequent backoffs. You can configure these +properties (and others) using spring.cloud.config.retry.* configuration properties.

+
+
+ + + + + +
+
Tip
+		 +To take full control of the retry add a @Bean of type +RetryOperationsInterceptor with id "configServerRetryInterceptor". Spring +Retry has a RetryInterceptorBuilder that makes it easy to create one. +
+
+
+
+

Locating Remote Configuration Resources

+
+

The Config Service serves property sources from /{name}/{profile}/{label}, where the default bindings in the client app are

+
+
+
    +
  • +

    "name" = ${spring.application.name}

    +
    • +
  • +

    "profile" = ${spring.profiles.active} (actually Environment.getActiveProfiles())

    +
    • +
  • +

    "label" = "master"

    +
    • +
+
+
+

All of them can be overridden by setting spring.cloud.config.* +(where * is "name", "profile" or "label"). The "label" is useful for +rolling back to previous versions of configuration; with the default +Config Server implementation it can be a git label, branch name or +commit id. Label can also be provided as a comma-separated list, in +which case the items in the list are tried on-by-one until one succeeds. +This can be useful when working on a feature branch, for instance, +when you might want to align the config label with your branch, but +make it optional (e.g. spring.cloud.config.label=myfeature,develop).

+
+
+
+

Security

+
+

If you use HTTP Basic security on the server then clients just need to +know the password (and username if it isn’t the default). You can do +that via the config server URI, or via separate username and password +properties, e.g.

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    config:
+     uri: https://user:secret@myconfig.mycompany.com
+
+
+
+

or

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    config:
+     uri: https://myconfig.mycompany.com
+     username: user
+     password: secret
+
+
+
+

The spring.cloud.config.password and spring.cloud.config.username +values override anything that is provided in the URI.

+
+
+

If you deploy your apps on Cloud Foundry then the best way to provide +the password is through service credentials, e.g. in the URI, since +then it doesn’t even need to be in a config file. An example which +works locally and for a user-provided service on Cloud Foundry named +"configserver":

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    config:
+     uri: ${vcap.services.configserver.credentials.uri:http://user:password@localhost:8888}
+
+
+
+

If you use another form of security you might need to provide a +RestTemplate to the ConfigServicePropertySourceLocator (e.g. by +grabbing it in the bootstrap context and injecting one).

+
+
+

Health Indicator

+
+

The Config Client supplies a Spring Boot Health Indicator that attempts to load configuration from Config Server. The health indicator can be disabled by setting health.config.enabled=false. The response is also cached for performance reasons. The default cache time to live is 5 minutes. To change that value set the health.config.time-to-live property (in milliseconds).

+
+
+
+

Providing A Custom RestTemplate

+
+

In some cases you might need to customize the requests made to the config server from +the client. Typically this involves passing special Authorization headers to +authenticate requests to the server. To provide a custom RestTemplate follow the +steps below.

+
+
+
    +
  1. +

    Create a new configuration bean with an implementation of PropertySourceLocator.

    +
    2. +
+
+
+
CustomConfigServiceBootstrapConfiguration.java
+
+
@Configuration
+public class CustomConfigServiceBootstrapConfiguration {
+    @Bean
+    public ConfigServicePropertySourceLocator configServicePropertySourceLocator() {
+        ConfigClientProperties clientProperties = configClientProperties();
+       ConfigServicePropertySourceLocator configServicePropertySourceLocator =  new ConfigServicePropertySourceLocator(clientProperties);
+        configServicePropertySourceLocator.setRestTemplate(customRestTemplate(clientProperties));
+        return configServicePropertySourceLocator;
+    }
+}
+
+
+
+
    +
  1. +

    In resources/META-INF create a file called +spring.factories and specify your custom configuration.

    +
    2. +
+
+
+
spring.factories
+
+
org.springframework.cloud.bootstrap.BootstrapConfiguration = com.my.config.client.CustomConfigServiceBootstrapConfiguration
+
+
+
+
+

Vault

+
+

When using Vault as a backend to your config server the client will need to +supply a token for the server to retrieve values from Vault. This token +can be provided within the client by setting spring.cloud.config.token +in bootstrap.yml.

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    config:
+      token: YourVaultToken
+
+
+
+
+
+

Vault

+
+

Nested Keys In Vault

+
+

Vault supports the ability to nest keys in a value stored in Vault. For example

+
+
+

echo -n '{"appA": {"secret": "appAsecret"}, "bar": "baz"}' | vault write secret/myapp -

+
+
+

This command will write a JSON object to your Vault. To access these values in Spring +you would use the traditional dot(.) annotation. For example

+
+
+
+
@Value("${appA.secret}")
+String name = "World";
+
+
+
+

The above code would set the name variable to appAsecret.

+
+
+
+
+
+

Spring Cloud Netflix

+
+
+
+

Edgware.M1

+
+
+

This project provides Netflix OSS integrations for Spring Boot apps through autoconfiguration +and binding to the Spring Environment and other Spring programming model idioms. With a few +simple annotations you can quickly enable and configure the common patterns inside your +application and build large distributed systems with battle-tested Netflix components. The +patterns provided include Service Discovery (Eureka), Circuit Breaker (Hystrix), +Intelligent Routing (Zuul) and Client Side Load Balancing (Ribbon).

+
+
+
+
+

Service Discovery: Eureka Clients

+
+
+

Service Discovery is one of the key tenets of a microservice based architecture. Trying to hand configure each client or some form of convention can be very difficult to do and can be very brittle. Eureka is the Netflix Service Discovery Server and Client. The server can be configured and deployed to be highly available, with each server replicating state about the registered services to the others.

+
+
+

How to Include Eureka Client

+
+

To include Eureka Client in your project use the starter with group org.springframework.cloud +and artifact id spring-cloud-starter-netflix-eureka-client. See the Spring Cloud Project page +for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+
+

Registering with Eureka

+
+

When a client registers with Eureka, it provides meta-data about itself +such as host and port, health indicator URL, home page etc. Eureka +receives heartbeat messages from each instance belonging to a service. +If the heartbeat fails over a configurable timetable, the instance is +normally removed from the registry.

+
+
+

Example eureka client:

+
+
+
+
@Configuration
+@ComponentScan
+@EnableAutoConfiguration
+@EnableEurekaClient
+@RestController
+public class Application {
+
+    @RequestMapping("/")
+    public String home() {
+        return "Hello world";
+    }
+
+    public static void main(String[] args) {
+        new SpringApplicationBuilder(Application.class).web(true).run(args);
+    }
+
+}
+
+
+
+

(i.e. utterly normal Spring Boot app). In this example we use +@EnableEurekaClient explicitly, but with only Eureka available you +could also use @EnableDiscoveryClient. Configuration is required to +locate the Eureka server. Example:

+
+
+
application.yml
+
+
eureka:
+  client:
+    serviceUrl:
+      defaultZone: http://localhost:8761/eureka/
+
+
+
+

where "defaultZone" is a magic string fallback value that provides the +service URL for any client that doesn’t express a preference +(i.e. it’s a useful default).

+
+
+

The default application name (service ID), virtual host and non-secure +port, taken from the Environment, are ${spring.application.name}, +${spring.application.name} and ${server.port} respectively.

+
+
+

@EnableEurekaClient makes the app into both a Eureka "instance" +(i.e. it registers itself) and a "client" (i.e. it can query the +registry to locate other services). The instance behaviour is driven +by eureka.instance.* configuration keys, but the defaults will be +fine if you ensure that your application has a +spring.application.name (this is the default for the Eureka service +ID, or VIP).

+
+
+

See EurekaInstanceConfigBean and EurekaClientConfigBean for more details of the configurable options.

+
+
+
+

Authenticating with the Eureka Server

+
+

HTTP basic authentication will be automatically added to your eureka +client if one of the eureka.client.serviceUrl.defaultZone URLs has +credentials embedded in it (curl style, like +http://user:password@localhost:8761/eureka). For more complex needs +you can create a @Bean of type DiscoveryClientOptionalArgs and +inject ClientFilter instances into it, all of which will be applied +to the calls from the client to the server.

+
+
+ + + + + +
+
Note
+		 +Because of a limitation in Eureka it isn’t possible to support +per-server basic auth credentials, so only the first set that are +found will be used. +
+
+
+
+

Status Page and Health Indicator

+
+

The status page and health indicators for a Eureka instance default to +"/info" and "/health" respectively, which are the default locations of +useful endpoints in a Spring Boot Actuator application. You need to +change these, even for an Actuator application if you use a +non-default context path or servlet path +(e.g. server.servletPath=/foo) or management endpoint path +(e.g. management.contextPath=/admin). Example:

+
+
+
application.yml
+
+
eureka:
+  instance:
+    statusPageUrlPath: ${management.context-path}/info
+    healthCheckUrlPath: ${management.context-path}/health
+
+
+
+

These links show up in the metadata that is consumed by clients, and +used in some scenarios to decide whether to send requests to your +application, so it’s helpful if they are accurate.

+
+
+
+

Registering a Secure Application

+
+

If your app wants to be contacted over HTTPS you can set two flags in +the EurekaInstanceConfig, viz +eureka.instance.[nonSecurePortEnabled,securePortEnabled]=[false,true] +respectively. This will make Eureka publish instance information +showing an explicit preference for secure communication. The Spring +Cloud DiscoveryClient will always return an https://…​; URI for a +service configured this way, and the Eureka (native) instance +information will have a secure health check URL.

+
+
+

Because of the way +Eureka works internally, it will still publish a non-secure URL for +status and home page unless you also override those explicitly. +You can use placeholders to configure the eureka instance urls, +e.g.

+
+
+
application.yml
+
+
eureka:
+  instance:
+    statusPageUrl: https://${eureka.hostname}/info
+    healthCheckUrl: https://${eureka.hostname}/health
+    homePageUrl: https://${eureka.hostname}/
+
+
+
+

(Note that ${eureka.hostname} is a native placeholder only available +in later versions of Eureka. You could achieve the same thing with +Spring placeholders as well, e.g. using ${eureka.instance.hostName}.)

+
+
+ + + + + +
+
Note
+		 +If your app is running behind a proxy, and the SSL termination +is in the proxy (e.g. if you run in Cloud Foundry or other platforms +as a service) then you will need to ensure that the proxy "forwarded" +headers are intercepted and handled by the application. An embedded +Tomcat container in a Spring Boot app does this automatically if it +has explicit configuration for the 'X-Forwarded-\*` headers. A sign +that you got this wrong will be that the links rendered by your app to +itself will be wrong (the wrong host, port or protocol). +
+
+
+
+

Eureka’s Health Checks

+
+

By default, Eureka uses the client heartbeat to determine if a client is up. +Unless specified otherwise the Discovery Client will not propagate the +current health check status of the application per the Spring Boot Actuator. Which means +that after successful registration Eureka will always announce that the +application is in 'UP' state. This behaviour can be altered by enabling +Eureka health checks, which results in propagating application status +to Eureka. As a consequence every other application won’t be sending +traffic to application in state other then 'UP'.

+
+
+
application.yml
+
+
eureka:
+  client:
+    healthcheck:
+      enabled: true
+
+
+
+ + + + + +
+
Warning
+		 +eureka.client.healthcheck.enabled=true should only be set in application.yml. Setting the value in bootstrap.yml will cause undesirable side effects like registering in eureka with an UNKNOWN status. +
+
+
+

If you require more control over the health checks, you may consider +implementing your own com.netflix.appinfo.HealthCheckHandler.

+
+
+
+

Eureka Metadata for Instances and Clients

+
+

It’s worth spending a bit of time understanding how the Eureka metadata works, so you can use it in a way that makes sense in your platform. There is standard metadata for things like hostname, IP address, port numbers, status page and health check. These are published in the service registry and used by clients to contact the services in a straightforward way. Additional metadata can be added to the instance registration in the eureka.instance.metadataMap, and this will be accessible in the remote clients, but in general will not change the behaviour of the client, unless it is made aware of the meaning of the metadata. There are a couple of special cases described below where Spring Cloud already assigns meaning to the metadata map.

+
+
+

Using Eureka on Cloudfoundry

+
+

Cloudfoundry has a global router so that all instances of the same app have the same hostname (it’s the same in other PaaS solutions with a similar architecture). This isn’t necessarily a barrier to using Eureka, but if you use the router (recommended, or even mandatory depending on the way your platform was set up), you need to explicitly set the hostname and port numbers (secure or non-secure) so that they use the router. You might also want to use instance metadata so you can distinguish between the instances on the client (e.g. in a custom load balancer). By default, the eureka.instance.instanceId is vcap.application.instance_id. For example:

+
+
+
application.yml
+
+
eureka:
+  instance:
+    hostname: ${vcap.application.uris[0]}
+    nonSecurePort: 80
+
+
+
+

Depending on the way the security rules are set up in your Cloudfoundry instance, you might be able to register and use the IP address of the host VM for direct service-to-service calls. This feature is not (yet) available on Pivotal Web Services (PWS).

+
+
+
+

Using Eureka on AWS

+
+

If the application is planned to be deployed to an AWS cloud, then the Eureka instance will have to be configured to be AWS aware and this can be done by customizing the EurekaInstanceConfigBean the following way:

+
+
+
+
@Bean
+@Profile("!default")
+public EurekaInstanceConfigBean eurekaInstanceConfig(InetUtils inetUtils) {
+  EurekaInstanceConfigBean b = new EurekaInstanceConfigBean(inetUtils);
+  AmazonInfo info = AmazonInfo.Builder.newBuilder().autoBuild("eureka");
+  b.setDataCenterInfo(info);
+  return b;
+}
+
+
+
+
+

Changing the Eureka Instance ID

+
+

A vanilla Netflix Eureka instance is registered with an ID that is equal to its host name (i.e. only one service per host). Spring Cloud Eureka provides a sensible default that looks like this: ${spring.cloud.client.hostname}:${spring.application.name}:${spring.application.instance_id:${server.port}}}. For example myhost:myappname:8080.

+
+
+

Using Spring Cloud you can override this by providing a unique identifier in eureka.instance.instanceId. For example:

+
+
+
application.yml
+
+
eureka:
+  instance:
+    instanceId: ${spring.application.name}:${vcap.application.instance_id:${spring.application.instance_id:${random.value}}}
+
+
+
+

With this metadata, and multiple service instances deployed on +localhost, the random value will kick in there to make the instance +unique. In Cloudfoundry the vcap.application.instance_id will be +populated automatically in a Spring Boot application, so the +random value will not be needed.

+
+
+
+
+

Using the EurekaClient

+
+

Once you have an app that is @EnableDiscoveryClient (or @EnableEurekaClient) you can use it to +discover service instances from the Eureka Server. One way to do that is to use the native +com.netflix.discovery.EurekaClient (as opposed to the Spring +Cloud DiscoveryClient), e.g.

+
+
+
+
@Autowired
+private EurekaClient discoveryClient;
+
+public String serviceUrl() {
+    InstanceInfo instance = discoveryClient.getNextServerFromEureka("STORES", false);
+    return instance.getHomePageUrl();
+}
+
+
+
+ + + + + +
+
Tip
+		 +
+

Don’t use the EurekaClient in @PostConstruct method or in a +@Scheduled method (or anywhere where the ApplicationContext might +not be started yet). It is initialized in a SmartLifecycle (with +phase=0) so the earliest you can rely on it being available is in +another SmartLifecycle with higher phase.

+
+
+
+
+

EurekaClient without Jersey

+
+

By default, EurekaClient uses Jersey for HTTP communication. If you wish +to avoid dependencies from Jersey, you can exclude it from your dependencies. +Spring Cloud will auto configure a transport client based on Spring +RestTemplate.

+
+
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-eureka</artifactId>
+    <exclusions>
+        <exclusion>
+            <groupId>com.sun.jersey</groupId>
+            <artifactId>jersey-client</artifactId>
+        </exclusion>
+        <exclusion>
+            <groupId>com.sun.jersey</groupId>
+            <artifactId>jersey-core</artifactId>
+        </exclusion>
+        <exclusion>
+            <groupId>com.sun.jersey.contribs</groupId>
+            <artifactId>jersey-apache-client4</artifactId>
+        </exclusion>
+    </exclusions>
+</dependency>
+
+
+
+
+
+

Alternatives to the native Netflix EurekaClient

+
+

You don’t have to use the raw Netflix EurekaClient and usually it +is more convenient to use it behind a wrapper of some sort. Spring +Cloud has support for Feign (a REST client +builder) and also Spring RestTemplate using +the logical Eureka service identifiers (VIPs) instead of physical +URLs. To configure Ribbon with a fixed list of physical servers you +can simply set <client>.ribbon.listOfServers to a comma-separated +list of physical addresses (or hostnames), where <client> is the ID +of the client.

+
+
+

You can also use the org.springframework.cloud.client.discovery.DiscoveryClient +which provides a simple API for discovery clients that is not specific +to Netflix, e.g.

+
+
+
+
@Autowired
+private DiscoveryClient discoveryClient;
+
+public String serviceUrl() {
+    List<ServiceInstance> list = discoveryClient.getInstances("STORES");
+    if (list != null && list.size() > 0 ) {
+        return list.get(0).getUri();
+    }
+    return null;
+}
+
+
+
+
+

Why is it so Slow to Register a Service?

+
+

Being an instance also involves a periodic heartbeat to the registry +(via the client’s serviceUrl) with default duration 30 seconds. A +service is not available for discovery by clients until the instance, +the server and the client all have the same metadata in their local +cache (so it could take 3 heartbeats). You can change the period using +eureka.instance.leaseRenewalIntervalInSeconds and this will speed up +the process of getting clients connected to other services. In +production it’s probably better to stick with the default because +there are some computations internally in the server that make +assumptions about the lease renewal period.

+
+
+
+

Zones

+
+

If you have deployed Eureka clients to multiple zones than you may prefer that +those clients leverage services within the same zone before trying services +in another zone. To do this you need to configure your Eureka clients correctly.

+
+
+

First, you need to make sure you have Eureka servers deployed to each zone and that +they are peers of each other. See the section on zones and regions +for more information.

+
+
+

Next you need to tell Eureka which zone your service is in. You can do this using +the metadataMap property. For example if service 1 is deployed to both zone 1 +and zone 2 you would need to set the following Eureka properties in service 1

+
+
+

Service 1 in Zone 1

+
+
+
+
eureka.instance.metadataMap.zone = zone1
+eureka.client.preferSameZoneEureka = true
+
+
+
+

Service 1 in Zone 2

+
+
+
+
eureka.instance.metadataMap.zone = zone2
+eureka.client.preferSameZoneEureka = true
+
+
+
+
+
+
+

Service Discovery: Eureka Server

+
+
+

How to Include Eureka Server

+
+

To include Eureka Server in your project use the starter with group org.springframework.cloud +and artifact id spring-cloud-starter-netflix-eureka-server. See the Spring Cloud Project page +for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+
+

How to Run a Eureka Server

+
+

Example eureka server;

+
+
+
+
@SpringBootApplication
+@EnableEurekaServer
+public class Application {
+
+    public static void main(String[] args) {
+        new SpringApplicationBuilder(Application.class).web(true).run(args);
+    }
+
+}
+
+
+
+

The server has a home page with a UI, and HTTP API endpoints per the +normal Eureka functionality under /eureka/*.

+
+
+

Eureka background reading: see flux capacitor and google group discussion.

+
+
+ + + + + +
+
Tip
+		 +
+

Due to Gradle’s dependency resolution rules and the lack of a parent bom feature, simply depending on spring-cloud-starter-netflix-eureka-server can cause failures on application startup. To remedy this the Spring Boot Gradle plugin must be added and the Spring cloud starter parent bom must be imported like so:

+
+
+
build.gradle
+
+
buildscript {
+  dependencies {
+    classpath("org.springframework.boot:spring-boot-gradle-plugin:1.3.5.RELEASE")
+  }
+}
+
+apply plugin: "spring-boot"
+
+dependencyManagement {
+  imports {
+    mavenBom "org.springframework.cloud:spring-cloud-dependencies:Brixton.RELEASE"
+  }
+}
+
+
+
+
+
+
+

High Availability, Zones and Regions

+
+

The Eureka server does not have a backend store, but the service +instances in the registry all have to send heartbeats to keep their +registrations up to date (so this can be done in memory). Clients also +have an in-memory cache of eureka registrations (so they don’t have to +go to the registry for every single request to a service).

+
+
+

By default every Eureka server is also a Eureka client and requires +(at least one) service URL to locate a peer. If you don’t provide it +the service will run and work, but it will shower your logs with a lot +of noise about not being able to register with the peer.

+
+
+

See also below for details of Ribbon +support on the client side for Zones and Regions.

+
+
+
+

Standalone Mode

+
+

The combination of the two caches (client and server) and the +heartbeats make a standalone Eureka server fairly resilient to +failure, as long as there is some sort of monitor or elastic runtime +keeping it alive (e.g. Cloud Foundry). In standalone mode, you might +prefer to switch off the client side behaviour, so it doesn’t keep +trying and failing to reach its peers. Example:

+
+
+
application.yml (Standalone Eureka Server)
+
+
server:
+  port: 8761
+
+eureka:
+  instance:
+    hostname: localhost
+  client:
+    registerWithEureka: false
+    fetchRegistry: false
+    serviceUrl:
+      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
+
+
+
+

Notice that the serviceUrl is pointing to the same host as the local +instance.

+
+
+
+

Peer Awareness

+
+

Eureka can be made even more resilient and available by running +multiple instances and asking them to register with each other. In +fact, this is the default behaviour, so all you need to do to make it +work is add a valid serviceUrl to a peer, e.g.

+
+
+
application.yml (Two Peer Aware Eureka Servers)
+
+
---
+spring:
+  profiles: peer1
+eureka:
+  instance:
+    hostname: peer1
+  client:
+    serviceUrl:
+      defaultZone: http://peer2/eureka/
+
+---
+spring:
+  profiles: peer2
+eureka:
+  instance:
+    hostname: peer2
+  client:
+    serviceUrl:
+      defaultZone: http://peer1/eureka/
+
+
+
+

In this example we have a YAML file that can be used to run the same +server on 2 hosts (peer1 and peer2), by running it in different +Spring profiles. You could use this configuration to test the peer +awareness on a single host (there’s not much value in doing that in +production) by manipulating /etc/hosts to resolve the host names. In +fact, the eureka.instance.hostname is not needed if you are running +on a machine that knows its own hostname (it is looked up using +java.net.InetAddress by default).

+
+
+

You can add multiple peers to a system, and as long as they are all +connected to each other by at least one edge, they will synchronize +the registrations amongst themselves. If the peers are physically +separated (inside a data centre or between multiple data centres) then +the system can in principle survive split-brain type failures.

+
+
+
+

Prefer IP Address

+
+

In some cases, it is preferable for Eureka to advertise the IP Adresses +of services rather than the hostname. Set eureka.instance.preferIpAddress +to true and when the application registers with eureka, it will use its +IP Address rather than its hostname.

+
+
+ + + + + +
+
Tip
+		 +
+

If hostname can’t be determined by Java, then IP address is sent to Eureka. +Only explict way of setting hostname is by using eureka.instance.hostname. +You can set your hostname at the run time using environment variable, for +example eureka.instance.hostname=${HOST_NAME}.

+
+
+
+
+
+
+
+

Circuit Breaker: Hystrix Clients

+
+
+

Netflix has created a library called Hystrix that implements the circuit breaker pattern. In a microservice architecture it is common to have multiple layers of service calls.

+
+
+
+HystrixGraph +
+
Figure 1. Microservice Graph
+
+
+

A service failure in the lower level of services can cause cascading failure all the way up to the user. When calls to a particular service is greater than circuitBreaker.requestVolumeThreshold (default: 20 requests) and failue percentage is greater than circuitBreaker.errorThresholdPercentage (default: >50%) in a rolling window defined by metrics.rollingStats.timeInMilliseconds (default: 10 seconds), the circuit opens and the call is not made. In cases of error and an open circuit a fallback can be provided by the developer.

+
+
+
+HystrixFallback +
+
Figure 2. Hystrix fallback prevents cascading failures
+
+
+

Having an open circuit stops cascading failures and allows overwhelmed or failing services time to heal. The fallback can be another Hystrix protected call, static data or a sane empty value. Fallbacks may be chained so the first fallback makes some other business call which in turn falls back to static data.

+
+
+

How to Include Hystrix

+
+

To include Hystrix in your project use the starter with group org.springframework.cloud +and artifact id spring-cloud-starter-netflix-hystrix. See the Spring Cloud Project page +for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+

Example boot app:

+
+
+
+
@SpringBootApplication
+@EnableCircuitBreaker
+public class Application {
+
+    public static void main(String[] args) {
+        new SpringApplicationBuilder(Application.class).web(true).run(args);
+    }
+
+}
+
+@Component
+public class StoreIntegration {
+
+    @HystrixCommand(fallbackMethod = "defaultStores")
+    public Object getStores(Map<String, Object> parameters) {
+        //do stuff that might fail
+    }
+
+    public Object defaultStores(Map<String, Object> parameters) {
+        return /* something useful */;
+    }
+}
+
+
+
+

The @HystrixCommand is provided by a Netflix contrib library called +"javanica". +Spring Cloud automatically wraps Spring beans with that +annotation in a proxy that is connected to the Hystrix circuit +breaker. The circuit breaker calculates when to open and close the +circuit, and what to do in case of a failure.

+
+
+

To configure the @HystrixCommand you can use the commandProperties +attribute with a list of @HystrixProperty annotations. See +here +for more details. See the Hystrix wiki +for details on the properties available.

+
+
+
+

Propagating the Security Context or using Spring Scopes

+
+

If you want some thread local context to propagate into a @HystrixCommand the default declaration will not work because it executes the command in a thread pool (in case of timeouts). You can switch Hystrix to use the same thread as the caller using some configuration, or directly in the annotation, by asking it to use a different "Isolation Strategy". For example:

+
+
+
+
@HystrixCommand(fallbackMethod = "stubMyService",
+    commandProperties = {
+      @HystrixProperty(name="execution.isolation.strategy", value="SEMAPHORE")
+    }
+)
+...
+
+
+
+

The same thing applies if you are using @SessionScope or @RequestScope. You will know when you need to do this because of a runtime exception that says it can’t find the scoped context.

+
+
+

You also have the option to set the hystrix.shareSecurityContext property to true. Doing so will auto configure an Hystrix concurrency strategy plugin hook who will transfer the SecurityContext from your main thread to the one used by the Hystrix command. Hystrix does not allow multiple hystrix concurrency strategy to be registered so an extension mechanism is available by declaring your own HystrixConcurrencyStrategy as a Spring bean. Spring Cloud will lookup for your implementation within the Spring context and wrap it inside its own plugin.

+
+
+
+

Health Indicator

+
+

The state of the connected circuit breakers are also exposed in the +/health endpoint of the calling application.

+
+
+
+
{
+    "hystrix": {
+        "openCircuitBreakers": [
+            "StoreIntegration::getStoresByLocationLink"
+        ],
+        "status": "CIRCUIT_OPEN"
+    },
+    "status": "UP"
+}
+
+
+
+
+

Hystrix Metrics Stream

+
+

To enable the Hystrix metrics stream include a dependency on spring-boot-starter-actuator. This will expose the /hystrix.stream as a management endpoint.

+
+
+
+
    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-actuator</artifactId>
+    </dependency>
+
+
+
+
+
+
+

Circuit Breaker: Hystrix Dashboard

+
+
+

One of the main benefits of Hystrix is the set of metrics it gathers about each HystrixCommand. The Hystrix Dashboard displays the health of each circuit breaker in an efficient manner.

+
+
+
+Hystrix +
+
Figure 3. Hystrix Dashboard
+
+
+
+
+

Hystrix Timeouts And Ribbon Clients

+
+
+

When using Hystrix commands that wrap Ribbon clients you want to make sure your Hystrix timeout +is configured to be longer than the configured Ribbon timeout, including any potential +retries that might be made. For example, if your Ribbon connection timeout is one second and +the Ribbon client might retry the request three times, than your Hystrix timeout should +be slightly more than three seconds.

+
+
+

How to Include Hystrix Dashboard

+
+

To include the Hystrix Dashboard in your project use the starter with group org.springframework.cloud +and artifact id spring-cloud-starter-hystrix-netflix-dashboard. See the Spring Cloud Project page +for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+

To run the Hystrix Dashboard annotate your Spring Boot main class with @EnableHystrixDashboard. You then visit /hystrix and point the dashboard to an individual instances /hystrix.stream endpoint in a Hystrix client application.

+
+
+ + + + + +
+
Note
+		 +When connecting to a /hystrix.stream endpoint which uses HTTPS the certificate used by the server +must be trusted by the JVM. If the certificate is not trusted you must import the certificate into the JVM +in order for the Hystrix Dashboard to make a successful connection to the stream endpoint. +
+
+
+
+

Turbine

+
+

Looking at an individual instances Hystrix data is not very useful in terms of the overall health of the system. Turbine is an application that aggregates all of the relevant /hystrix.stream endpoints into a combined /turbine.stream for use in the Hystrix Dashboard. Individual instances are located via Eureka. Running Turbine is as simple as annotating your main class with the @EnableTurbine annotation (e.g. using spring-cloud-starter-netflix-turbine to set up the classpath). All of the documented configuration properties from the Turbine 1 wiki apply. The only difference is that the turbine.instanceUrlSuffix does not need the port prepended as this is handled automatically unless turbine.instanceInsertPort=false.

+
+
+ + + + + +
+
Note
+		 +By default, Turbine looks for the /hystrix.stream endpoint on a registered instance by looking up its homePageUrl entry in Eureka, then appending /hystrix.stream to it. This means that if spring-boot-actuator is running on its own port (which is the default), the call to /hystrix.stream will fail. +To make turbine find the Hystrix stream at the correct port, you need to add management.port to the instances' metadata: +
+
+
+
+
eureka:
+  instance:
+    metadata-map:
+      management.port: ${management.port:8081}
+
+
+
+

The configuration key turbine.appConfig is a list of eureka serviceIds that turbine will use to lookup instances. The turbine stream is then used in the Hystrix dashboard using a url that looks like: http://my.turbine.sever:8080/turbine.stream?cluster=<CLUSTERNAME>; (the cluster parameter can be omitted if the name is "default"). The cluster parameter must match an entry in turbine.aggregator.clusterConfig. Values returned from eureka are uppercase, thus we expect this example to work if there is an app registered with Eureka called "customers":

+
+
+
+
turbine:
+  aggregator:
+    clusterConfig: CUSTOMERS
+  appConfig: customers
+
+
+
+

The clusterName can be customized by a SPEL expression in turbine.clusterNameExpression with root an instance of InstanceInfo. The default value is appName, which means that the Eureka serviceId ends up as the cluster key (i.e. the InstanceInfo for customers has an appName of "CUSTOMERS"). A different example would be turbine.clusterNameExpression=aSGName, which would get the cluster name from the AWS ASG name. Another example:

+
+
+
+
turbine:
+  aggregator:
+    clusterConfig: SYSTEM,USER
+  appConfig: customers,stores,ui,admin
+  clusterNameExpression: metadata['cluster']
+
+
+
+

In this case, the cluster name from 4 services is pulled from their metadata map, and is expected to have values that include "SYSTEM" and "USER".

+
+
+

To use the "default" cluster for all apps you need a string literal expression (with single quotes, and escaped with double quotes if it is in YAML as well):

+
+
+
+
turbine:
+  appConfig: customers,stores
+  clusterNameExpression: "'default'"
+
+
+
+

Spring Cloud provides a spring-cloud-starter-netflix-turbine that has all the dependencies you need to get a Turbine server running. Just create a Spring Boot application and annotate it with @EnableTurbine.

+
+
+ + + + + +
+
Note
+		 +by default Spring Cloud allows Turbine to use the host and port to allow multiple processes per host, per cluster. If you want the native Netflix behaviour built into Turbine that does not allow multiple processes per host, per cluster (the key to the instance id is the hostname), then set the property turbine.combineHostPort=false. +
+
+
+
+

Turbine Stream

+
+

In some environments (e.g. in a PaaS setting), the classic Turbine model of pulling metrics from all the distributed Hystrix commands doesn’t work. In that case you might want to have your Hystrix commands push metrics to Turbine, and Spring Cloud enables that with messaging. All you need to do on the client is add a dependency to spring-cloud-netflix-hystrix-stream and the spring-cloud-starter-stream-* of your choice (see Spring Cloud Stream documentation for details on the brokers, and how to configure the client credentials, but it should work out of the box for a local broker).

+
+
+

On the server side Just create a Spring Boot application and annotate it with @EnableTurbineStream and by default it will come up on port 8989 (point your Hystrix dashboard to that port, any path). You can customize the port using either server.port or turbine.stream.port. If you have spring-boot-starter-web and spring-boot-starter-actuator on the classpath as well, then you can open up the Actuator endpoints on a separate port (with Tomcat by default) by providing a management.port which is different.

+
+
+

You can then point the Hystrix Dashboard to the Turbine Stream Server instead of individual Hystrix streams. If Turbine Stream is running on port 8989 on myhost, then put http://myhost:8989 in the stream input field in the Hystrix Dashboard. Circuits will be prefixed by their respective serviceId, followed by a dot, then the circuit name.

+
+
+

Spring Cloud provides a spring-cloud-starter-netflix-turbine-stream that has all the dependencies you need to get a Turbine Stream server running - just add the Stream binder of your choice, e.g. spring-cloud-starter-stream-rabbit. You need Java 8 to run the app because it is Netty-based.

+
+
+
+
+
+

Client Side Load Balancer: Ribbon

+
+
+

Ribbon is a client side load balancer which gives you a lot of control +over the behaviour of HTTP and TCP clients. Feign already uses Ribbon, +so if you are using @FeignClient then this section also applies.

+
+
+

A central concept in Ribbon is that of the named client. Each load +balancer is part of an ensemble of components that work together to +contact a remote server on demand, and the ensemble has a name that +you give it as an application developer (e.g. using the @FeignClient +annotation). Spring Cloud creates a new ensemble as an +ApplicationContext on demand for each named client using +RibbonClientConfiguration. This contains (amongst other things) an +ILoadBalancer, a RestClient, and a ServerListFilter.

+
+
+

How to Include Ribbon

+
+

To include Ribbon in your project use the starter with group org.springframework.cloud +and artifact id spring-cloud-starter-netflix-ribbon. See the Spring Cloud Project page +for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+
+

Customizing the Ribbon Client

+
+

You can configure some bits of a Ribbon client using external +properties in <client>.ribbon.*, which is no different than using +the Netflix APIs natively, except that you can use Spring Boot +configuration files. The native options can +be inspected as static fields in CommonClientConfigKey (part of +ribbon-core).

+
+
+

Spring Cloud also lets you take full control of the client by +declaring additional configuration (on top of the +RibbonClientConfiguration) using @RibbonClient. Example:

+
+
+
+
@Configuration
+@RibbonClient(name = "foo", configuration = FooConfiguration.class)
+public class TestConfiguration {
+}
+
+
+
+

In this case the client is composed from the components already in +RibbonClientConfiguration together with any in FooConfiguration +(where the latter generally will override the former).

+
+
+ + + + + +
+
Warning
+		 +The FooConfiguration has to be @Configuration but take +care that it is not in a @ComponentScan for the main application +context, otherwise it will be shared by all the @RibbonClients. If +you use @ComponentScan (or @SpringBootApplication) you need to +take steps to avoid it being included (for instance put it in a +separate, non-overlapping package, or specify the packages to scan +explicitly in the @ComponentScan). +
+
+
+

Spring Cloud Netflix provides the following beans by default for ribbon +(BeanType beanName: ClassName):

+
+
+
    +
  • +

    IClientConfig ribbonClientConfig: DefaultClientConfigImpl

    +
    • +
  • +

    IRule ribbonRule: ZoneAvoidanceRule

    +
    • +
  • +

    IPing ribbonPing: DummyPing

    +
    • +
  • +

    ServerList<Server> ribbonServerList: ConfigurationBasedServerList

    +
    • +
  • +

    ServerListFilter<Server> ribbonServerListFilter: ZonePreferenceServerListFilter

    +
    • +
  • +

    ILoadBalancer ribbonLoadBalancer: ZoneAwareLoadBalancer

    +
    • +
  • +

    ServerListUpdater ribbonServerListUpdater: PollingServerListUpdater

    +
    • +
+
+
+

Creating a bean of one of those type and placing it in a @RibbonClient +configuration (such as FooConfiguration above) allows you to override each +one of the beans described. Example:

+
+
+
+
@Configuration
+protected static class FooConfiguration {
+	@Bean
+	public ZonePreferenceServerListFilter serverListFilter() {
+		ZonePreferenceServerListFilter filter = new ZonePreferenceServerListFilter();
+		filter.setZone("myTestZone");
+		return filter;
+	}
+
+	@Bean
+	public IPing ribbonPing() {
+		return new PingUrl();
+	}
+}
+
+
+
+

This replaces the NoOpPing with PingUrl and provides a custom serverListFilter

+
+
+
+

Customizing default for all Ribbon Clients

+
+

A default configuration can be provided for all Ribbon Clients using the @RibbonClients annotation and registering a default configuration as shown in the following example:

+
+
+
+
@RibbonClients(defaultConfiguration = DefaultRibbonConfig.class)
+public class RibbonClientDefaultConfigurationTestsConfig {
+
+	public static class BazServiceList extends ConfigurationBasedServerList {
+		public BazServiceList(IClientConfig config) {
+			super.initWithNiwsConfig(config);
+		}
+	}
+}
+
+@Configuration
+class DefaultRibbonConfig {
+
+	@Bean
+	public IRule ribbonRule() {
+		return new BestAvailableRule();
+	}
+
+	@Bean
+	public IPing ribbonPing() {
+		return new PingUrl();
+	}
+
+	@Bean
+	public ServerList<Server> ribbonServerList(IClientConfig config) {
+		return new RibbonClientDefaultConfigurationTestsConfig.BazServiceList(config);
+	}
+
+	@Bean
+	public ServerListSubsetFilter serverListFilter() {
+		ServerListSubsetFilter filter = new ServerListSubsetFilter();
+		return filter;
+	}
+
+}
+
+
+
+
+

Customizing the Ribbon Client using properties

+
+

Starting with version 1.2.0, Spring Cloud Netflix now supports customizing Ribbon clients using properties to be compatible with the Ribbon documentation.

+
+
+

This allows you to change behavior at start up time in different environments.

+
+
+

The supported properties are listed below and should be prefixed by <clientName>.ribbon.:

+
+
+
    +
  • +

    NFLoadBalancerClassName: should implement ILoadBalancer

    +
    • +
  • +

    NFLoadBalancerRuleClassName: should implement IRule

    +
    • +
  • +

    NFLoadBalancerPingClassName: should implement IPing

    +
    • +
  • +

    NIWSServerListClassName: should implement ServerList

    +
    • +
  • +

    NIWSServerListFilterClassName should implement ServerListFilter

    +
    • +
+
+
+ + + + + +
+
Note
+		 +Classes defined in these properties have precedence over beans defined using @RibbonClient(configuration=MyRibbonConfig.class) and the defaults provided by Spring Cloud Netflix. +
+
+
+

To set the IRule for a service name users you could set the following:

+
+
+
application.yml
+
+
users:
+  ribbon:
+    NFLoadBalancerRuleClassName: com.netflix.loadbalancer.WeightedResponseTimeRule
+
+
+
+

See the Ribbon documentation for implementations provided by Ribbon.

+
+
+
+

Using Ribbon with Eureka

+
+

When Eureka is used in conjunction with Ribbon (i.e., both are on the classpath) the ribbonServerList +is overridden with an extension of DiscoveryEnabledNIWSServerList +which populates the list of servers from Eureka. It also replaces the +IPing interface with NIWSDiscoveryPing which delegates to Eureka +to determine if a server is up. The ServerList that is installed by +default is a DomainExtractingServerList and the purpose of this is +to make physical metadata available to the load balancer without using +AWS AMI metadata (which is what Netflix relies on). By default the +server list will be constructed with "zone" information as provided in +the instance metadata (so on the remote clients set +eureka.instance.metadataMap.zone), and if that is missing it can use +the domain name from the server hostname as a proxy for zone (if the +flag approximateZoneFromHostname is set). Once the zone information +is available it can be used in a ServerListFilter. By default it +will be used to locate a server in the same zone as the client because +the default is a ZonePreferenceServerListFilter. The zone of the +client is determined the same way as the remote instances by default, +i.e. via eureka.instance.metadataMap.zone.

+
+
+ + + + + +
+
Note
+		 +The orthodox "archaius" way to set the client zone is via a +configuration property called "@zone", and Spring Cloud will use that +in preference to all other settings if it is available (note that the +key will have to be quoted in YAML configuration). +
+
+
+ + + + + +
+
Note
+		 +If there is no other source of zone data then a guess is made +based on the client configuration (as opposed to the instance +configuration). We take eureka.client.availabilityZones, which is a +map from region name to a list of zones, and pull out the first zone +for the instance’s own region (i.e. the eureka.client.region, which +defaults to "us-east-1" for comatibility with native Netflix). +
+
+
+
+

Example: How to Use Ribbon Without Eureka

+
+

Eureka is a convenient way to abstract the discovery of remote servers +so you don’t have to hard code their URLs in clients, but if you +prefer not to use it, Ribbon and Feign are still quite +amenable. Suppose you have declared a @RibbonClient for "stores", +and Eureka is not in use (and not even on the classpath). The Ribbon +client defaults to a configured server list, and you can supply the +configuration like this

+
+
+
application.yml
+
+
stores:
+  ribbon:
+    listOfServers: example.com,google.com
+
+
+
+
+

Example: Disable Eureka use in Ribbon

+
+

Setting the property ribbon.eureka.enabled = false will explicitly +disable the use of Eureka in Ribbon.

+
+
+
application.yml
+
+
ribbon:
+  eureka:
+   enabled: false
+
+
+
+
+

Using the Ribbon API Directly

+
+

You can also use the LoadBalancerClient directly. Example:

+
+
+
+
public class MyClass {
+    @Autowired
+    private LoadBalancerClient loadBalancer;
+
+    public void doStuff() {
+        ServiceInstance instance = loadBalancer.choose("stores");
+        URI storesUri = URI.create(String.format("http://%s:%s", instance.getHost(), instance.getPort()));
+        // ... do something with the URI
+    }
+}
+
+
+
+
+

Caching of Ribbon Configuration

+
+

Each Ribbon named client has a corresponding child Application Context that Spring Cloud maintains, this application context is lazily loaded up on the first request to the named client. +This lazy loading behavior can be changed to instead eagerly load up these child Application contexts at startup by specifying the names of the Ribbon clients.

+
+
+
application.yml
+
+
ribbon:
+  eager-load:
+    enabled: true
+    clients: client1, client2, client3
+
+
+
+
+

How to Configure Hystrix thread pools

+
+

If you change zuul.ribbonIsolationStrategy to THREAD, the thread isolation strategy for Hystrix will be used for all routes. In this case, the HystrixThreadPoolKey is set to "RibbonCommand" as default. It means that HystrixCommands for all routes will be executed in the same Hystrix thread pool. This behavior can be changed using the following configuration and it will result in HystrixCommands being executed in the Hystrix thread pool for each route.

+
+
+
application.yml
+
+
zuul:
+  threadPool:
+    useSeparateThreadPools: true
+
+
+
+

The default HystrixThreadPoolKey in this case is same with service ID for each route. To add a prefix to HystrixThreadPoolKey, set zuul.threadPool.threadPoolKeyPrefix to a value that you want to add. For example:

+
+
+
application.yml
+
+
zuul:
+  threadPool:
+    useSeparateThreadPools: true
+    threadPoolKeyPrefix: zuulgw
+
+
+
+
+
+
+

Declarative REST Client: Feign

+
+
+

Feign is a declarative web service client. It makes writing web service clients easier. To use Feign create an interface and annotate it. It has pluggable annotation support including Feign annotations and JAX-RS annotations. Feign also supports pluggable encoders and decoders. Spring Cloud adds support for Spring MVC annotations and for using the same HttpMessageConverters used by default in Spring Web. Spring Cloud integrates Ribbon and Eureka to provide a load balanced http client when using Feign.

+
+
+

How to Include Feign

+
+

To include Feign in your project use the starter with group org.springframework.cloud +and artifact id spring-cloud-starter-openfeign. See the Spring Cloud Project page +for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+

Example spring boot app

+
+
+
+
@Configuration
+@ComponentScan
+@EnableAutoConfiguration
+@EnableEurekaClient
+@EnableFeignClients
+public class Application {
+
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+
+}
+
+
+
+
StoreClient.java
+
+
@FeignClient("stores")
+public interface StoreClient {
+    @RequestMapping(method = RequestMethod.GET, value = "/stores")
+    List<Store> getStores();
+
+    @RequestMapping(method = RequestMethod.POST, value = "/stores/{storeId}", consumes = "application/json")
+    Store update(@PathVariable("storeId") Long storeId, Store store);
+}
+
+
+
+

In the @FeignClient annotation the String value ("stores" above) is +an arbitrary client name, which is used to create a Ribbon load +balancer (see below for details of Ribbon +support). You can also specify a URL using the url attribute +(absolute value or just a hostname). The name of the bean in the +application context is the fully qualified name of the interface. +To specify your own alias value you can use the qualifier value +of the @FeignClient annotation.

+
+
+

The Ribbon client above will want to discover the physical addresses +for the "stores" service. If your application is a Eureka client then +it will resolve the service in the Eureka service registry. If you +don’t want to use Eureka, you can simply configure a list of servers +in your external configuration (see +above for example).

+
+
+
+

Overriding Feign Defaults

+
+

A central concept in Spring Cloud’s Feign support is that of the named client. Each feign client is part of an ensemble of components that work together to contact a remote server on demand, and the ensemble has a name that you give it as an application developer using the @FeignClient annotation. Spring Cloud creates a new ensemble as an +ApplicationContext on demand for each named client using FeignClientsConfiguration. This contains (amongst other things) an feign.Decoder, a feign.Encoder, and a feign.Contract.

+
+
+

Spring Cloud lets you take full control of the feign client by declaring additional configuration (on top of the FeignClientsConfiguration) using @FeignClient. Example:

+
+
+
+
@FeignClient(name = "stores", configuration = FooConfiguration.class)
+public interface StoreClient {
+    //..
+}
+
+
+
+

In this case the client is composed from the components already in FeignClientsConfiguration together with any in FooConfiguration (where the latter will override the former).

+
+
+ + + + + +
+
Note
+		 +FooConfiguration does not need to be annotated with @Configuration. However, if it is, then take care to exclude it from any @ComponentScan that would otherwise include this configuration as it will become the default source for feign.Decoder, feign.Encoder, feign.Contract, etc., when specified. This can be avoided by putting it in a separate, non-overlapping package from any @ComponentScan or @SpringBootApplication, or it can be explicitly excluded in @ComponentScan. +
+
+
+ + + + + +
+
Note
+		 +The serviceId attribute is now deprecated in favor of the name attribute. +
+
+
+ + + + + +
+
Warning
+		 +Previously, using the url attribute, did not require the name attribute. Using name is now required. +
+
+
+

Placeholders are supported in the name and url attributes.

+
+
+
+
@FeignClient(name = "${feign.name}", url = "${feign.url}")
+public interface StoreClient {
+    //..
+}
+
+
+
+

Spring Cloud Netflix provides the following beans by default for feign (BeanType beanName: ClassName):

+
+
+
    +
  • +

    Decoder feignDecoder: ResponseEntityDecoder (which wraps a SpringDecoder)

    +
    • +
  • +

    Encoder feignEncoder: SpringEncoder

    +
    • +
  • +

    Logger feignLogger: Slf4jLogger

    +
    • +
  • +

    Contract feignContract: SpringMvcContract

    +
    • +
  • +

    Feign.Builder feignBuilder: HystrixFeign.Builder

    +
    • +
  • +

    Client feignClient: if Ribbon is enabled it is a LoadBalancerFeignClient, otherwise the default feign client is used.

    +
    • +
+
+
+

The OkHttpClient and ApacheHttpClient feign clients can be used by setting feign.okhttp.enabled or feign.httpclient.enabled to true, respectively, and having them on the classpath. +You can customize the HTTP client used by providing a bean of either ClosableHttpClient when using Apache or OkHttpClient whe using OK HTTP.

+
+
+

Spring Cloud Netflix does not provide the following beans by default for feign, but still looks up beans of these types from the application context to create the feign client:

+
+
+
    +
  • +

    Logger.Level

    +
    • +
  • +

    Retryer

    +
    • +
  • +

    ErrorDecoder

    +
    • +
  • +

    Request.Options

    +
    • +
  • +

    Collection<RequestInterceptor>

    +
    • +
  • +

    SetterFactory

    +
    • +
+
+
+

Creating a bean of one of those type and placing it in a @FeignClient configuration (such as FooConfiguration above) allows you to override each one of the beans described. Example:

+
+
+
+
@Configuration
+public class FooConfiguration {
+    @Bean
+    public Contract feignContract() {
+        return new feign.Contract.Default();
+    }
+
+    @Bean
+    public BasicAuthRequestInterceptor basicAuthRequestInterceptor() {
+        return new BasicAuthRequestInterceptor("user", "password");
+    }
+}
+
+
+
+

This replaces the SpringMvcContract with feign.Contract.Default and adds a RequestInterceptor to the collection of RequestInterceptor.

+
+
+

@FeignClient also can be configured using configuration properties.

+
+
+

application.yml

+
+
+
+
feign:
+  client:
+    config:
+      feignName:
+        connectTimeout: 5000
+        readTimeout: 5000
+        loggerLevel: full
+        errorDecoder: com.example.SimpleErrorDecoder
+        retryer: com.example.SimpleRetryer
+        requestInterceptors:
+          - com.example.FooRequestInterceptor
+          - com.example.BarRequestInterceptor
+        decode404: false
+
+
+
+

Default configurations can be specified in the @EnableFeignClients attribute defaultConfiguration in a similar manner as described above. The difference is that this configuration will apply to all feign clients.

+
+
+

If you prefer using configuration properties to configured all @FeignClient, you can create configuration properties with default feign name.

+
+
+

application.yml

+
+
+
+
feign:
+  client:
+    config:
+      default:
+        connectTimeout: 5000
+        readTimeout: 5000
+        loggerLevel: basic
+
+
+
+

If we create both @Configuration bean and configuration properties, configuration properties will win. +It will override @Configuration values. But if you want to change the priority to @Configuration, +you can change feign.client.default-to-properties to false.

+
+
+ + + + + +
+
Note
+		 +If you need to use ThreadLocal bound variables in your RequestInterceptor`s you will need to either set the +thread isolation strategy for Hystrix to `SEMAPHORE or disable Hystrix in Feign. +
+
+
+

application.yml

+
+
+
+
# To disable Hystrix in Feign
+feign:
+  hystrix:
+    enabled: false
+
+# To set thread isolation to SEMAPHORE
+hystrix:
+  command:
+    default:
+      execution:
+        isolation:
+          strategy: SEMAPHORE
+
+
+
+
+

Creating Feign Clients Manually

+
+

In some cases it might be necessary to customize your Feign Clients in a way that is not +possible using the methods above. In this case you can create Clients using the +Feign Builder API. Below is an example +which creates two Feign Clients with the same interface but configures each one with +a separate request interceptor.

+
+
+
+
@Import(FeignClientsConfiguration.class)
+class FooController {
+
+	private FooClient fooClient;
+
+	private FooClient adminClient;
+
+    @Autowired
+	public FooController(
+			Decoder decoder, Encoder encoder, Client client) {
+		this.fooClient = Feign.builder().client(client)
+				.encoder(encoder)
+				.decoder(decoder)
+				.requestInterceptor(new BasicAuthRequestInterceptor("user", "user"))
+				.target(FooClient.class, "http://PROD-SVC");
+		this.adminClient = Feign.builder().client(client)
+				.encoder(encoder)
+				.decoder(decoder)
+				.requestInterceptor(new BasicAuthRequestInterceptor("admin", "admin"))
+				.target(FooClient.class, "http://PROD-SVC");
+    }
+}
+
+
+
+ + + + + +
+
Note
+		 +In the above example FeignClientsConfiguration.class is the default configuration +provided by Spring Cloud Netflix. +
+
+
+ + + + + +
+
Note
+		 +PROD-SVC is the name of the service the Clients will be making requests to. +
+
+
+
+

Feign Hystrix Support

+
+

If Hystrix is on the classpath and feign.hystrix.enabled=true, Feign will wrap all methods with a circuit breaker. Returning a com.netflix.hystrix.HystrixCommand is also available. This lets you use reactive patterns (with a call to .toObservable() or .observe() or asynchronous use (with a call to .queue()).

+
+
+

To disable Hystrix support on a per-client basis create a vanilla Feign.Builder with the "prototype" scope, e.g.:

+
+
+
+
@Configuration
+public class FooConfiguration {
+    @Bean
+	@Scope("prototype")
+	public Feign.Builder feignBuilder() {
+		return Feign.builder();
+	}
+}
+
+
+
+ + + + + +
+
Warning
+		 +Prior to the Spring Cloud Dalston release, if Hystrix was on the classpath Feign would have wrapped +all methods in a circuit breaker by default. This default behavior was changed in Spring Cloud Dalston in +favor for an opt-in approach. +
+
+
+
+

Feign Hystrix Fallbacks

+
+

Hystrix supports the notion of a fallback: a default code path that is executed when they circuit is open or there is an error. To enable fallbacks for a given @FeignClient set the fallback attribute to the class name that implements the fallback. You also need to declare your implementation as a Spring bean.

+
+
+
+
@FeignClient(name = "hello", fallback = HystrixClientFallback.class)
+protected interface HystrixClient {
+    @RequestMapping(method = RequestMethod.GET, value = "/hello")
+    Hello iFailSometimes();
+}
+
+static class HystrixClientFallback implements HystrixClient {
+    @Override
+    public Hello iFailSometimes() {
+        return new Hello("fallback");
+    }
+}
+
+
+
+

If one needs access to the cause that made the fallback trigger, one can use the fallbackFactory attribute inside @FeignClient.

+
+
+
+
@FeignClient(name = "hello", fallbackFactory = HystrixClientFallbackFactory.class)
+protected interface HystrixClient {
+	@RequestMapping(method = RequestMethod.GET, value = "/hello")
+	Hello iFailSometimes();
+}
+
+@Component
+static class HystrixClientFallbackFactory implements FallbackFactory<HystrixClient> {
+	@Override
+	public HystrixClient create(Throwable cause) {
+		return new HystrixClientWithFallBackFactory() {
+			@Override
+			public Hello iFailSometimes() {
+				return new Hello("fallback; reason was: " + cause.getMessage());
+			}
+		};
+	}
+}
+
+
+
+ + + + + +
+
Warning
+		 +There is a limitation with the implementation of fallbacks in Feign and how Hystrix fallbacks work. Fallbacks are currently not supported for methods that return com.netflix.hystrix.HystrixCommand and rx.Observable. +
+
+
+
+

Feign and @Primary

+
+

When using Feign with Hystrix fallbacks, there are multiple beans in the ApplicationContext of the same type. This will cause @Autowired to not work because there isn’t exactly one bean, or one marked as primary. To work around this, Spring Cloud Netflix marks all Feign instances as @Primary, so Spring Framework will know which bean to inject. In some cases, this may not be desirable. To turn off this behavior set the primary attribute of @FeignClient to false.

+
+
+
+
@FeignClient(name = "hello", primary = false)
+public interface HelloClient {
+	// methods here
+}
+
+
+
+
+

Feign Inheritance Support

+
+

Feign supports boilerplate apis via single-inheritance interfaces. +This allows grouping common operations into convenient base interfaces.

+
+
+
UserService.java
+
+
public interface UserService {
+
+    @RequestMapping(method = RequestMethod.GET, value ="/users/{id}")
+    User getUser(@PathVariable("id") long id);
+}
+
+
+
+
UserResource.java
+
+
@RestController
+public class UserResource implements UserService {
+
+}
+
+
+
+
UserClient.java
+
+
package project.user;
+
+@FeignClient("users")
+public interface UserClient extends UserService {
+
+}
+
+
+
+ + + + + +
+
Note
+		 +It is generally not advisable to share an interface between a +server and a client. It introduces tight coupling, and also actually +doesn’t work with Spring MVC in its current form (method parameter +mapping is not inherited). +
+
+
+
+

Feign request/response compression

+
+

You may consider enabling the request or response GZIP compression for your +Feign requests. You can do this by enabling one of the properties:

+
+
+
+
feign.compression.request.enabled=true
+feign.compression.response.enabled=true
+
+
+
+

Feign request compression gives you settings similar to what you may set for your web server:

+
+
+
+
feign.compression.request.enabled=true
+feign.compression.request.mime-types=text/xml,application/xml,application/json
+feign.compression.request.min-request-size=2048
+
+
+
+

These properties allow you to be selective about the compressed media types and minimum request threshold length.

+
+
+
+

Feign logging

+
+

A logger is created for each Feign client created. By default the name of the logger is the full class name of the interface used to create the Feign client. Feign logging only responds to the DEBUG level.

+
+
+
application.yml
+
+
logging.level.project.user.UserClient: DEBUG
+
+
+
+

The Logger.Level object that you may configure per client, tells Feign how much to log. Choices are:

+
+
+
    +
  • +

    NONE, No logging (DEFAULT).

    +
    • +
  • +

    BASIC, Log only the request method and URL and the response status code and execution time.

    +
    • +
  • +

    HEADERS, Log the basic information along with request and response headers.

    +
    • +
  • +

    FULL, Log the headers, body, and metadata for both requests and responses.

    +
    • +
+
+
+

For example, the following would set the Logger.Level to FULL:

+
+
+
+
@Configuration
+public class FooConfiguration {
+    @Bean
+    Logger.Level feignLoggerLevel() {
+        return Logger.Level.FULL;
+    }
+}
+
+
+
+
+
+
+

External Configuration: Archaius

+
+
+

Archaius is the Netflix client side configuration library. It is the library used by all of the Netflix OSS components for configuration. Archaius is an extension of the Apache Commons Configuration project. It allows updates to configuration by either polling a source for changes or for a source to push changes to the client. Archaius uses Dynamic<Type>Property classes as handles to properties.

+
+
+
Archaius Example
+
+
class ArchaiusTest {
+    DynamicStringProperty myprop = DynamicPropertyFactory
+            .getInstance()
+            .getStringProperty("my.prop");
+
+    void doSomething() {
+        OtherClass.someMethod(myprop.get());
+    }
+}
+
+
+
+

Archaius has its own set of configuration files and loading priorities. Spring applications should generally not use Archaius directly, but the need to configure the Netflix tools natively remains. Spring Cloud has a Spring Environment Bridge so Archaius can read properties from the Spring Environment. This allows Spring Boot projects to use the normal configuration toolchain, while allowing them to configure the Netflix tools, for the most part, as documented.

+
+
+
+
+

Router and Filter: Zuul

+
+
+

Routing in an integral part of a microservice architecture. For example, / may be mapped to your web application, /api/users is mapped to the user service and /api/shop is mapped to the shop service. Zuul is a JVM based router and server side load balancer by Netflix.

+
+
+

Netflix uses Zuul for the following:

+
+
+
    +
  • +

    Authentication

    +
    • +
  • +

    Insights

    +
    • +
  • +

    Stress Testing

    +
    • +
  • +

    Canary Testing

    +
    • +
  • +

    Dynamic Routing

    +
    • +
  • +

    Service Migration

    +
    • +
  • +

    Load Shedding

    +
    • +
  • +

    Security

    +
    • +
  • +

    Static Response handling

    +
    • +
  • +

    Active/Active traffic management

    +
    • +
+
+
+

Zuul’s rule engine allows rules and filters to be written in essentially any JVM language, with built in support for Java and Groovy.

+
+
+ + + + + +
+
Note
+		 +The configuration property zuul.max.host.connections has been replaced by two new properties, zuul.host.maxTotalConnections and zuul.host.maxPerRouteConnections which default to 200 and 20 respectively. +
+
+
+ + + + + +
+
Note
+		 +Default Hystrix isolation pattern (ExecutionIsolationStrategy) for all routes is SEMAPHORE. zuul.ribbonIsolationStrategy can be changed to THREAD if this isolation pattern is preferred. +
+
+
+

How to Include Zuul

+
+

To include Zuul in your project use the starter with group org.springframework.cloud +and artifact id spring-cloud-starter-netflix-zuul. See the Spring Cloud Project page +for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+
+

Embedded Zuul Reverse Proxy

+
+

Spring Cloud has created an embedded Zuul proxy to ease the +development of a very common use case where a UI application wants to +proxy calls to one or more back end services. This feature is useful +for a user interface to proxy to the backend services it requires, +avoiding the need to manage CORS and authentication concerns +independently for all the backends.

+
+
+

To enable it, annotate a Spring Boot main class with +@EnableZuulProxy, and this forwards local calls to the appropriate +service. By convention, a service with the ID "users", will +receive requests from the proxy located at /users (with the prefix +stripped). The proxy uses Ribbon to locate an instance to forward to +via discovery, and all requests are executed in a +hystrix command, so +failures will show up in Hystrix metrics, and once the circuit is open +the proxy will not try to contact the service.

+
+
+ + + + + +
+
Note
+		 +the Zuul starter does not include a discovery client, so for +routes based on service IDs you need to provide one of those +on the classpath as well (e.g. Eureka is one choice). +
+
+
+

To skip having a service automatically added, set +zuul.ignored-services to a list of service id patterns. If a service +matches a pattern that is ignored, but also included in the explicitly +configured routes map, then it will be unignored. Example:

+
+
+
application.yml
+
+
 zuul:
+  ignoredServices: '*'
+  routes:
+    users: /myusers/**
+
+
+
+

In this example, all services are ignored except "users".

+
+
+

To augment or change +the proxy routes, you can add external configuration like the +following:

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    users: /myusers/**
+
+
+
+

This means that http calls to "/myusers" get forwarded to the "users" +service (for example "/myusers/101" is forwarded to "/101").

+
+
+

To get more fine-grained control over a route you can specify the path +and the serviceId independently:

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    users:
+      path: /myusers/**
+      serviceId: users_service
+
+
+
+

This means that http calls to "/myusers" get forwarded to the +"users_service" service. The route has to have a "path" which can be +specified as an ant-style pattern, so "/myusers/*" only matches one +level, but "/myusers/**" matches hierarchically.

+
+
+

The location of the backend can be specified as either a "serviceId" +(for a service from discovery) or a "url" (for a physical location), e.g.

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    users:
+      path: /myusers/**
+      url: http://example.com/users_service
+
+
+
+

These simple url-routes don’t get executed as a HystrixCommand nor can you loadbalance multiple URLs with Ribbon. +To achieve this, specify a service-route and configure a Ribbon client for the +serviceId (this currently requires disabling Eureka support in Ribbon: +see above for more information), e.g.

+
+
+
application.yml
+
+
zuul:
+  routes:
+    users:
+      path: /myusers/**
+      serviceId: users
+
+ribbon:
+  eureka:
+    enabled: false
+
+users:
+  ribbon:
+    listOfServers: example.com,google.com
+
+
+
+

You can provide convention between serviceId and routes using +regexmapper. It uses regular expression named groups to extract +variables from serviceId and inject them into a route pattern.

+
+
+
ApplicationConfiguration.java
+
+
@Bean
+public PatternServiceRouteMapper serviceRouteMapper() {
+    return new PatternServiceRouteMapper(
+        "(?<name>^.+)-(?<version>v.+$)",
+        "${version}/${name}");
+}
+
+
+
+

This means that a serviceId "myusers-v1" will be mapped to route +"/v1/myusers/**". Any regular expression is accepted but all named +groups must be present in both servicePattern and routePattern. If +servicePattern does not match a serviceId, the default behavior is +used. In the example above, a serviceId "myusers" will be mapped to route +"/myusers/**" (no version detected) This feature is disable by +default and only applies to discovered services.

+
+
+

To add a prefix to all mappings, set zuul.prefix to a value, such as +/api. The proxy prefix is stripped from the request before the +request is forwarded by default (switch this behaviour off with +zuul.stripPrefix=false). You can also switch off the stripping of +the service-specific prefix from individual routes, e.g.

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    users:
+      path: /myusers/**
+      stripPrefix: false
+
+
+
+ + + + + +
+
Note
+		 +zuul.stripPrefix only applies to the prefix set in zuul.prefix. It does not have any effect on prefixes +defined within a given route’s path. +
+
+
+

In this example, requests to "/myusers/101" will be forwarded to "/myusers/101" on the "users" service.

+
+
+

The zuul.routes entries actually bind to an object of type ZuulProperties. If you +look at the properties of that object you will see that it also has a "retryable" flag. +Set that flag to "true" to have the Ribbon client automatically retry failed requests +(and if you need to you can modify the parameters of the retry operations using +the Ribbon client configuration).

+
+
+

The X-Forwarded-Host header is added to the forwarded requests by +default. To turn it off set zuul.addProxyHeaders = false. The +prefix path is stripped by default, and the request to the backend +picks up a header "X-Forwarded-Prefix" ("/myusers" in the examples +above).

+
+
+

An application with @EnableZuulProxy could act as a standalone +server if you set a default route ("/"), for example zuul.route.home: +/ would route all traffic (i.e. "/**") to the "home" service.

+
+
+

If more fine-grained ignoring is needed, you can specify specific patterns to ignore. +These patterns are evaluated at the start of the route location process, which +means prefixes should be included in the pattern to warrant a match. Ignored patterns +span all services and supersede any other route specification.

+
+
+
application.yml
+
+
 zuul:
+  ignoredPatterns: /**/admin/**
+  routes:
+    users: /myusers/**
+
+
+
+

This means that all calls such as "/myusers/101" will be forwarded to "/101" on the "users" service. +But calls including "/admin/" will not resolve.

+
+
+ + + + + +
+
Warning
+		 +If you need your routes to have their order preserved you need to use a YAML +file as the ordering will be lost using a properties file. For example: +
+
+
+
application.yml
+
+
 zuul:
+  routes:
+    users:
+      path: /myusers/**
+    legacy:
+      path: /**
+
+
+
+

If you were to use a properties file, the legacy path may end up in front of the users +path rendering the users path unreachable.

+
+
+
+

Zuul Http Client

+
+

The default HTTP client used by zuul is now backed by the Apache HTTP Client instead of the +deprecated Ribbon RestClient. To use RestClient or to use the okhttp3.OkHttpClient set +ribbon.restclient.enabled=true or ribbon.okhttp.enabled=true respectively. If you would +like to customize the Apache HTTP client or the OK HTTP client provide a bean of type +ClosableHttpClient or OkHttpClient.

+
+
+
+

Cookies and Sensitive Headers

+
+

It’s OK to share headers between services in the same system, but you +probably don’t want sensitive headers leaking downstream into external +servers. You can specify a list of ignored headers as part of the +route configuration. Cookies play a special role because they have +well-defined semantics in browsers, and they are always to be treated +as sensitive. If the consumer of your proxy is a browser, then cookies +for downstream services also cause problems for the user because they +all get jumbled up (all downstream services look like they come from +the same place).

+
+
+

If you are careful with the design of your services, for example if +only one of the downstream services sets cookies, then you might be +able to let them flow from the backend all the way up to the +caller. Also, if your proxy sets cookies and all your back end +services are part of the same system, it can be natural to simply +share them (and for instance use Spring Session to link them up to some +shared state). Other than that, any cookies that get set by downstream +services are likely to be not very useful to the caller, so it is +recommended that you make (at least) "Set-Cookie" and "Cookie" into +sensitive headers for routes that are not part of your domain. Even +for routes that are part of your domain, try to think carefully +about what it means before allowing cookies to flow between them and +the proxy.

+
+
+

The sensitive headers can be configured as a comma-separated list per +route, e.g.

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    users:
+      path: /myusers/**
+      sensitiveHeaders: Cookie,Set-Cookie,Authorization
+      url: https://downstream
+
+
+
+ + + + + +
+
Note
+		 +this is the default value for sensitiveHeaders, so you don’t +need to set it unless you want it to be different. N.B. this is new in +Spring Cloud Netflix 1.1 (in 1.0 the user had no control over headers +and all cookies flow in both directions). +
+
+
+

The sensitiveHeaders are a blacklist and the default is not empty, +so to make Zuul send all headers (except the "ignored" ones) you would +have to explicitly set it to the empty list. This is necessary if you +want to pass cookie or authorization headers to your back end. Example:

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    users:
+      path: /myusers/**
+      sensitiveHeaders:
+      url: https://downstream
+
+
+
+

Sensitive headers can also be set globally by setting zuul.sensitiveHeaders. If sensitiveHeaders is set on a route, this will override the global sensitiveHeaders setting.

+
+
+
+

Ignored Headers

+
+

In addition to the per-route sensitive headers, you can set a global +value for zuul.ignoredHeaders for values that should be discarded +(both request and response) during interactions with downstream +services. By default these are empty, if Spring Security is not on the +classpath, and otherwise they are initialized to a set of well-known +"security" headers (e.g. involving caching) as specified by Spring +Security. The assumption in this case is that the downstream services +might add these headers too, and we want the values from the proxy. +To not discard these well known security headers in case Spring Security is on the classpath you can set zuul.ignoreSecurityHeaders to false. This can be useful if you disabled the HTTP Security response headers in Spring Security and want the values provided by downstream services

+
+
+
+

The Routes Endpoint

+
+

If you are using @EnableZuulProxy with tha Spring Boot Actuator you +will enable (by default) an additional endpoint, available via HTTP as +/routes. A GET to this endpoint will return a list of the mapped +routes:

+
+
+
GET /routes
+
+
{
+  /stores/**: "http://localhost:8081"
+}
+
+
+
+

Additional route details can be requested by adding the ?format=details query +string to /routes. This will produce the following output:

+
+
+
GET /routes?format=details
+
+
{
+  "/stores/**": {
+    "id": "stores",
+    "fullPath": "/stores/**",
+    "location": "http://localhost:8081",
+    "path": "/**",
+    "prefix": "/stores",
+    "retryable": false,
+    "customSensitiveHeaders": false,
+    "prefixStripped": true
+  }
+}
+
+
+
+

A POST will force a refresh of the existing routes (e.g. in +case there have been changes in the service catalog). You can disable +this endpoint by setting endpoints.routes.enabled to false.

+
+
+ + + + + +
+
Note
+		 +the routes should respond automatically to changes in the +service catalog, but the POST to /routes is a way to force the change +to happen immediately. +
+
+
+
+

Strangulation Patterns and Local Forwards

+
+

A common pattern when migrating an existing application or API is to +"strangle" old endpoints, slowly replacing them with different +implementations. The Zuul proxy is a useful tool for this because you +can use it to handle all traffic from clients of the old endpoints, +but redirect some of the requests to new ones.

+
+
+

Example configuration:

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    first:
+      path: /first/**
+      url: http://first.example.com
+    second:
+      path: /second/**
+      url: forward:/second
+    third:
+      path: /third/**
+      url: forward:/3rd
+    legacy:
+      path: /**
+      url: http://legacy.example.com
+
+
+
+

In this example we are strangling the "legacy" app which is mapped to +all requests that do not match one of the other patterns. Paths in +/first/** have been extracted into a new service with an external +URL. And paths in /second/** are forwarded so they can be handled +locally, e.g. with a normal Spring @RequestMapping. Paths in +/third/** are also forwarded, but with a different prefix +(i.e. /third/foo is forwarded to /3rd/foo).

+
+
+ + + + + +
+
Note
+		 +The ignored patterns aren’t completely ignored, they just +aren’t handled by the proxy (so they are also effectively forwarded +locally). +
+
+
+
+

Uploading Files through Zuul

+
+

If you @EnableZuulProxy you can use the proxy paths to +upload files and it should just work as long as the files +are small. For large files there is an alternative path +which bypasses the Spring DispatcherServlet (to +avoid multipart processing) in "/zuul/*". I.e. if +zuul.routes.customers=/customers/** then you can +POST large files to "/zuul/customers/*". The servlet +path is externalized via zuul.servletPath. Extremely +large files will also require elevated timeout settings +if the proxy route takes you through a Ribbon load +balancer, e.g.

+
+
+
application.yml
+
+
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 60000
+ribbon:
+  ConnectTimeout: 3000
+  ReadTimeout: 60000
+
+
+
+

Note that for streaming to work with large files, you need to use chunked encoding in the request (which some browsers +do not do by default). E.g. on the command line:

+
+
+
+
$ curl -v -H "Transfer-Encoding: chunked" \
+    -F "file=@mylarge.iso" localhost:9999/zuul/simple/file
+
+
+
+
+

Query String Encoding

+
+

When processing the incoming request, query params are decoded so they can be available for possible modifications in +Zuul filters. They are then re-encoded when building the backend request in the route filters. The result +can be different than the original input if it was encoded using Javascript’s encodeURIComponent() method for example. +While this causes no issues in most cases, some web servers can be picky with the encoding of complex query string.

+
+
+

To force the original encoding of the query string, it is possible to pass a special flag to ZuulProperties so +that the query string is taken as is with the HttpServletRequest::getQueryString method :

+
+
+
application.yml
+
+
 zuul:
+  forceOriginalQueryStringEncoding: true
+
+
+
+

Note: This special flag only works with SimpleHostRoutingFilter and you loose the ability to easily override +query parameters with RequestContext.getCurrentContext().setRequestQueryParams(someOverriddenParameters) since +the query string is now fetched directly on the original HttpServletRequest.

+
+
+
+

Plain Embedded Zuul

+
+

You can also run a Zuul server without the proxying, or switch on parts of the proxying platform selectively, if you +use @EnableZuulServer (instead of @EnableZuulProxy). Any beans that you add to the application of type ZuulFilter +will be installed automatically, as they are with @EnableZuulProxy, but without any of the proxy filters being added +automatically.

+
+
+

In this case the routes into the Zuul server are still specified by +configuring "zuul.routes.*", but there is no service +discovery and no proxying, so the "serviceId" and "url" settings are +ignored. For example:

+
+
+
application.yml
+
+
 zuul:
+  routes:
+    api: /api/**
+
+
+
+

maps all paths in "/api/**" to the Zuul filter chain.

+
+
+
+

Disable Zuul Filters

+
+

Zuul for Spring Cloud comes with a number of ZuulFilter beans enabled by default +in both proxy and server mode. See the zuul filters package for the +possible filters that are enabled. If you want to disable one, simply set +zuul.<SimpleClassName>.<filterType>.disable=true. By convention, the package after +filters is the Zuul filter type. For example to disable +org.springframework.cloud.netflix.zuul.filters.post.SendResponseFilter set +zuul.SendResponseFilter.post.disable=true.

+
+
+
+

Providing Hystrix Fallbacks For Routes

+
+

When a circuit for a given route in Zuul is tripped you can provide a fallback response +by creating a bean of type ZuulFallbackProvider. Within this bean you need to specify +the route ID the fallback is for and provide a ClientHttpResponse to return +as a fallback. Here is a very simple ZuulFallbackProvider implementation.

+
+
+
+
class MyFallbackProvider implements ZuulFallbackProvider {
+    @Override
+    public String getRoute() {
+        return "customers";
+    }
+
+    @Override
+    public ClientHttpResponse fallbackResponse() {
+        return new ClientHttpResponse() {
+            @Override
+            public HttpStatus getStatusCode() throws IOException {
+                return HttpStatus.OK;
+            }
+
+            @Override
+            public int getRawStatusCode() throws IOException {
+                return 200;
+            }
+
+            @Override
+            public String getStatusText() throws IOException {
+                return "OK";
+            }
+
+            @Override
+            public void close() {
+
+            }
+
+            @Override
+            public InputStream getBody() throws IOException {
+                return new ByteArrayInputStream("fallback".getBytes());
+            }
+
+            @Override
+            public HttpHeaders getHeaders() {
+                HttpHeaders headers = new HttpHeaders();
+                headers.setContentType(MediaType.APPLICATION_JSON);
+                return headers;
+            }
+        };
+    }
+}
+
+
+
+

And here is what the route configuration would look like.

+
+
+
+
zuul:
+  routes:
+    customers: /customers/**
+
+
+
+

If you would like to provide a default fallback for all routes than you can create a bean of +type ZuulFallbackProvider and have the getRoute method return * or null.

+
+
+
+
class MyFallbackProvider implements ZuulFallbackProvider {
+    @Override
+    public String getRoute() {
+        return "*";
+    }
+
+    @Override
+    public ClientHttpResponse fallbackResponse() {
+        return new ClientHttpResponse() {
+            @Override
+            public HttpStatus getStatusCode() throws IOException {
+                return HttpStatus.OK;
+            }
+
+            @Override
+            public int getRawStatusCode() throws IOException {
+                return 200;
+            }
+
+            @Override
+            public String getStatusText() throws IOException {
+                return "OK";
+            }
+
+            @Override
+            public void close() {
+
+            }
+
+            @Override
+            public InputStream getBody() throws IOException {
+                return new ByteArrayInputStream("fallback".getBytes());
+            }
+
+            @Override
+            public HttpHeaders getHeaders() {
+                HttpHeaders headers = new HttpHeaders();
+                headers.setContentType(MediaType.APPLICATION_JSON);
+                return headers;
+            }
+        };
+    }
+}
+
+
+
+
+

Rewriting Location header

+
+

If Zuul is fronting a web application then there may be a need to re-write the Location header when the web application redirects through a http status code of 3XX, otherwise the browser will end up redirecting to the web application’s url instead of the Zuul url. +A LocationRewriteFilter Zuul filter can be configured to re-write the Location header to the Zuul’s url, it also adds back the stripped global and route specific prefixes. The filter can be added the following way via a Spring Configuration file:

+
+
+
+
import org.springframework.cloud.netflix.zuul.filters.post.LocationRewriteFilter;
+...
+
+@Configuration
+@EnableZuulProxy
+public class ZuulConfig {
+    @Bean
+    public LocationRewriteFilter locationRewriteFilter() {
+        return new LocationRewriteFilter();
+    }
+}
+
+
+
+ + + + + +
+
Warning
+		 +
+

Use this filter with caution though, the filter acts on the Location header of ALL 3XX response codes which may not be appropriate in all scenarios, say if the user is redirecting to an external URL.

+
+
+
+
+
+

Zuul Developer Guide

+
+

For a general overview of how Zuul works, please see the Zuul Wiki.

+
+
+

The Zuul Servlet

+
+

Zuul is implemented as a Servlet. For the general cases, Zuul is embedded into the Spring Dispatch mechanism. This allows Spring MVC to be in control of the routing. In this case, Zuul is configured to buffer requests. If there is a need to go through Zuul without buffering requests (e.g. for large file uploads), the Servlet is also installed outside of the Spring Dispatcher. By default, this is located at /zuul. This path can be changed with the zuul.servlet-path property.

+
+
+
+

Zuul RequestContext

+
+

To pass information between filters, Zuul uses a RequestContext. Its data is held in a ThreadLocal specific to each request. Information about where to route requests, errors and the actual HttpServletRequest and HttpServletResponse are stored there. The RequestContext extends ConcurrentHashMap, so anything can be stored in the context. FilterConstants contains the keys that are used by the filters installed by Spring Cloud Netflix (more on these later).

+
+
+
+

@EnableZuulProxy vs. @EnableZuulServer

+
+

Spring Cloud Netflix installs a number of filters based on which annotation was used to enable Zuul. @EnableZuulProxy is a superset of @EnableZuulServer. In other words, @EnableZuulProxy contains all filters installed by @EnableZuulServer. The additional filters in the "proxy" enable routing functionality. If you want a "blank" Zuul, you should use @EnableZuulServer.

+
+
+
+

@EnableZuulServer Filters

+
+

Creates a SimpleRouteLocator that loads route definitions from Spring Boot configuration files.

+
+
+

The following filters are installed (as normal Spring Beans):

+
+
+

Pre filters:

+
+
+
    +
  • +

    ServletDetectionFilter: Detects if the request is through the Spring Dispatcher. Sets boolean with key FilterConstants.IS_DISPATCHER_SERVLET_REQUEST_KEY.

    +
    • +
  • +

    FormBodyWrapperFilter: Parses form data and reencodes it for downstream requests.

    +
    • +
  • +

    DebugFilter: if the debug request parameter is set, this filter sets RequestContext.setDebugRouting() and RequestContext.setDebugRequest() to true.

    +
    • +
+
+
+

Route filters:

+
+
+
    +
  • +

    SendForwardFilter: This filter forwards requests using the Servlet RequestDispatcher. The forwarding location is stored in the RequestContext attribute FilterConstants.FORWARD_TO_KEY. This is useful for forwarding to endpoints in the current application.

    +
    • +
+
+
+

Post filters:

+
+
+
    +
  • +

    SendResponseFilter: Writes responses from proxied requests to the current response.

    +
    • +
+
+
+

Error filters:

+
+
+
    +
  • +

    SendErrorFilter: Forwards to /error (by default) if RequestContext.getThrowable() is not null. The default forwarding path (/error) can be changed by setting the error.path property.

    +
    • +
+
+
+
+

@EnableZuulProxy Filters

+
+

Creates a DiscoveryClientRouteLocator that loads route definitions from a DiscoveryClient (like Eureka), as well as from properties. A route is created for each serviceId from the DiscoveryClient. As new services are added, the routes will be refreshed.

+
+
+

In addition to the filters described above, the following filters are installed (as normal Spring Beans):

+
+
+

Pre filters:

+
+
+
    +
  • +

    PreDecorationFilter: This filter determines where and how to route based on the supplied RouteLocator. It also sets various proxy-related headers for downstream requests.

    +
    • +
+
+
+

Route filters:

+
+
+
    +
  • +

    RibbonRoutingFilter: This filter uses Ribbon, Hystrix and pluggable HTTP clients to send requests. Service ids are found in the RequestContext attribute FilterConstants.SERVICE_ID_KEY. This filter can use different HTTP clients. They are:

    +
    +
      +
    • +

      Apache HttpClient. This is the default client.

      +
      • +
    • +

      Squareup OkHttpClient v3. This is enabled by having the com.squareup.okhttp3:okhttp library on the classpath and setting ribbon.okhttp.enabled=true.

      +
      • +
    • +

      Netflix Ribbon HTTP client. This is enabled by setting ribbon.restclient.enabled=true. This client has limitations, such as it doesn’t support the PATCH method, but also has built-in retry.

      +
      • +
    +
    +
    • +
  • +

    SimpleHostRoutingFilter: This filter sends requests to predetermined URLs via an Apache HttpClient. URLs are found in RequestContext.getRouteHost().

    +
    • +
+
+
+
+

Custom Zuul Filter examples

+
+

Most of the following "How to Write" examples below are included Sample Zuul Filters project. There are also examples of manipulating the request or response body in that repository.

+
+
+
+

How to Write a Pre Filter

+
+

Pre filters are used to set up data in the RequestContext for use in filters downstream. The main use case is to set information required for route filters.

+
+
+
+
public class QueryParamPreFilter extends ZuulFilter {
+	@Override
+	public int filterOrder() {
+		return PRE_DECORATION_FILTER_ORDER - 1; // run before PreDecoration
+	}
+
+	@Override
+	public String filterType() {
+		return PRE_TYPE;
+	}
+
+	@Override
+	public boolean shouldFilter() {
+		RequestContext ctx = RequestContext.getCurrentContext();
+		return !ctx.containsKey(FORWARD_TO_KEY) // a filter has already forwarded
+				&& !ctx.containsKey(SERVICE_ID_KEY); // a filter has already determined serviceId
+	}
+    @Override
+    public Object run() {
+        RequestContext ctx = RequestContext.getCurrentContext();
+		HttpServletRequest request = ctx.getRequest();
+		if (request.getParameter("foo") != null) {
+		    // put the serviceId in `RequestContext`
+    		ctx.put(SERVICE_ID_KEY, request.getParameter("foo"));
+    	}
+        return null;
+    }
+}
+
+
+
+

The filter above populates SERVICE_ID_KEY from the foo request parameter. In reality, it’s not a good idea to do that kind of direct mapping, but the service id should be looked up from the value of foo instead.

+
+
+

Now that SERVICE_ID_KEY is populated, PreDecorationFilter won’t run and RibbonRoutingFilter will. If you wanted to route to a full URL instead, call ctx.setRouteHost(url) instead.

+
+
+

To modify the path that routing filters will forward to, set the REQUEST_URI_KEY.

+
+
+
+

How to Write a Route Filter

+
+

Route filters are run after pre filters and are used to make requests to other services. Much of the work here is to translate request and response data to and from the client required model.

+
+
+
+
public class OkHttpRoutingFilter extends ZuulFilter {
+	@Autowired
+	private ProxyRequestHelper helper;
+
+	@Override
+	public String filterType() {
+		return ROUTE_TYPE;
+	}
+
+	@Override
+	public int filterOrder() {
+		return SIMPLE_HOST_ROUTING_FILTER_ORDER - 1;
+	}
+
+	@Override
+	public boolean shouldFilter() {
+		return RequestContext.getCurrentContext().getRouteHost() != null
+				&& RequestContext.getCurrentContext().sendZuulResponse();
+	}
+
+    @Override
+    public Object run() {
+		OkHttpClient httpClient = new OkHttpClient.Builder()
+				// customize
+				.build();
+
+		RequestContext context = RequestContext.getCurrentContext();
+		HttpServletRequest request = context.getRequest();
+
+		String method = request.getMethod();
+
+		String uri = this.helper.buildZuulRequestURI(request);
+
+		Headers.Builder headers = new Headers.Builder();
+		Enumeration<String> headerNames = request.getHeaderNames();
+		while (headerNames.hasMoreElements()) {
+			String name = headerNames.nextElement();
+			Enumeration<String> values = request.getHeaders(name);
+
+			while (values.hasMoreElements()) {
+				String value = values.nextElement();
+				headers.add(name, value);
+			}
+		}
+
+		InputStream inputStream = request.getInputStream();
+
+		RequestBody requestBody = null;
+		if (inputStream != null && HttpMethod.permitsRequestBody(method)) {
+			MediaType mediaType = null;
+			if (headers.get("Content-Type") != null) {
+				mediaType = MediaType.parse(headers.get("Content-Type"));
+			}
+			requestBody = RequestBody.create(mediaType, StreamUtils.copyToByteArray(inputStream));
+		}
+
+		Request.Builder builder = new Request.Builder()
+				.headers(headers.build())
+				.url(uri)
+				.method(method, requestBody);
+
+		Response response = httpClient.newCall(builder.build()).execute();
+
+		LinkedMultiValueMap<String, String> responseHeaders = new LinkedMultiValueMap<>();
+
+		for (Map.Entry<String, List<String>> entry : response.headers().toMultimap().entrySet()) {
+			responseHeaders.put(entry.getKey(), entry.getValue());
+		}
+
+		this.helper.setResponse(response.code(), response.body().byteStream(),
+				responseHeaders);
+		context.setRouteHost(null); // prevent SimpleHostRoutingFilter from running
+		return null;
+    }
+}
+
+
+
+

The above filter translates Servlet request information into OkHttp3 request information, executes an HTTP request, then translates OkHttp3 reponse information to the Servlet response. WARNING: this filter might have bugs and not function correctly.

+
+
+
+

How to Write a Post Filter

+
+

Post filters typically manipulate the response. In the filter below, we add a random UUID as the X-Foo header. Other manipulations, such as transforming the response body, are much more complex and compute-intensive.

+
+
+
+
public class AddResponseHeaderFilter extends ZuulFilter {
+	@Override
+	public String filterType() {
+		return POST_TYPE;
+	}
+
+	@Override
+	public int filterOrder() {
+		return SEND_RESPONSE_FILTER_ORDER - 1;
+	}
+
+	@Override
+	public boolean shouldFilter() {
+		return true;
+	}
+
+	@Override
+	public Object run() {
+		RequestContext context = RequestContext.getCurrentContext();
+    	HttpServletResponse servletResponse = context.getResponse();
+		servletResponse.addHeader("X-Foo", UUID.randomUUID().toString());
+		return null;
+	}
+}
+
+
+
+
+

How Zuul Errors Work

+
+

If an exception is thrown during any portion of the Zuul filter lifecycle, the error filters are executed. The SendErrorFilter is only run if RequestContext.getThrowable() is not null. It then sets specific javax.servlet.error.* attributes in the request and forwards the request to the Spring Boot error page.

+
+
+
+

Zuul Eager Application Context Loading

+
+

Zuul internally uses Ribbon for calling the remote url’s and Ribbon clients are by default lazily loaded up by Spring Cloud on first call. +This behavior can be changed for Zuul using the following configuration and will result in the child Ribbon related Application contexts being eagerly loaded up at application startup time.

+
+
+
application.yml
+
+
zuul:
+  ribbon:
+    eager-load:
+      enabled: true
+
+
+
+
+
+
+
+

Polyglot support with Sidecar

+
+
+

Do you have non-jvm languages you want to take advantage of Eureka, Ribbon and +Config Server? The Spring Cloud Netflix Sidecar was inspired by +Netflix Prana. It includes a simple http api +to get all of the instances (ie host and port) for a given service. You can +also proxy service calls through an embedded Zuul proxy which gets its route +entries from Eureka. The Spring Cloud Config Server can be accessed directly +via host lookup or through the Zuul Proxy. The non-jvm app should implement +a health check so the Sidecar can report to eureka if the app is up or down.

+
+
+

To include Sidecar in your project use the dependency with group org.springframework.cloud +and artifact id spring-cloud-netflix-sidecar.

+
+
+

To enable the Sidecar, create a Spring Boot application with @EnableSidecar. +This annotation includes @EnableCircuitBreaker, @EnableDiscoveryClient, +and @EnableZuulProxy. Run the resulting application on the same host as the +non-jvm application.

+
+
+

To configure the side car add sidecar.port and sidecar.health-uri to application.yml. +The sidecar.port property is the port the non-jvm app is listening on. This +is so the Sidecar can properly register the app with Eureka. The sidecar.health-uri +is a uri accessible on the non-jvm app that mimicks a Spring Boot health +indicator. It should return a json document like the following:

+
+
+
health-uri-document
+
+
{
+  "status":"UP"
+}
+
+
+
+

Here is an example application.yml for a Sidecar application:

+
+
+
application.yml
+
+
server:
+  port: 5678
+spring:
+  application:
+    name: sidecar
+
+sidecar:
+  port: 8000
+  health-uri: http://localhost:8000/health.json
+
+
+
+

The api for the DiscoveryClient.getInstances() method is /hosts/{serviceId}. +Here is an example response for /hosts/customers that returns two instances on +different hosts. This api is accessible to the non-jvm app (if the sidecar is +on port 5678) at http://localhost:5678/hosts/{serviceId}.

+
+
+
/hosts/customers
+
+
[
+    {
+        "host": "myhost",
+        "port": 9000,
+        "uri": "http://myhost:9000",
+        "serviceId": "CUSTOMERS",
+        "secure": false
+    },
+    {
+        "host": "myhost2",
+        "port": 9000,
+        "uri": "http://myhost2:9000",
+        "serviceId": "CUSTOMERS",
+        "secure": false
+    }
+]
+
+
+
+

The Zuul proxy automatically adds routes for each service known in eureka to +/<serviceId>, so the customers service is available at /customers. The +Non-jvm app can access the customer service via http://localhost:5678/customers +(assuming the sidecar is listening on port 5678).

+
+
+

If the Config Server is registered with Eureka, non-jvm application can access +it via the Zuul proxy. If the serviceId of the ConfigServer is configserver +and the Sidecar is on port 5678, then it can be accessed at +http://localhost:5678/configserver

+
+
+

Non-jvm app can take advantage of the Config Server’s ability to return YAML +documents. For example, a call to http://sidecar.local.spring.io:5678/configserver/default-master.yml +might result in a YAML document like the following

+
+
+
+
eureka:
+  client:
+    serviceUrl:
+      defaultZone: http://localhost:8761/eureka/
+  password: password
+info:
+  description: Spring Cloud Samples
+  url: https://github.com/spring-cloud-samples
+
+
+
+
+
+

RxJava with Spring MVC

+
+
+

Spring Cloud Netflix includes RxJava.

+
+
+
+
+

RxJava is a Java VM implementation of Reactive Extensions: a library for composing asynchronous and event-based programs by using observable sequences.

+
+
+
+
+

Spring Cloud Netflix provides support for returning rx.Single objects from Spring MVC Controllers. It also supports using rx.Observable objects for Server-sent events (SSE). This can be very convenient if your internal APIs are already built using RxJava (see Feign Hystrix Support for examples).

+
+
+

Here are some examples of using rx.Single:

+
+
+
+
@RequestMapping(method = RequestMethod.GET, value = "/single")
+public Single<String> single() {
+	return Single.just("single value");
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/singleWithResponse")
+public ResponseEntity<Single<String>> singleWithResponse() {
+	return new ResponseEntity<>(Single.just("single value"),
+			HttpStatus.NOT_FOUND);
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/singleCreatedWithResponse")
+public Single<ResponseEntity<String>> singleOuterWithResponse() {
+	return Single.just(new ResponseEntity<>("single value", HttpStatus.CREATED));
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/throw")
+public Single<Object> error() {
+	return Single.error(new RuntimeException("Unexpected"));
+}
+
+
+
+

If you have an Observable, rather than a single, you can use .toSingle() or .toList().toSingle(). Here are some examples:

+
+
+
+
@RequestMapping(method = RequestMethod.GET, value = "/single")
+public Single<String> single() {
+    return Observable.just("single value").toSingle();
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/multiple")
+public Single<List<String>> multiple() {
+    return Observable.just("multiple", "values").toList().toSingle();
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/responseWithObservable")
+public ResponseEntity<Single<String>> responseWithObservable() {
+
+    Observable<String> observable = Observable.just("single value");
+    HttpHeaders headers = new HttpHeaders();
+    headers.setContentType(APPLICATION_JSON_UTF8);
+    return new ResponseEntity<>(observable.toSingle(), headers, HttpStatus.CREATED);
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/timeout")
+public Observable<String> timeout() {
+    return Observable.timer(1, TimeUnit.MINUTES).map(new Func1<Long, String>() {
+        @Override
+        public String call(Long aLong) {
+            return "single value";
+        }
+    });
+}
+
+
+
+

If you have a streaming endpoint and client, SSE could be an option. To convert rx.Observable to a Spring SseEmitter use RxResponse.sse(). Here are some examples:

+
+
+
+
@RequestMapping(method = RequestMethod.GET, value = "/sse")
+public SseEmitter single() {
+	return RxResponse.sse(Observable.just("single value"));
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/messages")
+public SseEmitter messages() {
+	return RxResponse.sse(Observable.just("message 1", "message 2", "message 3"));
+}
+
+@RequestMapping(method = RequestMethod.GET, value = "/events")
+public SseEmitter event() {
+	return RxResponse.sse(APPLICATION_JSON_UTF8,
+			Observable.just(new EventDto("Spring io", getDate(2016, 5, 19)),
+					new EventDto("SpringOnePlatform", getDate(2016, 8, 1))));
+}
+
+
+
+
+
+

Metrics: Spectator, Servo, and Atlas

+
+
+

When used together, Spectator/Servo and Atlas provide a near real-time operational insight platform.

+
+
+

Spectator and Servo are Netflix’s metrics collection libraries. Atlas is a Netflix metrics backend to manage dimensional time series data.

+
+
+

Servo served Netflix for several years and is still usable, but is gradually being phased out in favor of Spectator, which is only designed to work with Java 8. Spring Cloud Netflix provides support for both, but Java 8 based applications are encouraged to use Spectator.

+
+
+

Dimensional vs. Hierarchical Metrics

+
+

Spring Boot Actuator metrics are hierarchical and metrics are separated only by name. These names often follow a naming convention that embeds key/value attribute pairs (dimensions) into the name separated by periods. Consider the following metrics for two endpoints, root and star-star:

+
+
+
+
{
+    "counter.status.200.root": 20,
+    "counter.status.400.root": 3,
+    "counter.status.200.star-star": 5,
+}
+
+
+
+

The first metric gives us a normalized count of successful requests against the root endpoint per unit of time. But what if the system had 20 endpoints and you want to get a count of successful requests against all the endpoints? Some hierarchical metrics backends would allow you to specify a wild card such as counter.status.200. that would read all 20 metrics and aggregate the results. Alternatively, you could provide a HandlerInterceptorAdapter that intercepts and records a metric like counter.status.200.all for all successful requests irrespective of the endpoint, but now you must write 20+1 different metrics. Similarly if you want to know the total number of successful requests for all endpoints in the service, you could specify a wild card such as counter.status.2.*.

+
+
+

Even in the presence of wildcarding support on a hierarchical metrics backend, naming consistency can be difficult. Specifically the position of these tags in the name string can slip with time, breaking queries. For example, suppose we add an additional dimension to the hierarchical metrics above for HTTP method. Then counter.status.200.root becomes counter.status.200.method.get.root, etc. Our counter.status.200.* suddenly no longer has the same semantic meaning. Furthermore, if the new dimension is not applied uniformly across the codebase, certain queries may become impossible. This can quickly get out of hand.

+
+
+

Netflix metrics are tagged (a.k.a. dimensional). Each metric has a name, but this single named metric can contain multiple statistics and 'tag' key/value pairs that allows more querying flexibility. In fact, the statistics themselves are recorded in a special tag.

+
+
+

Recorded with Netflix Servo or Spectator, a timer for the root endpoint described above contains 4 statistics per status code, where the count statistic is identical to Spring Boot Actuator’s counter. In the event that we have encountered an HTTP 200 and 400 thus far, there will be 8 available data points:

+
+
+
+
{
+    "root(status=200,stastic=count)": 20,
+    "root(status=200,stastic=max)": 0.7265630630000001,
+    "root(status=200,stastic=totalOfSquares)": 0.04759702862580789,
+    "root(status=200,stastic=totalTime)": 0.2093076914666667,
+    "root(status=400,stastic=count)": 1,
+    "root(status=400,stastic=max)": 0,
+    "root(status=400,stastic=totalOfSquares)": 0,
+    "root(status=400,stastic=totalTime)": 0,
+}
+
+
+
+
+

Default Metrics Collection

+
+

Without any additional dependencies or configuration, a Spring Cloud based service will autoconfigure a Servo MonitorRegistry and begin collecting metrics on every Spring MVC request. By default, a Servo timer with the name rest will be recorded for each MVC request which is tagged with:

+
+
+
    +
  1. +

    HTTP method

    +
    2. +
  2. +

    HTTP status (e.g. 200, 400, 500)

    +
    3. +
  3. +

    URI (or "root" if the URI is empty), sanitized for Atlas

    +
    4. +
  4. +

    The exception class name, if the request handler threw an exception

    +
    5. +
  5. +

    The caller, if a request header with a key matching netflix.metrics.rest.callerHeader is set on the request. There is no default key for netflix.metrics.rest.callerHeader. You must add it to your application properties if you wish to collect caller information.

    +
    6. +
+
+
+

Set the netflix.metrics.rest.metricName property to change the name of the metric from rest to a name you provide.

+
+
+

If Spring AOP is enabled and org.aspectj:aspectjweaver is present on your runtime classpath, Spring Cloud will also collect metrics on every client call made with RestTemplate. A Servo timer with the name of restclient will be recorded for each MVC request which is tagged with:

+
+
+
    +
  1. +

    HTTP method

    +
    2. +
  2. +

    HTTP status (e.g. 200, 400, 500), "CLIENT_ERROR" if the response returned null, or "IO_ERROR" if an IOException occurred during the execution of the RestTemplate method

    +
    3. +
  3. +

    URI, sanitized for Atlas

    +
    4. +
  4. +

    Client name

    +
    5. +
+
+
+ + + + + +
+
Warning
+		 +Avoid using hardcoded url parameters within RestTemplate. When targeting dynamic endpoints use URL variables. This will avoid potential "GC Overhead Limit Reached" issues where ServoMonitorCache treats each url as a unique key. +
+
+
+
+
// recommended
+String orderid = "1";
+restTemplate.getForObject("http://testeurekabrixtonclient/orders/{orderid}", String.class, orderid)
+
+// avoid
+restTemplate.getForObject("http://testeurekabrixtonclient/orders/1", String.class)
+
+
+
+
+

Metrics Collection: Spectator

+
+

To enable Spectator metrics, include a dependency on spring-boot-starter-spectator:

+
+
+
+
    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-starter-netflix-spectator</artifactId>
+    </dependency>
+
+
+
+

In Spectator parlance, a meter is a named, typed, and tagged configuration and a metric represents the value of a given meter at a point in time. Spectator meters are created and controlled by a registry, which currently has several different implementations. Spectator provides 4 meter types: counter, timer, gauge, and distribution summary.

+
+
+

Spring Cloud Spectator integration configures an injectable com.netflix.spectator.api.Registry instance for you. Specifically, it configures a ServoRegistry instance in order to unify the collection of REST metrics and the exporting of metrics to the Atlas backend under a single Servo API. Practically, this means that your code may use a mixture of Servo monitors and Spectator meters and both will be scooped up by Spring Boot Actuator MetricReader instances and both will be shipped to the Atlas backend.

+
+
+

Spectator Counter

+
+

A counter is used to measure the rate at which some event is occurring.

+
+
+
+
// create a counter with a name and a set of tags
+Counter counter = registry.counter("counterName", "tagKey1", "tagValue1", ...);
+counter.increment(); // increment when an event occurs
+counter.increment(10); // increment by a discrete amount
+
+
+
+

The counter records a single time-normalized statistic.

+
+
+
+

Spectator Timer

+
+

A timer is used to measure how long some event is taking. Spring Cloud automatically records timers for Spring MVC requests and conditionally RestTemplate requests, which can later be used to create dashboards for request related metrics like latency:

+
+
+
+RequestLatency +
+
Figure 4. Request Latency
+
+
+
+
// create a timer with a name and a set of tags
+Timer timer = registry.timer("timerName", "tagKey1", "tagValue1", ...);
+
+// execute an operation and time it at the same time
+T result = timer.record(() -> fooReturnsT());
+
+// alternatively, if you must manually record the time
+Long start = System.nanoTime();
+T result = fooReturnsT();
+timer.record(System.nanoTime() - start, TimeUnit.NANOSECONDS);
+
+
+
+

The timer simultaneously records 4 statistics: count, max, totalOfSquares, and totalTime. The count statistic will always match the single normalized value provided by a counter if you had called increment() once on the counter for each time you recorded a timing, so it is rarely necessary to count and time separately for a single operation.

+
+
+

For long running operations, Spectator provides a special LongTaskTimer.

+
+
+
+

Spectator Gauge

+
+

Gauges are used to determine some current value like the size of a queue or number of threads in a running state. Since gauges are sampled, they provide no information about how these values fluctuate between samples.

+
+
+

The normal use of a gauge involves registering the gauge once in initialization with an id, a reference to the object to be sampled, and a function to get or compute a numeric value based on the object. The reference to the object is passed in separately and the Spectator registry will keep a weak reference to the object. If the object is garbage collected, then Spectator will automatically drop the registration. See the note in Spectator’s documentation about potential memory leaks if this API is misused.

+
+
+
+
// the registry will automatically sample this gauge periodically
+registry.gauge("gaugeName", pool, Pool::numberOfRunningThreads);
+
+// manually sample a value in code at periodic intervals -- last resort!
+registry.gauge("gaugeName", Arrays.asList("tagKey1", "tagValue1", ...), 1000);
+
+
+
+
+

Spectator Distribution Summaries

+
+

A distribution summary is used to track the distribution of events. It is similar to a timer, but more general in that the size does not have to be a period of time. For example, a distribution summary could be used to measure the payload sizes of requests hitting a server.

+
+
+
+
// the registry will automatically sample this gauge periodically
+DistributionSummary ds = registry.distributionSummary("dsName", "tagKey1", "tagValue1", ...);
+ds.record(request.sizeInBytes());
+
+
+
+
+
+

Metrics Collection: Servo

+
+ + + + + +
+
Warning
+		 +If your code is compiled on Java 8, please use Spectator instead of Servo as Spectator is destined to replace Servo entirely in the long term. +
+
+
+

In Servo parlance, a monitor is a named, typed, and tagged configuration and a metric represents the value of a given monitor at a point in time. Servo monitors are logically equivalent to Spectator meters. Servo monitors are created and controlled by a MonitorRegistry. In spite of the above warning, Servo does have a wider array of monitor options than Spectator has meters.

+
+
+

Spring Cloud integration configures an injectable com.netflix.servo.MonitorRegistry instance for you. Once you have created the appropriate Monitor type in Servo, the process of recording data is wholly similar to Spectator.

+
+
+

Creating Servo Monitors

+
+

If you are using the Servo MonitorRegistry instance provided by Spring Cloud (specifically, an instance of DefaultMonitorRegistry), Servo provides convenience classes for retrieving counters and timers. These convenience classes ensure that only one Monitor is registered for each unique combination of name and tags.

+
+
+

To manually create a Monitor type in Servo, especially for the more exotic monitor types for which convenience methods are not provided, instantiate the appropriate type by providing a MonitorConfig instance:

+
+
+
+
MonitorConfig config = MonitorConfig.builder("timerName").withTag("tagKey1", "tagValue1").build();
+
+// somewhere we should cache this Monitor by MonitorConfig
+Timer timer = new BasicTimer(config);
+monitorRegistry.register(timer);
+
+
+
+
+
+

Metrics Backend: Atlas

+
+

Atlas was developed by Netflix to manage dimensional time series data for near real-time operational insight. Atlas features in-memory data storage, allowing it to gather and report very large numbers of metrics, very quickly.

+
+
+

Atlas captures operational intelligence. Whereas business intelligence is data gathered for analyzing trends over time, operational intelligence provides a picture of what is currently happening within a system.

+
+
+

Spring Cloud provides a spring-cloud-starter-netflix-atlas that has all the dependencies you need. Then just annotate your Spring Boot application with @EnableAtlas and provide a location for your running Atlas server with the netflix.atlas.uri property.

+
+
+

Global tags

+
+

Spring Cloud enables you to add tags to every metric sent to the Atlas backend. Global tags can be used to separate metrics by application name, environment, region, etc.

+
+
+

Each bean implementing AtlasTagProvider will contribute to the global tag list:

+
+
+
+
@Bean
+AtlasTagProvider atlasCommonTags(
+    @Value("${spring.application.name}") String appName) {
+  return () -> Collections.singletonMap("app", appName);
+}
+
+
+
+
+

Using Atlas

+
+

To bootstrap a in-memory standalone Atlas instance:

+
+
+
+
$ curl -LO https://github.com/Netflix/atlas/releases/download/v1.4.2/atlas-1.4.2-standalone.jar
+$ java -jar atlas-1.4.2-standalone.jar
+
+
+
+ + + + + +
+
Tip
+		 +An Atlas standalone node running on an r3.2xlarge (61GB RAM) can handle roughly 2 million metrics per minute for a given 6 hour window. +
+
+
+

Once running and you have collected a handful of metrics, verify that your setup is correct by listing tags on the Atlas server:

+
+
+
+
$ curl http://ATLAS/api/v1/tags
+
+
+
+ + + + + +
+
Tip
+		 +After executing several requests against your service, you can gather some very basic information on the request latency of every request by pasting the following url in your browser: http://ATLAS/api/v1/graph?q=name,rest,:eq,:avg +
+
+
+

The Atlas wiki contains a compilation of sample queries for various scenarios.

+
+
+

Make sure to check out the alerting philosophy and docs on using double exponential smoothing to generate dynamic alert thresholds.

+
+
+
+
+

Retrying Failed Requests

+
+

Spring Cloud Netflix offers a variety of ways to make HTTP requests. You can use a load balanced +RestTemplate, Ribbon, or Feign. No matter how you choose to your HTTP requests, there is always +a chance the request may fail. When a request fails you may want to have the request retried +automatically. To accomplish this when using Sping Cloud Netflix you need to include +Spring Retry on your application’s classpath. +When Spring Retry is present load balanced RestTemplates, Feign, and Zuul will automatically +retry any failed requests (assuming you configuration allows it to).

+
+
+

Configuration

+
+

Anytime Ribbon is used with Spring Retry you can control the retry functionality by configuring +certain Ribbon properties. The properties you can use are +client.ribbon.MaxAutoRetries, client.ribbon.MaxAutoRetriesNextServer, and +client.ribbon.OkToRetryOnAllOperations. See the Ribbon documentation +for a description of what there properties do.

+
+
+

In addition you may want to retry requests when certain status codes are returned in the +response. You can list the response codes you would like the Ribbon client to retry using the + property clientName.ribbon.retryableStatusCodes. For example

+
+
+
+
clientName:
+  ribbon:
+    retryableStatusCodes: 404,502
+
+
+
+

You can also create a bean of type LoadBalancedRetryPolicy and implement the retryableStatusCode +method to determine whether you want to retry a request given the status code.

+
+
+
+

Zuul

+
+

You can turn off Zuul’s retry functionality by setting zuul.retryable to false. You +can also disable retry functionality on route by route basis by setting +zuul.routes.routename.retryable to false.

+
+
+
+
+
+
+

HTTP Clients

+
+
+

Spring Cloud Netflix will automatically create the HTTP client used by Ribbon, Feign, and +Zuul for you. However you can also provide your own HTTP clients customized how you please +yourself. To do this you can either create a bean of type ClosableHttpClient if you +are using the Apache Http Cient, or OkHttpClient if you are using OK HTTP.

+
+
+ + + + + +
+
Note
+		 +When you create your own HTTP client you are also responsible for implementing +the correct connection management strategies for these clients. Doing this improperly +can result in resource management issues. +
+
+
+
+

Spring Cloud Stream

+
+
+
+

This section goes into more detail about how you can work with Spring Cloud Stream. +It covers topics such as creating and running stream applications.

+
+
+
+
+

Introducing Spring Cloud Stream

+
+
+

Spring Cloud Stream is a framework for building message-driven microservice applications. +Spring Cloud Stream builds upon Spring Boot to create standalone, production-grade Spring applications, and uses Spring Integration to provide connectivity to message brokers. +It provides opinionated configuration of middleware from several vendors, introducing the concepts of persistent publish-subscribe semantics, consumer groups, and partitions.

+
+
+

You can add the @EnableBinding annotation to your application to get immediate connectivity to a message broker, and you can add @StreamListener to a method to cause it to receive events for stream processing. +The following is a simple sink application which receives external messages.

+
+
+
+
@SpringBootApplication
+@EnableBinding(Sink.class)
+public class VoteRecordingSinkApplication {
+
+  public static void main(String[] args) {
+    SpringApplication.run(VoteRecordingSinkApplication.class, args);
+  }
+
+  @StreamListener(Sink.INPUT)
+  public void processVote(Vote vote) {
+      votingService.recordVote(vote);
+  }
+}
+
+
+
+

The @EnableBinding annotation takes one or more interfaces as parameters (in this case, the parameter is a single Sink interface). +An interface declares input and/or output channels. +Spring Cloud Stream provides the interfaces Source, Sink, and Processor; you can also define your own interfaces.

+
+
+

The following is the definition of the Sink interface:

+
+
+
+
public interface Sink {
+  String INPUT = "input";
+
+  @Input(Sink.INPUT)
+  SubscribableChannel input();
+}
+
+
+
+

The @Input annotation identifies an input channel, through which received messages enter the application; the @Output annotation identifies an output channel, through which published messages leave the application. +The @Input and @Output annotations can take a channel name as a parameter; if a name is not provided, the name of the annotated method will be used.

+
+
+

Spring Cloud Stream will create an implementation of the interface for you. +You can use this in the application by autowiring it, as in the following example of a test case.

+
+
+
+
@RunWith(SpringJUnit4ClassRunner.class)
+@SpringApplicationConfiguration(classes = VoteRecordingSinkApplication.class)
+@WebAppConfiguration
+@DirtiesContext
+public class StreamApplicationTests {
+
+  @Autowired
+  private Sink sink;
+
+  @Test
+  public void contextLoads() {
+    assertNotNull(this.sink.input());
+  }
+}
+
+
+
+
+
+

Main Concepts

+
+
+

Spring Cloud Stream provides a number of abstractions and primitives that simplify the writing of message-driven microservice applications. +This section gives an overview of the following:

+
+
+
    +
  • +

    Spring Cloud Stream’s application model

    +
    • +
  • +

    The Binder abstraction

    +
    • +
  • +

    Persistent publish-subscribe support

    +
    • +
  • +

    Consumer group support

    +
    • +
  • +

    Partitioning support

    +
    • +
  • +

    A pluggable Binder API

    +
    • +
+
+
+

Application Model

+
+

A Spring Cloud Stream application consists of a middleware-neutral core. +The application communicates with the outside world through input and output channels injected into it by Spring Cloud Stream. +Channels are connected to external brokers through middleware-specific Binder implementations.

+
+
+
+SCSt with binder +
+
Figure 5. Spring Cloud Stream Application
+
+
+

Fat JAR

+
+

Spring Cloud Stream applications can be run in standalone mode from your IDE for testing. +To run a Spring Cloud Stream application in production, you can create an executable (or "fat") JAR by using the standard Spring Boot tooling provided for Maven or Gradle.

+
+
+
+
+

The Binder Abstraction

+
+

Spring Cloud Stream provides Binder implementations for Kafka and Rabbit MQ. +Spring Cloud Stream also includes a TestSupportBinder, which leaves a channel unmodified so that tests can interact with channels directly and reliably assert on what is received. +You can use the extensible API to write your own Binder.

+
+
+

Spring Cloud Stream uses Spring Boot for configuration, and the Binder abstraction makes it possible for a Spring Cloud Stream application to be flexible in how it connects to middleware. +For example, deployers can dynamically choose, at runtime, the destinations (e.g., the Kafka topics or RabbitMQ exchanges) to which channels connect. +Such configuration can be provided through external configuration properties and in any form supported by Spring Boot (including application arguments, environment variables, and application.yml or application.properties files). +In the sink example from the Introducing Spring Cloud Stream section, setting the application property spring.cloud.stream.bindings.input.destination to raw-sensor-data will cause it to read from the raw-sensor-data Kafka topic, or from a queue bound to the raw-sensor-data RabbitMQ exchange.

+
+
+

Spring Cloud Stream automatically detects and uses a binder found on the classpath. +You can easily use different types of middleware with the same code: just include a different binder at build time. +For more complex use cases, you can also package multiple binders with your application and have it choose the binder, and even whether to use different binders for different channels, at runtime.

+
+
+
+

Persistent Publish-Subscribe Support

+
+

Communication between applications follows a publish-subscribe model, where data is broadcast through shared topics. +This can be seen in the following figure, which shows a typical deployment for a set of interacting Spring Cloud Stream applications.

+
+
+
+SCSt sensors +
+
Figure 6. Spring Cloud Stream Publish-Subscribe
+
+
+

Data reported by sensors to an HTTP endpoint is sent to a common destination named raw-sensor-data. +From the destination, it is independently processed by a microservice application that computes time-windowed averages and by another microservice application that ingests the raw data into HDFS. +In order to process the data, both applications declare the topic as their input at runtime.

+
+
+

The publish-subscribe communication model reduces the complexity of both the producer and the consumer, and allows new applications to be added to the topology without disruption of the existing flow. +For example, downstream from the average-calculating application, you can add an application that calculates the highest temperature values for display and monitoring. +You can then add another application that interprets the same flow of averages for fault detection. +Doing all communication through shared topics rather than point-to-point queues reduces coupling between microservices.

+
+
+

While the concept of publish-subscribe messaging is not new, Spring Cloud Stream takes the extra step of making it an opinionated choice for its application model. +By using native middleware support, Spring Cloud Stream also simplifies use of the publish-subscribe model across different platforms.

+
+
+
+

Consumer Groups

+
+

While the publish-subscribe model makes it easy to connect applications through shared topics, the ability to scale up by creating multiple instances of a given application is equally important. +When doing this, different instances of an application are placed in a competing consumer relationship, where only one of the instances is expected to handle a given message.

+
+
+

Spring Cloud Stream models this behavior through the concept of a consumer group. +(Spring Cloud Stream consumer groups are similar to and inspired by Kafka consumer groups.) +Each consumer binding can use the spring.cloud.stream.bindings.<channelName>.group property to specify a group name. +For the consumers shown in the following figure, this property would be set as spring.cloud.stream.bindings.<channelName>.group=hdfsWrite or spring.cloud.stream.bindings.<channelName>.group=average.

+
+
+
+SCSt groups +
+
Figure 7. Spring Cloud Stream Consumer Groups
+
+
+

All groups which subscribe to a given destination receive a copy of published data, but only one member of each group receives a given message from that destination. +By default, when a group is not specified, Spring Cloud Stream assigns the application to an anonymous and independent single-member consumer group that is in a publish-subscribe relationship with all other consumer groups.

+
+
+

Durability

+
+

Consistent with the opinionated application model of Spring Cloud Stream, consumer group subscriptions are durable. +That is, a binder implementation ensures that group subscriptions are persistent, and once at least one subscription for a group has been created, the group will receive messages, even if they are sent while all applications in the group are stopped.

+
+
+ + + + + +
+
Note
+		 +
+

Anonymous subscriptions are non-durable by nature. +For some binder implementations (e.g., RabbitMQ), it is possible to have non-durable group subscriptions.

+
+
+
+
+

In general, it is preferable to always specify a consumer group when binding an application to a given destination. +When scaling up a Spring Cloud Stream application, you must specify a consumer group for each of its input bindings. +This prevents the application’s instances from receiving duplicate messages (unless that behavior is desired, which is unusual).

+
+
+
+
+

Partitioning Support

+
+

Spring Cloud Stream provides support for partitioning data between multiple instances of a given application. +In a partitioned scenario, the physical communication medium (e.g., the broker topic) is viewed as being structured into multiple partitions. +One or more producer application instances send data to multiple consumer application instances and ensure that data identified by common characteristics are processed by the same consumer instance.

+
+
+

Spring Cloud Stream provides a common abstraction for implementing partitioned processing use cases in a uniform fashion. +Partitioning can thus be used whether the broker itself is naturally partitioned (e.g., Kafka) or not (e.g., RabbitMQ).

+
+
+
+SCSt partitioning +
+
Figure 8. Spring Cloud Stream Partitioning
+
+
+

Partitioning is a critical concept in stateful processing, where it is critiical, for either performance or consistency reasons, to ensure that all related data is processed together. +For example, in the time-windowed average calculation example, it is important that all measurements from any given sensor are processed by the same application instance.

+
+
+ + + + + +
+
Note
+		 +
+

To set up a partitioned processing scenario, you must configure both the data-producing and the data-consuming ends.

+
+
+
+
+
+
+
+

Programming Model

+
+
+

This section describes Spring Cloud Stream’s programming model. +Spring Cloud Stream provides a number of predefined annotations for declaring bound input and output channels as well as how to listen to channels.

+
+
+

Declaring and Binding Channels

+
+

Triggering Binding Via @EnableBinding

+
+

You can turn a Spring application into a Spring Cloud Stream application by applying the @EnableBinding annotation to one of the application’s configuration classes. +The @EnableBinding annotation itself is meta-annotated with @Configuration and triggers the configuration of Spring Cloud Stream infrastructure:

+
+
+
+
...
+@Import(...)
+@Configuration
+@EnableIntegration
+public @interface EnableBinding {
+    ...
+    Class<?>[] value() default {};
+}
+
+
+
+

The @EnableBinding annotation can take as parameters one or more interface classes that contain methods which represent bindable components (typically message channels).

+
+
+ + + + + +
+
Note
+		 +
+

In Spring Cloud Stream, the bindable MessageChannel components are the Spring Messaging MessageChannel (for outbound) and its extension SubscribableChannel (for inbound). +Using the same mechanism other bindable components can be supported. +KStream support in Spring Cloud Stream Kafka binder is one such example where KStream is used as inbound/outbound bindable components. +In this documentation, we will continue to refer to MessageChannels as the bindable components.

+
+
+
+
+
+

@Input and @Output

+
+

A Spring Cloud Stream application can have an arbitrary number of input and output channels defined in an interface as @Input and @Output methods:

+
+
+
+
public interface Barista {
+
+    @Input
+    SubscribableChannel orders();
+
+    @Output
+    MessageChannel hotDrinks();
+
+    @Output
+    MessageChannel coldDrinks();
+}
+
+
+
+

Using this interface as a parameter to @EnableBinding will trigger the creation of three bound channels named orders, hotDrinks, and coldDrinks, respectively.

+
+
+
+
@EnableBinding(Barista.class)
+public class CafeConfiguration {
+
+   ...
+}
+
+
+
+
Customizing Channel Names
+
+

Using the @Input and @Output annotations, you can specify a customized channel name for the channel, as shown in the following example:

+
+
+
+
public interface Barista {
+    ...
+    @Input("inboundOrders")
+    SubscribableChannel orders();
+}
+
+
+
+

In this example, the created bound channel will be named inboundOrders.

+
+
+
+
Source, Sink, and Processor
+
+

For easy addressing of the most common use cases, which involve either an input channel, an output channel, or both, Spring Cloud Stream provides three predefined interfaces out of the box.

+
+
+

Source can be used for an application which has a single outbound channel.

+
+
+
+
public interface Source {
+
+  String OUTPUT = "output";
+
+  @Output(Source.OUTPUT)
+  MessageChannel output();
+
+}
+
+
+
+

Sink can be used for an application which has a single inbound channel.

+
+
+
+
public interface Sink {
+
+  String INPUT = "input";
+
+  @Input(Sink.INPUT)
+  SubscribableChannel input();
+
+}
+
+
+
+

Processor can be used for an application which has both an inbound channel and an outbound channel.

+
+
+
+
public interface Processor extends Source, Sink {
+}
+
+
+
+

Spring Cloud Stream provides no special handling for any of these interfaces; they are only provided out of the box.

+
+
+
+
+

Accessing Bound Channels

+
+
Injecting the Bound Interfaces
+
+

For each bound interface, Spring Cloud Stream will generate a bean that implements the interface. +Invoking a @Input-annotated or @Output-annotated method of one of these beans will return the relevant bound channel.

+
+
+

The bean in the following example sends a message on the output channel when its hello method is invoked. +It invokes output() on the injected Source bean to retrieve the target channel.

+
+
+
+
@Component
+public class SendingBean {
+
+    private Source source;
+
+    @Autowired
+    public SendingBean(Source source) {
+        this.source = source;
+    }
+
+    public void sayHello(String name) {
+         source.output().send(MessageBuilder.withPayload(name).build());
+    }
+}
+
+
+
+
+
Injecting Channels Directly
+
+

Bound channels can be also injected directly:

+
+
+
+
@Component
+public class SendingBean {
+
+    private MessageChannel output;
+
+    @Autowired
+    public SendingBean(MessageChannel output) {
+        this.output = output;
+    }
+
+    public void sayHello(String name) {
+         output.send(MessageBuilder.withPayload(name).build());
+    }
+}
+
+
+
+

If the name of the channel is customized on the declaring annotation, that name should be used instead of the method name. +Given the following declaration:

+
+
+
+
public interface CustomSource {
+    ...
+    @Output("customOutput")
+    MessageChannel output();
+}
+
+
+
+

The channel will be injected as shown in the following example:

+
+
+
+
@Component
+public class SendingBean {
+
+    private MessageChannel output;
+
+    @Autowired
+    public SendingBean(@Qualifier("customOutput") MessageChannel output) {
+        this.output = output;
+    }
+
+    public void sayHello(String name) {
+         this.output.send(MessageBuilder.withPayload(name).build());
+    }
+}
+
+
+
+
+
+

Producing and Consuming Messages

+
+

You can write a Spring Cloud Stream application using either Spring Integration annotations or Spring Cloud Stream’s @StreamListener annotation. +The @StreamListener annotation is modeled after other Spring Messaging annotations (such as @MessageMapping, @JmsListener, @RabbitListener, etc.) but adds content type management and type coercion features.

+
+
+
Native Spring Integration Support
+
+

Because Spring Cloud Stream is based on Spring Integration, Stream completely inherits Integration’s foundation and infrastructure as well as the component itself. +For example, you can attach the output channel of a Source to a MessageSource:

+
+
+
+
@EnableBinding(Source.class)
+public class TimerSource {
+
+  @Value("${format}")
+  private String format;
+
+  @Bean
+  @InboundChannelAdapter(value = Source.OUTPUT, poller = @Poller(fixedDelay = "${fixedDelay}", maxMessagesPerPoll = "1"))
+  public MessageSource<String> timerMessageSource() {
+    return () -> new GenericMessage<>(new SimpleDateFormat(format).format(new Date()));
+  }
+}
+
+
+
+

Or you can use a processor’s channels in a transformer:

+
+
+
+
@EnableBinding(Processor.class)
+public class TransformProcessor {
+  @Transformer(inputChannel = Processor.INPUT, outputChannel = Processor.OUTPUT)
+  public Object transform(String message) {
+    return message.toUpperCase();
+  }
+}
+
+
+
+
+
Spring Integration Error Channel Support
+
+

Spring Cloud Stream supports publishing error messages received by the Spring Integration global +error channel. Error messages sent to the errorChannel can be published to a specific destination +at the broker by configuring a binding for the outbound target named error. For example, to +publish error messages to a broker destination named "myErrors", provide the following property: +spring.cloud.stream.bindings.error.destination=myErrors

+
+
+
+
Using @StreamListener for Automatic Content Type Handling
+
+

Complementary to its Spring Integration support, Spring Cloud Stream provides its own @StreamListener annotation, modeled after other Spring Messaging annotations (e.g. @MessageMapping, @JmsListener, @RabbitListener, etc.). +The @StreamListener annotation provides a simpler model for handling inbound messages, especially when dealing with use cases that involve content type management and type coercion.

+
+
+

Spring Cloud Stream provides an extensible MessageConverter mechanism for handling data conversion by bound channels and for, in this case, dispatching to methods annotated with @StreamListener. +The following is an example of an application which processes external Vote events:

+
+
+
+
@EnableBinding(Sink.class)
+public class VoteHandler {
+
+  @Autowired
+  VotingService votingService;
+
+  @StreamListener(Sink.INPUT)
+  public void handle(Vote vote) {
+    votingService.record(vote);
+  }
+}
+
+
+
+

The distinction between @StreamListener and a Spring Integration @ServiceActivator is seen when considering an inbound Message that has a String payload and a contentType header of application/json. +In the case of @StreamListener, the MessageConverter mechanism will use the contentType header to parse the String payload into a Vote object.

+
+
+

As with other Spring Messaging methods, method arguments can be annotated with @Payload, @Headers and @Header.

+
+
+ + + + + +
+
Note
+		 +
+

For methods which return data, you must use the @SendTo annotation to specify the output binding destination for data returned by the method:

+
+
+
+
@EnableBinding(Processor.class)
+public class TransformProcessor {
+
+  @Autowired
+  VotingService votingService;
+
+  @StreamListener(Processor.INPUT)
+  @SendTo(Processor.OUTPUT)
+  public VoteResult handle(Vote vote) {
+    return votingService.record(vote);
+  }
+}
+
+
+
+
+
+
+
Using @StreamListener for dispatching messages to multiple methods
+
+

Since version 1.2, Spring Cloud Stream supports dispatching messages to multiple @StreamListener methods registered on an input channel, based on a condition.

+
+
+

In order to be eligible to support conditional dispatching, a method must satisfy the follow conditions:

+
+
+
    +
  • +

    it must not return a value

    +
    • +
  • +

    it must be an individual message handling method (reactive API methods are not supported)

    +
    • +
+
+
+

The condition is specified via a SpEL expression in the condition attribute of the annotation and is evaluated for each message. +All the handlers that match the condition will be invoked in the same thread and no assumption must be made about the order in which the invocations take place.

+
+
+

An example of using @StreamListener with dispatching conditions can be seen below. +In this example, all the messages bearing a header type with the value foo will be dispatched to the receiveFoo method, and all the messages bearing a header type with the value bar will be dispatched to the receiveBar method.

+
+
+
+
@EnableBinding(Sink.class)
+@EnableAutoConfiguration
+public static class TestPojoWithAnnotatedArguments {
+
+    @StreamListener(target = Sink.INPUT, condition = "headers['type']=='foo'")
+    public void receiveFoo(@Payload FooPojo fooPojo) {
+       // handle the message
+    }
+
+    @StreamListener(target = Sink.INPUT, condition = "headers['type']=='bar'")
+    public void receiveBar(@Payload BarPojo barPojo) {
+       // handle the message
+    }
+}
+
+
+
+ + + + + +
+
Note
+		 +
+

Dispatching via @StreamListener conditions is only supported for handlers of individual messages, and not for reactive programming support (described below).

+
+
+
+
+
+
+

Reactive Programming Support

+
+

Spring Cloud Stream also supports the use of reactive APIs where incoming and outgoing data is handled as continuous data flows. +Support for reactive APIs is available via the spring-cloud-stream-reactive, which needs to be added explicitly to your project.

+
+
+

The programming model with reactive APIs is declarative, where instead of specifying how each individual message should be handled, you can use operators that describe functional transformations from inbound to outbound data flows.

+
+
+

Spring Cloud Stream supports the following reactive APIs:

+
+
+
    +
  • +

    Reactor

    +
    • +
  • +

    RxJava 1.x

    +
    • +
+
+
+

In the future, it is intended to support a more generic model based on Reactive Streams.

+
+
+

The reactive programming model is also using the @StreamListener annotation for setting up reactive handlers. The differences are that:

+
+
+
    +
  • +

    the @StreamListener annotation must not specify an input or output, as they are provided as arguments and return values from the method;

    +
    • +
  • +

    the arguments of the method must be annotated with @Input and @Output indicating which input or output will the incoming and respectively outgoing data flows connect to;

    +
    • +
  • +

    the return value of the method, if any, will be annotated with @Output, indicating the input where data shall be sent.

    +
    • +
+
+
+ + + + + +
+
Note
+		 +
+

Reactive programming support requires Java 1.8.

+
+
+
+
+ + + + + +
+
Note
+		 +
+

As of Spring Cloud Stream 1.1.1 and later (starting with release train Brooklyn.SR2), reactive programming support requires the use of Reactor 3.0.4.RELEASE and higher. +Earlier Reactor versions (including 3.0.1.RELEASE, 3.0.2.RELEASE and 3.0.3.RELEASE) are not supported. +spring-cloud-stream-reactive will transitively retrieve the proper version, but it is possible for the project structure to manage the version of the io.projectreactor:reactor-core to an earlier release, especially when using Maven. +This is the case for projects generated via Spring Initializr with Spring Boot 1.x, which will override the Reactor version to 2.0.8.RELEASE. +In such cases you must ensure that the proper version of the artifact is released. +This can be simply achieved by adding a direct dependency on io.projectreactor:reactor-core with a version of 3.0.4.RELEASE or later to your project.

+
+
+
+
+ + + + + +
+
Note
+		 +
+

The use of term reactive is currently referring to the reactive APIs being used and not to the execution model being reactive (i.e. the bound endpoints are still using a 'push' rather than 'pull' model). While some backpressure support is provided by the use of Reactor, we do intend on the long run to support entirely reactive pipelines by the use of native reactive clients for the connected middleware.

+
+
+
+
+
Reactor-based handlers
+
+

A Reactor based handler can have the following argument types:

+
+
+
    +
  • +

    For arguments annotated with @Input, it supports the Reactor type Flux. +The parameterization of the inbound Flux follows the same rules as in the case of individual message handling: it can be the entire Message, a POJO which can be the Message payload, or a POJO which is the result of a transformation based on the Message content-type header. Multiple inputs are provided;

    +
    • +
  • +

    For arguments annotated with Output, it supports the type FluxSender which connects a Flux produced by the method with an output. Generally speaking, specifying outputs as arguments is only recommended when the method can have multiple outputs;

    +
    • +
+
+
+

A Reactor based handler supports a return type of Flux, case in which it must be annotated with @Output. We recommend using the return value of the method when a single output flux is available.

+
+
+

Here is an example of a simple Reactor-based Processor.

+
+
+
+
@EnableBinding(Processor.class)
+@EnableAutoConfiguration
+public static class UppercaseTransformer {
+
+  @StreamListener
+  @Output(Processor.OUTPUT)
+  public Flux<String> receive(@Input(Processor.INPUT) Flux<String> input) {
+    return input.map(s -> s.toUpperCase());
+  }
+}
+
+
+
+

The same processor using output arguments looks like this:

+
+
+
+
@EnableBinding(Processor.class)
+@EnableAutoConfiguration
+public static class UppercaseTransformer {
+
+  @StreamListener
+  public void receive(@Input(Processor.INPUT) Flux<String> input,
+     @Output(Processor.OUTPUT) FluxSender output) {
+     output.send(input.map(s -> s.toUpperCase()));
+  }
+}
+
+
+
+
+
RxJava 1.x support
+
+

RxJava 1.x handlers follow the same rules as Reactor-based one, but will use Observable and ObservableSender arguments and return types.

+
+
+

So the first example above will become:

+
+
+
+
@EnableBinding(Processor.class)
+@EnableAutoConfiguration
+public static class UppercaseTransformer {
+
+  @StreamListener
+  @Output(Processor.OUTPUT)
+  public Observable<String> receive(@Input(Processor.INPUT) Observable<String> input) {
+    return input.map(s -> s.toUpperCase());
+  }
+}
+
+
+
+

The second example above will become:

+
+
+
+
@EnableBinding(Processor.class)
+@EnableAutoConfiguration
+public static class UppercaseTransformer {
+
+  @StreamListener
+  public void receive(@Input(Processor.INPUT) Observable<String> input,
+     @Output(Processor.OUTPUT) ObservableSender output) {
+     output.send(input.map(s -> s.toUpperCase()));
+  }
+}
+
+
+
+
+
Reactive Sources
+
+

Spring Cloud Stream reactive support also provides the ability for creating reactive sources through the StreamEmitter annotation. +Using StreamEmitter annotation, a regular source may be converted to a reactive one. +StreamEmitter is a method level annotation that marks a method to be an emitter to outputs declared via EnableBinding. +It is not allowed to use the Input annotation along with StreamEmitter, as the methods marked with this annotation are not listening from any input, rather generating to an output. +Following the same programming model used in StreamListener, StreamEmitter also allows flexible ways of using the Output annotation depending on whether the method has any arguments, return type etc.

+
+
+

Here are some examples of using StreamEmitter in various styles.

+
+
+

The following example will emit the "Hello World" message every millisecond and publish to a Flux. +In this case, the resulting messages in Flux will be sent to the output channel of the Source.

+
+
+
+
@EnableBinding(Source.class)
+@EnableAutoConfiguration
+public static class HelloWorldEmitter {
+
+  @StreamEmitter
+  @Output(Source.OUTPUT)
+  public Flux<String> emit() {
+    return Flux.intervalMillis(1)
+            .map(l -> "Hello World");
+  }
+}
+
+
+
+

Following is another flavor of the same sample as above. +Instead of returning a Flux, this method uses a FluxSender to programmatically send Flux from a source.

+
+
+
+
@EnableBinding(Source.class)
+@EnableAutoConfiguration
+public static class HelloWorldEmitter {
+
+  @StreamEmitter
+  @Output(Source.OUTPUT)
+  public void emit(FluxSender output) {
+    output.send(Flux.intervalMillis(1)
+            .map(l -> "Hello World"));
+  }
+}
+
+
+
+

Following is exactly same as the above snippet in functionality and style. +However, instead of using an explicit Output annotation at the method level, it is used as the method parameter level.

+
+
+
+
@EnableBinding(Source.class)
+@EnableAutoConfiguration
+public static class HelloWorldEmitter {
+
+  @StreamEmitter
+  public void emit(@Output(Source.OUTPUT) FluxSender output) {
+    output.send(Flux.intervalMillis(1)
+            .map(l -> "Hello World"));
+  }
+}
+
+
+
+

Here is yet another flavor of writing reacting sources using the Reactive Streams Publisher API and the support for it in the Spring Integration Java DSL. +The Publisher is still using Reactor Flux under the hood, but from an application perspective, that is transparent to the user and only needs Reactive Streams and Java DSL for Spring Integration.

+
+
+
+
@EnableBinding(Source.class)
+@EnableAutoConfiguration
+public static class HelloWorldEmitter {
+
+  @StreamEmitter
+  @Output(Source.OUTPUT)
+  @Bean
+  public Publisher<Message<String>> emit() {
+    return IntegrationFlows.from(() ->
+                new GenericMessage<>("Hello World"),
+        e -> e.poller(p -> p.fixedDelay(1)))
+        .toReactivePublisher();
+  }
+}
+
+
+
+
+
+

Aggregation

+
+

Spring Cloud Stream provides support for aggregating multiple applications together, connecting their input and output channels directly and avoiding the additional cost of exchanging messages via a broker. +As of version 1.0 of Spring Cloud Stream, aggregation is supported only for the following types of applications:

+
+
+
    +
  • +

    sources - applications with a single output channel named output, typically having a single binding of the type org.springframework.cloud.stream.messaging.Source

    +
    • +
  • +

    sinks - applications with a single input channel named input, typically having a single binding of the type org.springframework.cloud.stream.messaging.Sink

    +
    • +
  • +

    processors - applications with a single input channel named input and a single output channel named output, typically having a single binding of the type org.springframework.cloud.stream.messaging.Processor.

    +
    • +
+
+
+

They can be aggregated together by creating a sequence of interconnected applications, in which the output channel of an element in the sequence is connected to the input channel of the next element, if it exists. +A sequence can start with either a source or a processor, it can contain an arbitrary number of processors and must end with either a processor or a sink.

+
+
+

Depending on the nature of the starting and ending element, the sequence may have one or more bindable channels, as follows:

+
+
+
    +
  • +

    if the sequence starts with a source and ends with a sink, all communication between the applications is direct and no channels will be bound

    +
    • +
  • +

    if the sequence starts with a processor, then its input channel will become the input channel of the aggregate and will be bound accordingly

    +
    • +
  • +

    if the sequence ends with a processor, then its output channel will become the output channel of the aggregate and will be bound accordingly

    +
    • +
+
+
+

Aggregation is performed using the AggregateApplicationBuilder utility class, as in the following example. +Let’s consider a project in which we have source, processor and a sink, which may be defined in the project, or may be contained in one of the project’s dependencies.

+
+
+ + + + + +
+
Note
+		 +
+

Each component (source, sink or processor) in an aggregate application must be provided in a separate package if the configuration classes use @SpringBootApplication. +This is required to avoid cross-talk between applications, due to the classpath scanning performed by @SpringBootApplication on the configuration classes inside the same package. +In the example below, it can be seen that the Source, Processor and Sink application classes are grouped in separate packages. +A possible alternative is to provide the source, sink or processor configuration in a separate @Configuration class, avoid the use of @SpringBootApplication/@ComponentScan and use those for aggregation.

+
+
+
+
+
+
package com.app.mysink;
+
+@SpringBootApplication
+@EnableBinding(Sink.class)
+public class SinkApplication {
+
+	private static Logger logger = LoggerFactory.getLogger(SinkApplication.class);
+
+	@ServiceActivator(inputChannel=Sink.INPUT)
+	public void loggerSink(Object payload) {
+		logger.info("Received: " + payload);
+	}
+}
+
+
+
+
+
package com.app.myprocessor;
+
+// Imports omitted
+
+@SpringBootApplication
+@EnableBinding(Processor.class)
+public class ProcessorApplication {
+
+	@Transformer
+	public String loggerSink(String payload) {
+		return payload.toUpperCase();
+	}
+}
+
+
+
+
+
package com.app.mysource;
+
+// Imports omitted
+
+@SpringBootApplication
+@EnableBinding(Source.class)
+public class SourceApplication {
+
+	@InboundChannelAdapter(value = Source.OUTPUT)
+	public String timerMessageSource() {
+		return new SimpleDateFormat().format(new Date());
+	}
+}
+
+
+
+

Each configuration can be used for running a separate component, but in this case they can be aggregated together as follows:

+
+
+
+
package com.app;
+
+// Imports omitted
+
+@SpringBootApplication
+public class SampleAggregateApplication {
+
+	public static void main(String[] args) {
+		new AggregateApplicationBuilder()
+			.from(SourceApplication.class).args("--fixedDelay=5000")
+			.via(ProcessorApplication.class)
+			.to(SinkApplication.class).args("--debug=true").run(args);
+	}
+}
+
+
+
+

The starting component of the sequence is provided as argument to the from() method. +The ending component of the sequence is provided as argument to the to() method. +Intermediate processors are provided as argument to the via() method. +Multiple processors of the same type can be chained together (e.g. for pipelining transformations with different configurations). +For each component, the builder can provide runtime arguments for Spring Boot configuration.

+
+
+
Configuring aggregate application
+
+

Spring Cloud Stream supports passing properties for the individual applications inside the aggregate application using 'namespace' as prefix.

+
+
+

The namespace can be set for applications as follows:

+
+
+
+
@SpringBootApplication
+public class SampleAggregateApplication {
+
+	public static void main(String[] args) {
+		new AggregateApplicationBuilder()
+			.from(SourceApplication.class).namespace("source").args("--fixedDelay=5000")
+			.via(ProcessorApplication.class).namespace("processor1")
+			.to(SinkApplication.class).namespace("sink").args("--debug=true").run(args);
+	}
+}
+
+
+
+

Once the 'namespace' is set for the individual applications, the application properties with the namespace as prefix can be passed to the aggregate application using any supported property source (commandline, environment properties etc.,)

+
+
+

For instance, to override the default fixedDelay and debug properties of 'source' and 'sink' applications:

+
+
+
+
java -jar target/MyAggregateApplication-0.0.1-SNAPSHOT.jar --source.fixedDelay=10000 --sink.debug=false
+
+
+
+
+
Configuring binding service properties for non self contained aggregate application
+
+

The non self-contained aggregate application is bound to external broker via either or both the inbound/outbound components (typically, message channels) of the aggregate application while the applications inside the aggregate application are directly bound. +For example: a source application’s output and a processor application’s input are directly bound while the processor’s output channel is bound to an external destination at the broker. +When passing the binding service properties for non-self contained aggregate application, it is required to pass the binding service properties to the aggregate application instead of setting them as 'args' to individual child application. +For instance,

+
+
+
+
@SpringBootApplication
+public class SampleAggregateApplication {
+
+	public static void main(String[] args) {
+		new AggregateApplicationBuilder()
+			.from(SourceApplication.class).namespace("source").args("--fixedDelay=5000")
+			.via(ProcessorApplication.class).namespace("processor1").args("--debug=true").run(args);
+	}
+}
+
+
+
+

The binding properties like --spring.cloud.stream.bindings.output.destination=processor-output need to be specified as one of the external configuration properties (cmdline arg etc.,).

+
+
+
+
+
+
+
+

Binders

+
+
+

Spring Cloud Stream provides a Binder abstraction for use in connecting to physical destinations at the external middleware. +This section provides information about the main concepts behind the Binder SPI, its main components, and implementation-specific details.

+
+
+

Producers and Consumers

+
+
+producers consumers +
+
Figure 9. Producers and Consumers
+
+
+

A producer is any component that sends messages to a channel. +The channel can be bound to an external message broker via a Binder implementation for that broker. +When invoking the bindProducer() method, the first parameter is the name of the destination within the broker, the second parameter is the local channel instance to which the producer will send messages, and the third parameter contains properties (such as a partition key expression) to be used within the adapter that is created for that channel.

+
+
+

A consumer is any component that receives messages from a channel. +As with a producer, the consumer’s channel can be bound to an external message broker. +When invoking the bindConsumer() method, the first parameter is the destination name, and a second parameter provides the name of a logical group of consumers. +Each group that is represented by consumer bindings for a given destination receives a copy of each message that a producer sends to that destination (i.e., publish-subscribe semantics). +If there are multiple consumer instances bound using the same group name, then messages will be load-balanced across those consumer instances so that each message sent by a producer is consumed by only a single consumer instance within each group (i.e., queueing semantics).

+
+
+
+

Binder SPI

+
+

The Binder SPI consists of a number of interfaces, out-of-the box utility classes and discovery strategies that provide a pluggable mechanism for connecting to external middleware.

+
+
+

The key point of the SPI is the Binder interface which is a strategy for connecting inputs and outputs to external middleware.

+
+
+
+
public interface Binder<T, C extends ConsumerProperties, P extends ProducerProperties> {
+	Binding<T> bindConsumer(String name, String group, T inboundBindTarget, C consumerProperties);
+
+	Binding<T> bindProducer(String name, T outboundBindTarget, P producerProperties);
+}
+
+
+
+

The interface is parameterized, offering a number of extension points:

+
+
+
    +
  • +

    input and output bind targets - as of version 1.0, only MessageChannel is supported, but this is intended to be used as an extension point in the future;

    +
    • +
  • +

    extended consumer and producer properties - allowing specific Binder implementations to add supplemental properties which can be supported in a type-safe manner.

    +
    • +
+
+
+

A typical binder implementation consists of the following

+
+
+
    +
  • +

    a class that implements the Binder interface;

    +
    • +
  • +

    a Spring @Configuration class that creates a bean of the type above along with the middleware connection infrastructure;

    +
    • +
  • +

    a META-INF/spring.binders file found on the classpath containing one or more binder definitions, e.g.

    +
    • +
+
+
+
+
kafka:\
+org.springframework.cloud.stream.binder.kafka.config.KafkaBinderConfiguration
+
+
+
+
+

Binder Detection

+
+

Spring Cloud Stream relies on implementations of the Binder SPI to perform the task of connecting channels to message brokers. +Each Binder implementation typically connects to one type of messaging system.

+
+
+

Classpath Detection

+
+

By default, Spring Cloud Stream relies on Spring Boot’s auto-configuration to configure the binding process. +If a single Binder implementation is found on the classpath, Spring Cloud Stream will use it automatically. +For example, a Spring Cloud Stream project that aims to bind only to RabbitMQ can simply add the following dependency:

+
+
+
+
<dependency>
+  <groupId>org.springframework.cloud</groupId>
+  <artifactId>spring-cloud-stream-binder-rabbit</artifactId>
+</dependency>
+
+
+
+

For the specific maven coordinates of other binder dependencies, please refer to the documentation of that binder implementation.

+
+
+
+
+

Multiple Binders on the Classpath

+
+

When multiple binders are present on the classpath, the application must indicate which binder is to be used for each channel binding. +Each binder configuration contains a META-INF/spring.binders, which is a simple properties file:

+
+
+
+
rabbit:\
+org.springframework.cloud.stream.binder.rabbit.config.RabbitServiceAutoConfiguration
+
+
+
+

Similar files exist for the other provided binder implementations (e.g., Kafka), and custom binder implementations are expected to provide them, as well. +The key represents an identifying name for the binder implementation, whereas the value is a comma-separated list of configuration classes that each contain one and only one bean definition of type org.springframework.cloud.stream.binder.Binder.

+
+
+

Binder selection can either be performed globally, using the spring.cloud.stream.defaultBinder property (e.g., spring.cloud.stream.defaultBinder=rabbit) or individually, by configuring the binder on each channel binding. +For instance, a processor application (that has channels with the names input and output for read/write respectively) which reads from Kafka and writes to RabbitMQ can specify the following configuration:

+
+
+
+
spring.cloud.stream.bindings.input.binder=kafka
+spring.cloud.stream.bindings.output.binder=rabbit
+
+
+
+
+

Connecting to Multiple Systems

+
+

By default, binders share the application’s Spring Boot auto-configuration, so that one instance of each binder found on the classpath will be created. +If your application should connect to more than one broker of the same type, you can specify multiple binder configurations, each with different environment settings.

+
+
+ + + + + +
+
Note
+		 +
+

Turning on explicit binder configuration will disable the default binder configuration process altogether. +If you do this, all binders in use must be included in the configuration. +Frameworks that intend to use Spring Cloud Stream transparently may create binder configurations that can be referenced by name, but will not affect the default binder configuration. +In order to do so, a binder configuration may have its defaultCandidate flag set to false, e.g. spring.cloud.stream.binders.<configurationName>.defaultCandidate=false. +This denotes a configuration that will exist independently of the default binder configuration process.

+
+
+
+
+

For example, this is the typical configuration for a processor application which connects to two RabbitMQ broker instances:

+
+
+
+
spring:
+  cloud:
+    stream:
+      bindings:
+        input:
+          destination: foo
+          binder: rabbit1
+        output:
+          destination: bar
+          binder: rabbit2
+      binders:
+        rabbit1:
+          type: rabbit
+          environment:
+            spring:
+              rabbitmq:
+                host: <host1>
+        rabbit2:
+          type: rabbit
+          environment:
+            spring:
+              rabbitmq:
+                host: <host2>
+
+
+
+
+

Binder configuration properties

+
+

The following properties are available when creating custom binder configurations. +They must be prefixed with spring.cloud.stream.binders.<configurationName>.

+
+
+
+
type
+
+

The binder type. +It typically references one of the binders found on the classpath, in particular a key in a META-INF/spring.binders file.

+
+

By default, it has the same value as the configuration name.

+
+
+
inheritEnvironment
+
+

Whether the configuration will inherit the environment of the application itself.

+
+

Default true.

+
+
+
environment
+
+

Root for a set of properties that can be used to customize the environment of the binder. +When this is configured, the context in which the binder is being created is not a child of the application context. +This allows for complete separation between the binder components and the application components.

+
+

Default empty.

+
+
+
defaultCandidate
+
+

Whether the binder configuration is a candidate for being considered a default binder, or can be used only when explicitly referenced. +This allows adding binder configurations without interfering with the default processing.

+
+

Default true.

+
+
+
+
+
+
+
+
+

Configuration Options

+
+
+

Spring Cloud Stream supports general configuration options as well as configuration for bindings and binders. +Some binders allow additional binding properties to support middleware-specific features.

+
+
+

Configuration options can be provided to Spring Cloud Stream applications via any mechanism supported by Spring Boot. +This includes application arguments, environment variables, and YAML or .properties files.

+
+
+

Spring Cloud Stream Properties

+
+
+
spring.cloud.stream.instanceCount
+
+

The number of deployed instances of an application. +Must be set for partitioning and if using Kafka.

+
+

Default: 1.

+
+
+
spring.cloud.stream.instanceIndex
+
+

The instance index of the application: a number from 0 to instanceCount-1. +Used for partitioning and with Kafka. +Automatically set in Cloud Foundry to match the application’s instance index.

+
+
spring.cloud.stream.dynamicDestinations
+
+

A list of destinations that can be bound dynamically (for example, in a dynamic routing scenario). +If set, only listed destinations can be bound.

+
+

Default: empty (allowing any destination to be bound).

+
+
+
spring.cloud.stream.defaultBinder
+
+

The default binder to use, if multiple binders are configured. +See Multiple Binders on the Classpath.

+
+

Default: empty.

+
+
+
spring.cloud.stream.overrideCloudConnectors
+
+

This property is only applicable when the cloud profile is active and Spring Cloud Connectors are provided with the application. +If the property is false (the default), the binder will detect a suitable bound service (e.g. a RabbitMQ service bound in Cloud Foundry for the RabbitMQ binder) and will use it for creating connections (usually via Spring Cloud Connectors). +When set to true, this property instructs binders to completely ignore the bound services and rely on Spring Boot properties (e.g. relying on the spring.rabbitmq.* properties provided in the environment for the RabbitMQ binder). +The typical usage of this property is to be nested in a customized environment when connecting to multiple systems.

+
+

Default: false.

+
+
+
+
+
+
+

Binding Properties

+
+

Binding properties are supplied using the format spring.cloud.stream.bindings.<channelName>.<property>=<value>. +The <channelName> represents the name of the channel being configured (e.g., output for a Source).

+
+
+

To avoid repetition, Spring Cloud Stream supports setting values for all channels, in the format spring.cloud.stream.default.<property>=<value>.

+
+
+

In what follows, we indicate where we have omitted the spring.cloud.stream.bindings.<channelName>. prefix and focus just on the property name, with the understanding that the prefix will be included at runtime.

+
+
+

Properties for Use of Spring Cloud Stream

+
+

The following binding properties are available for both input and output bindings and must be prefixed with spring.cloud.stream.bindings.<channelName>., e.g. spring.cloud.stream.bindings.input.destination=ticktock.

+
+
+

Default values can be set by using the prefix spring.cloud.stream.default, e.g. spring.cloud.stream.default.contentType=application/json.

+
+
+
+
destination
+
+

The target destination of a channel on the bound middleware (e.g., the RabbitMQ exchange or Kafka topic). +If the channel is bound as a consumer, it could be bound to multiple destinations and the destination names can be specified as comma separated String values. +If not set, the channel name is used instead. +The default value of this property cannot be overridden.

+
+
group
+
+

The consumer group of the channel. +Applies only to inbound bindings. +See Consumer Groups.

+
+

Default: null (indicating an anonymous consumer).

+
+
+
contentType
+
+

The content type of the channel.

+
+

Default: null (so that no type coercion is performed).

+
+
+
binder
+
+

The binder used by this binding. +See Multiple Binders on the Classpath for details.

+
+

Default: null (the default binder will be used, if one exists).

+
+
+
+
+
+
+

Consumer properties

+
+

The following binding properties are available for input bindings only and must be prefixed with spring.cloud.stream.bindings.<channelName>.consumer., e.g. spring.cloud.stream.bindings.input.consumer.concurrency=3.

+
+
+

Default values can be set by using the prefix spring.cloud.stream.default.consumer, e.g. spring.cloud.stream.default.consumer.headerMode=raw.

+
+
+
+
concurrency
+
+

The concurrency of the inbound consumer.

+
+

Default: 1.

+
+
+
partitioned
+
+

Whether the consumer receives data from a partitioned producer.

+
+

Default: false.

+
+
+
headerMode
+
+

When set to raw, disables header parsing on input. +Effective only for messaging middleware that does not support message headers natively and requires header embedding. +Useful when inbound data is coming from outside Spring Cloud Stream applications.

+
+

Default: embeddedHeaders.

+
+
+
maxAttempts
+
+

If processing fails, the number of attempts to process the message (including the first). +Set to 1 to disable retry.

+
+

Default: 3.

+
+
+
backOffInitialInterval
+
+

The backoff initial interval on retry.

+
+

Default: 1000.

+
+
+
backOffMaxInterval
+
+

The maximum backoff interval.

+
+

Default: 10000.

+
+
+
backOffMultiplier
+
+

The backoff multiplier.

+
+

Default: 2.0.

+
+
+
instanceIndex
+
+

When set to a value greater than equal to zero, allows customizing the instance index of this consumer (if different from spring.cloud.stream.instanceIndex). +When set to a negative value, it will default to spring.cloud.stream.instanceIndex.

+
+

Default: -1.

+
+
+
instanceCount
+
+

When set to a value greater than equal to zero, allows customizing the instance count of this consumer (if different from spring.cloud.stream.instanceCount). +When set to a negative value, it will default to spring.cloud.stream.instanceCount.

+
+

Default: -1.

+
+
+
+
+
+
+

Producer Properties

+
+

The following binding properties are available for output bindings only and must be prefixed with spring.cloud.stream.bindings.<channelName>.producer., e.g. spring.cloud.stream.bindings.input.producer.partitionKeyExpression=payload.id.

+
+
+

Default values can be set by using the prefix spring.cloud.stream.default.producer, e.g. spring.cloud.stream.default.producer.partitionKeyExpression=payload.id.

+
+
+
+
partitionKeyExpression
+
+

A SpEL expression that determines how to partition outbound data. +If set, or if partitionKeyExtractorClass is set, outbound data on this channel will be partitioned, and partitionCount must be set to a value greater than 1 to be effective. +The two options are mutually exclusive. +See Partitioning Support.

+
+

Default: null.

+
+
+
partitionKeyExtractorClass
+
+

A PartitionKeyExtractorStrategy implementation. +If set, or if partitionKeyExpression is set, outbound data on this channel will be partitioned, and partitionCount must be set to a value greater than 1 to be effective. +The two options are mutually exclusive. +See Partitioning Support.

+
+

Default: null.

+
+
+
partitionSelectorClass
+
+

A PartitionSelectorStrategy implementation. +Mutually exclusive with partitionSelectorExpression. +If neither is set, the partition will be selected as the hashCode(key) % partitionCount, where key is computed via either partitionKeyExpression or partitionKeyExtractorClass.

+
+

Default: null.

+
+
+
partitionSelectorExpression
+
+

A SpEL expression for customizing partition selection. +Mutually exclusive with partitionSelectorClass. +If neither is set, the partition will be selected as the hashCode(key) % partitionCount, where key is computed via either partitionKeyExpression or partitionKeyExtractorClass.

+
+

Default: null.

+
+
+
partitionCount
+
+

The number of target partitions for the data, if partitioning is enabled. +Must be + set to a value greater than 1 if the producer is partitioned. +On Kafka, interpreted as a + hint; the larger of this and the partition count of the target topic is used instead.

+
+

Default: 1.

+
+
+
requiredGroups
+
+

A comma-separated list of groups to which the producer must ensure message delivery even if they start after it has been created (e.g., by pre-creating durable queues in RabbitMQ).

+
+
headerMode
+
+

When set to raw, disables header embedding on output. +Effective only for messaging middleware that does not support message headers natively and requires header embedding. +Useful when producing data for non-Spring Cloud Stream applications.

+
+

Default: embeddedHeaders.

+
+
+
useNativeEncoding
+
+

When set to true, the outbound message is serialized directly by client library, which must be configured correspondingly (e.g. setting an appropriate Kafka producer value serializer). +When this configuration is being used, the outbound message marshalling is not based on the contentType of the binding. +When native encoding is used, it is the responsibility of the consumer to use appropriate decoder (ex: Kafka consumer value de-serializer) to deserialize the inbound message. +Also, when native encoding/decoding is used the headerMode property is ignored and headers will not be embedded into the message.

+
+

Default: false.

+
+
+
+
+
+
+
+

Using dynamically bound destinations

+
+

Besides the channels defined via @EnableBinding, Spring Cloud Stream allows applications to send messages to dynamically bound destinations. +This is useful, for example, when the target destination needs to be determined at runtime. +Applications can do so by using the BinderAwareChannelResolver bean, registered automatically by the @EnableBinding annotation.

+
+
+

The property 'spring.cloud.stream.dynamicDestinations' can be used for restricting the dynamic destination names to a set known beforehand (whitelisting). +If the property is not set, any destination can be bound dynamicaly.

+
+
+

The BinderAwareChannelResolver can be used directly as in the following example, in which a REST controller uses a path variable to decide the target channel.

+
+
+
+
@EnableBinding
+@Controller
+public class SourceWithDynamicDestination {
+
+	@Autowired
+	private BinderAwareChannelResolver resolver;
+
+	@RequestMapping(path = "/{target}", method = POST, consumes = "*/*")
+	@ResponseStatus(HttpStatus.ACCEPTED)
+	public void handleRequest(@RequestBody String body, @PathVariable("target") target,
+	       @RequestHeader(HttpHeaders.CONTENT_TYPE) Object contentType) {
+		sendMessage(body, target, contentType);
+	}
+
+	private void sendMessage(String body, String target, Object contentType) {
+		resolver.resolveDestination(target).send(MessageBuilder.createMessage(body,
+				new MessageHeaders(Collections.singletonMap(MessageHeaders.CONTENT_TYPE, contentType))));
+	}
+}
+
+
+
+

After starting the application on the default port 8080, when sending the following data:

+
+
+
+
curl -H "Content-Type: application/json" -X POST -d "customer-1" http://localhost:8080/customers
+
+curl -H "Content-Type: application/json" -X POST -d "order-1" http://localhost:8080/orders
+
+
+
+

The destinations 'customers' and 'orders' are created in the broker (for example: exchange in case of Rabbit or topic in case of Kafka) with the names 'customers' and 'orders', and the data is published to the appropriate destinations.

+
+
+

The BinderAwareChannelResolver is a general purpose Spring Integration DestinationResolver and can be injected in other components. +For example, in a router using a SpEL expression based on the target field of an incoming JSON message.

+
+
+
+
@EnableBinding
+@Controller
+public class SourceWithDynamicDestination {
+
+	@Autowired
+	private BinderAwareChannelResolver resolver;
+
+
+	@RequestMapping(path = "/", method = POST, consumes = "application/json")
+	@ResponseStatus(HttpStatus.ACCEPTED)
+	public void handleRequest(@RequestBody String body, @RequestHeader(HttpHeaders.CONTENT_TYPE) Object contentType) {
+		sendMessage(body, contentType);
+	}
+
+	private void sendMessage(Object body, Object contentType) {
+		routerChannel().send(MessageBuilder.createMessage(body,
+				new MessageHeaders(Collections.singletonMap(MessageHeaders.CONTENT_TYPE, contentType))));
+	}
+
+	@Bean(name = "routerChannel")
+	public MessageChannel routerChannel() {
+		return new DirectChannel();
+	}
+
+	@Bean
+	@ServiceActivator(inputChannel = "routerChannel")
+	public ExpressionEvaluatingRouter router() {
+        ExpressionEvaluatingRouter router =
+            new ExpressionEvaluatingRouter(new SpelExpressionParser().parseExpression("payload.target"));
+		router.setDefaultOutputChannelName("default-output");
+		router.setChannelResolver(resolver);
+		return router;
+	}
+}
+
+
+
+
+
+
+

Content Type and Transformation

+
+
+

To allow you to propagate information about the content type of produced messages, Spring Cloud Stream attaches, by default, a contentType header to outbound messages. +For middleware that does not directly support headers, Spring Cloud Stream provides its own mechanism of automatically wrapping outbound messages in an envelope of its own. +For middleware that does support headers, Spring Cloud Stream applications may receive messages with a given content type from non-Spring Cloud Stream applications.

+
+
+

Spring Cloud Stream can handle messages based on this information in two ways:

+
+
+
    +
  • +

    Through its contentType settings on inbound and outbound channels

    +
    • +
  • +

    Through its argument mapping performed for methods annotated with @StreamListener

    +
    • +
+
+
+

Spring Cloud Stream allows you to declaratively configure type conversion for inputs and outputs using the spring.cloud.stream.bindings.<channelName>.content-type property of a binding. +Note that general type conversion may also be accomplished easily by using a transformer inside your application. +Currently, Spring Cloud Stream natively supports the following type conversions commonly used in streams:

+
+
+
    +
  • +

    JSON to/from POJO

    +
    • +
  • +

    JSON to/from org.springframework.tuple.Tuple

    +
    • +
  • +

    Object to/from byte[] : Either the raw bytes serialized for remote transport, bytes emitted by an application, or converted to bytes using Java serialization(requires the object to be Serializable)

    +
    • +
  • +

    String to/from byte[]

    +
    • +
  • +

    Object to plain text (invokes the object’s toString() method)

    +
    • +
+
+
+

Where JSON represents either a byte array or String payload containing JSON. +Currently, Objects may be converted from a JSON byte array or String. +Converting to JSON always produces a String.

+
+
+

If no content-type property is set on an outbound channel, Spring Cloud Stream will serialize the payload using a serializer based on the Kryo serialization framework. +Deserializing messages at the destination requires the payload class to be present on the receiver’s classpath.

+
+
+

MIME types

+
+

content-type values are parsed as media types, e.g., application/json or text/plain;charset=UTF-8. +MIME types are especially useful for indicating how to convert to String or byte[] content. +Spring Cloud Stream also uses MIME type format to represent Java types, using the general type application/x-java-object with a type parameter. +For example, application/x-java-object;type=java.util.Map or application/x-java-object;type=com.bar.Foo can be set as the content-type property of an input binding. +In addition, Spring Cloud Stream provides custom MIME types, notably, application/x-spring-tuple to specify a Tuple.

+
+
+
+

MIME types and Java types

+
+

The type conversions Spring Cloud Stream provides out of the box are summarized in the following table: +'Source Payload' means the payload before conversion and 'Target Payload' means the 'payload' after conversion. +The type conversion can occur either on the 'producer' side (output) or at the 'consumer' side (input).

+
+ +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Source PayloadTarget Payloadcontent-type header (source message)content-type header (after conversion)Comments

POJO

JSON String

ignored

application/json

Tuple

JSON String

ignored

application/json

JSON is tailored for Tuple

POJO

String (toString())

ignored

text/plain, java.lang.String

POJO

byte[] (java.io serialized)

ignored

application/x-java-serialized-object

JSON byte[] or String

POJO

application/json (or none)

application/x-java-object

byte[] or String

Serializable

application/x-java-serialized-object

application/x-java-object

JSON byte[] or String

Tuple

application/json (or none)

application/x-spring-tuple

byte[]

String

any

text/plain, java.lang.String

will apply any Charset specified in the content-type header

String

byte[]

any

application/octet-stream

will apply any Charset specified in the content-type header

+
+ + + + + +
+
Note
+		 +
+

Conversion applies to payloads that require type conversion. +For example, if an application produces an XML string with outputType=application/json, the payload will not be converted from XML to JSON. +This is because the payload send to the outbound channel is already a String so no conversion will be applied at runtime. +It is also important to note that when using the default serialization mechanism, the payload class must be shared between the sending and receiving application, and compatible with the binary content. +This can create issues when application code changes independently in the two applications, as the binary format and code may become incompatible.

+
+
+
+
+ + + + + +
+
Tip
+		 +
+

While conversion is supported for both inbound and outbound channels, it is especially recommended to be used for the conversion of outbound messages. +For the conversion of inbound messages, especially when the target is a POJO, the @StreamListener support will perform the conversion automatically.

+
+
+
+
+
+

Customizing message conversion

+
+

Besides the conversions that it supports out of the box, Spring Cloud Stream also supports registering your own message conversion implementations. +This allows you to send and receive data in a variety of custom formats, including binary, and associate them with specific contentTypes. +Spring Cloud Stream registers all the beans of type org.springframework.messaging.converter.MessageConverter as custom message converters along with the out of the box message converters.

+
+
+

If your message converter needs to work with a specific content-type and target class (for both input and output), then the message converter needs to extend org.springframework.messaging.converter.AbstractMessageConverter. +For conversion when using @StreamListener, a message converter that implements org.springframework.messaging.converter.MessageConverter would suffice.

+
+
+

Here is an example of creating a message converter bean (with the content-type application/bar) inside a Spring Cloud Stream application:

+
+
+
+
@EnableBinding(Sink.class)
+@SpringBootApplication
+public static class SinkApplication {
+
+  ...
+
+  @Bean
+  public MessageConverter customMessageConverter() {
+    return new MyCustomMessageConverter();
+  }
+
+
+
+
+
public class MyCustomMessageConverter extends AbstractMessageConverter {
+
+	public MyCustomMessageConverter() {
+		super(new MimeType("application", "bar"));
+	}
+
+	@Override
+  protected boolean supports(Class<?> clazz) {
+    return (Bar.class == clazz);
+  }
+
+	@Override
+	protected Object convertFromInternal(Message<?> message, Class<?> targetClass, Object conversionHint) {
+		Object payload = message.getPayload();
+		return (payload instanceof Bar ? payload : new Bar((byte[]) payload));
+	}
+}
+
+
+
+

Spring Cloud Stream also provides support for Avro-based converters and schema evolution. +See the specific section for details.

+
+
+
+

@StreamListener and Message Conversion

+
+

The @StreamListener annotation provides a convenient way for converting incoming messages without the need to specify the content type of an input channel. +During the dispatching process to methods annotated with @StreamListener, a conversion will be applied automatically if the argument requires it.

+
+
+

For example, let’s consider a message with the String content {"greeting":"Hello, world"} and a content-type header of application/json is received on the input channel. +Let us consider the following application that receives it:

+
+
+
+
public class GreetingMessage {
+
+  String greeting;
+
+  public String getGreeting() {
+    return greeting;
+  }
+
+  public void setGreeting(String greeting) {
+    this.greeting = greeting;
+  }
+}
+
+@EnableBinding(Sink.class)
+@EnableAutoConfiguration
+public static class GreetingSink {
+
+		@StreamListener(Sink.INPUT)
+		public void receive(Greeting greeting) {
+			// handle Greeting
+		}
+	}
+
+
+
+

The argument of the method will be populated automatically with the POJO containing the unmarshalled form of the JSON String.

+
+
+
+
+
+

Schema evolution support

+
+
+

Spring Cloud Stream provides support for schema-based message converters through its spring-cloud-stream-schema module. +Currently, the only serialization format supported out of the box for schema-based message converters is Apache Avro, with more formats to be added in future versions.

+
+
+

Apache Avro Message Converters

+
+

The spring-cloud-stream-schema module contains two types of message converters that can be used for Apache Avro serialization:

+
+
+
    +
  • +

    converters using the class information of the serialized/deserialized objects, or a schema with a location known at startup;

    +
    • +
  • +

    converters using a schema registry - they locate the schemas at runtime, as well as dynamically registering new schemas as domain objects evolve.

    +
    • +
+
+
+
+

Converters with schema support

+
+

The AvroSchemaMessageConverter supports serializing and deserializing messages either using a predefined schema or by using the schema information available in the class (either reflectively, or contained in the SpecificRecord). +If the target type of the conversion is a GenericRecord, then a schema must be set.

+
+
+

For using it, you can simply add it to the application context, optionally specifying one ore more MimeTypes to associate it with. +The default MimeType is application/avro.

+
+
+

Here is an example of configuring it in a sink application registering the Apache Avro MessageConverter, without a predefined schema:

+
+
+
+
@EnableBinding(Sink.class)
+@SpringBootApplication
+public static class SinkApplication {
+
+  ...
+
+  @Bean
+  public MessageConverter userMessageConverter() {
+      return new AvroSchemaMessageConverter(MimeType.valueOf("avro/bytes"));
+  }
+}
+
+
+
+

Conversely, here is an application that registers a converter with a predefined schema, to be found on the classpath:

+
+
+
+
@EnableBinding(Sink.class)
+@SpringBootApplication
+public static class SinkApplication {
+
+  ...
+
+  @Bean
+  public MessageConverter userMessageConverter() {
+      AvroSchemaMessageConverter converter = new AvroSchemaMessageConverter(MimeType.valueOf("avro/bytes"));
+      converter.setSchemaLocation(new ClassPathResource("schemas/User.avro"));
+      return converter;
+  }
+}
+
+
+
+

In order to understand the schema registry client converter, we will describe the schema registry support first.

+
+
+
+

Schema Registry Support

+
+

Most serialization models, especially the ones that aim for portability across different platforms and languages, rely on a schema that describes how the data is serialized in the binary payload. +In order to serialize the data and then to interpret it, both the sending and receiving sides must have access to a schema that describes the binary format. +In certain cases, the schema can be inferred from the payload type on serialization, or from the target type on deserialization, but in a lot of cases applications benefit from having access to an explicit schema that describes the binary data format. +A schema registry allows you to store schema information in a textual format (typically JSON) and makes that information accessible to various applications that need it to receive and send data in binary format. +A schema is referenceable as a tuple consisting of:

+
+
+
    +
  • +

    a subject that is the logical name of the schema;

    +
    • +
  • +

    the schema version;

    +
    • +
  • +

    the schema format which describes the binary format of the data.

    +
    • +
+
+
+
+

Schema Registry Server

+
+

Spring Cloud Stream provides a schema registry server implementation. +In order to use it, you can simply add the spring-cloud-stream-schema-server artifact to your project and use the @EnableSchemaRegistryServer annotation, adding the schema registry server REST controller to your application. +This annotation is intended to be used with Spring Boot web applications, and the listening port of the server is controlled by the server.port setting. +The spring.cloud.stream.schema.server.path setting can be used to control the root path of the schema server (especially when it is embedded in other applications). +The spring.cloud.stream.schema.server.allowSchemaDeletion boolean setting enables the deletion of schema. By default this is disabled.

+
+
+

The schema registry server uses a relational database to store the schemas. + By default, it uses an embedded database. +You can customize the schema storage using the Spring Boot SQL database and JDBC configuration options.

+
+
+

A Spring Boot application enabling the schema registry looks as follows:

+
+
+
+
@SpringBootApplication
+@EnableSchemaRegistryServer
+public class SchemaRegistryServerApplication {
+	public static void main(String[] args) {
+		SpringApplication.run(SchemaRegistryServerApplication.class, args);
+	}
+}
+
+
+
+

Schema Registry Server API

+
+

The Schema Registry Server API consists of the following operations:

+
+
+
POST /
+
+

Register a new schema.

+
+
+

Accepts JSON payload with the following fields:

+
+
+
    +
  • +

    subject the schema subject;

    +
    • +
  • +

    format the schema format;

    +
    • +
  • +

    definition the schema definition.

    +
    • +
+
+
+

Response is a schema object in JSON format, with the following fields:

+
+
+
    +
  • +

    id the schema id;

    +
    • +
  • +

    subject the schema subject;

    +
    • +
  • +

    format the schema format;

    +
    • +
  • +

    version the schema version;

    +
    • +
  • +

    definition the schema definition.

    +
    • +
+
+
+
+
GET /{subject}/{format}/{version}
+
+

Retrieve an existing schema by its subject, format and version.

+
+
+

Response is a schema object in JSON format, with the following fields:

+
+
+
    +
  • +

    id the schema id;

    +
    • +
  • +

    subject the schema subject;

    +
    • +
  • +

    format the schema format;

    +
    • +
  • +

    version the schema version;

    +
    • +
  • +

    definition the schema definition.

    +
    • +
+
+
+
+
GET /{subject}/{format}
+
+

Retrieve a list of existing schema by its subject and format.

+
+
+

Response is a list of schemas with each schema object in JSON format, with the following fields:

+
+
+
    +
  • +

    id the schema id;

    +
    • +
  • +

    subject the schema subject;

    +
    • +
  • +

    format the schema format;

    +
    • +
  • +

    version the schema version;

    +
    • +
  • +

    definition the schema definition.

    +
    • +
+
+
+
+
GET /schemas/{id}
+
+

Retrieve an existing schema by its id.

+
+
+

Response is a schema object in JSON format, with the following fields:

+
+
+
    +
  • +

    id the schema id;

    +
    • +
  • +

    subject the schema subject;

    +
    • +
  • +

    format the schema format;

    +
    • +
  • +

    version the schema version;

    +
    • +
  • +

    definition the schema definition.

    +
    • +
+
+
+
+
DELETE /{subject}/{format}/{version}
+
+

Delete an existing schema by its subject, format and version.

+
+
+
+
DELETE /schemas/{id}
+
+

Delete an existing schema by its id.

+
+
+
+
DELETE /{subject}
+
+

Delete existing schemas by their subject.

+
+
+ + + + + +
+
Note
+		 +
+

This note applies to users of Spring Cloud Stream 1.1.0.RELEASE only. +Spring Cloud Stream 1.1.0.RELEASE used the table name schema for storing Schema objects, which is a keyword in a number of database implementations. +To avoid any conflicts in the future, starting with 1.1.1.RELEASE we have opted for the name SCHEMA_REPOSITORY for the storage table. +Any Spring Cloud Stream 1.1.0.RELEASE users that are upgrading are advised to migrate their existing schemas to the new table before upgrading.

+
+
+
+
+
+
+
+

Schema Registry Client

+
+

The client-side abstraction for interacting with schema registry servers is the SchemaRegistryClient interface, with the following structure:

+
+
+
+
public interface SchemaRegistryClient {
+
+	SchemaRegistrationResponse register(String subject, String format, String schema);
+
+	String fetch(SchemaReference schemaReference);
+
+	String fetch(Integer id);
+
+}
+
+
+
+

Spring Cloud Stream provides out of the box implementations for interacting with its own schema server, as well as for interacting with the Confluent Schema Registry.

+
+
+

A client for the Spring Cloud Stream schema registry can be configured using the @EnableSchemaRegistryClient as follows:

+
+
+
+
  @EnableBinding(Sink.class)
+  @SpringBootApplication
+  @EnableSchemaRegistryClient
+  public static class AvroSinkApplication {
+    ...
+  }
+
+
+
+ + + + + +
+
Note
+		 +
+

The default converter is optimized to cache not only the schemas from the remote server but also the parse() and toString() methods that are quite expensive. +Because of this, it uses a DefaultSchemaRegistryClient that does not caches responses. +If you intend to use the client directly on your code, you can request a bean that also caches responses to be created. +To do that, just add the property spring.cloud.stream.schemaRegistryClient.cached=true to your application properties.

+
+
+
+
+

Using Confluent’s Schema Registry

+
+

The default configuration will create a DefaultSchemaRegistryClient bean. +If you want to use the Confluent schema registry, you need to create a bean of type ConfluentSchemaRegistryClient, which will supersede the one configured by default by the framework.

+
+
+
+
@Bean
+public SchemaRegistryClient schemaRegistryClient(@Value("${spring.cloud.stream.schemaRegistryClient.endpoint}") String endpoint){
+  ConfluentSchemaRegistryClient client = new ConfluentSchemaRegistryClient();
+  client.setEndpoint(endpoint);
+  return client;
+}
+
+
+
+ + + + + +
+
Note
+		 +
+

The ConfluentSchemaRegistryClient is tested against Confluent platform version 3.2.2.

+
+
+
+
+
+

Schema Registry Client properties

+
+

The Schema Registry Client supports the following properties:

+
+
+
+
spring.cloud.stream.schemaRegistryClient.endpoint
+
+

The location of the schema-server. +Use a full URL when setting this, including protocol (http or https) , port and context path.

+
+
Default
+
+

http://localhost:8990/

+
+
spring.cloud.stream.schemaRegistryClient.cached
+
+

Whether the client should cache schema server responses. +Normally set to false, as the caching happens in the message converter. +Clients using the schema registry client should set this to true.

+
+
Default
+
+

true

+
+
+
+
+
+
+

Avro Schema Registry Client Message Converters

+
+

For Spring Boot applications that have a SchemaRegistryClient bean registered with the application context, Spring Cloud Stream will auto-configure an Apache Avro message converter that uses the schema registry client for schema management. +This eases schema evolution, as applications that receive messages can get easy access to a writer schema that can be reconciled with their own reader schema.

+
+
+

For outbound messages, the MessageConverter will be activated if the content type of the channel is set to application/*+avro, e.g.:

+
+
+
+
spring.cloud.stream.bindings.output.contentType=application/*+avro
+
+
+
+

During the outbound conversion, the message converter will try to infer the schemas of the outbound messages based on their type and register them to a subject based on the payload type using the SchemaRegistryClient. +If an identical schema is already found, then a reference to it will be retrieved. +If not, the schema will be registered and a new version number will be provided. +The message will be sent with a contentType header using the scheme application/[prefix].[subject].v[version]+avro, where prefix is configurable and subject is deduced from the payload type.

+
+
+

For example, a message of the type User may be sent as a binary payload with a content type of application/vnd.user.v2+avro, where user is the subject and 2 is the version number.

+
+
+

When receiving messages, the converter will infer the schema reference from the header of the incoming message and will try to retrieve it. The schema will be used as the writer schema in the deserialization process.

+
+
+

Avro Schema Registry Message Converter properties

+
+

If you have enabled Avro based schema registry client by setting spring.cloud.stream.bindings.output.contentType=application/*+avro you can customize the behavior of the registration with the following properties.

+
+
+
+
spring.cloud.stream.schema.avro.dynamicSchemaGenerationEnabled
+
+

Enable if you want the converter to use reflection to infer a Schema from a POJO.

+
+
Default
+
+

false

+
+
spring.cloud.stream.schema.avro.readerSchema
+
+

Avro compares schema versions by looking at a writer schema (origin payload) and a reader schema (your application payload), check Avro documentation for more information. If set, this overrides any lookups at the schema server and uses the local schema as the reader schema.

+
+
Default
+
+

null

+
+
spring.cloud.stream.schema.avro.schemaLocations
+
+

Register any .avsc files listed in this property with the Schema Server.

+
+
Default
+
+

empty

+
+
spring.cloud.stream.schema.avro.prefix
+
+

The prefix to be used on the Content-Type header.

+
+
Default
+
+

vnd

+
+
+
+
+
+
+

Schema Registration and Resolution

+
+

To better understand how Spring Cloud Stream registers and resolves new schemas, as well as its use of Avro schema comparison features, we will provide two separate subsections below: one for the registration, and one for the resolution of schemas.

+
+
+

Schema Registration Process (Serialization)

+
+

The first part of the registration process is extracting a schema from the payload that is being sent over a channel. +Avro types such as SpecificRecord or GenericRecord already contain a schema, which can be retrieved immediately from the instance. +In the case of POJOs a schema will be inferred if the property spring.cloud.stream.schema.avro.dynamicSchemaGenerationEnabled is set to true (the default).

+
+
+
+schema resolution +
+
Figure 10. Schema Writer Resolution Process
+
+
+

Once a schema is obtained, the converter will then load its metadata (version) from the remote server. +First it queries a local cache, and if not found it then submits the data to the server that will reply with versioning information. +The converter will always cache the results to avoid the overhead of querying the Schema Server for every new message that needs to be serialized.

+
+
+
+registration +
+
Figure 11. Schema Registration Process
+
+
+

With the schema version information, the converter sets the contentType header of the message to carry the version information such as application/vnd.user.v1+avro

+
+
+
+

Schema Resolution Process (Deserialization)

+
+

When reading messages that contain version information (i.e. a contentType header with a scheme like above), the converter will query the Schema server to fetch the writer schema of the message. +Once it has found the correct schema of the incoming message, it then retrieves the reader schema and using Avro’s schema resolution support reads it into the reader definition (setting defaults and missing properties).

+
+
+
+schema reading +
+
Figure 12. Schema Reading Resolution Process
+
+
+ + + + + +
+
Note
+		 +
+

It’s important to understand the difference between a writer schema (the application that wrote the message) and a reader schema (the receiving application). +Please take a moment to read the Avro terminology and understand the process. +Spring Cloud Stream will always fetch the writer schema to determine how to read a message. If you want to get Avro’s schema evolution support working you need to make sure that a readerSchema was properly set for your application.

+
+
+
+
+
+
+
+
+

Inter-Application Communication

+
+
+

Connecting Multiple Application Instances

+
+

While Spring Cloud Stream makes it easy for individual Spring Boot applications to connect to messaging systems, the typical scenario for Spring Cloud Stream is the creation of multi-application pipelines, where microservice applications send data to each other. +You can achieve this scenario by correlating the input and output destinations of adjacent applications.

+
+
+

Supposing that a design calls for the Time Source application to send data to the Log Sink application, you can use a common destination named ticktock for bindings within both applications.

+
+
+

Time Source (that has the channel name output) will set the following property:

+
+
+
+
spring.cloud.stream.bindings.output.destination=ticktock
+
+
+
+

Log Sink (that has the channel name input) will set the following property:

+
+
+
+
spring.cloud.stream.bindings.input.destination=ticktock
+
+
+
+
+

Instance Index and Instance Count

+
+

When scaling up Spring Cloud Stream applications, each instance can receive information about how many other instances of the same application exist and what its own instance index is. +Spring Cloud Stream does this through the spring.cloud.stream.instanceCount and spring.cloud.stream.instanceIndex properties. +For example, if there are three instances of a HDFS sink application, all three instances will have spring.cloud.stream.instanceCount set to 3, and the individual applications will have spring.cloud.stream.instanceIndex set to 0, 1, and 2, respectively.

+
+
+

When Spring Cloud Stream applications are deployed via Spring Cloud Data Flow, these properties are configured automatically; when Spring Cloud Stream applications are launched independently, these properties must be set correctly. +By default, spring.cloud.stream.instanceCount is 1, and spring.cloud.stream.instanceIndex is 0.

+
+
+

In a scaled-up scenario, correct configuration of these two properties is important for addressing partitioning behavior (see below) in general, and the two properties are always required by certain binders (e.g., the Kafka binder) in order to ensure that data are split correctly across multiple consumer instances.

+
+
+
+

Partitioning

+
+

Configuring Output Bindings for Partitioning

+
+

An output binding is configured to send partitioned data by setting one and only one of its partitionKeyExpression or partitionKeyExtractorClass properties, as well as its partitionCount property. +For example, the following is a valid and typical configuration:

+
+
+
+
spring.cloud.stream.bindings.output.producer.partitionKeyExpression=payload.id
+spring.cloud.stream.bindings.output.producer.partitionCount=5
+
+
+
+

Based on the above example configuration, data will be sent to the target partition using the following logic.

+
+
+

A partition key’s value is calculated for each message sent to a partitioned output channel based on the partitionKeyExpression. +The partitionKeyExpression is a SpEL expression which is evaluated against the outbound message for extracting the partitioning key.

+
+
+

If a SpEL expression is not sufficient for your needs, you can instead calculate the partition key value by setting the property partitionKeyExtractorClass to a class which implements the org.springframework.cloud.stream.binder.PartitionKeyExtractorStrategy interface. +While the SpEL expression should usually suffice, more complex cases may use the custom implementation strategy. +In that case, the property 'partitionKeyExtractorClass' can be set as follows:

+
+
+
+
spring.cloud.stream.bindings.output.producer.partitionKeyExtractorClass=com.example.MyKeyExtractor
+spring.cloud.stream.bindings.output.producer.partitionCount=5
+
+
+
+

Once the message key is calculated, the partition selection process will determine the target partition as a value between 0 and partitionCount - 1. +The default calculation, applicable in most scenarios, is based on the formula key.hashCode() % partitionCount. +This can be customized on the binding, either by setting a SpEL expression to be evaluated against the 'key' (via the partitionSelectorExpression property) or by setting a org.springframework.cloud.stream.binder.PartitionSelectorStrategy implementation (via the partitionSelectorClass property).

+
+
+

The binding level properties for 'partitionSelectorExpression' and 'partitionSelectorClass' can be specified similar to the way 'partitionKeyExpression' and 'partitionKeyExtractorClass' properties are specified in the above examples. +Additional properties can be configured for more advanced scenarios, as described in the following section.

+
+
+
Spring-managed custom PartitionKeyExtractorClass implementations
+
+

In the example above, a custom strategy such as MyKeyExtractor is instantiated by the Spring Cloud Stream directly. +In some cases, it is necessary for such a custom strategy implementation to be created as a Spring bean, for being able to be managed by Spring, so that it can perform dependency injection, property binding, etc. +This can be done by configuring it as a @Bean in the application context and using the fully qualified class name as the bean’s name, as in the following example.

+
+
+
+
@Bean(name="com.example.MyKeyExtractor")
+public MyKeyExtractor extractor() {
+    return new MyKeyExtractor();
+}
+
+
+
+

As a Spring bean, the custom strategy benefits from the full lifecycle of a Spring bean. +For example, if the implementation need access to the application context directly, it can make implement 'ApplicationContextAware'.

+
+
+
+
Configuring Input Bindings for Partitioning
+
+

An input binding (with the channel name input) is configured to receive partitioned data by setting its partitioned property, as well as the instanceIndex and instanceCount properties on the application itself, as in the following example:

+
+
+
+
spring.cloud.stream.bindings.input.consumer.partitioned=true
+spring.cloud.stream.instanceIndex=3
+spring.cloud.stream.instanceCount=5
+
+
+
+

The instanceCount value represents the total number of application instances between which the data need to be partitioned, and the instanceIndex must be a unique value across the multiple instances, between 0 and instanceCount - 1. +The instance index helps each application instance to identify the unique partition (or, in the case of Kafka, the partition set) from which it receives data. +It is important to set both values correctly in order to ensure that all of the data is consumed and that the application instances receive mutually exclusive datasets.

+
+
+

While a scenario which using multiple instances for partitioned data processing may be complex to set up in a standalone case, Spring Cloud Dataflow can simplify the process significantly by populating both the input and output values correctly as well as relying on the runtime infrastructure to provide information about the instance index and instance count.

+
+
+
+
+
+
+
+

Testing

+
+
+

Spring Cloud Stream provides support for testing your microservice applications without connecting to a messaging system. +You can do that by using the TestSupportBinder provided by the spring-cloud-stream-test-support library, which can be added as a test dependency to the application:

+
+
+
+
   <dependency>
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-stream-test-support</artifactId>
+       <scope>test</scope>
+   </dependency>
+
+
+
+ + + + + +
+
Note
+		 +
+

The TestSupportBinder uses the Spring Boot autoconfiguration mechanism to supersede the other binders found on the classpath. +Therefore, when adding a binder as a dependency, make sure that the test scope is being used.

+
+
+
+
+

The TestSupportBinder allows users to interact with the bound channels and inspect what messages are sent and received by the application

+
+
+

For outbound message channels, the TestSupportBinder registers a single subscriber and retains the messages emitted by the application in a MessageCollector. +They can be retrieved during tests and have assertions made against them.

+
+
+

The user can also send messages to inbound message channels, so that the consumer application can consume the messages. +The following example shows how to test both input and output channels on a processor.

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment= SpringBootTest.WebEnvironment.RANDOM_PORT)
+public class ExampleTest {
+
+  @Autowired
+  private Processor processor;
+
+  @Autowired
+  private MessageCollector messageCollector;
+
+  @Test
+  @SuppressWarnings("unchecked")
+  public void testWiring() {
+    Message<String> message = new GenericMessage<>("hello");
+    processor.input().send(message);
+    Message<String> received = (Message<String>) messageCollector.forChannel(processor.output()).poll();
+    assertThat(received.getPayload(), equalTo("hello world"));
+  }
+
+
+  @SpringBootApplication
+  @EnableBinding(Processor.class)
+  public static class MyProcessor {
+
+    @Autowired
+    private Processor channels;
+
+    @Transformer(inputChannel = Processor.INPUT, outputChannel = Processor.OUTPUT)
+    public String transform(String in) {
+      return in + " world";
+    }
+  }
+}
+
+
+
+

In the example above, we are creating an application that has an input and an output channel, bound through the Processor interface. +The bound interface is injected into the test so we can have access to both channels. +We are sending a message on the input channel and we are using the MessageCollector provided by Spring Cloud Stream’s test support to capture the message has been sent to the output channel as a result. +Once we have received the message, we can validate that the component functions correctly.

+
+
+

Disabling the test binder autoconfiguration

+
+

The intent behind the test binder superseding all the other binders on the classpath is to make it easy to test your applications without making changes to your production dependencies. +In some cases (e.g. integration tests) it is useful to use the actual production binders instead, and that requires disabling the test binder autoconfiguration. +In order to do so, you can exclude the org.springframework.cloud.stream.test.binder.TestSupportBinderAutoConfiguration class using one of the Spring Boot autoconfiguration exclusion mechanisms, as in the following example.

+
+
+
+
	@SpringBootApplication(exclude = TestSupportBinderAutoConfiguration.class)
+	@EnableBinding(Processor.class)
+	public static class MyProcessor {
+
+		@Transformer(inputChannel = Processor.INPUT, outputChannel = Processor.OUTPUT)
+		public String transform(String in) {
+			return in + " world";
+		}
+	}
+
+
+
+

When autoconfiguration is disabled, the test binder is available on the classpath, and its defaultCandidate property is set to false, so that it does not interfere with the regular user configuration. It can be referenced under the name test e.g.:

+
+
+
+
spring.cloud.stream.defaultBinder=test
+
+
+
+
+
+
+

Health Indicator

+
+
+

Spring Cloud Stream provides a health indicator for binders. +It is registered under the name of binders and can be enabled or disabled by setting the management.health.binders.enabled property.

+
+
+
+
+

Metrics Emitter

+
+
+

Spring Cloud Stream provides a module called spring-cloud-stream-metrics that can be used to emit any available metric from Spring Boot metrics endpoint to a named channel. +This module allow operators to collect metrics from stream applications without relying on polling their endpoints.

+
+
+

The module is activated when you set the destination name for metrics binding, e.g. spring.cloud.stream.bindings.applicationMetrics.destination=<DESTINATION_NAME>. +applicationMetrics can be configured in a similar fashion to any other producer binding. +The default contentType setting of applicationMetrics is application/json.

+
+
+

The following properties can be used for customizing the emission of metrics:

+
+
+
+
spring.cloud.stream.metrics.key
+
+

The name of the metric being emitted. Should be an unique value per application.

+
+
Default
+
+

${spring.application.name:${vcap.application.name:${spring.config.name:application}}}

+
+
spring.cloud.stream.metrics.prefix
+
+

Prefix string to be prepended to the metrics key.

+
+

Default: ``

+
+
+
spring.cloud.stream.metrics.properties
+
+

Just like the includes option, it allows white listing application properties that will be added to the metrics payload

+
+

Default: null.

+
+
+
+
+
+

A detailed overview of the metrics export process can be found in the Spring Boot reference documentation. +Spring Cloud Stream provides a metric exporter named application that can be configured via regular Spring Boot metrics configuration properties.

+
+
+

The exporter can be configured either by using the global Spring Boot configuration settings for exporters, or by using exporter-specific properties. +For using the global configuration settings, the properties should be prefixed by spring.metric.export (e.g. spring.metric.export.includes=integration**). +These configuration options will apply to all exporters (unless they have been configured differently). +Alternatively, if it is intended to use configuration settings that are different from the other exporters (e.g. for restricting the number of metrics published), the Spring Cloud Stream provided metrics exporter can be configured using the prefix spring.metrics.export.triggers.application (e.g. spring.metrics.export.triggers.application.includes=integration**).

+
+
+ + + + + +
+
Note
+		 +
+

Due to Spring Boot’s relaxed binding the value of a property being included can be slightly different than the original value.

+
+
+

As a rule of thumb, the metric exporter will attempt to normalize all the properties in a consistent format using the dot notation (e.g. JAVA_HOME becomes java.home).

+
+
+

The goal of normalization is to make downstream consumers of those metrics capable of receiving property names consistently, regardless of how they are set on the monitored application (--spring.application.name or SPRING_APPLICATION_NAME would always yield spring.application.name).

+
+
+
+
+

Below is a sample of the data published to the channel in JSON format by the following command:

+
+
+
+
java -jar time-source.jar \
+    --spring.cloud.stream.bindings.applicationMetrics.destination=someMetrics \
+    --spring.cloud.stream.metrics.properties=spring.application** \
+    --spring.metrics.export.includes=integration.channel.input**,integration.channel.output**
+
+
+
+

The resulting JSON is:

+
+
+
+
{
+   "name":"time-source",
+   "metrics":[
+      {
+         "name":"integration.channel.output.errorRate.mean",
+         "value":0.0,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.errorRate.max",
+         "value":0.0,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.errorRate.min",
+         "value":0.0,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.errorRate.stdev",
+         "value":0.0,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.errorRate.count",
+         "value":0.0,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.sendCount",
+         "value":6.0,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.sendRate.mean",
+         "value":0.994885872292989,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.sendRate.max",
+         "value":1.006247080013156,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.sendRate.min",
+         "value":1.0012035220116378,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.sendRate.stdev",
+         "value":6.505181111084848E-4,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      },
+      {
+         "name":"integration.channel.output.sendRate.count",
+         "value":6.0,
+         "timestamp":"2017-04-11T16:56:35.790Z"
+      }
+   ],
+   "createdTime":"2017-04-11T20:56:35.790Z",
+   "properties":{
+      "spring.application.name":"time-source",
+      "spring.application.index":"0"
+   }
+}
+
+
+
+
+
+

Samples

+
+
+

For Spring Cloud Stream samples, please refer to the spring-cloud-stream-samples repository on GitHub.

+
+
+
+
+

Getting Started

+
+
+

To get started with creating Spring Cloud Stream applications, visit the Spring Initializr and create a new Maven project named "GreetingSource". +Select Spring Boot {supported-spring-boot-version} in the dropdown. +In the Search for dependencies text box type Stream Rabbit or Stream Kafka depending on what binder you want to use.

+
+
+

Next, create a new class, GreetingSource, in the same package as the GreetingSourceApplication class. +Give it the following code:

+
+
+
+
import org.springframework.cloud.stream.annotation.EnableBinding;
+import org.springframework.cloud.stream.messaging.Source;
+import org.springframework.integration.annotation.InboundChannelAdapter;
+
+@EnableBinding(Source.class)
+public class GreetingSource {
+
+    @InboundChannelAdapter(Source.OUTPUT)
+    public String greet() {
+        return "hello world " + System.currentTimeMillis();
+    }
+}
+
+
+
+

The @EnableBinding annotation is what triggers the creation of Spring Integration infrastructure components. +Specifically, it will create a Kafka connection factory, a Kafka outbound channel adapter, and the message channel defined inside the Source interface:

+
+
+
+
public interface Source {
+
+  String OUTPUT = "output";
+
+  @Output(Source.OUTPUT)
+  MessageChannel output();
+
+}
+
+
+
+

The auto-configuration also creates a default poller, so that the greet() method will be invoked once per second. +The standard Spring Integration @InboundChannelAdapter annotation sends a message to the source’s output channel, using the return value as the payload of the message.

+
+
+

To test-drive this setup, run a Kafka message broker. +An easy way to do this is to use a Docker image:

+
+
+
+
# On OS X
+$ docker run -p 2181:2181 -p 9092:9092 --env ADVERTISED_HOST=`docker-machine ip \`docker-machine active\`` --env ADVERTISED_PORT=9092 spotify/kafka
+
+# On Linux
+$ docker run -p 2181:2181 -p 9092:9092 --env ADVERTISED_HOST=localhost --env ADVERTISED_PORT=9092 spotify/kafka
+
+
+
+

Build the application:

+
+
+
+
./mvnw clean package
+
+
+
+

The consumer application is coded in a similar manner. +Go back to Initializr and create another project, named LoggingSink. +Then create a new class, LoggingSink, in the same package as the class LoggingSinkApplication and with the following code:

+
+
+
+
import org.springframework.cloud.stream.annotation.EnableBinding;
+import org.springframework.cloud.stream.annotation.StreamListener;
+import org.springframework.cloud.stream.messaging.Sink;
+
+@EnableBinding(Sink.class)
+public class LoggingSink {
+
+    @StreamListener(Sink.INPUT)
+    public void log(String message) {
+        System.out.println(message);
+    }
+}
+
+
+
+

Build the application:

+
+
+
+
./mvnw clean package
+
+
+
+

To connect the GreetingSource application to the LoggingSink application, each application must share the same destination name. +Starting up both applications as shown below, you will see the consumer application printing "hello world" and a timestamp to the console:

+
+
+
+
cd GreetingSource
+java -jar target/GreetingSource-0.0.1-SNAPSHOT.jar --spring.cloud.stream.bindings.output.destination=mydest
+
+cd LoggingSink
+java -jar target/LoggingSink-0.0.1-SNAPSHOT.jar --server.port=8090 --spring.cloud.stream.bindings.input.destination=mydest
+
+
+
+

(The different server port prevents collisions of the HTTP port used to service the Spring Boot Actuator endpoints in the two applications.)

+
+
+

The output of the LoggingSink application will look something like the following:

+
+
+
+
[           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8090 (http)
+[           main] com.example.LoggingSinkApplication       : Started LoggingSinkApplication in 6.828 seconds (JVM running for 7.371)
+hello world 1458595076731
+hello world 1458595077732
+hello world 1458595078733
+hello world 1458595079734
+hello world 1458595080735
+
+
+
+
+

Binder Implementations

+
+

Apache Kafka Binder

+
+ +
+

Usage

+
+

For using the Apache Kafka binder, you just need to add it to your Spring Cloud Stream application, using the following Maven coordinates:

+
+
+
+
<dependency>
+  <groupId>org.springframework.cloud</groupId>
+  <artifactId>spring-cloud-stream-binder-kafka</artifactId>
+</dependency>
+
+
+
+

Alternatively, you can also use the Spring Cloud Stream Kafka Starter.

+
+
+
+
<dependency>
+  <groupId>org.springframework.cloud</groupId>
+  <artifactId>spring-cloud-starter-stream-kafka</artifactId>
+</dependency>
+
+
+
+
+

Apache Kafka Binder Overview

+
+

A simplified diagram of how the Apache Kafka binder operates can be seen below.

+
+
+
+kafka binder +
+
Figure 13. Kafka Binder
+
+
+

The Apache Kafka Binder implementation maps each destination to an Apache Kafka topic. +The consumer group maps directly to the same Apache Kafka concept. +Partitioning also maps directly to Apache Kafka partitions as well.

+
+
+
+

Configuration Options

+
+

This section contains the configuration options used by the Apache Kafka binder.

+
+
+

For common configuration options and properties pertaining to binder, refer to the core documentation.

+
+
+

Kafka Binder Properties

+
+
+
spring.cloud.stream.kafka.binder.brokers
+
+

A list of brokers to which the Kafka binder will connect.

+
+

Default: localhost.

+
+
+
spring.cloud.stream.kafka.binder.defaultBrokerPort
+
+

brokers allows hosts specified with or without port information (e.g., host1,host2:port2). +This sets the default port when no port is configured in the broker list.

+
+

Default: 9092.

+
+
+
spring.cloud.stream.kafka.binder.zkNodes
+
+

A list of ZooKeeper nodes to which the Kafka binder can connect.

+
+

Default: localhost.

+
+
+
spring.cloud.stream.kafka.binder.defaultZkPort
+
+

zkNodes allows hosts specified with or without port information (e.g., host1,host2:port2). +This sets the default port when no port is configured in the node list.

+
+

Default: 2181.

+
+
+
spring.cloud.stream.kafka.binder.configuration
+
+

Key/Value map of client properties (both producers and consumer) passed to all clients created by the binder. +Due to the fact that these properties will be used by both producers and consumers, usage should be restricted to common properties, especially security settings.

+
+

Default: Empty map.

+
+
+
spring.cloud.stream.kafka.binder.headers
+
+

The list of custom headers that will be transported by the binder.

+
+

Default: empty.

+
+
+
spring.cloud.stream.kafka.binder.offsetUpdateTimeWindow
+
+

The frequency, in milliseconds, with which offsets are saved. +Ignored if 0.

+
+

Default: 10000.

+
+
+
spring.cloud.stream.kafka.binder.offsetUpdateCount
+
+

The frequency, in number of updates, which which consumed offsets are persisted. +Ignored if 0. +Mutually exclusive with offsetUpdateTimeWindow.

+
+

Default: 0.

+
+
+
spring.cloud.stream.kafka.binder.requiredAcks
+
+

The number of required acks on the broker.

+
+

Default: 1.

+
+
+
spring.cloud.stream.kafka.binder.minPartitionCount
+
+

Effective only if autoCreateTopics or autoAddPartitions is set. +The global minimum number of partitions that the binder will configure on topics on which it produces/consumes data. +It can be superseded by the partitionCount setting of the producer or by the value of instanceCount * concurrency settings of the producer (if either is larger).

+
+

Default: 1.

+
+
+
spring.cloud.stream.kafka.binder.replicationFactor
+
+

The replication factor of auto-created topics if autoCreateTopics is active.

+
+

Default: 1.

+
+
+
spring.cloud.stream.kafka.binder.autoCreateTopics
+
+

If set to true, the binder will create new topics automatically. +If set to false, the binder will rely on the topics being already configured. +In the latter case, if the topics do not exist, the binder will fail to start. +Of note, this setting is independent of the auto.topic.create.enable setting of the broker and it does not influence it: if the server is set to auto-create topics, they may be created as part of the metadata retrieval request, with default broker settings.

+
+

Default: true.

+
+
+
spring.cloud.stream.kafka.binder.autoAddPartitions
+
+

If set to true, the binder will create add new partitions if required. +If set to false, the binder will rely on the partition size of the topic being already configured. +If the partition count of the target topic is smaller than the expected value, the binder will fail to start.

+
+

Default: false.

+
+
+
spring.cloud.stream.kafka.binder.socketBufferSize
+
+

Size (in bytes) of the socket buffer to be used by the Kafka consumers.

+
+

Default: 2097152.

+
+
+
+
+
+
+

Kafka Consumer Properties

+
+

The following properties are available for Kafka consumers only and +must be prefixed with spring.cloud.stream.kafka.bindings.<channelName>.consumer..

+
+
+
+
autoRebalanceEnabled
+
+

When true, topic partitions will be automatically rebalanced between the members of a consumer group. +When false, each consumer will be assigned a fixed set of partitions based on spring.cloud.stream.instanceCount and spring.cloud.stream.instanceIndex. +This requires both spring.cloud.stream.instanceCount and spring.cloud.stream.instanceIndex properties to be set appropriately on each launched instance. +The property spring.cloud.stream.instanceCount must typically be greater than 1 in this case.

+
+

Default: true.

+
+
+
autoCommitOffset
+
+

Whether to autocommit offsets when a message has been processed. +If set to false, a header with the key kafka_acknowledgment of the type org.springframework.kafka.support.Acknowledgment header will be present in the inbound message. +Applications may use this header for acknowledging messages. +See the examples section for details. +When this property is set to false, Kafka binder will set the ack mode to org.springframework.kafka.listener.AbstractMessageListenerContainer.AckMode.MANUAL.

+
+

Default: true.

+
+
+
autoCommitOnError
+
+

Effective only if autoCommitOffset is set to true. +If set to false it suppresses auto-commits for messages that result in errors, and will commit only for successful messages, allows a stream to automatically replay from the last successfully processed message, in case of persistent failures. +If set to true, it will always auto-commit (if auto-commit is enabled). +If not set (default), it effectively has the same value as enableDlq, auto-committing erroneous messages if they are sent to a DLQ, and not committing them otherwise.

+
+

Default: not set.

+
+
+
recoveryInterval
+
+

The interval between connection recovery attempts, in milliseconds.

+
+

Default: 5000.

+
+
+
startOffset
+
+

The starting offset for new groups. +Allowed values: earliest, latest. +If the consumer group is set explicitly for the consumer 'binding' (via spring.cloud.stream.bindings.<channelName>.group), then 'startOffset' is set to earliest; otherwise it is set to latest for the anonymous consumer group.

+
+

Default: null (equivalent to earliest).

+
+
+
enableDlq
+
+

When set to true, it will send enable DLQ behavior for the consumer. +By default, messages that result in errors will be forwarded to a topic named error.<destination>.<group>. +The DLQ topic name can be configurable via the property dlqName. +This provides an alternative option to the more common Kafka replay scenario for the case when the number of errors is relatively small and replaying the entire original topic may be too cumbersome.

+
+

Default: false.

+
+
+
configuration
+
+

Map with a key/value pair containing generic Kafka consumer properties.

+
+

Default: Empty map.

+
+
+
dlqName
+
+

The name of the DLQ topic to receive the error messages.

+
+

Default: null (If not specified, messages that result in errors will be forwarded to a topic named error.<destination>.<group>).

+
+
+
+
+
+
+

Kafka Producer Properties

+
+

The following properties are available for Kafka producers only and +must be prefixed with spring.cloud.stream.kafka.bindings.<channelName>.producer..

+
+
+
+
bufferSize
+
+

Upper limit, in bytes, of how much data the Kafka producer will attempt to batch before sending.

+
+

Default: 16384.

+
+
+
sync
+
+

Whether the producer is synchronous.

+
+

Default: false.

+
+
+
batchTimeout
+
+

How long the producer will wait before sending in order to allow more messages to accumulate in the same batch. +(Normally the producer does not wait at all, and simply sends all the messages that accumulated while the previous send was in progress.) A non-zero value may increase throughput at the expense of latency.

+
+

Default: 0.

+
+
+
messageKeyExpression
+
+

A SpEL expression evaluated against the outgoing message used to populate the key of the produced Kafka message. +For example headers.key or payload.myKey.

+
+

Default: none.

+
+
+
configuration
+
+

Map with a key/value pair containing generic Kafka producer properties.

+
+

Default: Empty map.

+
+
+
+
+
+ + + + + +
+
Note
+		 +
+

The Kafka binder will use the partitionCount setting of the producer as a hint to create a topic with the given partition count (in conjunction with the minPartitionCount, the maximum of the two being the value being used). +Exercise caution when configuring both minPartitionCount for a binder and partitionCount for an application, as the larger value will be used. +If a topic already exists with a smaller partition count and autoAddPartitions is disabled (the default), then the binder will fail to start. +If a topic already exists with a smaller partition count and autoAddPartitions is enabled, new partitions will be added. +If a topic already exists with a larger number of partitions than the maximum of (minPartitionCount and partitionCount), the existing partition count will be used.

+
+
+
+
+
+

Usage examples

+
+

In this section, we illustrate the use of the above properties for specific scenarios.

+
+
+
Example: Setting autoCommitOffset false and relying on manual acking.
+
+

This example illustrates how one may manually acknowledge offsets in a consumer application.

+
+
+

This example requires that spring.cloud.stream.kafka.bindings.input.consumer.autoCommitOffset is set to false. +Use the corresponding input channel name for your example.

+
+
+
+
@SpringBootApplication
+@EnableBinding(Sink.class)
+public class ManuallyAcknowdledgingConsumer {
+
+ public static void main(String[] args) {
+     SpringApplication.run(ManuallyAcknowdledgingConsumer.class, args);
+ }
+
+ @StreamListener(Sink.INPUT)
+ public void process(Message<?> message) {
+     Acknowledgment acknowledgment = message.getHeaders().get(KafkaHeaders.ACKNOWLEDGMENT, Acknowledgment.class);
+     if (acknowledgment != null) {
+         System.out.println("Acknowledgment provided");
+         acknowledgment.acknowledge();
+     }
+ }
+}
+
+
+
+
+
Example: security configuration
+
+

Apache Kafka 0.9 supports secure connections between client and brokers. +To take advantage of this feature, follow the guidelines in the Apache Kafka Documentation as well as the Kafka 0.9 security guidelines from the Confluent documentation. +Use the spring.cloud.stream.kafka.binder.configuration option to set security properties for all clients created by the binder.

+
+
+

For example, for setting security.protocol to SASL_SSL, set:

+
+
+
+
spring.cloud.stream.kafka.binder.configuration.security.protocol=SASL_SSL
+
+
+
+

All the other security properties can be set in a similar manner.

+
+
+

When using Kerberos, follow the instructions in the reference documentation for creating and referencing the JAAS configuration.

+
+
+

Spring Cloud Stream supports passing JAAS configuration information to the application using a JAAS configuration file and using Spring Boot properties.

+
+
+
Using JAAS configuration files
+
+

The JAAS, and (optionally) krb5 file locations can be set for Spring Cloud Stream applications by using system properties. +Here is an example of launching a Spring Cloud Stream application with SASL and Kerberos using a JAAS configuration file:

+
+
+
+
 java -Djava.security.auth.login.config=/path.to/kafka_client_jaas.conf -jar log.jar \
+   --spring.cloud.stream.kafka.binder.brokers=secure.server:9092 \
+   --spring.cloud.stream.kafka.binder.zkNodes=secure.zookeeper:2181 \
+   --spring.cloud.stream.bindings.input.destination=stream.ticktock \
+   --spring.cloud.stream.kafka.binder.configuration.security.protocol=SASL_PLAINTEXT
+
+
+
+
+
Using Spring Boot properties
+
+

As an alternative to having a JAAS configuration file, Spring Cloud Stream provides a mechanism for setting up the JAAS configuration for Spring Cloud Stream applications using Spring Boot properties.

+
+
+

The following properties can be used for configuring the login context of the Kafka client.

+
+
+
+
spring.cloud.stream.kafka.binder.jaas.loginModule
+
+

The login module name. Not necessary to be set in normal cases.

+
+

Default: com.sun.security.auth.module.Krb5LoginModule.

+
+
+
spring.cloud.stream.kafka.binder.jaas.controlFlag
+
+

The control flag of the login module.

+
+

Default: required.

+
+
+
spring.cloud.stream.kafka.binder.jaas.options
+
+

Map with a key/value pair containing the login module options.

+
+

Default: Empty map.

+
+
+
+
+
+

Here is an example of launching a Spring Cloud Stream application with SASL and Kerberos using Spring Boot configuration properties:

+
+
+
+
 java --spring.cloud.stream.kafka.binder.brokers=secure.server:9092 \
+   --spring.cloud.stream.kafka.binder.zkNodes=secure.zookeeper:2181 \
+   --spring.cloud.stream.bindings.input.destination=stream.ticktock \
+   --spring.cloud.stream.kafka.binder.autoCreateTopics=false \
+   --spring.cloud.stream.kafka.binder.configuration.security.protocol=SASL_PLAINTEXT \
+   --spring.cloud.stream.kafka.binder.jaas.options.useKeyTab=true \
+   --spring.cloud.stream.kafka.binder.jaas.options.storeKey=true \
+   --spring.cloud.stream.kafka.binder.jaas.options.keyTab=/etc/security/keytabs/kafka_client.keytab \
+   --spring.cloud.stream.kafka.binder.jaas.options.principal=kafka-client-1@EXAMPLE.COM
+
+
+
+

This represents the equivalent of the following JAAS file:

+
+
+
+
KafkaClient {
+    com.sun.security.auth.module.Krb5LoginModule required
+    useKeyTab=true
+    storeKey=true
+    keyTab="/etc/security/keytabs/kafka_client.keytab"
+    principal="kafka-client-1@EXAMPLE.COM";
+};
+
+
+
+

If the topics required already exist on the broker, or will be created by an administrator, autocreation can be turned off and only client JAAS properties need to be sent. As an alternative to setting spring.cloud.stream.kafka.binder.autoCreateTopics you can simply remove the broker dependency from the application. See Excluding Kafka broker jar from the classpath of the binder based application for details.

+
+
+ + + + + +
+
Note
+		 +
+

Do not mix JAAS configuration files and Spring Boot properties in the same application. +If the -Djava.security.auth.login.config system property is already present, Spring Cloud Stream will ignore the Spring Boot properties.

+
+
+
+
+ + + + + +
+
Note
+		 +
+

Exercise caution when using the autoCreateTopics and autoAddPartitions if using Kerberos. +Usually applications may use principals that do not have administrative rights in Kafka and Zookeeper, and relying on Spring Cloud Stream to create/modify topics may fail. +In secure environments, we strongly recommend creating topics and managing ACLs administratively using Kafka tooling.

+
+
+
+
+
+
+
Using the binder with Apache Kafka 0.10
+
+

The default Kafka support in Spring Cloud Stream Kafka binder is for Kafka version 0.10.1.1. The binder also supports connecting to other 0.10 based versions and 0.9 clients. +In order to do this, when you create the project that contains your application, include spring-cloud-starter-stream-kafka as you normally would do for the default binder. +Then add these dependencies at the top of the <dependencies> section in the pom.xml file to override the dependencies.

+
+
+

Here is an example for downgrading your application to 0.10.0.1. Since it is still on the 0.10 line, the default spring-kafka and spring-integration-kafka versions can be retained.

+
+
+
+
<dependency>
+  <groupId>org.apache.kafka</groupId>
+  <artifactId>kafka_2.11</artifactId>
+  <version>0.10.0.1</version>
+  <exclusions>
+    <exclusion>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-log4j12</artifactId>
+    </exclusion>
+  </exclusions>
+</dependency>
+<dependency>
+  <groupId>org.apache.kafka</groupId>
+  <artifactId>kafka-clients</artifactId>
+  <version>0.10.0.1</version>
+</dependency>
+
+
+
+

Here is another example of using 0.9.0.1 version.

+
+
+
+
<dependency>
+  <groupId>org.springframework.kafka</groupId>
+  <artifactId>spring-kafka</artifactId>
+  <version>1.0.5.RELEASE</version>
+</dependency>
+<dependency>
+  <groupId>org.springframework.integration</groupId>
+  <artifactId>spring-integration-kafka</artifactId>
+  <version>2.0.1.RELEASE</version>
+</dependency>
+<dependency>
+  <groupId>org.apache.kafka</groupId>
+  <artifactId>kafka_2.11</artifactId>
+  <version>0.9.0.1</version>
+  <exclusions>
+    <exclusion>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-log4j12</artifactId>
+    </exclusion>
+  </exclusions>
+</dependency>
+<dependency>
+  <groupId>org.apache.kafka</groupId>
+  <artifactId>kafka-clients</artifactId>
+  <version>0.9.0.1</version>
+</dependency>
+
+
+
+ + + + + +
+
Note
+		 +
+

The versions above are provided only for the sake of the example. +For best results, we recommend using the most recent 0.10-compatible versions of the projects.

+
+
+
+
+
+
Excluding Kafka broker jar from the classpath of the binder based application
+
+

The Apache Kafka Binder uses the administrative utilities which are part of the Apache Kafka server library to create and reconfigure topics. +If the inclusion of the Apache Kafka server library and its dependencies is not necessary at runtime because the application will rely on the topics being configured administratively, the Kafka binder allows for Apache Kafka server dependency to be excluded from the application.

+
+
+

If you use non default versions for Kafka dependencies as advised above, all you have to do is not to include the kafka broker dependency. +If you use the default Kafka version, then ensure that you exclude the kafka broker jar from the spring-cloud-starter-stream-kafka dependency as following.

+
+
+
+
<dependency>
+  <groupId>org.springframework.cloud</groupId>
+  <artifactId>spring-cloud-starter-stream-kafka</artifactId>
+  <exclusions>
+    <exclusion>
+      <groupId>org.apache.kafka</groupId>
+      <artifactId>kafka_2.11</artifactId>
+    </exclusion>
+  </exclusions>
+</dependency>
+
+
+
+

If you exclude the Apache Kafka server dependency and the topic is not present on the server, then the Apache Kafka broker will create the topic if auto topic creation is enabled on the server. +Please keep in mind that if you are relying on this, then the Kafka server will use the default number of partitions and replication factors. +On the other hand, if auto topic creation is disabled on the server, then care must be taken before running the application to create the topic with the desired number of partitions.

+
+
+

If you want to have full control over how partitions are allocated, then leave the default settings as they are, i.e. do not exclude the kafka broker jar and ensure that spring.cloud.stream.kafka.binder.autoCreateTopics is set to true, which is the default.

+
+
+
+
+
+

Kafka Streams Binding Capabilities of Spring Cloud Stream

+
+

Spring Cloud Stream Kafka support also includes a binder specifically designed for Kafka Streams binding. +Using this binder, applications can be written that leverage the Kafka Streams API. +For more information on Kafka Streams, see Kafka Streams API Developer Manual

+
+
+

Kafka Streams support in Spring Cloud Stream is based on the foundations provided by the Spring Kafka project. For details on that support, see Kafaka Streams Support in Spring Kafka.

+
+
+

Here are the maven coordinates for the Spring Cloud Stream KStream binder artifact.

+
+
+
+
<dependency>
+  <groupId>org.springframework.cloud</groupId>
+  <artifactId>spring-cloud-stream-binder-kstream</artifactId>
+</dependency>
+
+
+
+

In addition to leveraging the Spring Cloud Stream programming model which is based on Spring Boot, one of the main other benefits that the KStream binder provides is the fact that it avoids the boilerplate configuration that one needs to write when using the Kafka Streams API directly. +High level streams DSL provided through the Kafka Streams API can be used through Spring Cloud Stream in the current support.

+
+
+

Usage example of high level streams DSL

+
+

This application will listen from a Kafka topic and write the word count for each unique word that it sees in a 5 seconds time window.

+
+
+
+
@SpringBootApplication
+@EnableBinding(KStreamProcessor.class)
+public class WordCountProcessorApplication {
+
+	@StreamListener("input")
+	@SendTo("output")
+	public KStream<?, String> process(KStream<?, String> input) {
+		return input
+				.flatMapValues(value -> Arrays.asList(value.toLowerCase().split("\\W+")))
+				.map((key, word) -> new KeyValue<>(word, word))
+				.groupByKey(Serdes.String(), Serdes.String())
+				.count(TimeWindows.of(5000), "store-name")
+				.toStream()
+				.map((w, c) -> new KeyValue<>(null, "Count for " + w.key() + ": " + c));
+	}
+
+	public static void main(String[] args) {
+		SpringApplication.run(WordCountProcessorApplication.class, args);
+	}
+
+
+
+

If you build it as Spring Boot runnable fat jar, you can run the above example in the following way:

+
+
+
+
java -jar uber.jar  --spring.cloud.stream.bindings.input.destination=words --spring.cloud.stream.bindings.output.destination=counts
+
+
+
+

This means that the application will listen from the incoming Kafka topic words and write to the output topic counts.

+
+
+

Spring Cloud Stream will ensure that the messages from both the incoming and outgoing topics are bound as KStream objects. +As one may observe, the developer can exclusively focus on the business aspects of the code, i.e. writing the logic required in the processor rather than setting up the streams specific configuration required by the Kafka Streams infrastructure. +All those boilerplate is handled by Spring Cloud Stream behind the scenes.

+
+
+
+

Support for interactive queries

+
+

If access to the KafkaStreams is needed for interactive queries, the internal KafkaStreams instance can be accessed via KStreamBuilderFactoryBean.getKafkaStreams(). +You can autowire the KStreamBuilderFactoryBean instance provided by the KStream binder. Then you can get KafkaStreams instance from it and retrieve the underlying store, execute queries on it, etc.

+
+
+
+

Kafka Streams properties

+
+
+
configuration
+
+

Map with a key/value pair containing properties pertaining to Kafka Streams API. +This property must be prefixed with spring.cloud.stream.kstream.binder..

+
+
+
Following are some examples of using this property.
+
+
+
+
+
+
+
+
spring.cloud.stream.kstream.binder.configuration.key.serde=org.apache.kafka.common.serialization.Serdes$StringSerde
+spring.cloud.stream.kstream.binder.configuration.value.serde=org.apache.kafka.common.serialization.Serdes$StringSerde
+spring.cloud.stream.kstream.binder.configuration.commit.interval.ms=1000
+
+
+
+
+
For more information about all the properties that may go into streams configuration, see StreamsConfig JavaDocs.
+
+
+
+

There can also be binding specific properties.

+
+
+

For instance, you can use a different Serde for your input or output destination.

+
+
+
+
spring.cloud.stream.kstream.bindings.output.producer.keySerde=org.apache.kafka.common.serialization.Serdes$IntegerSerde
+spring.cloud.stream.kstream.bindings.output.producer.valueSerde=org.apache.kafka.common.serialization.Serdes$LongSerde
+
+
+
+
+
+

Dead-Letter Topic Processing

+
+

Because it can’t be anticipated how users would want to dispose of dead-lettered messages, the framework does not provide any standard mechanism to handle them. +If the reason for the dead-lettering is transient, you may wish to route the messages back to the original topic. +However, if the problem is a permanent issue, that could cause an infinite loop. +The following spring-boot application is an example of how to route those messages back to the original topic, but moves them to a third "parking lot" topic after three attempts. +The application is simply another spring-cloud-stream application that reads from the dead-letter topic. +It terminates when no messages are received for 5 seconds.

+
+
+

The examples assume the original destination is so8400out and the consumer group is so8400.

+
+
+

There are several considerations.

+
+
+
    +
  • +

    Consider only running the rerouting when the main application is not running. +Otherwise, the retries for transient errors will be used up very quickly.

    +
    • +
  • +

    Alternatively, use a two-stage approach - use this application to route to a third topic, and another to route from there back to the main topic.

    +
    • +
  • +

    Since this technique uses a message header to keep track of retries, it won’t work with headerMode=raw. +In that case, consider adding some data to the payload (that can be ignored by the main application).

    +
    • +
  • +

    x-retries has to be added to the headers property spring.cloud.stream.kafka.binder.headers=x-retries on both this, and the main application so that the header is transported between the applications.

    +
    • +
  • +

    Since kafka is publish/subscribe, replayed messages will be sent to each consumer group, even those that successfully processed a message the first time around.

    +
    • +
+
+
+
application.properties
+
+
spring.cloud.stream.bindings.input.group=so8400replay
+spring.cloud.stream.bindings.input.destination=error.so8400out.so8400
+
+spring.cloud.stream.bindings.output.destination=so8400out
+spring.cloud.stream.bindings.output.producer.partitioned=true
+
+spring.cloud.stream.bindings.parkingLot.destination=so8400in.parkingLot
+spring.cloud.stream.bindings.parkingLot.producer.partitioned=true
+
+spring.cloud.stream.kafka.binder.configuration.auto.offset.reset=earliest
+
+spring.cloud.stream.kafka.binder.headers=x-retries
+
+
+
+
Application
+
+
@SpringBootApplication
+@EnableBinding(TwoOutputProcessor.class)
+public class ReRouteDlqKApplication implements CommandLineRunner {
+
+    private static final String X_RETRIES_HEADER = "x-retries";
+
+    public static void main(String[] args) {
+        SpringApplication.run(ReRouteDlqKApplication.class, args).close();
+    }
+
+    private final AtomicInteger processed = new AtomicInteger();
+
+    @Autowired
+    private MessageChannel parkingLot;
+
+    @StreamListener(Processor.INPUT)
+    @SendTo(Processor.OUTPUT)
+    public Message<?> reRoute(Message<?> failed) {
+        processed.incrementAndGet();
+        Integer retries = failed.getHeaders().get(X_RETRIES_HEADER, Integer.class);
+        if (retries == null) {
+            System.out.println("First retry for " + failed);
+            return MessageBuilder.fromMessage(failed)
+                    .setHeader(X_RETRIES_HEADER, new Integer(1))
+                    .setHeader(BinderHeaders.PARTITION_OVERRIDE,
+                            failed.getHeaders().get(KafkaHeaders.RECEIVED_PARTITION_ID))
+                    .build();
+        }
+        else if (retries.intValue() < 3) {
+            System.out.println("Another retry for " + failed);
+            return MessageBuilder.fromMessage(failed)
+                    .setHeader(X_RETRIES_HEADER, new Integer(retries.intValue() + 1))
+                    .setHeader(BinderHeaders.PARTITION_OVERRIDE,
+                            failed.getHeaders().get(KafkaHeaders.RECEIVED_PARTITION_ID))
+                    .build();
+        }
+        else {
+            System.out.println("Retries exhausted for " + failed);
+            parkingLot.send(MessageBuilder.fromMessage(failed)
+                    .setHeader(BinderHeaders.PARTITION_OVERRIDE,
+                            failed.getHeaders().get(KafkaHeaders.RECEIVED_PARTITION_ID))
+                    .build());
+        }
+        return null;
+    }
+
+    @Override
+    public void run(String... args) throws Exception {
+        while (true) {
+            int count = this.processed.get();
+            Thread.sleep(5000);
+            if (count == this.processed.get()) {
+                System.out.println("Idle, terminating");
+                return;
+            }
+        }
+    }
+
+    public interface TwoOutputProcessor extends Processor {
+
+        @Output("parkingLot")
+        MessageChannel parkingLot();
+
+    }
+
+}
+
+
+
+
+
+
+

RabbitMQ Binder

+
+ +
+

Usage

+
+

For using the RabbitMQ binder, you just need to add it to your Spring Cloud Stream application, using the following Maven coordinates:

+
+
+
+
<dependency>
+  <groupId>org.springframework.cloud</groupId>
+  <artifactId>spring-cloud-stream-binder-rabbit</artifactId>
+</dependency>
+
+
+
+

Alternatively, you can also use the Spring Cloud Stream RabbitMQ Starter.

+
+
+
+
<dependency>
+  <groupId>org.springframework.cloud</groupId>
+  <artifactId>spring-cloud-starter-stream-rabbit</artifactId>
+</dependency>
+
+
+
+
+

RabbitMQ Binder Overview

+
+

A simplified diagram of how the RabbitMQ binder operates can be seen below.

+
+
+
+rabbit binder +
+
Figure 14. RabbitMQ Binder
+
+
+

The RabbitMQ Binder implementation maps each destination to a TopicExchange. +For each consumer group, a Queue will be bound to that TopicExchange. +Each consumer instance have a corresponding RabbitMQ Consumer instance for its group’s Queue. +For partitioned producers/consumers the queues are suffixed with the partition index and use the partition index as routing key.

+
+
+

Using the autoBindDlq option, you can optionally configure the binder to create and configure dead-letter queues (DLQs) (and a dead-letter exchange DLX). +The dead letter queue has the name of the destination, appended with .dlq. +If retry is enabled (maxAttempts > 1) failed messages will be delivered to the DLQ. +If retry is disabled (maxAttempts = 1), you should set requeueRejected to false (default) so that a failed message will be routed to the DLQ, instead of being requeued. +In addition, republishToDlq causes the binder to publish a failed message to the DLQ (instead of rejecting it); this enables additional information to be added to the message in headers, such as the stack trace in the x-exception-stacktrace header. +This option does not need retry enabled; you can republish a failed message after just one attempt. +Starting with version 1.2, you can configure the delivery mode of republished messsages; see property republishDeliveryMode.

+
+
+ + + + + +
+
Important
+		 +Setting requeueRejected to true will cause the message to be requeued and redelivered continually, which is likely not what you want unless the failure issue is transient. +In general, it’s better to enable retry within the binder by setting maxAttempts to greater than one, or set republishToDlq to true. +
+
+
+

See RabbitMQ Binder Properties for more information about these properties.

+
+
+

The framework does not provide any standard mechanism to consume dead-letter messages (or to re-route them back to the primary queue). +Some options are described in Dead-Letter Queue Processing.

+
+
+ + + + + +
+
Note
+		 +
+

When multiple RabbitMQ binders are used in a Spring Cloud Stream application, it is important to disable 'RabbitAutoConfiguration' to avoid the same configuration from RabbitAutoConfiguration being applied to the two binders.

+
+
+
+
+
+

Configuration Options

+
+

This section contains settings specific to the RabbitMQ Binder and bound channels.

+
+
+

For general binding configuration options and properties, +please refer to the Spring Cloud Stream core documentation.

+
+
+

RabbitMQ Binder Properties

+
+

By default, the RabbitMQ binder uses Spring Boot’s ConnectionFactory, and it therefore supports all Spring Boot configuration options for RabbitMQ. +(For reference, consult the Spring Boot documentation.) +RabbitMQ configuration options use the spring.rabbitmq prefix.

+
+
+

In addition to Spring Boot options, the RabbitMQ binder supports the following properties:

+
+
+
+
spring.cloud.stream.rabbit.binder.adminAddresses
+
+

A comma-separated list of RabbitMQ management plugin URLs. +Only used when nodes contains more than one entry. +Each entry in this list must have a corresponding entry in spring.rabbitmq.addresses.

+
+

Default: empty.

+
+
+
spring.cloud.stream.rabbit.binder.nodes
+
+

A comma-separated list of RabbitMQ node names. +When more than one entry, used to locate the server address where a queue is located. +Each entry in this list must have a corresponding entry in spring.rabbitmq.addresses.

+
+

Default: empty.

+
+
+
spring.cloud.stream.rabbit.binder.compressionLevel
+
+

Compression level for compressed bindings. +See java.util.zip.Deflater.

+
+

Default: 1 (BEST_LEVEL).

+
+
+
+
+
+
+

RabbitMQ Consumer Properties

+
+

The following properties are available for Rabbit consumers only and +must be prefixed with spring.cloud.stream.rabbit.bindings.<channelName>.consumer..

+
+
+
+
acknowledgeMode
+
+

The acknowledge mode.

+
+

Default: AUTO.

+
+
+
autoBindDlq
+
+

Whether to automatically declare the DLQ and bind it to the binder DLX.

+
+

Default: false.

+
+
+
bindingRoutingKey
+
+

The routing key with which to bind the queue to the exchange (if bindQueue is true). +for partitioned destinations -<instanceIndex> will be appended.

+
+

Default: #.

+
+
+
bindQueue
+
+

Whether to bind the queue to the destination exchange; set to false if you have set up your own infrastructure and have previously created/bound the queue.

+
+

Default: true.

+
+
+
deadLetterQueueName
+
+

name of the DLQ

+
+

Default: prefix+destination.dlq

+
+
+
deadLetterExchange
+
+

a DLX to assign to the queue; if autoBindDlq is true

+
+

Default: 'prefix+DLX'

+
+
+
deadLetterRoutingKey
+
+

a dead letter routing key to assign to the queue; if autoBindDlq is true

+
+

Default: destination

+
+
+
declareExchange
+
+

Whether to declare the exchange for the destination.

+
+

Default: true.

+
+
+
delayedExchange
+
+

Whether to declare the exchange as a Delayed Message Exchange - requires the delayed message exchange plugin on the broker. +The x-delayed-type argument is set to the exchangeType.

+
+

Default: false.

+
+
+
dlqDeadLetterExchange
+
+

if a DLQ is declared, a DLX to assign to that queue

+
+

Default: none

+
+
+
dlqDeadLetterRoutingKey
+
+

if a DLQ is declared, a dead letter routing key to assign to that queue; default none

+
+

Default: none

+
+
+
dlqExpires
+
+

how long before an unused dead letter queue is deleted (ms)

+
+

Default: no expiration

+
+
+
dlqLazy
+
+

Declare the dead letter queue with the x-queue-mode=lazy argument. +See Lazy Queues. +Consider using a policy instead of this setting because using a policy allows changing the setting without deleting the queue.

+
+

Default: false.

+
+
+
dlqMaxLength
+
+

maximum number of messages in the dead letter queue

+
+

Default: no limit

+
+
+
dlqMaxLengthBytes
+
+

maximum number of total bytes in the dead letter queue from all messages

+
+

Default: no limit

+
+
+
dlqMaxPriority
+
+

maximum priority of messages in the dead letter queue (0-255)

+
+

Default: none

+
+
+
dlqTtl
+
+

default time to live to apply to the dead letter queue when declared (ms)

+
+

Default: no limit

+
+
+
durableSubscription
+
+

Whether subscription should be durable. +Only effective if group is also set.

+
+

Default: true.

+
+
+
exchangeAutoDelete
+
+

If declareExchange is true, whether the exchange should be auto-delete (removed after the last queue is removed).

+
+

Default: true.

+
+
+
exchangeDurable
+
+

If declareExchange is true, whether the exchange should be durable (survives broker restart).

+
+

Default: true.

+
+
+
exchangeType
+
+

The exchange type; direct, fanout or topic for non-partitioned destinations; direct or topic for partitioned destinations.

+
+

Default: topic.

+
+
+
exclusive
+
+

Create an exclusive consumer; concurrency should be 1 when this is true; often used when strict ordering is required but enabling a hot standby instance to take over after a failure. +See recoveryInterval, which controls how often a standby instance will attempt to consume.

+
+

Default: false.

+
+
+
expires
+
+

how long before an unused queue is deleted (ms)

+
+

Default: no expiration

+
+
+
headerPatterns
+
+

Patterns for headers to be mapped from inbound messages.

+
+

Default: ['*'] (all headers).

+
+
+
lazy
+
+

Declare the queue with the x-queue-mode=lazy argument. +See Lazy Queues. +Consider using a policy instead of this setting because using a policy allows changing the setting without deleting the queue.

+
+

Default: false.

+
+
+
maxConcurrency
+
+

the maximum number of consumers

+
+

Default: 1.

+
+
+
maxLength
+
+

maximum number of messages in the queue

+
+

Default: no limit

+
+
+
maxLengthBytes
+
+

maximum number of total bytes in the queue from all messages

+
+

Default: no limit

+
+
+
maxPriority
+
+

maximum priority of messages in the queue (0-255)

+
+
Default
+
+

none

+
+
prefetch
+
+

Prefetch count.

+
+

Default: 1.

+
+
+
prefix
+
+

A prefix to be added to the name of the destination and queues.

+
+

Default: "".

+
+
+
recoveryInterval
+
+

The interval between connection recovery attempts, in milliseconds.

+
+

Default: 5000.

+
+
+
requeueRejected
+
+

Whether delivery failures should be requeued when retry is disabled or republishToDlq is false.

+
+

Default: false.

+
+
+
republishDeliveryMode
+
+

When republishToDlq is true, specify the delivery mode of the republished message.

+
+

Default: DeliveryMode.PERSISTENT

+
+
+
republishToDlq
+
+

By default, messages which fail after retries are exhausted are rejected. +If a dead-letter queue (DLQ) is configured, RabbitMQ will route the failed message (unchanged) to the DLQ. +If set to true, the binder will republish failed messages to the DLQ with additional headers, including the exception message and stack trace from the cause of the final failure.

+
+

Default: false

+
+
+
transacted
+
+

Whether to use transacted channels.

+
+

Default: false.

+
+
+
ttl
+
+

default time to live to apply to the queue when declared (ms)

+
+

Default: no limit

+
+
+
txSize
+
+

The number of deliveries between acks.

+
+

Default: 1.

+
+
+
+
+
+
+

Rabbit Producer Properties

+
+

The following properties are available for Rabbit producers only and +must be prefixed with spring.cloud.stream.rabbit.bindings.<channelName>.producer..

+
+
+
+
autoBindDlq
+
+

Whether to automatically declare the DLQ and bind it to the binder DLX.

+
+

Default: false.

+
+
+
batchingEnabled
+
+

Whether to enable message batching by producers.

+
+

Default: false.

+
+
+
batchSize
+
+

The number of messages to buffer when batching is enabled.

+
+

Default: 100.

+
+
+
batchBufferLimit
+
+

Default: 10000.

+
+
batchTimeout
+
+

Default: 5000.

+
+
bindingRoutingKey
+
+

The routing key with which to bind the queue to the exchange (if bindQueue is true). +Only applies to non-partitioned destinations. +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: #.

+
+
+
bindQueue
+
+

Whether to bind the queue to the destination exchange; set to false if you have set up your own infrastructure and have previously created/bound the queue. +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: true.

+
+
+
compress
+
+

Whether data should be compressed when sent.

+
+

Default: false.

+
+
+
deadLetterQueueName
+
+

name of the DLQ +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: prefix+destination.dlq

+
+
+
deadLetterExchange
+
+

a DLX to assign to the queue; if autoBindDlq is true +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: 'prefix+DLX'

+
+
+
deadLetterRoutingKey
+
+

a dead letter routing key to assign to the queue; if autoBindDlq is true +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: destination

+
+
+
declareExchange
+
+

Whether to declare the exchange for the destination.

+
+

Default: true.

+
+
+
delay
+
+

A SpEL expression to evaluate the delay to apply to the message (x-delay header) - has no effect if the exchange is not a delayed message exchange.

+
+

Default: No x-delay header is set.

+
+
+
delayedExchange
+
+

Whether to declare the exchange as a Delayed Message Exchange - requires the delayed message exchange plugin on the broker. +The x-delayed-type argument is set to the exchangeType.

+
+

Default: false.

+
+
+
deliveryMode
+
+

Delivery mode.

+
+

Default: PERSISTENT.

+
+
+
dlqDeadLetterExchange
+
+

if a DLQ is declared, a DLX to assign to that queue +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: none

+
+
+
dlqDeadLetterRoutingKey
+
+

if a DLQ is declared, a dead letter routing key to assign to that queue; default none +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: none

+
+
+
dlqExpires
+
+

how long before an unused dead letter queue is deleted (ms) +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no expiration

+
+
+
dlqLazy
+
+

Declare the dead letter queue with the x-queue-mode=lazy argument. +See Lazy Queues. +Consider using a policy instead of this setting because using a policy allows changing the setting without deleting the queue. +Only applies if requiredGroups are provided and then only to those groups.

+
+
dlqMaxLength
+
+

maximum number of messages in the dead letter queue +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no limit

+
+
+
dlqMaxLengthBytes
+
+

maximum number of total bytes in the dead letter queue from all messages +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no limit

+
+
+
dlqMaxPriority
+
+

maximum priority of messages in the dead letter queue (0-255) +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: none

+
+
+
dlqTtl
+
+

default time to live to apply to the dead letter queue when declared (ms) +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no limit

+
+
+
exchangeAutoDelete
+
+

If declareExchange is true, whether the exchange should be auto-delete (removed after the last queue is removed).

+
+

Default: true.

+
+
+
exchangeDurable
+
+

If declareExchange is true, whether the exchange should be durable (survives broker restart).

+
+

Default: true.

+
+
+
exchangeType
+
+

The exchange type; direct, fanout or topic for non-partitioned destinations; direct or topic for partitioned destinations.

+
+

Default: topic.

+
+
+
expires
+
+

how long before an unused queue is deleted (ms) +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no expiration

+
+
+
headerPatterns
+
+

Patterns for headers to be mapped to outbound messages.

+
+

Default: ['*'] (all headers).

+
+
+
lazy
+
+

Declare the queue with the x-queue-mode=lazy argument. +See Lazy Queues. +Consider using a policy instead of this setting because using a policy allows changing the setting without deleting the queue. +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: false.

+
+
+
maxLength
+
+

maximum number of messages in the queue +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no limit

+
+
+
maxLengthBytes
+
+

maximum number of total bytes in the queue from all messages +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no limit

+
+
+
maxPriority
+
+

maximum priority of messages in the queue (0-255) +Only applies if requiredGroups are provided and then only to those groups.

+
+
Default
+
+

none

+
+
prefix
+
+

A prefix to be added to the name of the destination exchange.

+
+

Default: "".

+
+
+
routingKeyExpression
+
+

A SpEL expression to determine the routing key to use when publishing messages. +For a fixed routing key, use a literal expression, e.g. routingKeyExpression='my.routingKey' in a properties file, or routingKeyExpression: '''my.routingKey''' in a YAML file.

+
+

Default: destination or destination-<partition> for partitioned destinations.

+
+
+
transacted
+
+

Whether to use transacted channels.

+
+

Default: false.

+
+
+
ttl
+
+

default time to live to apply to the queue when declared (ms) +Only applies if requiredGroups are provided and then only to those groups.

+
+

Default: no limit

+
+
+
+
+
+ + + + + +
+
Note
+		 +
+

In the case of RabbitMQ, content type headers can be set by external applications. +Spring Cloud Stream supports them as part of an extended internal protocol used for any type of transport (including transports, such as Kafka, that do not normally support headers).

+
+
+
+
+
+
+

Retry With the RabbitMQ Binder

+
+

Overview

+
+

When retry is enabled within the binder, the listener container thread is suspended for any back off periods that are configured. +This might be important when strict ordering is required with a single consumer but for other use cases it prevents other messages from being processed on that thread. +An alternative to using binder retry is to set up dead lettering with time to live on the dead-letter queue (DLQ), as well as dead-letter configuration on the DLQ itself. +See RabbitMQ Binder Properties for more information about the properties discussed here. +Example configuration to enable this feature:

+
+
+
    +
  • +

    Set autoBindDlq to true - the binder will create a DLQ; you can optionally specify a name in deadLetterQueueName

    +
    • +
  • +

    Set dlqTtl to the back off time you want to wait between redeliveries

    +
    • +
  • +

    Set the dlqDeadLetterExchange to the default exchange - expired messages from the DLQ will be routed to the original queue since the default deadLetterRoutingKey is the queue name (destination.group)

    +
    • +
+
+
+

To force a message to be dead-lettered, either throw an AmqpRejectAndDontRequeueException, or set requeueRejected to true and throw any exception.

+
+
+

The loop will continue without end, which is fine for transient problems but you may want to give up after some number of attempts. +Fortunately, RabbitMQ provides the x-death header which allows you to determine how many cycles have occurred.

+
+
+

To acknowledge a message after giving up, throw an ImmediateAcknowledgeAmqpException.

+
+
+
+

Putting it All Together

+
+
+
---
+spring.cloud.stream.bindings.input.destination=myDestination
+spring.cloud.stream.bindings.input.group=consumerGroup
+#disable binder retries
+spring.cloud.stream.bindings.input.consumer.max-attempts=1
+#dlx/dlq setup
+spring.cloud.stream.rabbit.bindings.input.consumer.auto-bind-dlq=true
+spring.cloud.stream.rabbit.bindings.input.consumer.dlq-ttl=5000
+spring.cloud.stream.rabbit.bindings.input.consumer.dlq-dead-letter-exchange=
+---
+
+
+
+

This configuration creates an exchange myDestination with queue myDestination.consumerGroup bound to a topic exchange with a wildcard routing key #. +It creates a DLQ bound to a direct exchange DLX with routing key myDestination.consumerGroup. +When messages are rejected, they are routed to the DLQ. +After 5 seconds, the message expires and is routed to the original queue using the queue name as the routing key.

+
+
+
Spring Boot application
+
+
@SpringBootApplication
+@EnableBinding(Sink.class)
+public class XDeathApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(XDeathApplication.class, args);
+    }
+
+    @StreamListener(Sink.INPUT)
+    public void listen(String in, @Header(name = "x-death", required = false) Map<?,?> death) {
+        if (death != null && death.get("count").equals(3L)) {
+            // giving up - don't send to DLX
+            throw new ImmediateAcknowledgeAmqpException("Failed after 4 attempts");
+        }
+        throw new AmqpRejectAndDontRequeueException("failed");
+    }
+
+}
+
+
+
+

Notice that the count property in the x-death header is a Long.

+
+
+
+
+

Dead-Letter Queue Processing

+
+

Because it can’t be anticipated how users would want to dispose of dead-lettered messages, the framework does not provide any standard mechanism to handle them. +If the reason for the dead-lettering is transient, you may wish to route the messages back to the original queue. +However, if the problem is a permanent issue, that could cause an infinite loop. +The following spring-boot application is an example of how to route those messages back to the original queue, but moves them to a third "parking lot" queue after three attempts. +The second example utilizes the RabbitMQ Delayed Message Exchange to introduce a delay to the requeued message. +In this example, the delay increases for each attempt. +These examples use a @RabbitListener to receive messages from the DLQ, you could also use RabbitTemplate.receive() in a batch process.

+
+
+

The examples assume the original destination is so8400in and the consumer group is so8400.

+
+
+

Non-Partitioned Destinations

+
+

The first two examples are when the destination is not partitioned.

+
+
+
+
@SpringBootApplication
+public class ReRouteDlqApplication {
+
+    private static final String ORIGINAL_QUEUE = "so8400in.so8400";
+
+    private static final String DLQ = ORIGINAL_QUEUE + ".dlq";
+
+    private static final String PARKING_LOT = ORIGINAL_QUEUE + ".parkingLot";
+
+    private static final String X_RETRIES_HEADER = "x-retries";
+
+    public static void main(String[] args) throws Exception {
+        ConfigurableApplicationContext context = SpringApplication.run(ReRouteDlqApplication.class, args);
+        System.out.println("Hit enter to terminate");
+        System.in.read();
+        context.close();
+    }
+
+    @Autowired
+    private RabbitTemplate rabbitTemplate;
+
+    @RabbitListener(queues = DLQ)
+    public void rePublish(Message failedMessage) {
+        Integer retriesHeader = (Integer) failedMessage.getMessageProperties().getHeaders().get(X_RETRIES_HEADER);
+        if (retriesHeader == null) {
+            retriesHeader = Integer.valueOf(0);
+        }
+        if (retriesHeader < 3) {
+            failedMessage.getMessageProperties().getHeaders().put(X_RETRIES_HEADER, retriesHeader + 1);
+            this.rabbitTemplate.send(ORIGINAL_QUEUE, failedMessage);
+        }
+        else {
+            this.rabbitTemplate.send(PARKING_LOT, failedMessage);
+        }
+    }
+
+    @Bean
+    public Queue parkingLot() {
+        return new Queue(PARKING_LOT);
+    }
+
+}
+
+
+
+
+
@SpringBootApplication
+public class ReRouteDlqApplication {
+
+    private static final String ORIGINAL_QUEUE = "so8400in.so8400";
+
+    private static final String DLQ = ORIGINAL_QUEUE + ".dlq";
+
+    private static final String PARKING_LOT = ORIGINAL_QUEUE + ".parkingLot";
+
+    private static final String X_RETRIES_HEADER = "x-retries";
+
+    private static final String DELAY_EXCHANGE = "dlqReRouter";
+
+    public static void main(String[] args) throws Exception {
+        ConfigurableApplicationContext context = SpringApplication.run(ReRouteDlqApplication.class, args);
+        System.out.println("Hit enter to terminate");
+        System.in.read();
+        context.close();
+    }
+
+    @Autowired
+    private RabbitTemplate rabbitTemplate;
+
+    @RabbitListener(queues = DLQ)
+    public void rePublish(Message failedMessage) {
+        Map<String, Object> headers = failedMessage.getMessageProperties().getHeaders();
+        Integer retriesHeader = (Integer) headers.get(X_RETRIES_HEADER);
+        if (retriesHeader == null) {
+            retriesHeader = Integer.valueOf(0);
+        }
+        if (retriesHeader < 3) {
+            headers.put(X_RETRIES_HEADER, retriesHeader + 1);
+            headers.put("x-delay", 5000 * retriesHeader);
+            this.rabbitTemplate.send(DELAY_EXCHANGE, ORIGINAL_QUEUE, failedMessage);
+        }
+        else {
+            this.rabbitTemplate.send(PARKING_LOT, failedMessage);
+        }
+    }
+
+    @Bean
+    public DirectExchange delayExchange() {
+        DirectExchange exchange = new DirectExchange(DELAY_EXCHANGE);
+        exchange.setDelayed(true);
+        return exchange;
+    }
+
+    @Bean
+    public Binding bindOriginalToDelay() {
+        return BindingBuilder.bind(new Queue(ORIGINAL_QUEUE)).to(delayExchange()).with(ORIGINAL_QUEUE);
+    }
+
+    @Bean
+    public Queue parkingLot() {
+        return new Queue(PARKING_LOT);
+    }
+
+}
+
+
+
+
+

Partitioned Destinations

+
+

With partitioned destinations, there is one DLQ for all partitions and we determine the original queue from the headers.

+
+
+
republishToDlq=false
+
+

When republishToDlq is false, RabbitMQ publishes the message to the DLX/DLQ with an x-death header containing information about the original destination.

+
+
+
+
@SpringBootApplication
+public class ReRouteDlqApplication {
+
+	private static final String ORIGINAL_QUEUE = "so8400in.so8400";
+
+	private static final String DLQ = ORIGINAL_QUEUE + ".dlq";
+
+	private static final String PARKING_LOT = ORIGINAL_QUEUE + ".parkingLot";
+
+	private static final String X_DEATH_HEADER = "x-death";
+
+	private static final String X_RETRIES_HEADER = "x-retries";
+
+	public static void main(String[] args) throws Exception {
+		ConfigurableApplicationContext context = SpringApplication.run(ReRouteDlqApplication.class, args);
+		System.out.println("Hit enter to terminate");
+		System.in.read();
+		context.close();
+	}
+
+	@Autowired
+	private RabbitTemplate rabbitTemplate;
+
+	@SuppressWarnings("unchecked")
+	@RabbitListener(queues = DLQ)
+	public void rePublish(Message failedMessage) {
+		Map<String, Object> headers = failedMessage.getMessageProperties().getHeaders();
+		Integer retriesHeader = (Integer) headers.get(X_RETRIES_HEADER);
+		if (retriesHeader == null) {
+			retriesHeader = Integer.valueOf(0);
+		}
+		if (retriesHeader < 3) {
+			headers.put(X_RETRIES_HEADER, retriesHeader + 1);
+			List<Map<String, ?>> xDeath = (List<Map<String, ?>>) headers.get(X_DEATH_HEADER);
+			String exchange = (String) xDeath.get(0).get("exchange");
+			List<String> routingKeys = (List<String>) xDeath.get(0).get("routing-keys");
+			this.rabbitTemplate.send(exchange, routingKeys.get(0), failedMessage);
+		}
+		else {
+			this.rabbitTemplate.send(PARKING_LOT, failedMessage);
+		}
+	}
+
+	@Bean
+	public Queue parkingLot() {
+		return new Queue(PARKING_LOT);
+	}
+
+}
+
+
+
+
+
republishToDlq=true
+
+

When republishToDlq is true, the republishing recoverer adds the original exchange and routing key to headers.

+
+
+
+
@SpringBootApplication
+public class ReRouteDlqApplication {
+
+	private static final String ORIGINAL_QUEUE = "so8400in.so8400";
+
+	private static final String DLQ = ORIGINAL_QUEUE + ".dlq";
+
+	private static final String PARKING_LOT = ORIGINAL_QUEUE + ".parkingLot";
+
+	private static final String X_RETRIES_HEADER = "x-retries";
+
+	private static final String X_ORIGINAL_EXCHANGE_HEADER = RepublishMessageRecoverer.X_ORIGINAL_EXCHANGE;
+
+	private static final String X_ORIGINAL_ROUTING_KEY_HEADER = RepublishMessageRecoverer.X_ORIGINAL_ROUTING_KEY;
+
+	public static void main(String[] args) throws Exception {
+		ConfigurableApplicationContext context = SpringApplication.run(ReRouteDlqApplication.class, args);
+		System.out.println("Hit enter to terminate");
+		System.in.read();
+		context.close();
+	}
+
+	@Autowired
+	private RabbitTemplate rabbitTemplate;
+
+	@RabbitListener(queues = DLQ)
+	public void rePublish(Message failedMessage) {
+		Map<String, Object> headers = failedMessage.getMessageProperties().getHeaders();
+		Integer retriesHeader = (Integer) headers.get(X_RETRIES_HEADER);
+		if (retriesHeader == null) {
+			retriesHeader = Integer.valueOf(0);
+		}
+		if (retriesHeader < 3) {
+			headers.put(X_RETRIES_HEADER, retriesHeader + 1);
+			String exchange = (String) headers.get(X_ORIGINAL_EXCHANGE_HEADER);
+			String originalRoutingKey = (String) headers.get(X_ORIGINAL_ROUTING_KEY_HEADER);
+			this.rabbitTemplate.send(exchange, originalRoutingKey, failedMessage);
+		}
+		else {
+			this.rabbitTemplate.send(PARKING_LOT, failedMessage);
+		}
+	}
+
+	@Bean
+	public Queue parkingLot() {
+		return new Queue(PARKING_LOT);
+	}
+
+}
+
+
+
+
+
+
+
+

Spring Cloud Bus

+
+
+
+

Spring Cloud Bus links nodes of a distributed system with a lightweight message broker. This can then be used to broadcast state changes (e.g. configuration changes) or other management instructions. A key idea is that the Bus is like a distributed Actuator for a Spring Boot application that is scaled out, but it can also be used as a communication channel between apps. Starters are provided for an AMQP broker as the transport or for Kafka, but the same basic feature set (and some more depending on the transport) is on the roadmap for other transports.

+
+
+ + + + + +
+
Note
+		 +Spring Cloud is released under the non-restrictive Apache 2.0 license. If you would like to contribute to this section of the documentation or if you find an error, please find the source code and issue trackers in the project at github. +
+
+
+
+
+

Quick Start

+
+
+

Spring Cloud Bus works by adding Spring Boot autconfiguration if it detects itself on the classpath. All you need to do to enable the bus is to add spring-cloud-starter-bus-amqp or spring-cloud-starter-bus-kafka to your dependency management and Spring Cloud takes care of the rest. Make sure the broker (RabbitMQ or Kafka) is available and configured: running on localhost you shouldn’t have to do anything, but if you are running remotely use Spring Cloud Connectors, or Spring Boot conventions to define the broker credentials, e.g. for Rabbit

+
+
+
application.yml
+
+
spring:
+  rabbitmq:
+    host: mybroker.com
+    port: 5672
+    username: user
+    password: secret
+
+
+
+

The bus currently supports sending messages to all nodes listening or all nodes for a particular service (as defined by Eureka). More selector criteria may be added in the future (ie. only service X nodes in data center Y, etc…​). There are also some http endpoints under the /bus/* actuator namespace. There are currently two implemented. The first, /bus/env, sends key/value pairs to update each node’s Spring Environment. The second, /bus/refresh, will reload each application’s configuration, just as if they had all been pinged on their /refresh endpoint.

+
+
+ + + + + +
+
Note
+		 +The Bus starters cover Rabbit and Kafka, because those are the two most common implementations, but Spring Cloud Stream is quite flexible and binder will work combined with spring-cloud-bus. +
+
+
+
+
+

Addressing an Instance

+
+
+

The HTTP endpoints accept a "destination" parameter, e.g. "/bus/refresh?destination=customers:9000", where the destination is an ApplicationContext ID. If the ID is owned by an instance on the Bus then it will process the message and all other instances will ignore it. Spring Boot sets the ID for you in the ContextIdApplicationContextInitializer to a combination of the spring.application.name, active profiles and server.port by default.

+
+
+
+
+

Addressing all instances of a service

+
+
+

The "destination" parameter is used in a Spring PathMatcher (with the path separator as a colon :) to determine if an instance will process the message. Using the example from above, "/bus/refresh?destination=customers:**" will target all instances of the "customers" service regardless of the profiles and ports set as the ApplicationContext ID.

+
+
+
+
+

Application Context ID must be unique

+
+
+

The bus tries to eliminate processing an event twice, once from the original ApplicationEvent and once from the queue. To do this, it checks the sending application context id againts the current application context id. If multiple instances of a service have the same application context id, events will not be processed. Running on a local machine, each service will be on a different port and that will be part of the application context id. Cloud Foundry supplies an index to differentiate. To ensure that the application context id is the unique, set spring.application.index to something unique for each instance of a service. For example, in lattice, set spring.application.index=${INSTANCE_INDEX} in application.properties (or bootstrap.properties if using configserver).

+
+
+
+
+

Customizing the Message Broker

+
+
+

Spring Cloud Bus uses +Spring Cloud Stream to +broadcast the messages so to get messages to flow you only need to +include the binder implementation of your choice in the +classpath. There are convenient starters specifically for the bus with +AMQP (RabbitMQ) and Kafka +(spring-cloud-starter-bus-[amqp,kafka]). Generally speaking +Spring Cloud Stream relies on Spring Boot autoconfiguration +conventions for configuring middleware, so for instance the AMQP +broker address can be changed with spring.rabbitmq.* +configuration properties. Spring Cloud Bus has a handful of native +configuration properties in spring.cloud.bus.* +(e.g. spring.cloud.bus.destination is the name of the topic to use +the the externall middleware). Normally the defaults will suffice.

+
+
+

To lean more about how to customize the message broker settings +consult the Spring Cloud Stream documentation.

+
+
+
+
+

Tracing Bus Events

+
+
+

Bus events (subclasses of RemoteApplicationEvent) can be traced by +setting spring.cloud.bus.trace.enabled=true. If you do this then the +Spring Boot TraceRepository (if it is present) will show each event +sent and all the acks from each service instance. Example (from the +/trace endpoint):

+
+
+
+
{
+  "timestamp": "2015-11-26T10:24:44.411+0000",
+  "info": {
+    "signal": "spring.cloud.bus.ack",
+    "type": "RefreshRemoteApplicationEvent",
+    "id": "c4d374b7-58ea-4928-a312-31984def293b",
+    "origin": "stores:8081",
+    "destination": "*:**"
+  }
+  },
+  {
+  "timestamp": "2015-11-26T10:24:41.864+0000",
+  "info": {
+    "signal": "spring.cloud.bus.sent",
+    "type": "RefreshRemoteApplicationEvent",
+    "id": "c4d374b7-58ea-4928-a312-31984def293b",
+    "origin": "customers:9000",
+    "destination": "*:**"
+  }
+  },
+  {
+  "timestamp": "2015-11-26T10:24:41.862+0000",
+  "info": {
+    "signal": "spring.cloud.bus.ack",
+    "type": "RefreshRemoteApplicationEvent",
+    "id": "c4d374b7-58ea-4928-a312-31984def293b",
+    "origin": "customers:9000",
+    "destination": "*:**"
+  }
+}
+
+
+
+

This trace shows that a RefreshRemoteApplicationEvent was sent from +customers:9000, broadcast to all services, and it was received +(acked) by customers:9000 and stores:8081.

+
+
+

To handle the ack signals yourself you could add an @EventListener +for the AckRemoteApplicationEvent and SentApplicationEvent types +to your app (and enable tracing). Or you could tap into the +TraceRepository and mine the data from there.

+
+
+ + + + + +
+
Note
+		 +Any Bus application can trace acks, but sometimes it will be +useful to do this in a central service that can do more complex +queries on the data. Or forward it to a specialized tracing service. +
+
+
+
+
+

Broadcasting Your Own Events

+
+
+

The Bus can carry any event of type RemoteApplicationEvent, but the +default transport is JSON and the deserializer needs to know which +types are going to be used ahead of time. To register a new type it +needs to be in a subpackage of org.springframework.cloud.bus.event.

+
+
+

To customise the event name you can use @JsonTypeName on your custom class +or rely on the default strategy which is to use the simple name of the class. +Note that both the producer and the consumer will need access to the class +definition.

+
+
+

Registering events in custom packages

+
+

If you cannot or don’t want to use a subpackage of org.springframework.cloud.bus.event +for your custom events, you must specify which packages to scan for events of +type RemoteApplicationEvent using @RemoteApplicationEventScan. Packages +specified with @RemoteApplicationEventScan include subpackages.

+
+
+

For example, if you have a custom event called FooEvent:

+
+
+
+
package com.acme;
+
+public class FooEvent extends RemoteApplicationEvent {
+    ...
+}
+
+
+
+

you can register this event with the deserializer in the following way:

+
+
+
+
package com.acme;
+
+@Configuration
+@RemoteApplicationEventScan
+public class BusConfiguration {
+    ...
+}
+
+
+
+

Without specifying a value, the package of the class where @RemoteApplicationEventScan +is used will be registered. In this example com.acme will be registered using the +package of BusConfiguration.

+
+
+

You can also explicitly specify the packages to scan using the value, basePackages or +basePackageClasses properties on @RemoteApplicationEventScan. For example:

+
+
+
+
package com.acme;
+
+@Configuration
+//@RemoteApplicationEventScan({"com.acme", "foo.bar"})
+//@RemoteApplicationEventScan(basePackages = {"com.acme", "foo.bar", "fizz.buzz"})
+@RemoteApplicationEventScan(basePackageClasses = BusConfiguration.class)
+public class BusConfiguration {
+    ...
+}
+
+
+
+

All examples of @RemoteApplicationEventScan above are equivalent, +in that the com.acme package will be registered by explicitly specifying the +packages on @RemoteApplicationEventScan. Note, you can specify multiple base +packages to scan.

+
+
+
+
+

Spring Cloud Sleuth

+
+
+
+

Adrian Cole, Spencer Gibb, Marcin Grzejszczak, Dave Syer

+
+
+

Edgware.M1

+
+
+

Spring Cloud Sleuth implements a distributed tracing solution for Spring Cloud.

+
+
+
+
+

Terminology

+
+

Spring Cloud Sleuth borrows Dapper’s terminology.

+
+
+

Span: The basic unit of work. For example, sending an RPC is a new span, as is sending a response to an +RPC. Span’s are identified by a unique 64-bit ID for the span and another 64-bit ID for the trace the span +is a part of. Spans also have other data, such as descriptions, timestamped events, key-value +annotations (tags), the ID of the span that caused them, and process ID’s (normally IP address).

+
+
+

Spans are started and stopped, and they keep track of their timing information. Once you create a +span, you must stop it at some point in the future.

+
+
+ + + + + +
+
Tip
+		 +The initial span that starts a trace is called a root span. The value of span id +of that span is equal to trace id. +
+
+
+

Trace: A set of spans forming a tree-like structure. For example, if you are running a distributed +big-data store, a trace might be formed by a put request.

+
+
+

Annotation: is used to record existence of an event in time. Some of the core annotations used to define +the start and stop of a request are:

+
+
+
    +
  • +

    cs - Client Sent - The client has made a request. This annotation depicts the start of the span.

    +
    • +
  • +

    sr - Server Received - The server side got the request and will start processing it. +If one subtracts the cs timestamp from this timestamp one will receive the network latency.

    +
    • +
  • +

    ss - Server Sent - Annotated upon completion of request processing (when the response +got sent back to the client). If one subtracts the sr timestamp from this timestamp one +will receive the time needed by the server side to process the request.

    +
    • +
  • +

    cr - Client Received - Signifies the end of the span. The client has successfully received the +response from the server side. If one subtracts the cs timestamp from this timestamp one +will receive the whole time needed by the client to receive the response from the server.

    +
    • +
+
+
+

Visualization of what Span and Trace will look in a system together with the Zipkin annotations:

+
+
+
+Trace Info propagation +
+
+
+

Each color of a note signifies a span (7 spans - from A to G). If you have such information in the note:

+
+
+
+
Trace Id = X
+Span Id = D
+Client Sent
+
+
+
+

That means that the current span has Trace-Id set to X, Span-Id set to D. It also has emitted + Client Sent event.

+
+
+

This is how the visualization of the parent / child relationship of spans would look like:

+
+
+
+Parent child relationship +
+
+
+
+

Purpose

+
+

In the following sections the example from the image above will be taken into consideration.

+
+
+

Distributed tracing with Zipkin

+
+

Altogether there are 7 spans . If you go to traces in Zipkin you will see this number in the second trace:

+
+
+
+Traces +
+
+
+

However if you pick a particular trace then you will see 4 spans:

+
+
+
+Traces Info propagation +
+
+
+ + + + + +
+
Note
+		 +When picking a particular trace you will see merged spans. That means that if there were 2 spans sent to +Zipkin with Server Received and Server Sent / Client Received and Client Sent +annotations then they will presented as a single span. +
+
+
+

Why is there a difference between the 7 and 4 spans in this case?

+
+
+
    +
  • +

    2 spans come from http:/start span. It has the Server Received (SR) and Server Sent (SS) annotations.

    +
    • +
  • +

    2 spans come from the RPC call from service1 to service2 to the http:/foo endpoint. It has the Client Sent (CS) +and Client Received (CR) annotations on service1 side. It also has Server Received (SR) and Server Sent (SS) annotations +on the service2 side. Physically there are 2 spans but they form 1 logical span related to an RPC call.

    +
    • +
  • +

    2 spans come from the RPC call from service2 to service3 to the http:/bar endpoint. It has the Client Sent (CS) +and Client Received (CR) annotations on service2 side. It also has Server Received (SR) and Server Sent (SS) annotations +on the service3 side. Physically there are 2 spans but they form 1 logical span related to an RPC call.

    +
    • +
  • +

    2 spans come from the RPC call from service2 to service4 to the http:/baz endpoint. It has the Client Sent (CS) +and Client Received (CR) annotations on service2 side. It also has Server Received (SR) and Server Sent (SS) annotations +on the service4 side. Physically there are 2 spans but they form 1 logical span related to an RPC call.

    +
    • +
+
+
+

So if we count the physical spans we have 1 from http:/start, 2 from service1 calling service2, 2 form service2 +calling service3 and 2 from service2 calling service4. Altogether 7 spans.

+
+
+

Logically we see the information of Total Spans: 4 because we have 1 span related to the incoming request +to service1 and 3 spans related to RPC calls.

+
+
+
+

Visualizing errors

+
+

Zipkin allows you to visualize errors in your trace. When an exception was thrown and wasn’t caught then we’re +setting proper tags on the span which Zipkin can properly colorize. You could see in the list of traces one + trace that was in red color. That’s because there was an exception thrown.

+
+
+

If you click that trace then you’ll see a similar picture

+
+
+
+Error Traces +
+
+
+

Then if you click on one of the spans you’ll see the following

+
+
+
+Error Traces Info propagation +
+
+
+

As you can see you can easily see the reason for an error and the whole stacktrace related to it.

+
+
+
+

Live examples

+
+
+Zipkin deployed on Pivotal Web Services +
+
Click Pivotal Web Services icon to see it live!Click Pivotal Web Services icon to see it live!
+
+
+

The dependency graph in Zipkin would look like this:

+
+
+
+Dependencies +
+
+
+
+Zipkin deployed on Pivotal Web Services +
+
Click Pivotal Web Services icon to see it live!Click Pivotal Web Services icon to see it live!
+
+
+
+

Log correlation

+
+

When grepping the logs of those four applications by trace id equal to e.g. 2485ec27856c56f4 one would get the following:

+
+
+
+
service1.log:2016-02-26 11:15:47.561  INFO [service1,2485ec27856c56f4,2485ec27856c56f4,true] 68058 --- [nio-8081-exec-1] i.s.c.sleuth.docs.service1.Application   : Hello from service1. Calling service2
+service2.log:2016-02-26 11:15:47.710  INFO [service2,2485ec27856c56f4,9aa10ee6fbde75fa,true] 68059 --- [nio-8082-exec-1] i.s.c.sleuth.docs.service2.Application   : Hello from service2. Calling service3 and then service4
+service3.log:2016-02-26 11:15:47.895  INFO [service3,2485ec27856c56f4,1210be13194bfe5,true] 68060 --- [nio-8083-exec-1] i.s.c.sleuth.docs.service3.Application   : Hello from service3
+service2.log:2016-02-26 11:15:47.924  INFO [service2,2485ec27856c56f4,9aa10ee6fbde75fa,true] 68059 --- [nio-8082-exec-1] i.s.c.sleuth.docs.service2.Application   : Got response from service3 [Hello from service3]
+service4.log:2016-02-26 11:15:48.134  INFO [service4,2485ec27856c56f4,1b1845262ffba49d,true] 68061 --- [nio-8084-exec-1] i.s.c.sleuth.docs.service4.Application   : Hello from service4
+service2.log:2016-02-26 11:15:48.156  INFO [service2,2485ec27856c56f4,9aa10ee6fbde75fa,true] 68059 --- [nio-8082-exec-1] i.s.c.sleuth.docs.service2.Application   : Got response from service4 [Hello from service4]
+service1.log:2016-02-26 11:15:48.182  INFO [service1,2485ec27856c56f4,2485ec27856c56f4,true] 68058 --- [nio-8081-exec-1] i.s.c.sleuth.docs.service1.Application   : Got response from service2 [Hello from service2, response from service3 [Hello from service3] and from service4 [Hello from service4]]
+
+
+
+

If you’re using a log aggregating tool like Kibana, +Splunk etc. you can order the events that took place. An example of +Kibana would look like this:

+
+
+
+Log correlation with Kibana +
+
+
+

If you want to use Logstash here is the Grok pattern for Logstash:

+
+
+
+
filter {
+       # pattern matching logback pattern
+       grok {
+              match => { "message" => "%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span},%{DATA:exportable}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+       }
+}
+
+
+
+ + + + + +
+
Note
+		 +If you want to use Grok together with the logs from Cloud Foundry you have to use this pattern: +
+
+
+
+
filter {
+       # pattern matching logback pattern
+       grok {
+              match => { "message" => "(?m)OUT\s+%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span},%{DATA:exportable}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+       }
+}
+
+
+
+
JSON Logback with Logstash
+
+

Often you do not want to store your logs in a text file but in a JSON file that Logstash can immediately pick. To do that you have to do the following (for readability +we’re passing the dependencies in the groupId:artifactId:version notation.

+
+
+

Dependencies setup

+
+
+
    +
  • +

    Ensure that Logback is on the classpath (ch.qos.logback:logback-core)

    +
    • +
  • +

    Add Logstash Logback encode - example for version 4.6 : net.logstash.logback:logstash-logback-encoder:4.6

    +
    • +
+
+
+

Logback setup

+
+
+

Below you can find an example of a Logback configuration (file named logback-spring.xml) that:

+
+
+
    +
  • +

    logs information from the application in a JSON format to a build/${spring.application.name}.json file

    +
    • +
  • +

    has commented out two additional appenders - console and standard log file

    +
    • +
  • +

    has the same logging pattern as the one presented in the previous section

    +
    • +
+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+	<include resource="org/springframework/boot/logging/logback/defaults.xml"/>
+	​
+	<springProperty scope="context" name="springAppName" source="spring.application.name"/>
+	<!-- Example for logging into the build folder of your project -->
+	<property name="LOG_FILE" value="${BUILD_FOLDER:-build}/${springAppName}"/>​
+
+	<!-- You can override this to have a custom pattern -->
+	<property name="CONSOLE_LOG_PATTERN"
+			  value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>
+
+	<!-- Appender to log to console -->
+	<appender name="console" class="ch.qos.logback.core.ConsoleAppender">
+		<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
+			<!-- Minimum logging level to be presented in the console logs-->
+			<level>DEBUG</level>
+		</filter>
+		<encoder>
+			<pattern>${CONSOLE_LOG_PATTERN}</pattern>
+			<charset>utf8</charset>
+		</encoder>
+	</appender>
+
+	<!-- Appender to log to file -->​
+	<appender name="flatfile" class="ch.qos.logback.core.rolling.RollingFileAppender">
+		<file>${LOG_FILE}</file>
+		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+			<fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.gz</fileNamePattern>
+			<maxHistory>7</maxHistory>
+		</rollingPolicy>
+		<encoder>
+			<pattern>${CONSOLE_LOG_PATTERN}</pattern>
+			<charset>utf8</charset>
+		</encoder>
+	</appender>
+	​
+	<!-- Appender to log to file in a JSON format -->
+	<appender name="logstash" class="ch.qos.logback.core.rolling.RollingFileAppender">
+		<file>${LOG_FILE}.json</file>
+		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+			<fileNamePattern>${LOG_FILE}.json.%d{yyyy-MM-dd}.gz</fileNamePattern>
+			<maxHistory>7</maxHistory>
+		</rollingPolicy>
+		<encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
+			<providers>
+				<timestamp>
+					<timeZone>UTC</timeZone>
+				</timestamp>
+				<pattern>
+					<pattern>
+						{
+						"severity": "%level",
+						"service": "${springAppName:-}",
+						"trace": "%X{X-B3-TraceId:-}",
+						"span": "%X{X-B3-SpanId:-}",
+						"parent": "%X{X-B3-ParentSpanId:-}",
+						"exportable": "%X{X-Span-Export:-}",
+						"pid": "${PID:-}",
+						"thread": "%thread",
+						"class": "%logger{40}",
+						"rest": "%message"
+						}
+					</pattern>
+				</pattern>
+			</providers>
+		</encoder>
+	</appender>
+	​
+	<root level="INFO">
+		<appender-ref ref="console"/>
+		<!-- uncomment this to have also JSON logs -->
+		<!--<appender-ref ref="logstash"/>-->
+		<!--<appender-ref ref="flatfile"/>-->
+	</root>
+</configuration>
+
+
+
+ + + + + +
+
Note
+		 +If you’re using a custom logback-spring.xml then you have to pass the spring.application.name in +bootstrap instead of application property file. Otherwise your custom logback file won’t read the property properly. +
+
+
+
+
+

Propagating Span Context

+
+

The span context is the state that must get propagated to any child Spans across process boundaries. +Part of the Span Context is the Baggage. The trace and span IDs are a required part of the span context. +Baggage is an optional part.

+
+
+

Baggage is a set of key:value pairs stored in the span context. Baggage travels together with the trace +and is attached to every span. Spring Cloud Sleuth will understand that a header is baggage related if the HTTP + header is prefixed with baggage- and for messaging it starts with baggage_.

+
+
+ + + + + +
+
Important
+		 +There’s currently no limitation of the count or size of baggage items. However, keep in mind that +too many can decrease system throughput or increase RPC latency. In extreme cases, it could crash the app due +to exceeding transport-level message or header capacity. +
+
+
+

Example of setting baggage on a span:

+
+
+
+
Span initialSpan = this.tracer.createSpan("span");
+initialSpan.setBaggageItem("foo", "bar");
+initialSpan.setBaggageItem("UPPER_CASE", "someValue");
+
+
+
+
Baggage vs. Span Tags
+
+

Baggage travels with the trace (i.e. every child span contains the baggage of its parent). Zipkin has no knowledge of +baggage and will not even receive that information.

+
+
+

Tags are attached to a specific span - they are presented for that particular span only. However you +can search by tag to find the trace, where there exists a span having the searched tag value.

+
+
+

If you want to be able to lookup a span based on baggage, you should add corresponding entry as a tag in the root span.

+
+
+
+
@Autowired Tracer tracer;
+
+Span span = tracer.getCurrentSpan();
+String baggageKey = "key";
+String baggageValue = "foo";
+span.setBaggageItem(baggageKey, baggageValue);
+tracer.addTag(baggageKey, baggageValue);
+
+
+
+
+
+
+

Adding to the project

+
+

Only Sleuth (log correlation)

+
+

If you want to profit only from Spring Cloud Sleuth without the Zipkin integration just add +the spring-cloud-starter-sleuth module to your project.

+
+
+
Maven
+
+
<dependencyManagement> (1)
+         <dependencies>
+             <dependency>
+                 <groupId>org.springframework.cloud</groupId>
+                 <artifactId>spring-cloud-dependencies</artifactId>
+                 <version>Camden.RELEASE</version>
+                 <type>pom</type>
+                 <scope>import</scope>
+             </dependency>
+         </dependencies>
+   </dependencyManagement>
+
+   <dependency> (2)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-starter-sleuth</artifactId>
+   </dependency>
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-starter-sleuth

    +
    3. +
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:Camden.RELEASE"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-sleuth"
+}
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-starter-sleuth

    +
    3. +
+
+
+
+

Sleuth with Zipkin via HTTP

+
+

If you want both Sleuth and Zipkin just add the spring-cloud-starter-zipkin dependency.

+
+
+
Maven
+
+
<dependencyManagement> (1)
+         <dependencies>
+             <dependency>
+                 <groupId>org.springframework.cloud</groupId>
+                 <artifactId>spring-cloud-dependencies</artifactId>
+                 <version>Camden.RELEASE</version>
+                 <type>pom</type>
+                 <scope>import</scope>
+             </dependency>
+         </dependencies>
+   </dependencyManagement>
+
+   <dependency> (2)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-starter-zipkin</artifactId>
+   </dependency>
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-starter-zipkin

    +
    3. +
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:Camden.RELEASE"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin"
+}
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-starter-zipkin

    +
    3. +
+
+
+
+

Sleuth with Zipkin via Spring Cloud Stream

+
+

If you want both Sleuth and Zipkin just add the spring-cloud-sleuth-stream dependency.

+
+
+
Maven
+
+
<dependencyManagement> (1)
+         <dependencies>
+             <dependency>
+                 <groupId>org.springframework.cloud</groupId>
+                 <artifactId>spring-cloud-dependencies</artifactId>
+                 <version>Camden.RELEASE</version>
+                 <type>pom</type>
+                 <scope>import</scope>
+             </dependency>
+         </dependencies>
+   </dependencyManagement>
+
+   <dependency> (2)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-sleuth-stream</artifactId>
+   </dependency>
+   <dependency> (3)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-starter-sleuth</artifactId>
+   </dependency>
+   <!-- EXAMPLE FOR RABBIT BINDING -->
+   <dependency> (4)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-stream-binder-rabbit</artifactId>
+   </dependency>
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-sleuth-stream

    +
    3. +
  3. +

    Add the dependency to spring-cloud-starter-sleuth - that way all dependant dependencies will be downloaded

    +
    4. +
  4. +

    Add a binder (e.g. Rabbit binder) to tell Spring Cloud Stream what it should bind to

    +
    5. +
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:Camden.RELEASE"
+    }
+}
+
+dependencies {
+    compile "org.springframework.cloud:spring-cloud-sleuth-stream" (2)
+    compile "org.springframework.cloud:spring-cloud-starter-sleuth" (3)
+    // Example for Rabbit binding
+    compile "org.springframework.cloud:spring-cloud-stream-binder-rabbit" (4)
+}
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-sleuth-stream

    +
    3. +
  3. +

    Add the dependency to spring-cloud-starter-sleuth - that way all dependant dependencies will be downloaded

    +
    4. +
  4. +

    Add a binder (e.g. Rabbit binder) to tell Spring Cloud Stream what it should bind to

    +
    5. +
+
+
+
+

Spring Cloud Sleuth Stream Zipkin Collector

+
+

If you want to start a Spring Cloud Sleuth Stream Zipkin collector just add the spring-cloud-sleuth-zipkin-stream +dependency

+
+
+
Maven
+
+
<dependencyManagement> (1)
+         <dependencies>
+             <dependency>
+                 <groupId>org.springframework.cloud</groupId>
+                 <artifactId>spring-cloud-dependencies</artifactId>
+                 <version>Camden.RELEASE</version>
+                 <type>pom</type>
+                 <scope>import</scope>
+             </dependency>
+         </dependencies>
+   </dependencyManagement>
+
+   <dependency> (2)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-sleuth-zipkin-stream</artifactId>
+   </dependency>
+   <dependency> (3)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-starter-sleuth</artifactId>
+   </dependency>
+   <!-- EXAMPLE FOR RABBIT BINDING -->
+   <dependency> (4)
+       <groupId>org.springframework.cloud</groupId>
+       <artifactId>spring-cloud-stream-binder-rabbit</artifactId>
+   </dependency>
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-sleuth-zipkin-stream

    +
    3. +
  3. +

    Add the dependency to spring-cloud-starter-sleuth - that way all dependant dependencies will be downloaded

    +
    4. +
  4. +

    Add a binder (e.g. Rabbit binder) to tell Spring Cloud Stream what it should bind to

    +
    5. +
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:Camden.RELEASE"
+    }
+}
+
+dependencies {
+    compile "org.springframework.cloud:spring-cloud-sleuth-zipkin-stream" (2)
+    compile "org.springframework.cloud:spring-cloud-starter-sleuth" (3)
+    // Example for Rabbit binding
+    compile "org.springframework.cloud:spring-cloud-stream-binder-rabbit" (4)
+}
+
+
+
+
    +
  1. +

    In order not to pick versions by yourself it’s much better if you add the dependency management via +the Spring BOM

    +
    2. +
  2. +

    Add the dependency to spring-cloud-sleuth-zipkin-stream

    +
    3. +
  3. +

    Add the dependency to spring-cloud-starter-sleuth - that way all dependant dependencies will be downloaded

    +
    4. +
  4. +

    Add a binder (e.g. Rabbit binder) to tell Spring Cloud Stream what it should bind to

    +
    5. +
+
+
+

and then just annotate your main class with @EnableZipkinStreamServer annotation:

+
+
+
+
package example;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.cloud.sleuth.zipkin.stream.EnableZipkinStreamServer;
+
+@SpringBootApplication
+@EnableZipkinStreamServer
+public class ZipkinStreamServerApplication {
+
+	public static void main(String[] args) throws Exception {
+		SpringApplication.run(ZipkinStreamServerApplication.class, args);
+	}
+
+}
+
+
+
+
+
+

Additional resources

+
+
+

Marcin Grzejszczak talking about Spring Cloud Sleuth and Zipkin

+
+
+
+ +
+
+
+

click here to see the video

+
+
+
+
+

Features

+
+
+
    +
  • +

    Adds trace and span ids to the Slf4J MDC, so you can extract all the logs from a given trace or span in a log aggregator. Example logs:

    +
    +
    +
    2016-02-02 15:30:57.902  INFO [bar,6bfd228dc00d216b,6bfd228dc00d216b,false] 23030 --- [nio-8081-exec-3] ...
+2016-02-02 15:30:58.372 ERROR [bar,6bfd228dc00d216b,6bfd228dc00d216b,false] 23030 --- [nio-8081-exec-3] ...
+2016-02-02 15:31:01.936  INFO [bar,46ab0d418373cbc9,46ab0d418373cbc9,false] 23030 --- [nio-8081-exec-4] ...
    +
    +
    +
    +

    notice the [appname,traceId,spanId,exportable] entries from the MDC:

    +
    +
    +
      +
    • +

      spanId - the id of a specific operation that took place

      +
      • +
    • +

      appname - the name of the application that logged the span

      +
      • +
    • +

      traceId - the id of the latency graph that contains the span

      +
      • +
    • +

      exportable - whether the log should be exported to Zipkin or not. When would you like the span not to be +exportable? In the case in which you want to wrap some operation in a Span and have it written to the logs +only.

      +
      • +
    +
    +
    • +
  • +

    Provides an abstraction over common distributed tracing data models: traces, spans (forming a DAG), annotations, +key-value annotations. Loosely based on HTrace, but Zipkin (Dapper) compatible.

    +
    • +
  • +

    Sleuth records timing information to aid in latency analysis. Using sleuth, you can pinpoint causes of +latency in your applications. Sleuth is written to not log too much, and to not cause your production application to crash.

    +
    +
      +
    • +

      propagates structural data about your call-graph in-band, and the rest out-of-band.

      +
      • +
    • +

      includes opinionated instrumentation of layers such as HTTP

      +
      • +
    • +

      includes sampling policy to manage volume

      +
      • +
    • +

      can report to a Zipkin system for query and visualization

      +
      • +
    +
    +
    • +
  • +

    Instruments common ingress and egress points from Spring applications (servlet filter, async endpoints, +rest template, scheduled actions, message channels, zuul filters, feign client).

    +
    • +
  • +

    Sleuth includes default logic to join a trace across http or messaging boundaries. For example, http propagation +works via Zipkin-compatible request headers. This propagation logic is defined and customized via +SpanInjector and SpanExtractor implementations.

    +
    • +
  • +

    Sleuth gives you the possibility to propagate context (also known as baggage) between processes. That means that if you set on a Span +a baggage element then it will be sent downstream either via HTTP or messaging to other processes.

    +
    • +
  • +

    Provides a way to create / continue spans and add tags and logs via annotations.

    +
    • +
  • +

    Provides simple metrics of accepted / dropped spans.

    +
    • +
  • +

    If spring-cloud-sleuth-zipkin then the app will generate and collect Zipkin-compatible traces. +By default it sends them via HTTP to a Zipkin server on localhost (port 9411). +Configure the location of the service using spring.zipkin.baseUrl.

    +
    • +
  • +

    If spring-cloud-sleuth-stream then the app will generate and collect traces via Spring Cloud Stream. +Your app automatically becomes a producer of tracer messages that are sent over your broker of choice +(e.g. RabbitMQ, Apache Kafka, Redis).

    +
    • +
+
+
+ + + + + +
+
Important
+		 +If using Zipkin or Stream, configure the percentage of spans exported using spring.sleuth.sampler.percentage +(default 0.1, i.e. 10%). Otherwise you might think that Sleuth is not working cause it’s omitting some spans. +
+
+
+ + + + + +
+
Note
+		 +the SLF4J MDC is always set and logback users will immediately see the trace and span ids in logs per the example + above. Other logging systems have to configure their own formatter to get the same result. The default is + logging.pattern.level set to %5p [${spring.zipkin.service.name:${spring.application.name:-}},%X{X-B3-TraceId:-},%X{X-B3-SpanId:-},%X{X-Span-Export:-}] + (this is a Spring Boot feature for logback users). + This means that if you’re not using SLF4J this pattern WILL NOT be automatically applied. +
+
+
+
+
+

Sampling

+
+
+

In distributed tracing the data volumes can be very high so sampling +can be important (you usually don’t need to export all spans to get a +good picture of what is happening). Spring Cloud Sleuth has a +Sampler strategy that you can implement to take control of the +sampling algorithm. Samplers do not stop span (correlation) ids from +being generated, but they do prevent the tags and events being +attached and exported. By default you get a strategy that continues to +trace if a span is already active, but new ones are always marked as +non-exportable. If all your apps run with this sampler you will see +traces in logs, but not in any remote store. For testing the default +is often enough, and it probably is all you need if you are only using +the logs (e.g. with an ELK aggregator). If you are exporting span data +to Zipkin or Spring Cloud Stream, there is also an AlwaysSampler +that exports everything and a PercentageBasedSampler that samples a +fixed fraction of spans.

+
+
+ + + + + +
+
Note
+		 +the PercentageBasedSampler is the default if you are using +spring-cloud-sleuth-zipkin or spring-cloud-sleuth-stream. You can +configure the exports using spring.sleuth.sampler.percentage. The passed +value needs to be a double from 0.0 to 1.0 so it’s not a percentage. +For backwards compatibility reasons we’re not changing the property name. +
+
+
+

A sampler can be installed just by creating a bean definition, e.g:

+
+
+
+
@Bean
+public Sampler defaultSampler() {
+	return new AlwaysSampler();
+}
+
+
+
+ + + + + +
+
Tip
+		 +You can set the HTTP header X-B3-Flags to 1 or when doing messaging you can +set spanFlags header to 1. Then the current span will be forced to be exportable +regardless of the sampling decision. +
+
+
+
+
+

Instrumentation

+
+
+

Spring Cloud Sleuth instruments all your Spring application +automatically, so you shouldn’t have to do anything to activate +it. The instrumentation is added using a variety of technologies +according to the stack that is available, e.g. for a servlet web +application we use a Filter, and for Spring Integration we use +ChannelInterceptors.

+
+
+

You can customize the keys used in span tags. To limit the volume of +span data, by default an HTTP request will be tagged only with a +handful of metadata like the status code, host and URL. You can add +request headers by configuring spring.sleuth.keys.http.headers (a +list of header names).

+
+
+ + + + + +
+
Note
+		 +Remember that tags are only collected and exported if there is a +Sampler that allows it (by default there is not, so there is no +danger of accidentally collecting too much data without configuring +something). +
+
+
+ + + + + +
+
Note
+		 +Currently the instrumentation in Spring Cloud Sleuth is eager - it means that +we’re actively trying to pass the tracing context between threads. Also timing events +are captured even when sleuth isn’t exporting data to a tracing system. +This approach may change in the future towards being lazy on this matter. +
+
+
+
+
+

Span lifecycle

+
+
+

You can do the following operations on the Span by means of org.springframework.cloud.sleuth.Tracer interface:

+
+
+
    +
  • +

    start - when you start a span its name is assigned and start timestamp is recorded.

    +
    • +
  • +

    close - the span gets finished (the end time of the span is recorded) and if +the span is exportable then it will be eligible for collection to Zipkin. +The span is also removed from the current thread.

    +
    • +
  • +

    continue - a new instance of span will be created whereas it will be a copy of the +one that it continues.

    +
    • +
  • +

    detach - the span doesn’t get stopped or closed. It only gets removed from the current thread.

    +
    • +
  • +

    create with explicit parent - you can create a new span and set an explicit parent to it

    +
    • +
+
+
+ + + + + +
+
Tip
+		 +Spring creates the instance of Tracer for you. In order to use it all you need is to just autowire it. +
+
+
+

Creating and closing spans

+
+

You can manually create spans by using the Tracer interface.

+
+
+
+
// Start a span. If there was a span present in this thread it will become
+// the `newSpan`'s parent.
+Span newSpan = this.tracer.createSpan("calculateTax");
+try {
+	// ...
+	// You can tag a span
+	this.tracer.addTag("taxValue", taxValue);
+	// ...
+	// You can log an event on a span
+	newSpan.logEvent("taxCalculated");
+} finally {
+	// Once done remember to close the span. This will allow collecting
+	// the span to send it to Zipkin
+	this.tracer.close(newSpan);
+}
+
+
+
+

In this example we could see how to create a new instance of span. Assuming that there already +was a span present in this thread then it would become the parent of that span.

+
+
+ + + + + +
+
Important
+		 +Always clean after you create a span! Don’t forget to close a span if you want to send it to Zipkin. +
+
+
+ + + + + +
+
Important
+		 +If your span contains a name greater than 50 chars, then that name will +be truncated to 50 chars. Your names have to be explicit and concrete. Big names lead to +latency issues and sometimes even thrown exceptions. +
+
+
+
+

Continuing spans

+
+

Sometimes you don’t want to create a new span but you want to continue one. Example of such a +situation might be (of course it all depends on the use-case):

+
+
+
    +
  • +

    AOP - If there was already a span created before an aspect was reached then you might not want to create a new span.

    +
    • +
  • +

    Hystrix - executing a Hystrix command is most likely a logical part of the current processing. It’s in fact +only a technical implementation detail that you wouldn’t necessarily want to reflect in tracing as a separate being.

    +
    • +
+
+
+

The continued instance of span is equal to the one that it continues:

+
+
+
+
Span continuedSpan = this.tracer.continueSpan(spanToContinue);
+assertThat(continuedSpan).isEqualTo(spanToContinue);
+
+
+
+

To continue a span you can use the Tracer interface.

+
+
+
+
// let's assume that we're in a thread Y and we've received
+// the `initialSpan` from thread X
+Span continuedSpan = this.tracer.continueSpan(initialSpan);
+try {
+	// ...
+	// You can tag a span
+	this.tracer.addTag("taxValue", taxValue);
+	// ...
+	// You can log an event on a span
+	continuedSpan.logEvent("taxCalculated");
+} finally {
+	// Once done remember to detach the span. That way you'll
+	// safely remove it from the current thread without closing it
+	this.tracer.detach(continuedSpan);
+}
+
+
+
+ + + + + +
+
Important
+		 +Always clean after you create a span! Don’t forget to detach a span if some work was done started in one + thread (e.g. thread X) and it’s waiting for other threads (e.g. Y, Z) to finish. + Then the spans in the threads Y, Z should be detached at the end of their work. When the results are collected + the span in thread X should be closed. +
+
+
+
+

Creating spans with an explicit parent

+
+

There is a possibility that you want to start a new span and provide an explicit parent of that span. +Let’s assume that the parent of a span is in one thread and you want to start a new span in another thread. The +startSpan method of the Tracer interface is the method you are looking for.

+
+
+
+
// let's assume that we're in a thread Y and we've received
+// the `initialSpan` from thread X. `initialSpan` will be the parent
+// of the `newSpan`
+Span newSpan = this.tracer.createSpan("calculateCommission", initialSpan);
+try {
+	// ...
+	// You can tag a span
+	this.tracer.addTag("commissionValue", commissionValue);
+	// ...
+	// You can log an event on a span
+	newSpan.logEvent("commissionCalculated");
+} finally {
+	// Once done remember to close the span. This will allow collecting
+	// the span to send it to Zipkin. The tags and events set on the
+	// newSpan will not be present on the parent
+	this.tracer.close(newSpan);
+}
+
+
+
+ + + + + +
+
Important
+		 +After having created such a span remember to close it. Otherwise you will see a lot of warnings in your logs + related to the fact that you have a span present in the current thread other than the one you’re trying to close. + What’s worse your spans won’t get closed properly thus will not get collected to Zipkin. +
+
+
+
+
+
+

Naming spans

+
+
+

Picking a span name is not a trivial task. Span name should depict an operation name. The name should +be low cardinality (e.g. not include identifiers).

+
+
+

Since there is a lot of instrumentation going on some of the span names will be +artificial like:

+
+
+
    +
  • +

    controller-method-name when received by a Controller with a method name conrollerMethodName

    +
    • +
  • +

    async for asynchronous operations done via wrapped Callable and Runnable.

    +
    • +
  • +

    @Scheduled annotated methods will return the simple name of the class.

    +
    • +
+
+
+

Fortunately, for the asynchronous processing you can provide explicit naming.

+
+
+

@SpanName annotation

+
+

You can name the span explicitly via the @SpanName annotation.

+
+
+
+
@SpanName("calculateTax")
+class TaxCountingRunnable implements Runnable {
+
+	@Override public void run() {
+		// perform logic
+	}
+}
+
+
+
+

In this case, when processed in the following manner:

+
+
+
+
Runnable runnable = new TraceRunnable(tracer, spanNamer, new TaxCountingRunnable());
+Future<?> future = executorService.submit(runnable);
+// ... some additional logic ...
+future.get();
+
+
+
+

The span will be named calculateTax.

+
+
+
+

toString() method

+
+

It’s pretty rare to create separate classes for Runnable or Callable. Typically one creates an anonymous +instance of those classes. You can’t annotate such classes thus to override that, if there is no @SpanName annotation present, +we’re checking if the class has a custom implementation of the toString() method.

+
+
+

So executing such code:

+
+
+
+
Runnable runnable = new TraceRunnable(tracer, spanNamer, new Runnable() {
+	@Override public void run() {
+		// perform logic
+	}
+
+	@Override public String toString() {
+		return "calculateTax";
+	}
+});
+Future<?> future = executorService.submit(runnable);
+// ... some additional logic ...
+future.get();
+
+
+
+

will lead in creating a span named calculateTax.

+
+
+
+
+
+

Managing spans with annotations

+
+
+

Rationale

+
+

The main arguments for this features are

+
+
+
    +
  • +

    api-agnostic means to collaborate with a span

    +
    +
      +
    • +

      use of annotations allows users to add to a span with no library dependency on a span api. +This allows Sleuth to change its core api less impact to user code.

      +
      • +
    +
    +
    • +
  • +

    reduced surface area for basic span operations.

    +
    +
      +
    • +

      without this feature one has to use the span api, which has lifecycle commands that +could be used incorrectly. By only exposing scope, tag and log functionality, users can +collaborate without accidentally breaking span lifecycle.

      +
      • +
    +
    +
    • +
  • +

    collaboration with runtime generated code

    +
    +
      +
    • +

      with libraries such as Spring Data / Feign the implementations of interfaces are generated +at runtime thus span wrapping of objects was tedious. Now you can provide annotations + over interfaces and arguments of those interfaces

      +
      • +
    +
    +
    • +
+
+
+
+

Creating new spans

+
+

If you really don’t want to take care of creating local spans manually you can profit from the +@NewSpan annotation. Also we give you the @SpanTag annotation to add tags in an automated +fashion.

+
+
+

Let’s look at some examples of usage.

+
+
+
+
@NewSpan
+void testMethod();
+
+
+
+

Annotating the method without any parameter will lead to a creation of a new span whose name +will be equal to annotated method name.

+
+
+
+
@NewSpan("customNameOnTestMethod4")
+void testMethod4();
+
+
+
+

If you provide the value in the annotation (either directly or via the name parameter) then +the created span will have the name as the provided value.

+
+
+
+
// method declaration
+@NewSpan(name = "customNameOnTestMethod5")
+void testMethod5(@SpanTag("testTag") String param);
+
+// and method execution
+this.testBean.testMethod5("test");
+
+
+
+

You can combine both the name and a tag. Let’s focus on the latter. In this case whatever the value of +the annotated method’s parameter runtime value will be - that will be the value of the tag. In our sample +the tag key will be testTag and the tag value will be test.

+
+
+
+
@NewSpan(name = "customNameOnTestMethod3")
+@Override
+public void testMethod3() {
+}
+
+
+
+

You can place the @NewSpan annotation on both the class and an interface. If you override the +interface’s method and provide a different value of the @NewSpan annotation then the most +concrete one wins (in this case customNameOnTestMethod3 will be set).

+
+
+
+

Continuing spans

+
+

If you want to just add tags and annotations to an existing span it’s enough +to use the @ContinueSpan annotation as presented below. Note that in contrast +with the @NewSpan annotation you can also add logs via the log parameter:

+
+
+
+
// method declaration
+@ContinueSpan(log = "testMethod11")
+void testMethod11(@SpanTag("testTag11") String param);
+
+// method execution
+this.testBean.testMethod11("test");
+
+
+
+

That way the span will get continued and:

+
+
+
    +
  • +

    logs with name testMethod11.before and testMethod11.after will be created

    +
    • +
  • +

    if an exception will be thrown a log testMethod11.afterFailure will also be created

    +
    • +
  • +

    tag with key testTag11 and value test will be created

    +
    • +
+
+
+
+

More advanced tag setting

+
+

There are 3 different ways to add tags to a span. All of them are controlled by the SpanTag annotation. +Precedence is:

+
+
+
    +
  • +

    try with the bean of TagValueResolver type and provided name

    +
    • +
  • +

    if one hasn’t provided the bean name, try to evaluate an expression. We’re searching for a TagValueExpressionResolver bean. +The default implementation uses SPEL expression resolution.

    +
    • +
  • +

    if one hasn’t provided any expression to evaluate just return a toString() value of the parameter

    +
    • +
+
+
+

Custom extractor

+
+

The value of the tag for following method will be computed by an implementation of TagValueResolver interface. +Its class name has to be passed as the value of the resolver attribute.

+
+
+

Having such an annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForTagValueResolver(@SpanTag(key = "test", resolver = TagValueResolver.class) String test) {
+}
+
+
+
+

and such a TagValueResolver bean implementation

+
+
+
+
@Bean(name = "myCustomTagValueResolver")
+public TagValueResolver tagValueResolver() {
+	return parameter -> "Value from myCustomTagValueResolver";
+}
+
+
+
+

Will lead to setting of a tag value equal to Value from myCustomTagValueResolver.

+
+
+
+

Resolving expressions for value

+
+

Having such an annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForTagValueExpression(@SpanTag(key = "test", expression = "length() + ' characters'") String test) {
+}
+
+
+
+

and no custom implementation of a TagValueExpressionResolver will lead to evaluation of the SPEL expression and a tag with value 4 characters will be set on the span. +If you want to use some other expression resolution mechanism you can create your own implementation +of the bean.

+
+
+
+

Using toString method

+
+

Having such an annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForArgumentToString(@SpanTag("test") Long param) {
+}
+
+
+
+

if executed with a value of 15 will lead to setting of a tag with a String value of "15".

+
+
+
+
+
+
+

Customizations

+
+
+

Thanks to the SpanInjector and SpanExtractor you can customize the way spans +are created and propagated.

+
+
+

There are currently two built-in ways to pass tracing information between processes:

+
+
+
    +
  • +

    via Spring Integration

    +
    • +
  • +

    via HTTP

    +
    • +
+
+
+

Span ids are extracted from Zipkin-compatible (B3) headers (either Message +or HTTP headers), to start or join an existing trace. Trace information is +injected into any outbound requests so the next hop can extract them.

+
+
+

The key change in comparison to the previous versions of Sleuth is that Sleuth is implementing +the Open Tracing’s TextMap notion. In Sleuth it’s called SpanTextMap. Basically the idea +is that any means of communication (e.g. message, http request, etc.) can be abstracted via +a SpanTextMap. This abstraction defines how one can insert data into the carrier and +how to retrieve it from there. Thanks to this if you want to instrument a new HTTP library +that uses a FooRequest as a mean of sending HTTP requests then you have to create an +implementation of a SpanTextMap that delegates calls to FooRequest in terms of retrieval +and insertion of HTTP headers.

+
+
+

Spring Integration

+
+

For Spring Integration there are 2 interfaces responsible for creation of a Span from a Message. +These are:

+
+
+
    +
  • +

    MessagingSpanTextMapExtractor

    +
    • +
  • +

    MessagingSpanTextMapInjector

    +
    • +
+
+
+

You can override them by providing your own implementation.

+
+
+
+

HTTP

+
+

For HTTP there are 2 interfaces responsible for creation of a Span from a Message. +These are:

+
+
+
    +
  • +

    HttpSpanExtractor

    +
    • +
  • +

    HttpSpanInjector

    +
    • +
+
+
+

You can override them by providing your own implementation.

+
+
+
+

Example

+
+

Let’s assume that instead of the standard Zipkin compatible tracing HTTP header names +you have

+
+
+
    +
  • +

    for trace id - correlationId

    +
    • +
  • +

    for span id - mySpanId

    +
    • +
+
+
+

This is a an example of a SpanExtractor

+
+
+
+
static class CustomHttpSpanExtractor implements HttpSpanExtractor {
+
+	@Override public Span joinTrace(SpanTextMap carrier) {
+		Map<String, String> map = TextMapUtil.asMap(carrier);
+		long traceId = Span.hexToId(map.get("correlationid"));
+		long spanId = Span.hexToId(map.get("myspanid"));
+		// extract all necessary headers
+		Span.SpanBuilder builder = Span.builder().traceId(traceId).spanId(spanId);
+		// build rest of the Span
+		return builder.build();
+	}
+}
+
+static class CustomHttpSpanInjector implements HttpSpanInjector {
+
+	@Override
+	public void inject(Span span, SpanTextMap carrier) {
+		carrier.put("correlationId", span.traceIdString());
+		carrier.put("mySpanId", Span.idToHex(span.getSpanId()));
+	}
+}
+
+
+
+

And you could register it like this:

+
+
+
+
@Bean
+HttpSpanInjector customHttpSpanInjector() {
+	return new CustomHttpSpanInjector();
+}
+
+@Bean
+HttpSpanExtractor customHttpSpanExtractor() {
+	return new CustomHttpSpanExtractor();
+}
+
+
+
+

Spring Cloud Sleuth does not add trace/span related headers to the Http Response for security reasons. If you need the headers then a custom SpanInjector +that injects the headers into the Http Response and a Servlet filter which makes use of this can be added the following way:

+
+
+
+
static class CustomHttpServletResponseSpanInjector extends ZipkinHttpSpanInjector {
+
+	@Override
+	public void inject(Span span, SpanTextMap carrier) {
+		super.inject(span, carrier);
+		carrier.put(Span.TRACE_ID_NAME, span.traceIdString());
+		carrier.put(Span.SPAN_ID_NAME, Span.idToHex(span.getSpanId()));
+	}
+}
+
+static class HttpResponseInjectingTraceFilter extends GenericFilterBean {
+
+	private final Tracer tracer;
+	private final HttpSpanInjector spanInjector;
+
+	public HttpResponseInjectingTraceFilter(Tracer tracer, HttpSpanInjector spanInjector) {
+		this.tracer = tracer;
+		this.spanInjector = spanInjector;
+	}
+
+	@Override
+	public void doFilter(ServletRequest request, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
+		HttpServletResponse response = (HttpServletResponse) servletResponse;
+		Span currentSpan = this.tracer.getCurrentSpan();
+		this.spanInjector.inject(currentSpan, new HttpServletResponseTextMap(response));
+		filterChain.doFilter(request, response);
+	}
+
+	 class HttpServletResponseTextMap implements SpanTextMap {
+
+		 private final HttpServletResponse delegate;
+
+		 HttpServletResponseTextMap(HttpServletResponse delegate) {
+			 this.delegate = delegate;
+		 }
+
+		 @Override
+		 public Iterator<Map.Entry<String, String>> iterator() {
+			 Map<String, String> map = new HashMap<>();
+			 for (String header : this.delegate.getHeaderNames()) {
+				map.put(header, this.delegate.getHeader(header));
+			 }
+			 return map.entrySet().iterator();
+		 }
+
+		 @Override
+		 public void put(String key, String value) {
+			this.delegate.addHeader(key, value);
+		 }
+	 }
+}
+
+
+
+

And you could register them like this:

+
+
+
+
@Bean HttpSpanInjector customHttpServletResponseSpanInjector() {
+	return new CustomHttpServletResponseSpanInjector();
+}
+
+@Bean
+HttpResponseInjectingTraceFilter responseInjectingTraceFilter(Tracer tracer) {
+	return new HttpResponseInjectingTraceFilter(tracer, customHttpServletResponseSpanInjector());
+}
+
+
+
+
+

TraceFilter

+
+

You can also modify the behaviour of the TraceFilter - the component that is responsible +for processing the input HTTP request and adding tags basing on the HTTP response. You can customize +the tags, or modify the response headers by registering your own instance of the TraceFilter bean.

+
+
+

In the following example we will register the TraceFilter bean and we will add the +ZIPKIN-TRACE-ID response header containing the current Span’s trace id. Also we will +add to the Span a tag with key custom and a value tag.

+
+
+
+
@Bean
+TraceFilter myTraceFilter(BeanFactory beanFactory, final Tracer tracer) {
+	return new TraceFilter(beanFactory) {
+		@Override protected void addResponseTags(HttpServletResponse response,
+				Throwable e) {
+			// execute the default behaviour
+			super.addResponseTags(response, e);
+			// for readability we're returning trace id in a hex form
+			response.addHeader("ZIPKIN-TRACE-ID",
+					Span.idToHex(tracer.getCurrentSpan().getTraceId()));
+			// we can also add some custom tags
+			tracer.addTag("custom", "tag");
+		}
+	};
+}
+
+
+
+
+

Custom SA tag in Zipkin

+
+

Sometimes you want to create a manual Span that will wrap a call to an external service which is not instrumented. +What you can do is to create a span with the peer.service tag that will contain a value of the service that you want to call. +Below you can see an example of a call to Redis that is wrapped in such a span.

+
+
+
+
org.springframework.cloud.sleuth.Span newSpan = tracer.createSpan("redis");
+try {
+	newSpan.tag("redis.op", "get");
+	newSpan.tag("lc", "redis");
+	newSpan.logEvent(org.springframework.cloud.sleuth.Span.CLIENT_SEND);
+	// call redis service e.g
+	// return (SomeObj) redisTemplate.opsForHash().get("MYHASH", someObjKey);
+} finally {
+	newSpan.tag("peer.service", "redisService");
+	newSpan.tag("peer.ipv4", "1.2.3.4");
+	newSpan.tag("peer.port", "1234");
+	newSpan.logEvent(org.springframework.cloud.sleuth.Span.CLIENT_RECV);
+	tracer.close(newSpan);
+}
+
+
+
+ + + + + +
+
Important
+		 +Remember not to add both peer.service tag and the SA tag! You have to add only peer.service. +
+
+
+
+

Custom service name

+
+

By default Sleuth assumes that when you send a span to Zipkin, you want the span’s service name + to be equal to spring.application.name value. That’s not always the case though. There + are situations in which you want to explicitly provide a different service name for all spans coming + from your application. To achieve that it’s enough to just pass the following property + to your application to override that value (example for foo service name):

+
+
+
+
spring.zipkin.service.name: foo
+
+
+
+
+

Customization of reported spans

+
+

Before reporting spans to e.g. Zipkin you can be interested in modifying that span in some way. + You can achieve that by using the SpanAdjuster interface.

+
+
+

Example of usage:

+
+
+

In Sleuth we’re generating spans with a fixed name. Some users want to modify the name depending on values +of tags. Implementation of the SpanAdjuster interface can be used to alter that name. Example:

+
+
+
+
@Bean
+SpanAdjuster customSpanAdjuster() {
+    return span -> span.toBuilder().name(scrub(span.getName())).build();
+}
+
+
+
+

This will lead in changing the name of the reported span just before it gets sent to Zipkin.

+
+
+ + + + + +
+
Important
+		 +Your SpanReporter should inject the SpanAdjuster and + allow span manipulation before the actual reporting is done. +
+
+
+
+

Host locator

+
+

In order to define the host that is corresponding to a particular span we need to resolve the host name +and port. The default approach is to take it from server properties. If those for some reason are not set +then we’re trying to retrieve the host name from the network interfaces.

+
+
+

If you have the discovery client enabled and prefer to retrieve the host address from the registered +instance in a service registry then you have to set the property (it’s applicable for both HTTP and +Stream based span reporting).

+
+
+
+
spring.zipkin.locator.discovery.enabled: true
+
+
+
+
+
+
+

Sending spans to Zipkin

+
+
+

By default if you add spring-cloud-starter-zipkin as a dependency to your project, +when the span is closed, it will be sent to Zipkin over HTTP. The communication +is asynchronous. You can configure the URL by setting the spring.zipkin.baseUrl +property as follows:

+
+
+
+
spring.zipkin.baseUrl: http://192.168.99.100:9411/
+
+
+
+

If you want to find Zipkin via service discovery it’s enough to pass the +Zipkin’s service id inside the URL (example for zipkinserver service id)

+
+
+
+
spring.zipkin.baseUrl: http://zipkinserver/
+
+
+
+
+
+

Span Data as Messages

+
+
+

You can accumulate and send span data over +Spring Cloud Stream by +including the spring-cloud-sleuth-stream jar as a dependency, and +adding a Channel Binder implementation +(e.g. spring-cloud-starter-stream-rabbit for RabbitMQ or +spring-cloud-starter-stream-kafka for Kafka). This will +automatically turn your app into a producer of messages with payload +type Spans.

+
+
+

Zipkin Consumer

+
+

There is a special convenience annotation for setting up a message consumer +for the Span data and pushing it into a Zipkin SpanStore. This application

+
+
+
+
@SpringBootApplication
+@EnableZipkinStreamServer
+public class Consumer {
+	public static void main(String[] args) {
+		SpringApplication.run(Consumer.class, args);
+	}
+}
+
+
+
+

will listen for the Span data on whatever transport you provide via a +Spring Cloud Stream Binder (e.g. include +spring-cloud-starter-stream-rabbit for RabbitMQ, and similar +starters exist for Redis and Kafka). If you add the following UI dependency

+
+
+
+
<groupId>io.zipkin.java</groupId>
+<artifactId>zipkin-autoconfigure-ui</artifactId>
+
+
+
+

Then you’ll have your app a +Zipkin server, which hosts +the UI and api on port 9411.

+
+
+

The default SpanStore is in-memory (good for demos and getting +started quickly). For a more robust solution you can add MySQL and +spring-boot-starter-jdbc to your classpath and enable the JDBC +SpanStore via configuration, e.g.:

+
+
+
+
spring:
+  rabbitmq:
+    host: ${RABBIT_HOST:localhost}
+  datasource:
+    schema: classpath:/mysql.sql
+    url: jdbc:mysql://${MYSQL_HOST:localhost}/test
+    username: root
+    password: root
+# Switch this on to create the schema on startup:
+    initialize: true
+    continueOnError: true
+  sleuth:
+    enabled: false
+zipkin:
+  storage:
+    type: mysql
+
+
+
+ + + + + +
+
Note
+		 +The @EnableZipkinStreamServer is also annotated with +@EnableZipkinServer so the process will also expose the standard +Zipkin server endpoints for collecting spans over HTTP, and for +querying in the Zipkin Web UI. +
+
+
+
+

Custom Consumer

+
+

A custom consumer can also easily be implemented using +spring-cloud-sleuth-stream and binding to the SleuthSink. Example:

+
+
+
+
@EnableBinding(SleuthSink.class)
+@SpringBootApplication(exclude = SleuthStreamAutoConfiguration.class)
+@MessageEndpoint
+public class Consumer {
+
+    @ServiceActivator(inputChannel = SleuthSink.INPUT)
+    public void sink(Spans input) throws Exception {
+        // ... process spans
+    }
+}
+
+
+
+ + + + + +
+
Note
+		 +the sample consumer application above explicitly excludes +SleuthStreamAutoConfiguration so it doesn’t send messages to itself, +but this is optional (you might actually want to trace requests into +the consumer app). +
+
+
+

In order to customize the polling mechanism you can create a bean of PollerMetadata type +with name equal to StreamSpanReporter.POLLER. Here you can find an example of such a configuration.

+
+
+
+
@Configuration
+public static class CustomPollerConfiguration {
+
+	@Bean(name = StreamSpanReporter.POLLER)
+	PollerMetadata customPoller() {
+		PollerMetadata poller = new PollerMetadata();
+		poller.setMaxMessagesPerPoll(500);
+		poller.setTrigger(new PeriodicTrigger(5000L));
+		return poller;
+	}
+}
+
+
+
+
+
+
+

Metrics

+
+
+

Currently Spring Cloud Sleuth registers very simple metrics related to spans. +It’s using the Spring Boot’s metrics support +to calculate the number of accepted and dropped spans. Each time a span gets +sent to Zipkin the number of accepted spans will increase. If there’s an error then +the number of dropped spans will get increased.

+
+
+
+
+

Integrations

+
+
+

Runnable and Callable

+
+

If you’re wrapping your logic in Runnable or Callable it’s enough to wrap those classes in their Sleuth representative.

+
+
+

Example for Runnable:

+
+
+
+
Runnable runnable = new Runnable() {
+	@Override
+	public void run() {
+		// do some work
+	}
+
+	@Override
+	public String toString() {
+		return "spanNameFromToStringMethod";
+	}
+};
+// Manual `TraceRunnable` creation with explicit "calculateTax" Span name
+Runnable traceRunnable = new TraceRunnable(tracer, spanNamer, runnable, "calculateTax");
+// Wrapping `Runnable` with `Tracer`. The Span name will be taken either from the
+// `@SpanName` annotation or from `toString` method
+Runnable traceRunnableFromTracer = tracer.wrap(runnable);
+
+
+
+

Example for Callable:

+
+
+
+
Callable<String> callable = new Callable<String>() {
+	@Override
+	public String call() throws Exception {
+		return someLogic();
+	}
+
+	@Override
+	public String toString() {
+		return "spanNameFromToStringMethod";
+	}
+};
+// Manual `TraceCallable` creation with explicit "calculateTax" Span name
+Callable<String> traceCallable = new TraceCallable<>(tracer, spanNamer, callable, "calculateTax");
+// Wrapping `Callable` with `Tracer`. The Span name will be taken either from the
+// `@SpanName` annotation or from `toString` method
+Callable<String> traceCallableFromTracer = tracer.wrap(callable);
+
+
+
+

That way you will ensure that a new Span is created and closed for each execution.

+
+
+
+

Hystrix

+
+

Custom Concurrency Strategy

+
+

We’re registering a custom HystrixConcurrencyStrategy +that wraps all Callable instances into their Sleuth representative - +the TraceCallable. The strategy either starts or continues a span depending on the fact whether tracing was already going +on before the Hystrix command was called. To disable the custom Hystrix Concurrency Strategy set the spring.sleuth.hystrix.strategy.enabled to false.

+
+
+
+

Manual Command setting

+
+

Assuming that you have the following HystrixCommand:

+
+
+
+
HystrixCommand<String> hystrixCommand = new HystrixCommand<String>(setter) {
+	@Override
+	protected String run() throws Exception {
+		return someLogic();
+	}
+};
+
+
+
+

In order to pass the tracing information you have to wrap the same logic in the Sleuth version of the HystrixCommand which is the +TraceCommand:

+
+
+
+
TraceCommand<String> traceCommand = new TraceCommand<String>(tracer, traceKeys, setter) {
+	@Override
+	public String doRun() throws Exception {
+		return someLogic();
+	}
+};
+
+
+
+
+
+

RxJava

+
+

We’re registering a custom RxJavaSchedulersHook +that wraps all Action0 instances into their Sleuth representative - +the TraceAction. The hook either starts or continues a span depending on the fact whether tracing was already going +on before the Action was scheduled. To disable the custom RxJavaSchedulersHook set the spring.sleuth.rxjava.schedulers.hook.enabled to false.

+
+
+

You can define a list of regular expressions for thread names, for which you don’t want a Span to be created. Just provide a comma separated list +of regular expressions in the spring.sleuth.rxjava.schedulers.ignoredthreads property.

+
+
+
+

HTTP integration

+
+

Features from this section can be disabled by providing the spring.sleuth.web.enabled property with value equal to false.

+
+
+

HTTP Filter

+
+

Via the TraceFilter all sampled incoming requests result in creation of a Span. That Span’s name is http: + the path to which + the request was sent. E.g. if the request was sent to /foo/bar then the name will be http:/foo/bar. You can configure which URIs you would + like to skip via the spring.sleuth.web.skipPattern property. If you have ManagementServerProperties on classpath then + its value of contextPath gets appended to the provided skip pattern.

+
+
+
+

HandlerInterceptor

+
+

Since we want the span names to be precise we’re using a TraceHandlerInterceptor that either wraps an + existing HandlerInterceptor or is added directly to the list of existing HandlerInterceptors. The + TraceHandlerInterceptor adds a special request attribute to the given HttpServletRequest. If the + the TraceFilter doesn’t see this attribute set it will create a "fallback" span which is an additional + span created on the server side so that the trace is presented properly in the UI. Seeing that most likely + signifies that there is a missing instrumentation. In that case please file an issue in Spring Cloud Sleuth.

+
+
+
+

Async Servlet support

+
+

If your controller returns a Callable or a WebAsyncTask Spring Cloud Sleuth will continue the existing span instead of creating a new one.

+
+
+
+
+

HTTP client integration

+
+

Synchronous Rest Template

+
+

We’re injecting a RestTemplate interceptor that ensures that all the tracing information is passed to the requests. Each time a +call is made a new Span is created. It gets closed upon receiving the response. In order to block the synchronous RestTemplate features +just set spring.sleuth.web.client.enabled to false.

+
+
+ + + + + +
+
Important
+		 +You have to register RestTemplate as a bean so that the interceptors will get injected. +If you create a RestTemplate instance with a new keyword then the instrumentation WILL NOT work. +
+
+
+
+

Asynchronous Rest Template

+
+ + + + + +
+
Important
+		 +A traced version of an AsyncRestTemplate bean is registered for you out of the box. If you +have your own bean you have to wrap it in a TraceAsyncRestTemplate representation. The best solution +is to only customize the ClientHttpRequestFactory and / or AsyncClientHttpRequestFactory. +If you have your own AsyncRestTemplate and you don’t wrap it your calls WILL NOT GET TRACED. +
+
+
+

Custom instrumentation is set to create and close Spans upon sending and receiving requests. You can customize the ClientHttpRequestFactory +and the AsyncClientHttpRequestFactory by registering your beans. Remember to use tracing compatible implementations (e.g. don’t forget to +wrap ThreadPoolTaskScheduler in a TraceAsyncListenableTaskExecutor). Example of custom request factories:

+
+
+
+
@EnableAutoConfiguration
+@Configuration
+public static class TestConfiguration {
+
+	@Bean
+	ClientHttpRequestFactory mySyncClientFactory() {
+		return new MySyncClientHttpRequestFactory();
+	}
+
+	@Bean
+	AsyncClientHttpRequestFactory myAsyncClientFactory() {
+		return new MyAsyncClientHttpRequestFactory();
+	}
+}
+
+
+
+

To block the AsyncRestTemplate features set spring.sleuth.web.async.client.enabled to false. +To disable creation of the default TraceAsyncClientHttpRequestFactoryWrapper set spring.sleuth.web.async.client.factory.enabled +to false. If you don’t want to create AsyncRestClient at all set spring.sleuth.web.async.client.template.enabled to false.

+
+
+
Multiple Asynchronous Rest Templates
+
+

Sometimes you need to use multiple implementations of Asynchronous Rest Template. In the following snippet you +can see an example of how to set up such a custom AsyncRestTemplate.

+
+
+
+
@Configuration
+@EnableAutoConfiguration
+static class Config {
+	@Autowired Tracer tracer;
+	@Autowired HttpTraceKeysInjector httpTraceKeysInjector;
+	@Autowired HttpSpanInjector spanInjector;
+
+	@Bean(name = "customAsyncRestTemplate")
+	public AsyncRestTemplate traceAsyncRestTemplate(@Qualifier("customHttpRequestFactoryWrapper")
+			TraceAsyncClientHttpRequestFactoryWrapper wrapper, ErrorParser errorParser) {
+		return new TraceAsyncRestTemplate(wrapper, this.tracer, errorParser);
+	}
+
+	@Bean(name = "customHttpRequestFactoryWrapper")
+	public TraceAsyncClientHttpRequestFactoryWrapper traceAsyncClientHttpRequestFactory() {
+		return new TraceAsyncClientHttpRequestFactoryWrapper(this.tracer,
+				this.spanInjector,
+				asyncClientFactory(),
+				clientHttpRequestFactory(),
+				this.httpTraceKeysInjector);
+	}
+
+	private ClientHttpRequestFactory clientHttpRequestFactory() {
+		ClientHttpRequestFactory clientHttpRequestFactory = new CustomClientHttpRequestFactory();
+		//CUSTOMIZE HERE
+		return clientHttpRequestFactory;
+	}
+
+	private AsyncClientHttpRequestFactory asyncClientFactory() {
+		AsyncClientHttpRequestFactory factory = new CustomAsyncClientHttpRequestFactory();
+		//CUSTOMIZE HERE
+		return factory;
+	}
+}
+
+
+
+
+
+

Traverson

+
+

If you’re using the Traverson library +it’s enough for you to inject a RestTemplate as a bean into your Traverson object. Since RestTemplate +is already intercepted, you will get full support of tracing in your client. Below you can find a pseudo code +of how to do that:

+
+
+
+
@Autowired RestTemplate restTemplate;
+
+Traverson traverson = new Traverson(URI.create("http://some/address"),
+    MediaType.APPLICATION_JSON, MediaType.APPLICATION_JSON_UTF8).setRestOperations(restTemplate);
+// use Traverson
+
+
+
+
+
+

Feign

+
+

By default Spring Cloud Sleuth provides integration with feign via the TraceFeignClientAutoConfiguration. You can disable it entirely +by setting spring.sleuth.feign.enabled to false. If you do so then no Feign related instrumentation will take place.

+
+
+

Part of Feign instrumentation is done via a FeignBeanPostProcessor. You can disable it by providing the spring.sleuth.feign.processor.enabled equal to false. +If you set it like this then Spring Cloud Sleuth will not instrument any of your custom Feign components. All the default instrumentation +however will be still there.

+
+
+
+

Asynchronous communication

+
+

@Async annotated methods

+
+

In Spring Cloud Sleuth we’re instrumenting async related components so that the tracing information is passed between threads. +You can disable this behaviour by setting the value of spring.sleuth.async.enabled to false.

+
+
+

If you annotate your method with @Async then we’ll automatically create a new Span with the following characteristics:

+
+
+
    +
  • +

    if the method is annotated with @SpanName then the value of the annotation will be the Span’s name

    +
    • +
  • +

    if the method is not annotated with @SpanName the Span name will be the annotated method name

    +
    • +
  • +

    the Span will be tagged with that method’s class name and the method name too

    +
    • +
+
+
+
+

@Scheduled annotated methods

+
+

In Spring Cloud Sleuth we’re instrumenting scheduled method execution so that the tracing information is passed between threads. You can disable this behaviour +by setting the value of spring.sleuth.scheduled.enabled to false.

+
+
+

If you annotate your method with @Scheduled then we’ll automatically create a new Span with the following characteristics:

+
+
+
    +
  • +

    the Span name will be the annotated method name

    +
    • +
  • +

    the Span will be tagged with that method’s class name and the method name too

    +
    • +
+
+
+

If you want to skip Span creation for some @Scheduled annotated classes you can set the +spring.sleuth.scheduled.skipPattern with a regular expression that will match the fully qualified name of the +@Scheduled annotated class.

+
+
+ + + + + +
+
Tip
+		 +If you are using spring-cloud-sleuth-stream and spring-cloud-netflix-hystrix-stream together, Span will be created for each Hystrix metrics and sent to Zipkin. This may be annoying. You can prevent this by setting spring.sleuth.scheduled.skipPattern=org.springframework.cloud.netflix.hystrix.stream.HystrixStreamTask +
+
+
+
+

Executor, ExecutorService and ScheduledExecutorService

+
+

We’re providing LazyTraceExecutor, TraceableExecutorService and TraceableScheduledExecutorService. Those implementations +are creating Spans each time a new task is submitted, invoked or scheduled.

+
+
+

Here you can see an example of how to pass tracing information with TraceableExecutorService when working with CompletableFuture:

+
+
+
+
CompletableFuture<Long> completableFuture = CompletableFuture.supplyAsync(() -> {
+	// perform some logic
+	return 1_000_000L;
+}, new TraceableExecutorService(executorService,
+		// 'calculateTax' explicitly names the span - this param is optional
+		tracer, traceKeys, spanNamer, "calculateTax"));
+
+
+
+
Customization of Executors
+
+

Sometimes you need to set up a custom instance of the AsyncExecutor. In the following snippet you +can see an example of how to set up such a custom Executor.

+
+
+
+
@Configuration
+@EnableAutoConfiguration
+@EnableAsync
+static class CustomExecutorConfig extends AsyncConfigurerSupport {
+
+	@Autowired BeanFactory beanFactory;
+
+	@Override public Executor getAsyncExecutor() {
+		ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+		// CUSTOMIZE HERE
+		executor.setCorePoolSize(7);
+		executor.setMaxPoolSize(42);
+		executor.setQueueCapacity(11);
+		executor.setThreadNamePrefix("MyExecutor-");
+		// DON'T FORGET TO INITIALIZE
+		executor.initialize();
+		return new LazyTraceExecutor(this.beanFactory, executor);
+	}
+}
+
+
+
+
+
+
+

Messaging

+
+

Spring Cloud Sleuth integrates with Spring Integration. It creates spans for publish and +subscribe events. To disable Spring Integration instrumentation, set spring.sleuth.integration.enabled to false.

+
+
+

You can provide the spring.sleuth.integration.patterns pattern to explicitly +provide the names of channels that you want to include for tracing. By default all channels +are included.

+
+
+ + + + + +
+
Important
+		 +When using the Executor to build a Spring Integration IntegrationFlow remember to use the untraced version of the Executor. +Decorating Spring Integration Executor Channel with TraceableExecutorService will cause the spans to be improperly closed. +
+
+
+
+

Zuul

+
+

We’re registering Zuul filters to propagate the tracing information (the request header is enriched with tracing data). +To disable Zuul support set the spring.sleuth.zuul.enabled property to false.

+
+
+
+
+
+

Running examples

+
+
+

You can find the running examples deployed in the Pivotal Web Services. Check them out in the following links:

+
+
+ +
+
+
+

Spring Cloud Consul

+
+
+
+

Edgware.M1

+
+
+

This project provides Consul integrations for Spring Boot apps through autoconfiguration +and binding to the Spring Environment and other Spring programming model idioms. With a few +simple annotations you can quickly enable and configure the common patterns inside your +application and build large distributed systems with Consul based components. The +patterns provided include Service Discovery, Control Bus and Configuration. +Intelligent Routing (Zuul) and Client Side Load Balancing (Ribbon), Circuit Breaker +(Hystrix) are provided by integration with Spring Cloud Netflix.

+
+
+
+
+

Install Consul

+
+
+

Please see the installation documentation for instructions on how to install Consul.

+
+
+
+
+

Consul Agent

+
+
+

A Consul Agent client must be available to all Spring Cloud Consul applications. By default, the Agent client is expected to be at localhost:8500. See the Agent documentation for specifics on how to start an Agent client and how to connect to a cluster of Consul Agent Servers. For development, after you have installed consul, you may start a Consul Agent using the following command:

+
+
+
+
./src/main/bash/local_run_consul.sh
+
+
+
+

This will start an agent in server mode on port 8500, with the ui available at http://localhost:8500

+
+
+
+
+

Service Discovery with Consul

+
+
+

Service Discovery is one of the key tenets of a microservice based architecture. Trying to hand configure each client or some form of convention can be very difficult to do and can be very brittle. Consul provides Service Discovery services via an HTTP API and DNS. Spring Cloud Consul leverages the HTTP API for service registration and discovery. This does not prevent non-Spring Cloud applications from leveraging the DNS interface. Consul Agents servers are run in a cluster that communicates via a gossip protocol and uses the Raft consensus protocol.

+
+
+

How to activate

+
+

To activate Consul Service Discovery use the starter with group org.springframework.cloud and artifact id spring-cloud-starter-consul-discovery. See the Spring Cloud Project page for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+
+

Registering with Consul

+
+

When a client registers with Consul, it provides meta-data about itself such as host and port, id, name and tags. An HTTP Check is created by default that Consul hits the /health endpoint every 10 seconds. If the health check fails, the service instance is marked as critical.

+
+
+

Example Consul client:

+
+
+
+
@SpringBootApplication
+@EnableDiscoveryClient
+@RestController
+public class Application {
+
+    @RequestMapping("/")
+    public String home() {
+        return "Hello world";
+    }
+
+    public static void main(String[] args) {
+        new SpringApplicationBuilder(Application.class).web(true).run(args);
+    }
+
+}
+
+
+
+

(i.e. utterly normal Spring Boot app). If the Consul client is located somewhere other than localhost:8500, the configuration is required to locate the client. Example:

+
+
+
application.yml
+
+
spring:
+  cloud:
+    consul:
+      host: localhost
+      port: 8500
+
+
+
+ + + + + +
+
Caution
+		 +If you use Spring Cloud Consul Config, the above values will need to be placed in bootstrap.yml instead of application.yml. +
+
+
+

The default service name, instance id and port, taken from the Environment, are ${spring.application.name}, the Spring Context ID and ${server.port} respectively.

+
+
+

@EnableDiscoveryClient make the app into both a Consul "service" (i.e. it registers itself) and a "client" (i.e. it can query Consul to locate other services).

+
+
+
+

HTTP Health Check

+
+

The health check for a Consul instance defaults to "/health", which is the default locations of a useful endpoint in a Spring Boot Actuator application. You need to change these, even for an Actuator application if you use a non-default context path or servlet path (e.g. server.servletPath=/foo) or management endpoint path (e.g. management.context-path=/admin). The interval that Consul uses to check the health endpoint may also be configured. "10s" and "1m" represent 10 seconds and 1 minute respectively. Example:

+
+
+
application.yml
+
+
spring:
+  cloud:
+    consul:
+      discovery:
+        healthCheckPath: ${management.context-path}/health
+        healthCheckInterval: 15s
+
+
+
+

Metadata and Consul tags

+
+

Consul does not yet support metadata on services. Spring Cloud’s ServiceInstance has a Map<String, String> metadata field. Spring Cloud Consul uses Consul tags to approximate metadata until Consul officially supports metadata. Tags with the form key=value will be split and used as a Map key and value respectively. Tags without the equal = sign, will be used as both the key and value.

+
+
+
application.yml
+
+
spring:
+  cloud:
+    consul:
+      discovery:
+        tags: foo=bar, baz
+
+
+
+

The above configuration will result in a map with foo→bar and baz→baz.

+
+
+
+

Making the Consul Instance ID Unique

+
+

By default a consul instance is registered with an ID that is equal to its Spring Application Context ID. By default, the Spring Application Context ID is ${spring.application.name}:comma,separated,profiles:${server.port}. For most cases, this will allow multiple instances of one service to run on one machine. If further uniqueness is required, Using Spring Cloud you can override this by providing a unique identifier in spring.cloud.consul.discovery.instanceId. For example:

+
+
+
application.yml
+
+
spring:
+  cloud:
+    consul:
+      discovery:
+        instanceId: ${spring.application.name}:${vcap.application.instance_id:${spring.application.instance_id:${random.value}}}
+
+
+
+

With this metadata, and multiple service instances deployed on localhost, the random value will kick in there to make the instance unique. In Cloudfoundry the vcap.application.instance_id will be populated automatically in a Spring Boot application, so the random value will not be needed.

+
+
+
+
+

Using the DiscoveryClient

+
+

Spring Cloud has support for Feign (a REST client builder) and also Spring RestTemplate using the logical service names instead of physical URLs.

+
+
+

You can also use the org.springframework.cloud.client.discovery.DiscoveryClient which provides a simple API for discovery clients that is not specific to Netflix, e.g.

+
+
+
+
@Autowired
+private DiscoveryClient discoveryClient;
+
+public String serviceUrl() {
+    List<ServiceInstance> list = discoveryClient.getInstances("STORES");
+    if (list != null && list.size() > 0 ) {
+        return list.get(0).getUri();
+    }
+    return null;
+}
+
+
+
+
+
+
+

Distributed Configuration with Consul

+
+
+

Consul provides a Key/Value Store for storing configuration and other metadata. Spring Cloud Consul Config is an alternative to the Config Server and Client. Configuration is loaded into the Spring Environment during the special "bootstrap" phase. Configuration is stored in the /config folder by default. Multiple PropertySource instances are created based on the application’s name and the active profiles that mimicks the Spring Cloud Config order of resolving properties. For example, an application with the name "testApp" and with the "dev" profile will have the following property sources created:

+
+
+
+
config/testApp,dev/
+config/testApp/
+config/application,dev/
+config/application/
+
+
+
+

The most specific property source is at the top, with the least specific at the bottom. Properties is the config/application folder are applicable to all applications using consul for configuration. Properties in the config/testApp folder are only available to the instances of the service named "testApp".

+
+
+

Configuration is currently read on startup of the application. Sending a HTTP POST to /refresh will cause the configuration to be reloaded. Watching the key value store (which Consul supports) is not currently possible, but will be a future addition to this project.

+
+
+

How to activate

+
+

To get started with Consul Configuration use the starter with group org.springframework.cloud and artifact id spring-cloud-starter-consul-config. See the Spring Cloud Project page for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+

This will enable auto-configuration that will setup Spring Cloud Consul Config.

+
+
+
+

Customizing

+
+

Consul Config may be customized using the following properties:

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    consul:
+      config:
+        enabled: true
+        prefix: configuration
+        defaultContext: apps
+        profileSeparator: '::'
+
+
+
+
    +
  • +

    enabled setting this value to "false" disables Consul Config

    +
    • +
  • +

    prefix sets the base folder for configuration values

    +
    • +
  • +

    defaultContext sets the folder name used by all applications

    +
    • +
  • +

    profileSeparator sets the value of the separator used to separate the profile name in property sources with profiles

    +
    • +
+
+
+
+

Config Watch

+
+

The Consul Config Watch takes advantage of the ability of consul to watch a key prefix. The Config Watch makes a blocking Consul HTTP API call to determine if any relevant configuration data has changed for the current application. If there is new configuration data a Refresh Event is published. This is equivalent to calling the /refresh actuator endpoint.

+
+
+

To change the frequency of when the Config Watch is called change spring.cloud.consul.config.watch.delay. The default value is 1000, which is in milliseconds.

+
+
+

To disable the Config Watch set spring.cloud.consul.config.watch.enabled=false.

+
+
+
+

YAML or Properties with Config

+
+

It may be more convenient to store a blob of properties in YAML or Properties format as opposed to individual key/value pairs. Set the spring.cloud.consul.config.format property to YAML or PROPERTIES. For example to use YAML:

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    consul:
+      config:
+        format: YAML
+
+
+
+

YAML must be set in the appropriate data key in consul. Using the defaults above the keys would look like:

+
+
+
+
config/testApp,dev/data
+config/testApp/data
+config/application,dev/data
+config/application/data
+
+
+
+

You could store a YAML document in any of the keys listed above.

+
+
+

You can change the data key using spring.cloud.consul.config.data-key.

+
+
+
+

git2consul with Config

+
+

git2consul is a Consul community project that loads files from a git repository to individual keys into Consul. By default the names of the keys are names of the files. YAML and Properties files are supported with file extensions of .yml and .properties respectively. Set the spring.cloud.consul.config.format property to FILES. For example:

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    consul:
+      config:
+        format: FILES
+
+
+
+

Given the following keys in /config, the development profile and an application name of foo:

+
+
+
+
.gitignore
+application.yml
+bar.properties
+foo-development.properties
+foo-production.yml
+foo.properties
+master.ref
+
+
+
+

the following property sources would be created:

+
+
+
+
config/foo-development.properties
+config/foo.properties
+config/application.yml
+
+
+
+

The value of each key needs to be a properly formatted YAML or Properties file.

+
+
+
+

Fail Fast

+
+

It may be convenient in certain circumstances (like local development or certain test scenarios) to not fail if consul isn’t available for configuration. Setting spring.cloud.consul.config.failFast=false in bootstrap.yml will cause the configuration module to log a warning rather than throw an exception. This will allow the application to continue startup normally.

+
+
+
+
+
+

Consul Retry

+
+
+

If you expect that the consul agent may occasionally be unavailable when +your app starts, you can ask it to keep trying after a failure. You need to add +spring-retry and spring-boot-starter-aop to your classpath. The default +behaviour is to retry 6 times with an initial backoff interval of 1000ms and an +exponential multiplier of 1.1 for subsequent backoffs. You can configure these +properties (and others) using spring.cloud.consul.retry.* configuration properties. +This works with both Spring Cloud Consul Config and Discovery registration.

+
+
+ + + + + +
+
Tip
+		 +To take full control of the retry add a @Bean of type +RetryOperationsInterceptor with id "consulRetryInterceptor". Spring +Retry has a RetryInterceptorBuilder that makes it easy to create one. +
+
+
+
+
+

Spring Cloud Bus with Consul

+
+
+

How to activate

+
+

To get started with the Consul Bus use the starter with group org.springframework.cloud and artifact id spring-cloud-starter-consul-bus. See the Spring Cloud Project page for details on setting up your build system with the current Spring Cloud Release Train.

+
+
+

See the Spring Cloud Bus documentation for the available actuator endpoints and howto send custom messages.

+
+
+
+
+
+

Circuit Breaker with Hystrix

+
+
+

Applications can use the Hystrix Circuit Breaker provided by the Spring Cloud Netflix project by including this starter in the projects pom.xml: spring-cloud-starter-hystrix. Hystrix doesn’t depend on the Netflix Discovery Client. The @EnableHystrix annotation should be placed on a configuration class (usually the main class). Then methods can be annotated with @HystrixCommand to be protected by a circuit breaker. See the documentation for more details.

+
+
+
+
+

Hystrix metrics aggregation with Turbine and Consul

+
+
+

Turbine (provided by the Spring Cloud Netflix project), aggregates multiple instances Hystrix metrics streams, so the dashboard can display an aggregate view. Turbine uses the DiscoveryClient interface to lookup relevant instances. To use Turbine with Spring Cloud Consul, configure the Turbine application in a manner similar to the following examples:

+
+
+
pom.xml
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-netflix-turbine</artifactId>
+</dependency>
+<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-consul-discovery</artifactId>
+</dependency>
+
+
+
+

Notice that the Turbine dependency is not a starter. The turbine starter includes support for Netflix Eureka.

+
+
+
application.yml
+
+
spring.application.name: turbine
+applications: consulhystrixclient
+turbine:
+  aggregator:
+    clusterConfig: ${applications}
+  appConfig: ${applications}
+
+
+
+

The clusterConfig and appConfig sections must match, so it’s useful to put the comma-separated list of service ID’s into a separate configuration property.

+
+
+
Turbine.java
+
+
@EnableTurbine
+@EnableDiscoveryClient
+@SpringBootApplication
+public class Turbine {
+    public static void main(String[] args) {
+        SpringApplication.run(DemoturbinecommonsApplication.class, args);
+    }
+}
+
+
+
+
+

Spring Cloud Zookeeper

+
+
+This project provides Zookeeper integrations for Spring Boot apps through autoconfiguration +and binding to the Spring Environment and other Spring programming model idioms. With a few +simple annotations you can quickly enable and configure the common patterns inside your +application and build large distributed systems with Zookeeper based components. The +patterns provided include Service Discovery and Configuration. +Intelligent Routing (Zuul) and Client Side Load Balancing (Ribbon), Circuit Breaker +(Hystrix) are provided by integration with Spring Cloud Netflix. +
+
+
+

Install Zookeeper

+
+
+

Please see the installation documentation for instructions on how to install Zookeeper.

+
+
+
+
+

Service Discovery with Zookeeper

+
+
+

Service Discovery is one of the key tenets of a microservice based architecture. Trying to hand configure each client or some form of convention can be very difficult to do and can be very brittle. Curator(A java library for Zookeeper) provides Service Discovery services via Service Discovery Extension. Spring Cloud Zookeeper leverages this extension for service registration and discovery.

+
+
+

How to activate

+
+

Including a dependency on org.springframework.cloud:spring-cloud-starter-zookeeper-discovery will enable auto-configuration that will setup Spring Cloud Zookeeper Discovery.

+
+
+ + + + + +
+
Note
+		 +You still need to include org.springframework.boot:spring-boot-starter-web for web functionality. +
+
+
+
+

Registering with Zookeeper

+
+

When a client registers with Zookeeper, it provides meta-data about itself such as host and port, id and name.

+
+
+

Example Zookeeper client:

+
+
+
+
@SpringBootApplication
+@EnableDiscoveryClient
+@RestController
+public class Application {
+
+    @RequestMapping("/")
+    public String home() {
+        return "Hello world";
+    }
+
+    public static void main(String[] args) {
+        new SpringApplicationBuilder(Application.class).web(true).run(args);
+    }
+
+}
+
+
+
+

(i.e. utterly normal Spring Boot app). If Zookeeper is located somewhere other than localhost:2181, the configuration is required to locate the server. Example:

+
+
+
application.yml
+
+
spring:
+  cloud:
+    zookeeper:
+      connect-string: localhost:2181
+
+
+
+ + + + + +
+
Caution
+		 +If you use Spring Cloud Zookeeper Config, the above values will need to be placed in bootstrap.yml instead of application.yml. +
+
+
+

The default service name, instance id and port, taken from the Environment, are ${spring.application.name}, the Spring Context ID and ${server.port} respectively.

+
+
+

@EnableDiscoveryClient makes the app into both a Zookeeper "service" (i.e. it registers itself) and a "client" (i.e. it can query Zookeeper to locate other services).

+
+
+
+

Using the DiscoveryClient

+
+

Spring Cloud has support for Feign (a REST client builder) and also Spring RestTemplate using the logical service names instead of physical URLs.

+
+
+

You can also use the org.springframework.cloud.client.discovery.DiscoveryClient which provides a simple API for discovery clients that is not specific to Netflix, e.g.

+
+
+
+
@Autowired
+private DiscoveryClient discoveryClient;
+
+public String serviceUrl() {
+    List<ServiceInstance> list = discoveryClient.getInstances("STORES");
+    if (list != null && list.size() > 0 ) {
+        return list.get(0).getUri().toString();
+    }
+    return null;
+}
+
+
+
+
+
+
+

Using Spring Cloud Zookeeper with Spring Cloud Netflix Components

+
+
+

Spring Cloud Netflix supplies useful tools that work regardless of which DiscoveryClient implementation is used. Feign, Turbine, Ribbon and Zuul all work with Spring Cloud Zookeeper.

+
+
+

Ribbon with Zookeeper

+
+

Spring Cloud Zookeeper provides an implementation of Ribbon’s ServerList. When the spring-cloud-starter-zookeeper-discovery is used, Ribbon is auto-configured to use the ZookeeperServerList by default.

+
+
+
+
+
+

Spring Cloud Zookeeper and Service Registry

+
+
+

Spring Cloud Zookeeper implements the ServiceRegistry interface allowing developers to register arbitrary service in a programmatic way.

+
+
+

The ServiceInstanceRegistration class offers a builder() method to create a Registration object that can be used by the ServiceRegistry.

+
+
+
+
@Autowired
+private ZookeeperServiceRegistry serviceRegistry;
+
+public void registerThings() {
+    ZookeeperRegistration registration = ServiceInstanceRegistration.builder()
+            .defaultUriSpec()
+            .address("anyUrl")
+            .port(10)
+            .name("/a/b/c/d/anotherservice")
+            .build();
+    this.serviceRegistry.register(registration);
+}
+
+
+
+

Instance Status

+
+

Netflix Eureka supports having instances registered with the server that are OUT_OF_SERVICE and not returned as active service instances. This is very useful for behaviors such as blue/green deployments. The Curator Service Discovery recipe does not support this behavior. Taking advantage of the flexible payload has let Spring Cloud Zookeeper implement OUT_OF_SERVICE by updating some specific metadata and then filtering on that metadata in the Ribbon ZookeeperServerList. The ZookeeperServerList filters out all non-null instance statuses that do not equal UP. If the instance status field is empty, it is considered UP for backwards compatibility. To change the status of an instance POST OUT_OF_SERVICE to the ServiceRegistry instance status actuator endpoint.

+
+
+
+
----
+$ echo -n OUT_OF_SERVICE | http POST http://localhost:8081/service-registry/instance-status
+----
+
+
+
+
+
NOTE: The above example uses the `http` command from https://httpie.org
+
+
+
+
+
+
+

Zookeeper Dependencies

+
+
+

Using the Zookeeper Dependencies

+
+

Spring Cloud Zookeeper gives you a possibility to provide dependencies of your application as properties. As dependencies you can understand other applications that are registered +in Zookeeper and which you would like to call via Feign (a REST client builder) +and also Spring RestTemplate.

+
+
+

You can also benefit from the Zookeeper Dependency Watchers functionality that lets you control and monitor what is the state of your dependencies and decide what to do with that.

+
+
+
+

How to activate Zookeeper Dependencies

+
+
    +
  • +

    Including a dependency on org.springframework.cloud:spring-cloud-starter-zookeeper-discovery will enable auto-configuration that will setup Spring Cloud Zookeeper Dependencies.

    +
    • +
  • +

    If you have to have the spring.cloud.zookeeper.dependencies section properly set up - check the subsequent section for more details then the feature is active

    +
    • +
  • +

    You can have the dependencies turned off even if you’ve provided the dependencies in your properties. Just set the property spring.cloud.zookeeper.dependency.enabled to false (defaults to true).

    +
    • +
+
+
+
+

Setting up Zookeeper Dependencies

+
+

Let’s take a closer look at an example of dependencies representation:

+
+
+
application.yml
+
+
spring.application.name: yourServiceName
+spring.cloud.zookeeper:
+  dependencies:
+    newsletter:
+      path: /path/where/newsletter/has/registered/in/zookeeper
+      loadBalancerType: ROUND_ROBIN
+      contentTypeTemplate: application/vnd.newsletter.$version+json
+      version: v1
+      headers:
+        header1:
+            - value1
+        header2:
+            - value2
+      required: false
+      stubs: org.springframework:foo:stubs
+    mailing:
+      path: /path/where/mailing/has/registered/in/zookeeper
+      loadBalancerType: ROUND_ROBIN
+      contentTypeTemplate: application/vnd.mailing.$version+json
+      version: v1
+      required: true
+
+
+
+

Let’s now go through each part of the dependency one by one. The root property name is spring.cloud.zookeeper.dependencies.

+
+
+

Aliases

+
+

Below the root property you have to represent each dependency has by an alias due to the constraints of Ribbon (the application id has to be placed in the URL +thus you can’t pass any complex path like /foo/bar/name). The alias will be the name that you will use instead of serviceId for DiscoveryClient, Feign or RestTemplate.

+
+
+

In the aforementioned examples the aliases are newsletter and mailing. Example of Feign usage with newsletter would be:

+
+
+
+
@FeignClient("newsletter")
+public interface NewsletterService {
+        @RequestMapping(method = RequestMethod.GET, value = "/newsletter")
+        String getNewsletters();
+}
+
+
+
+
+

Path

+
+

Represented by path yaml property.

+
+
+

Path is the path under which the dependency is registered under Zookeeper. Like presented before Ribbon operates on URLs thus this path is not compliant with its requirement. +That is why Spring Cloud Zookeeper maps the alias to the proper path.

+
+
+
+

Load balancer type

+
+

Represented by loadBalancerType yaml property.

+
+
+

If you know what kind of load balancing strategy has to be applied when calling this particular dependency then you can provide it in the yaml file and it will be automatically applied. +You can choose one of the following load balancing strategies

+
+
+
    +
  • +

    STICKY - once chosen the instance will always be called

    +
    • +
  • +

    RANDOM - picks an instance randomly

    +
    • +
  • +

    ROUND_ROBIN - iterates over instances over and over again

    +
    • +
+
+
+
+

Content-Type template and version

+
+

Represented by contentTypeTemplate and version yaml property.

+
+
+

If you version your api via the Content-Type header then you don’t want to add this header to each of your requests. Also if you want to call a new version of the API you don’t want to +roam around your code to bump up the API version. That’s why you can provide a contentTypeTemplate with a special $version placeholder. That placeholder will be filled by the value of the +version yaml property. Let’s take a look at an example.

+
+
+

Having the following contentTypeTemplate:

+
+
+
+
application/vnd.newsletter.$version+json
+
+
+
+

and the following version:

+
+
+
+
v1
+
+
+
+

Will result in setting up of a Content-Type header for each request:

+
+
+
+
application/vnd.newsletter.v1+json
+
+
+
+
+

Default headers

+
+

Represented by headers map in yaml

+
+
+

Sometimes each call to a dependency requires setting up of some default headers. In order not to do that in code you can set them up in the yaml file. +Having the following headers section:

+
+
+
+
headers:
+    Accept:
+        - text/html
+        - application/xhtml+xml
+    Cache-Control:
+        - no-cache
+
+
+
+

Results in adding the Accept and Cache-Control headers with appropriate list of values in your HTTP request.

+
+
+
+

Obligatory dependencies

+
+

Represented by required property in yaml

+
+
+

If one of your dependencies is required to be up and running when your application is booting then it’s enough to set up the required: true property in the yaml file.

+
+
+

If your application can’t localize the required dependency during boot time it will throw an exception and the Spring Context will fail to set up. +In other words your application won’t be able to start if the required dependency is not registered in Zookeeper.

+
+
+

You can read more about Spring Cloud Zookeeper Presence Checker in the following sections.

+
+
+
+

Stubs

+
+

You can provide a colon separated path to the JAR containing stubs of the dependency. Example

+
+
+
+
stubs: org.springframework:foo:stubs
+
+
+
+

means that for a particular dependencies can be found under:

+
+
+
    +
  • +

    groupId: org.springframework

    +
    • +
  • +

    artifactId: foo

    +
    • +
  • +

    classifier: stubs - this is the default value

    +
    • +
+
+
+

This is actually equal to

+
+
+
+
stubs: org.springframework:foo
+
+
+
+

since stubs is the default classifier.

+
+
+
+
+

Configuring Spring Cloud Zookeeper Dependencies

+
+

There is a bunch of properties that you can set to enable / disable parts of Zookeeper Dependencies functionalities.

+
+
+
    +
  • +

    spring.cloud.zookeeper.dependencies - if you don’t set this property you won’t benefit from Zookeeper Dependencies

    +
    • +
  • +

    spring.cloud.zookeeper.dependency.ribbon.enabled (enabled by default) - Ribbon requires explicit global configuration or a particular one for a dependency. By turning on this property +runtime load balancing strategy resolution is possible and you can profit from the loadBalancerType section of the Zookeeper Dependencies. The configuration that needs this property +has an implementation of LoadBalancerClient that delegates to the ILoadBalancer presented in the next bullet

    +
    • +
  • +

    spring.cloud.zookeeper.dependency.ribbon.loadbalancer (enabled by default) - thanks to this property the custom ILoadBalancer knows that the part of the URI passed to Ribbon might +actually be the alias that has to be resolved to a proper path in Zookeeper. Without this property you won’t be able to register applications under nested paths.

    +
    • +
  • +

    spring.cloud.zookeeper.dependency.headers.enabled (enabled by default) - this property registers such a RibbonClient that automatically will append appropriate headers and content +types with version as presented in the Dependency configuration. Without this setting of those two parameters will not be operational.

    +
    • +
  • +

    spring.cloud.zookeeper.dependency.resttemplate.enabled (enabled by default) - when enabled will modify the request headers of @LoadBalanced annotated RestTemplate so that it passes +headers and content type with version set in Dependency configuration. Wihtout this setting of those two parameters will not be operational.

    +
    • +
+
+
+
+
+
+

Spring Cloud Zookeeper Dependency Watcher

+
+
+

The Dependency Watcher mechanism allows you to register listeners to your dependencies. The functionality is in fact an implementation of the Observator pattern. When a dependency changes +its state (UP or DOWN) then some custom logic can be applied.

+
+
+

How to activate

+
+

Spring Cloud Zookeeper Dependencies functionality needs to be enabled to profit from Dependency Watcher mechanism.

+
+
+
+

Registering a listener

+
+

In order to register a listener you have to implement an interface org.springframework.cloud.zookeeper.discovery.watcher.DependencyWatcherListener and register it as a bean. +The interface gives you one method:

+
+
+
+
    void stateChanged(String dependencyName, DependencyState newState);
+
+
+
+

If you want to register a listener for a particular dependency then the dependencyName would be the discriminator for your concrete implementation. newState will provide you with information + whether your dependency has changed to CONNECTED or DISCONNECTED.

+
+
+
+

Presence Checker

+
+

Bound with Dependency Watcher is the functionality called Presence Checker. It allows you to provide custom behaviour upon booting of your application to react accordingly to the state +of your dependencies.

+
+
+

The default implementation of the abstract org.springframework.cloud.zookeeper.discovery.watcher.presence.DependencyPresenceOnStartupVerifier class is the +org.springframework.cloud.zookeeper.discovery.watcher.presence.DefaultDependencyPresenceOnStartupVerifier which works in the following way.

+
+
+
    +
  • +

    If the dependency is marked us required and it’s not in Zookeeper then upon booting your application will throw an exception and shutdown

    +
    • +
  • +

    If dependency is not required the org.springframework.cloud.zookeeper.discovery.watcher.presence.LogMissingDependencyChecker will log that application is missing at WARN level

    +
    • +
+
+
+

The functionality can be overriden since the DefaultDependencyPresenceOnStartupVerifier is registered only when there is no bean of DependencyPresenceOnStartupVerifier.

+
+
+
+
+
+

Distributed Configuration with Zookeeper

+
+
+

Zookeeper provides a hierarchical namespace that allows clients to store arbitrary data, such as configuration data. Spring Cloud Zookeeper Config is an alternative to the Config Server and Client. Configuration is loaded into the Spring Environment during the special "bootstrap" phase. Configuration is stored in the /config namespace by default. Multiple PropertySource instances are created based on the application’s name and the active profiles that mimicks the Spring Cloud Config order of resolving properties. For example, an application with the name "testApp" and with the "dev" profile will have the following property sources created:

+
+
+
+
config/testApp,dev
+config/testApp
+config/application,dev
+config/application
+
+
+
+

The most specific property source is at the top, with the least specific at the bottom. Properties is the config/application namespace are applicable to all applications using zookeeper for configuration. Properties in the config/testApp namespace are only available to the instances of the service named "testApp".

+
+
+

Configuration is currently read on startup of the application. Sending a HTTP POST to /refresh will cause the configuration to be reloaded. Watching the configuration namespace (which Zookeeper supports) is not currently implemented, but will be a future addition to this project.

+
+
+

How to activate

+
+

Including a dependency on org.springframework.cloud:spring-cloud-starter-zookeeper-config will enable auto-configuration that will setup Spring Cloud Zookeeper Config.

+
+
+
+

Customizing

+
+

Zookeeper Config may be customized using the following properties:

+
+
+
bootstrap.yml
+
+
spring:
+  cloud:
+    zookeeper:
+      config:
+        enabled: true
+        root: configuration
+        defaultContext: apps
+        profileSeparator: '::'
+
+
+
+
    +
  • +

    enabled setting this value to "false" disables Zookeeper Config

    +
    • +
  • +

    root sets the base namespace for configuration values

    +
    • +
  • +

    defaultContext sets the name used by all applications

    +
    • +
  • +

    profileSeparator sets the value of the separator used to separate the profile name in property sources with profiles

    +
    • +
+
+
+
+

ACLs

+
+

You can add authentication information for Zookeeper ACLs by calling the addAuthInfo method of a +CuratorFramework bean. One way to accomplish this is by providing your own CuratorFramework bean:

+
+
+
+
@BoostrapConfiguration
+public class CustomCuratorFrameworkConfig {
+
+  @Bean
+  public CuratorFramework curatorFramework() {
+    CuratorFramework curator = new CuratorFramework();
+    curator.addAuthInfo("digest", "user:password".getBytes());
+    return curator;
+  }
+
+}
+
+
+
+

Consult the ZookeeperAutoConfiguration class +to see how the CuratorFramework bean is configured by default.

+
+
+

Alternatively, you can add your credentials from a class that depends on the existing +CuratorFramework bean:

+
+
+
+
@BoostrapConfiguration
+public class DefaultCuratorFrameworkConfig {
+
+  public ZookeeperConfig(CuratorFramework curator) {
+    curator.addAuthInfo("digest", "user:password".getBytes());
+  }
+
+}
+
+
+
+

This must occur during the boostrapping phase. You can register configuration classes to run +during this phase by annotating them with @BootstrapConfiguration and including them in a +comma-separated list set as the value of the property +org.springframework.cloud.bootstrap.BootstrapConfiguration in the file +resources/META-INF/spring.factories:

+
+
+
resources/META-INF/spring.factories
+
+
org.springframework.cloud.bootstrap.BootstrapConfiguration=\
+my.project.CustomCuratorFrameworkConfig,\
+my.project.DefaultCuratorFrameworkConfig
+
+
+
+

Unresolved directive in spring-cloud.adoc - include::/Users/ryanjbaxter/git-repos/spring-cloud/scripts/docs/../cli/docs/src/main/asciidoc/spring-cloud-cli.adoc[]

+
+
+
+
+

Spring Cloud Security

+
+
+
+

Spring Cloud Security offers a set of primitives for building secure +applications and services with minimum fuss. A declarative model which +can be heavily configured externally (or centrally) lends itself to +the implementation of large systems of co-operating, remote components, +usually with a central indentity management service. It is also extremely +easy to use in a service platform like Cloud Foundry. Building on +Spring Boot and Spring Security OAuth2 we can quickly create systems that +implement common patterns like single sign on, token relay and token +exchange.

+
+
+ + + + + +
+
Note
+		 +Spring Cloud is released under the non-restrictive Apache 2.0 license. If you would like to contribute to this section of the documentation or if you find an error, please find the source code and issue trackers in the project at github. +
+
+
+
+
+

Quickstart

+
+
+

OAuth2 Single Sign On

+
+

Here’s a Spring Cloud "Hello World" app with HTTP Basic +authentication and a single user account:

+
+
+
app.groovy
+
+
@Grab('spring-boot-starter-security')
+@Controller
+class Application {
+
+  @RequestMapping('/')
+  String home() {
+    'Hello World'
+  }
+
+}
+
+
+
+

You can run it with spring run app.groovy and watch the logs for the password (username is "user"). So far this is just the default for a Spring Boot app.

+
+
+

Here’s a Spring Cloud app with OAuth2 SSO:

+
+
+
app.groovy
+
+
@Controller
+@EnableOAuth2Sso
+class Application {
+
+  @RequestMapping('/')
+  String home() {
+    'Hello World'
+  }
+
+}
+
+
+
+

Spot the difference? This app will actually behave exactly the same as +the previous one, because it doesn’t know it’s OAuth2 credentals +yet.

+
+
+

You can register an app in github quite easily, so try that if you +want a production app on your own domain. If you are happy to test on +localhost:8080, then set up these properties in your application +configuration:

+
+
+
application.yml
+
+
security:
+  oauth2:
+    client:
+      clientId: bd1c0a783ccdd1c9b9e4
+      clientSecret: 1a9030fbca47a5b2c28e92f19050bb77824b5ad1
+      accessTokenUri: https://github.com/login/oauth/access_token
+      userAuthorizationUri: https://github.com/login/oauth/authorize
+      clientAuthenticationScheme: form
+    resource:
+      userInfoUri: https://api.github.com/user
+      preferTokenInfo: false
+
+
+
+

run the app above and it will redirect to github for authorization. If +you are already signed into github you won’t even notice that it has +authenticated. These credentials will only work if your app is +running on port 8080.

+
+
+

To limit the scope that the client asks for when it obtains an access token +you can set security.oauth2.client.scope (comma separated or an array in YAML). By +default the scope is empty and it is up to to Authorization Server to +decide what the defaults should be, usually depending on the settings in +the client registration that it holds.

+
+
+ + + + + +
+
Note
+		 +The examples above are all Groovy scripts. If you want to write the +same code in Java (or Groovy) you need to add Spring Security OAuth2 +to the classpath (e.g. see the +sample here). +
+
+
+
+

OAuth2 Protected Resource

+
+

You want to protect an API resource with an OAuth2 token? Here’s a +simple example (paired with the client above):

+
+
+
app.groovy
+
+
@Grab('spring-cloud-starter-security')
+@RestController
+@EnableResourceServer
+class Application {
+
+  @RequestMapping('/')
+  def home() {
+    [message: 'Hello World']
+  }
+
+}
+
+
+
+

and

+
+
+
application.yml
+
+
security:
+  oauth2:
+    resource:
+      userInfoUri: https://api.github.com/user
+      preferTokenInfo: false
+
+
+
+
+
+
+

More Detail

+
+
+

Single Sign On

+
+ + + + + +
+
Note
+		 +All of the OAuth2 SSO and resource server features moved to Spring Boot +in version 1.3. You can find documentation in the +Spring Boot user guide. +
+
+
+
+

Token Relay

+
+

A Token Relay is where an OAuth2 consumer acts as a Client and +forwards the incoming token to outgoing resource requests. The +consumer can be a pure Client (like an SSO application) or a Resource +Server.

+
+
+

Client Token Relay

+
+

If your app is a user facing OAuth2 client (i.e. has declared +@EnableOAuth2Sso or @EnableOAuth2Client) then it has an +OAuth2ClientContext in request scope from Spring Boot. You can +create your own OAuth2RestTemplate from this context and an +autowired OAuth2ProtectedResourceDetails, and then the context will +always forward the access token downstream, also refreshing the access +token automatically if it expires. (These are features of Spring +Security and Spring Boot.)

+
+
+ + + + + +
+
Note
+		 +Spring Boot (1.4.1) does not create an +OAuth2ProtectedResourceDetails automatically if you are using +client_credentials tokens. In that case you need to create your own +ClientCredentialsResourceDetails and configure it with +@ConfigurationProperties("security.oauth2.client"). +
+
+
+
+

Client Token Relay in Zuul Proxy

+
+

If your app also has a +Spring +Cloud Zuul embedded reverse proxy (using @EnableZuulProxy) then you +can ask it to forward OAuth2 access tokens downstream to the services +it is proxying. Thus the SSO app above can be enhanced simply like +this:

+
+
+
app.groovy
+
+
@Controller
+@EnableOAuth2Sso
+@EnableZuulProxy
+class Application {
+
+}
+
+
+
+

and it will (in addition to logging the user in and grabbing a token) +pass the authentication token downstream to the /proxy/* +services. If those services are implemented with +@EnableResourceServer then they will get a valid token in the +correct header.

+
+
+

How does it work? The @EnableOAuth2Sso annotation pulls in +spring-cloud-starter-security (which you could do manually in a +traditional app), and that in turn triggers some autoconfiguration for +a ZuulFilter, which itself is activated because Zuul is on the +classpath (via @EnableZuulProxy). The +filter +just extracts an access token from the currently authenticated user, +and puts it in a request header for the downstream requests.

+
+
+
+

Resource Server Token Relay

+
+

If your app has @EnableResourceServer you might want to relay the +incoming token downstream to other services. If you use a +RestTemplate to contact the downstream services then this is just a +matter of how to create the template with the right context.

+
+
+

If your service uses UserInfoTokenServices to authenticate incoming +tokens (i.e. it is using the security.oauth2.user-info-uri +configuration), then you can simply create an OAuth2RestTemplate +using an autowired OAuth2ClientContext (it will be populated by the +authentication process before it hits the backend code). Equivalently +(with Spring Boot 1.4), you could inject a +UserInfoRestTemplateFactory and grab its OAuth2RestTemplate in +your configuration. For example:

+
+
+
MyConfiguration.java
+
+
@Bean
+public OAuth2RestTemplate restTemplate(UserInfoRestTemplateFactory factory) {
+    return factory.getUserInfoRestTemplate();
+}
+
+
+
+

This rest template will then have the same OAuth2ClientContext +(request-scoped) that is used by the authentication filter, so you can +use it to send requests with the same access token.

+
+
+

If your app is not using UserInfoTokenServices but is still a client +(i.e. it declares @EnableOAuth2Client or @EnableOAuth2Sso), then +with Spring Security Cloud any OAuth2RestOperations that the user +creates from an @Autowired @OAuth2Context will also forward +tokens. This feature is implemented by default as an MVC handler +interceptor, so it only works in Spring MVC. If you are not using MVC +you could use a custom filter or AOP interceptor wrapping an +AccessTokenContextRelay to provide the same feature.

+
+
+

Here’s a basic +example showing the use of an autowired rest template created +elsewhere ("foo.com" is a Resource Server accepting the same tokens as +the surrounding app):

+
+
+
MyController.java
+
+
@Autowired
+private OAuth2RestOperations restTemplate;
+
+@RequestMapping("/relay")
+public String relay() {
+    ResponseEntity<String> response =
+      restTemplate.getForEntity("https://foo.com/bar", String.class);
+    return "Success! (" + response.getBody() + ")";
+}
+
+
+
+

If you don’t want to forward tokens (and that is a valid +choice, since you might want to act as yourself, rather than the +client that sent you the token), then you only need to create your own +OAuth2Context instead of autowiring the default one.

+
+
+

Feign clients will also pick up an interceptor that uses the +OAuth2ClientContext if it is available, so they should also do a +token relay anywhere where a RestTemplate would.

+
+
+
+
+
+
+

Configuring Authentication Downstream of a Zuul Proxy

+
+
+

You can control the authorization behaviour downstream of an +@EnableZuulProxy through the proxy.auth.* settings. Example:

+
+
+
application.yml
+
+
proxy:
+  auth:
+    routes:
+      customers: oauth2
+      stores: passthru
+      recommendations: none
+
+
+
+

In this example the "customers" service gets an OAuth2 token relay, +the "stores" service gets a passthrough (the authorization header is +just passed downstream), and the "recommendations" service has its +authorization header removed. The default behaviour is to do a token +relay if there is a token available, and passthru otherwise.

+
+
+

See + +ProxyAuthenticationProperties for full details.

+
+
+
+

Spring Cloud for Cloud Foundry

+
+
+
+

Spring Cloud for Cloudfoundry makes it easy to run +Spring Cloud apps in +Cloud Foundry (the Platform as a +Service). Cloud Foundry has the notion of a "service", which is +middlware that you "bind" to an app, essentially providing it with an +environment variable containing credentials (e.g. the location and +username to use for the service).

+
+
+

The spring-cloud-cloudfoundry-web project provides basic support for +some enhanced features of webapps in Cloud Foundry: binding +automatically to single-sign-on services and optionally enabling +sticky routing for discovery.

+
+
+

The spring-cloud-cloudfoundry-discovery project provides an +implementation of Spring Cloud Commons DiscoveryClient so you can +@EnableDiscoveryClient and provide your credentials as +spring.cloud.cloudfoundry.discovery.[email,password] and then you +can use the DiscoveryClient directly or via a LoadBalancerClient +(also *.url if you are not connecting to +Pivotal Web Services).

+
+
+

The first time you use it the discovery client might be slow owing to +the fact that it has to get an access token from Cloud Foundry.

+
+
+
+
+

Discovery

+
+
+

Here’s a Spring Cloud app with Cloud Foundry discovery:

+
+
+
app.groovy
+
+
@Grab('org.springframework.cloud:spring-cloud-cloudfoundry')
+@RestController
+@EnableDiscoveryClient
+class Application {
+
+  @Autowired
+  DiscoveryClient client
+
+  @RequestMapping('/')
+  String home() {
+    'Hello from ' + client.getLocalServiceInstance()
+  }
+
+}
+
+
+
+

If you run it without any service bindings:

+
+
+
+
$ spring jar app.jar app.groovy
+$ cf push -p app.jar
+
+
+
+

It will show its app name in the home page.

+
+
+

The DiscoveryClient can lists all the apps in a space, according to +the credentials it is authenticated with, where the space defaults to +the one the client is running in (if any). If neither org nor space +are configured, they default per the user’s profile in Cloud Foundry.

+
+
+
+
+

Single Sign On

+
+
+ + + + + +
+
Note
+		 +All of the OAuth2 SSO and resource server features moved to Spring Boot +in version 1.3. You can find documentation in the +Spring Boot user guide. +
+
+
+

This project provides automatic binding from CloudFoundry service +credentials to the Spring Boot features. If you have a CloudFoundry +service called "sso", for instance, with credentials containing +"client_id", "client_secret" and "auth_domain", it will bind +automatically to the Spring OAuth2 client that you enable with +@EnableOAuth2Sso (from Spring Boot). The name of the service can be +parameterized using spring.oauth2.sso.serviceId.

+
+
+
+

Spring Cloud Contract

+
+
+
+

Documentation Authors: Adam Dudczak, Mathias Düsterhöft, Marcin Grzejszczak, Dennis Kieselhorst, Jakub Kubryński, Karol Lassak, +Olga Maciaszek-Sharma, Mariusz Smykuła, Dave Syer

+
+
+

Edgware.M1

+
+
+
+
+

1. Spring Cloud Contract

+
+
+

What you always need is confidence in pushing new features into a new application or service in a distributed system. +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, asserting that a contract is kept by producers +and consumers, for HTTP and message-based interactions.

+
+
+
+
+

2. Spring Cloud Contract Verifier

+
+
+

2.1. Introduction

+
+ + + + + +
+ + +The Accurest project was initially started by Marcin Grzejszczak and Jakub Kubrynski (codearte.io) +
+
+
+

Just to make long story short - Spring Cloud Contract Verifier is a tool that enables Consumer Driven Contract (CDC) development of JVM-based applications. It is shipped +with Contract Definition Language (DSL). Contract definitions are used to produce following resources:

+
+
+
    +
  • +

    JSON stub definitions to be used by WireMock when doing integration testing on the client code (client tests). +Test code must still be written by hand, test data is produced by Spring Cloud Contract Verifier.

    +
    • +
  • +

    Messaging routes if you’re using one. We’re integrating with Spring Integration, Spring Cloud Stream, Spring AMQP and Apache Camel. You can however set your own integrations if you want to

    +
    • +
  • +

    Acceptance tests (in JUnit or Spock) used to verify if server-side implementation of the API is compliant with the contract (server tests). +Full test is generated by Spring Cloud Contract Verifier.

    +
    • +
+
+
+

Spring Cloud Contract Verifier moves TDD to the level of software architecture.

+
+
+

2.1.1. Why?

+
+

Let us assume that we have a system comprising of multiple microservices:

+
+
+
+Microservices Architecture +
+
+
+
Testing issues
+
+

If we wanted to test the application in top left corner if it can communicate with other services then we could do one of two things:

+
+
+
    +
  • +

    deploy all microservices and perform end to end tests

    +
    • +
  • +

    mock other microservices in unit / integration tests

    +
    • +
+
+
+

Both have their advantages but also a lot of disadvantages. Let’s focus on the latter.

+
+
+

Deploy all microservices and perform end to end tests

+
+
+

Advantages:

+
+
+
    +
  • +

    simulates production

    +
    • +
  • +

    tests real communication between services

    +
    • +
+
+
+

Disadvantages:

+
+
+
    +
  • +

    to test one microservice we would have to deploy 6 microservices, a couple of databases etc.

    +
    • +
  • +

    the environment where the tests would be conducted would be locked for a single suite of tests (i.e. nobody else would be able to run the tests in the meantime).

    +
    • +
  • +

    long to run

    +
    • +
  • +

    very late feedback

    +
    • +
  • +

    extremely hard to debug

    +
    • +
+
+
+

Mock other microservices in unit / integration tests

+
+
+

Advantages:

+
+
+
    +
  • +

    very fast feedback

    +
    • +
  • +

    no infrastructure requirements

    +
    • +
+
+
+

Disadvantages:

+
+
+
    +
  • +

    the implementor of the service creates stubs thus they might have nothing to do with the reality

    +
    • +
  • +

    you can go to production with passing tests and failing production

    +
    • +
+
+
+

To solve the aforementioned issues Spring Cloud Contract Verifier with Stub Runner were created. Their 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 is using directly.

+
+
+
+Stubbed Services +
+
+
+

Spring Cloud Contract Verifier gives you the certainty that the stubs that you’re using were created by the service that you’re calling. Also if you can use them it means that they were +tested against the producer’s side. In other words - you can trust those stubs.

+
+
+
+
+

2.1.2. Purposes

+
+

The main purposes of Spring Cloud Contract Verifier with Stub Runner are:

+
+
+
    +
  • +

    to ensure that WireMock / Messaging stubs (used when developing the client) are doing exactly what actual server-side implementation will do,

    +
    • +
  • +

    to promote ATDD method and Microservices architectural style,

    +
    • +
  • +

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

    +
    • +
  • +

    to generate boilerplate test code used on the server side.

    +
    • +
+
+
+ + + + + +
+ + +Spring Cloud Contract Verifier’s purpose is NOT to start writing business features in the contracts. +Let’s 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 2 contracts. One for the positive and one for the negative fraud case. +Contract tests are used to test contracts between applications and not to simulate full behaviour. +
+
+
+
+

2.1.3. How

+
+
Define the contract
+
+

As consumers we need to define what exactly we want to achieve. We need to formulate our expectations. That’s why we write the following contract.

+
+
+

Let’s assume that we’d like to send the request containing the id of the client and the amount he wants to borrow from us. We’d like to send it to the /fraudcheck url via the PUT method.

+
+
+
+
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 200 // (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 `clientId` 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 `clientId` 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.*`
+ */
+
+
+
+
+
Client Side
+
+

Spring Cloud Contract will generate stubs, which you can use during client side testing. +You will have a WireMock instance / Messaging route up and running that simulates the service Y. +You would like to feed that instance with a proper stub definition.

+
+
+

At some point in time you need to send a request to the Fraud Detection service.

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

Annotate your test class with @AutoConfigureStubRunner. In the annotation provide the group id and artifact id for the Stub Runner to download stubs of your collaborators.

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"}, workOffline = true)
+@DirtiesContext
+public class LoanApplicationServiceTests {
+
+
+
+

After that, during the tests Spring Cloud Contract will automatically find the stubs (simulating the real service) in Maven repository and expose them on configured (or random) port.

+
+
+
+
Server Side
+
+

Being a service Y since you are developing your stub, you need to be sure that it’s actually resembling your +concrete implementation. You can’t have a situation where your stub acts in one way and your application on +production behaves in a different way.

+
+
+

That’s why from the provided stub acceptance tests will be generated that will ensure +that your application behaves in the same way as you define in your stub.

+
+
+

The autogenerated test would look like this:

+
+
+
+
@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");
+}
+
+
+
+
+
+

2.1.4. Step by step guide to CDC

+
+

Let’s take an example of Fraud Detection and Loan Issuance process. The business scenario is such that we want to issue loans to people but don’t want them to steal the money from us. The current implementation of our system grants loans to everybody.

+
+
+

Let’s assume that the Loan Issuance is a client to the +Fraud Detection server. In the current sprint we are required to develop a new feature - if a client wants to borrow too much money then we mark him as fraud.

+
+
+

Technical remark - Fraud Detection will have artifact id http-server, Loan Issuance http-client and both have group id com.example.

+
+
+

Social remark - both client and 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 side code here.

+
+
+ + + + + +
+ + +In this case the ownership of the contracts lays on the producer side. It means that physically +all the contract are present in the producer’s repository +
+
+
+
Technical note
+
+

If using the SNAPSHOT / Milestone / Release Candidate versions please add the following section to your

+
+
+
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 "http://repo.spring.io/snapshot" }
+	maven { url "http://repo.spring.io/milestone" }
+	maven { url "http://repo.spring.io/release" }
+}
+
+
+
+
+
Consumer side (Loan Issuance)
+
+

As a developer of the Loan Issuance service (a consumer of the Fraud Detection server):

+
+
+

start doing TDD by writing a test to your feature

+
+
+
+
@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");
+}
+
+
+
+

We’ve just written a test of our new feature. If a loan application for a big amount is received we should reject that loan application with some description.

+
+
+

write the missing implementation

+
+
+

At some point in time you need to send a request to the Fraud Detection service. Let’s assume that we’d like to send the request containing the id of the client and the amount he wants to borrow from us. We’d like to send it to the /fraudcheck url via the PUT method.

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

For simplicity we’ve hardcoded the port of the Fraud Detection service at 8080 and our application is running on 8090.

+
+
+

If we’d start the written test it would obviously break since we have no service running on port 8080.

+
+
+

clone the Fraud Detection service repository locally

+
+
+

We’ll start playing around with the server side contract. That’s why we need to first clone it.

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

define the contract locally in the repo of Fraud Detection service

+
+
+

As consumers we need to define what exactly we want to achieve. We need to formulate our expectations. That’s why we write the following contract.

+
+
+ + + + + +
+ + +We’re placing the contract under src/test/resources/contracts/fraud folder. The fraud folder +is important cause we’ll reference that folder in the producer’s test base class name. +
+
+
+
+
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 200 // (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 `clientId` 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 `clientId` 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.*`
+ */
+
+
+
+

The Contract is written using a statically typed Groovy DSL. You might be wondering what are those +value(client(…​), server(…​)) parts. By using this notation Spring Cloud Contract allows you to +define parts of a JSON / URL / etc. which are dynamic. In case of an identifier or a timestamp you +don’t want to hardcode a value. You want to allow some different ranges of values. That’s why for +the consumer side you can set regular expressions matching those values. You can provide the body +either by means of a map notation or String with interpolations. +Consult the docs +for more information. We highly recommend using the map notation!

+
+
+ + + + + +
+ + +It’s really important that you understand the map notation to set up contracts. Please read the +Groovy docs regarding JSON +
+
+
+

The aforementioned contract is an agreement between two sides that:

+
+
+
    +
  • +

    if an HTTP request is sent with

    +
    +
      +
    • +

      a method PUT on an endpoint /fraudcheck

      +
      • +
    • +

      JSON body with client.id matching the regular expression [0-9]{10} and loanAmount equal to 99999

      +
      • +
    • +

      and with a header Content-Type equal to application/vnd.fraud.v1+json

      +
      • +
    +
    +
    • +
  • +

    then an HTTP response would be sent to the consumer that

    +
    +
      +
    • +

      has status 200

      +
      • +
    • +

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

      +
      • +
    • +

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

      +
      • +
    +
    +
    • +
+
+
+

Once we’re ready to check the API in practice in the integration tests we need to just install the stubs locally

+
+
+

add the Spring Cloud Contract Verifier plugin

+
+
+

We can add either Maven or Gradle plugin - in this example we’ll show how to add Maven. First we need to add the Spring Cloud Contract BOM.

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

Next, the Spring Cloud Contract Verifier Maven plugin

+
+
+
+
<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>
+	</configuration>
+</plugin>
+
+
+
+

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

+
+
+
    +
  • +

    generate and run tests

    +
    • +
  • +

    produce and install stubs

    +
    • +
+
+
+

We don’t want to generate tests since we, as consumers, want only to play with the stubs. That’s why we need to skip the tests generation and execution. When we execute:

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

In the logs we’ll see something like this:

+
+
+
+
[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
+
+
+
+

This 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’s confirming that the stubs of the http-server have been installed in the local repository.

+
+
+

run the integration tests

+
+
+

In order to profit from the Spring Cloud Contract Stub Runner functionality of automatic stub downloading you have to do the following in our consumer side project (Loan Application service).

+
+
+

Add the Spring Cloud Contract BOM

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

Add the dependency to Spring Cloud Contract Stub Runner

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

Annotate your test class with @AutoConfigureStubRunner. In the annotation provide the group id and artifact id for the Stub Runner to download stubs of your collaborators. Also provide the offline work switch since you’re playing with the collaborators offline (optional step).

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"}, workOffline = true)
+@DirtiesContext
+public class LoanApplicationServiceTests {
+
+
+
+

Now if you run your tests you’ll see sth like this:

+
+
+
+
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}]
+
+
+
+

Which means that Stub Runner has found your stubs and started a server for app with group id com.example, artifact id http-server with version 0.0.1-SNAPSHOT of the stubs and with stubs classifier on port 8080.

+
+
+

file a PR

+
+
+

What we did until now is an iterative process. We can play around with the contract, install it locally and work on the consumer side until we’re happy with the contract.

+
+
+

Once we’re satisfied with the results and the test passes publish a PR to the server side. Currently the consumer side work is done.

+
+
+
+
Producer side (Fraud Detection server)
+
+

As a developer of the Fraud Detection server (a server to the Loan Issuance service):

+
+
+

initial implementation

+
+
+

As a reminder here you can see the initial implementation

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

take over the PR

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

You have to add the dependencies needed by the autogenerated tests

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

In the configuration of the Maven plugin we passed the packageWithBaseClasses property

+
+
+
+
<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>
+	</configuration>
+</plugin>
+
+
+
+ + + + + +
+ + +We’ve decided to use the "convention based" naming by setting the packageWithBaseClasses property. +That means that 2 last packages will be combined into a name of the base test class. In our case the contracts +were placed under src/test/resources/contracts/fraud. Since we don’t have 2 packages starting from the contracts +folder we’re picking only one which is fraud. We’re adding the Base suffix and we’re capitalizing fraud. +That gives us the FraudBase test class name. +
+
+
+

That’s because all the generated tests will extend that class. Over there you can set up your Spring Context or +whatever is necessary. In our case we’re using Rest Assured MVC to start the server side FraudDetectionController.

+
+
+
+
package com.example.fraud;
+
+import org.junit.Before;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+
+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 would get sth like this:

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

That’s because you have a new contract from which a test was generated and it failed since you haven’t implemented the feature. The autogenerated test would look like this:

+
+
+
+
@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");
+}
+
+
+
+

As you can see all the producer() parts of the Contract that were present in the value(consumer(…​), producer(…​)) blocks got injected into the test.

+
+
+

What’s important here to note is that on the producer side we also are doing TDD. We have expectations in form of a test. This test is shooting a request to our own application to an URL, headers and body defined in the contract. It also is expecting very precisely defined values in the response. In other words you have is your red part of red, green and refactor. Time to convert the red into the green.

+
+
+

write the missing implementation

+
+
+

Now since we now what is the expected input and expected output let’s write the missing implementation.

+
+
+
+
@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);
+}
+
+
+
+

If we execute ./mvnw clean install again the tests will 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.

+
+
+

deploy your app

+
+
+

Once you’ve finished your work it’s time to deploy your change. First merge the branch

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

Then we assume that your CI would run sth like ./mvnw clean deploy which would publish both the application and the stub artifcats.

+
+
+
+
Consumer side (Loan Issuance) final step
+
+

As a developer of the Loan Issuance service (a consumer of the Fraud Detection server):

+
+
+

merge branch to master

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

work online

+
+
+

Now you can disable the offline work for Spring Cloud Contract Stub Runner and provide where the repository with your stubs is placed. At this moment the stubs of the server side will be automatically downloaded from Nexus / Artifactory. +You can switch off the value of the workOffline parameter in your annotation. Below you can see an +example of achieving the same by changing the properties.

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

And that’s it!

+
+
+
+
+

2.1.5. Dependencies

+
+

The best way to add the dependencies is to just use the proper starter dependency.

+
+
+

For stub-runner use spring-cloud-starter-stub-runner and when you’re using a plugin just add +spring-cloud-starter-contract-verifier.

+
+
+
+

2.1.6. Additional links

+
+

Below you can find some resources related to Spring Cloud Contract Verifier and Stub Runner. Note that some can be outdated since the Spring Cloud Contract Verifier project +is under constant development.

+
+
+
Spring Cloud Contract video
+
+

You can check out the video from the Warsaw JUG about Spring Cloud Contract:

+
+
+
+ +
+
+
+
+
Readings
+
+ +
+
+
+
+

2.1.7. Samples

+
+

Here you can find some samples.

+
+
+
+
+

2.2. FAQ

+
+

2.2.1. Why use Spring Cloud Contract Verifier and not X ?

+
+

For the time being Spring Cloud Contract Verifier is a JVM based tool. So it could be your first pick when you’re already creating +software for the JVM. This project has a lot of really interesting features but especially quite a few of them definitely make +Spring Cloud Contract Verifier stand out on the "market" of Consumer Driven Contract (CDC) tooling. Out of many the most interesting are:

+
+
+
    +
  • +

    Possibility to do CDC with messaging

    +
    • +
  • +

    Clear and easy to use, statically typed DSL

    +
    • +
  • +

    Possibility 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

    +
    • +
+
+
+
+

2.2.2. What is this value(consumer(), producer()) ?

+
+

One of the biggest challenges related to stubs is their reusability. Only if they can be vastly used, will they serve their purpose. +What typically makes that difficult are the hard-coded values of request / response elements. For example dates or ids. +Imagine the following JSON request

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

and JSON response

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

Imagine the pain required to set proper value of the time field (let’s assume that this content is generated by the +database) by changing the clock in the system or providing stub implementations of data providers. The same is related +to the field called id. Will you create a stubbed implementation of UUID generator? Makes little sense…​

+
+
+

So as a consumer you would like to send a request that matches any form of a time or any UUID. That way your system +will work as usual - will generate data and you won’t have to stub anything out. Let’s 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 like this:

+
+
+
+
{
+    "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 that you can operate on. So such a JSON is valid

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

As you could see in the previous sections we generate tests from contracts. So from the producer’s side the situation looks +much different. We’re parsing 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 can’t have any sort of matching. We need concrete values that the +producer’s backend can work on. Such a JSON would be a valid one:

+
+
+
+
{
+    "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 doesn’t necessarily have to +contain concrete values of time or id. Let’s say that you generate those on the producer side - again, you’d +have to do a lot of stubbing to ensure that you always return the same values. That’s why from the producer’s side +what you might want is the following response:

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

How can you then provide one time a matcher for the consumer and a concrete value for the producer and vice versa? +In Spring Cloud Contract we’re allowing you to provide a dynamic value. That means that it can differ for both +sides of the communication. You can pass the values:

+
+
+

Either via the value method

+
+
+
+
value(consumer(...), producer(...))
+value(stub(...), test(...))
+value(client(...), server(...))
+
+
+
+

or using the $() method

+
+
+
+
$(consumer(...), producer(...))
+$(stub(...), test(...))
+$(client(...), server(...))
+
+
+
+

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

+
+
+

Calling value() or $() tells Spring Cloud Contract that you will be passing a dynamic value. +Inside the consumer() method you pass the value that should be used on the consumer side (in the generated stub). +Inside the producer() method you pass the value that should be used on the producer side (in the generated test).

+
+
+ + + + + +
+ + +If on one side you have passed the regular expression and you haven’t passed the other, then the +other side will get auto-generated. +
+
+
+

Most often you will use that method together with the regex helper method. E.g. consumer(regex('[0-9]{10}')).

+
+
+

To sum it up the contract for the aforementioned scenario would look more or less like this (the regular expression +for time and UUID are simplified and most likely invalid but we want to keep things very simple in this example):

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+				request {
+					method 'GET'
+					url '/someUrl'
+					body([
+					    time : value(consumer(regex('[0-9]{4}-[0-9]{2}-[0-9]{2} [0-2][0-9]-[0-5][0-9]-[0-5][0-9]')),
+					    id: value(consumer(regex('[0-9a-zA-z]{8}-[0-9a-zA-z]{4}-[0-9a-zA-z]{4}-[0-9a-zA-z]{12}'))
+					    body: "foo"
+					])
+				}
+			response {
+				status 200
+				body([
+					    time : value(producer(regex('[0-9]{4}-[0-9]{2}-[0-9]{2} [0-2][0-9]-[0-5][0-9]-[0-5][0-9]')),
+					    id: value([producer(regex('[0-9a-zA-z]{8}-[0-9a-zA-z]{4}-[0-9a-zA-z]{4}-[0-9a-zA-z]{12}'))
+					    body: "bar"
+					])
+			}
+}
+
+
+
+ + + + + +
+ + +Please read the Groovy docs related to JSON to understand how to +properly structure the request / response bodies. +
+
+
+
+

2.2.3. How to do Stubs versioning?

+
+
API Versioning
+
+

Let’s try to answer a question what versioning really means. If you’re referring to the API version then there are +different approaches.

+
+
+
    +
  • +

    use Hypermedia, links and do not version your API by any means

    +
    • +
  • +

    pass versions through headers / urls

    +
    • +
+
+
+

I will not try to answer a question which approach is better. Whatever suit your needs and allows you to generate +business value should be picked.

+
+
+

Let’s assume that you do version your API. In that case you should provide as many contracts as many versions you support. +You can create a subfolder for every version or append it to th contract name - whatever suits you more.

+
+
+
+
JAR versioning
+
+

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

+
+
+

Let’s assume that you’re doing Continuous Delivery / Deployment which means that you’re generating a new version of +the jar each time you go through the pipeline and that jar can go to production at any time. For example your jar version +looks like this (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 will look like this.

+
+
+
+
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. Example

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

If the versioning however is fixed (e.g. 1.0.4.RELEASE or 2.1.1) then you have to set the concrete value of the jar +version. Example for 2.1.1.

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

You can manipulate the classifier to run the tests against current 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 then you can run tests in one case with dev stubs and one with prod stubs.

+
+
+

Example of tests using development version of stubs

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

Example of tests using production version of stubs

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

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

+
+
+
+
+

2.2.4. Common repo with contracts

+
+

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

+
+
+
Repo structure
+
+

Let’s assume that we have a producer with coordinates com.example:server and 3 consumers: client1, +client2, client3. Then in the repository with common contracts you would have the following setup +(which you can checkout here:

+
+
+
+
├── 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 the under the slash-delimited groupid / artifact id folder (com/example/server) you have +expectations of the 3 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 repo.

+
+
+

Example of a pom.xml inside the server folder.

+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://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-SNAPSHOT</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>1.5.4.RELEASE</version>
+		<relativePath />
+	</parent>
+
+	<properties>
+		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+		<java.version>1.8</java.version>
+		<spring-cloud-contract.version>1.2.0.BUILD-SNAPSHOT</spring-cloud-contract.version>
+		<spring-cloud-dependencies.version>Edgware.BUILD-SNAPSHOT</spring-cloud-dependencies.version>
+		<excludeBuildFolders>true</excludeBuildFolders>
+	</properties>
+
+	<dependencyManagement>
+		<dependencies>
+			<dependency>
+				<groupId>org.springframework.cloud</groupId>
+				<artifactId>spring-cloud-dependencies</artifactId>
+				<version>${spring-cloud-dependencies.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>
+
+
+
+

As you can see there are no dependencies other than the Spring Cloud Contract Maven Plugin. +Those poms are necessary for the consumer side to run mvn clean install -DskipTests to locally install + stubs of the producer project.

+
+
+

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

+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://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-SNAPSHOT</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’s using the assembly plugin in order to build the JAR with all the contracts. Example of such setup is here:

+
+
+
+
<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+		  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+		  xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://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>
+
+
+
+
+
Workflow
+
+

The workflow would look similar to the one presented in the Step by step guide to CDC. The only difference + is that the producer doesn’t own the contracts anymore. So the consumer and the producer have to work on + common contracts in a common repository.

+
+
+
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 (e.g. com/example/server) +and runs mvn clean install -DskipTests to install locally the stubs converted from the contracts.

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

As a producer it’s enough to alter the Spring Cloud Contract Verifier to provide the URL and the dependency +of the JAR containing the contracts:

+
+
+
+
<plugin>
+	<groupId>org.springframework.cloud</groupId>
+	<artifactId>spring-cloud-contract-maven-plugin</artifactId>
+	<configuration>
+		<contractsRepositoryUrl>http://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 groupid com.example.standalone and artifactid contracts will be downloaded +from http://link/to/your/nexus/or/artifactory/or/sth. It will be then unpacked in a local temporary folder +and contracts present under the com/example/server will be picked as the ones used to generate the +tests and the stubs. Due to this convention the producer team will know which consumer teams will be broken +when some incompatible changes are done.

+
+
+

The rest of the flow looks the same.

+
+
+
+
+
+

2.2.5. Can I have multiple base classes for tests?

+
+

Yes! Check out the Different base classes for contracts sections +of either Gradle or Maven plugins.

+
+
+
+

2.2.6. 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 which relies on 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, just add this to your application properties

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

2.2.7. How can I debug the mapping/request/response being sent by WireMock?

+
+

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

+
+
+

To turn off this feature just bump WireMock logging to ERROR

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

2.2.8. How can I see what got registered in the HTTP server stub?

+
+

You can use the mappingsOutputFolder property on @AutoConfigureStubRunner or StubRunnerRule +to dump all mappings per artifact id. Also the port at which the given stub server was +started will be attached.

+
+
+
+

2.2.9. Can I reference the request from the response?

+
+

Yes! With version 1.1.0 we’ve added such a possibility. On the HTTP stub server side we’re providing support +for this for WireMock. In case of other HTTP server stubs you’ll have to implement the approach yourself.

+
+
+
+

2.2.10. Can I reference text from file?

+
+

Yes! With version 1.2.0 we’ve added such a possibility. It’s enough to call file(…​) method in the +DSL and provide a path relative to where the contract lays.

+
+
+
+
+

2.3. Spring Cloud Contract Verifier HTTP

+
+

2.3.1. Gradle Project

+
+
Prerequisites
+
+

In order to use Spring Cloud Contract Verifier with WireMock you have to use Gradle or Maven plugin.

+
+
+ + + + + +
+ + +If you want to use Spock in your projects you have to add separately +the spock-core and spock-spring modules. Check Spock docs for more information +
+
+
+
Add gradle plugin with dependencies
+
+
+
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}"
+	}
+}
+
+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:2.4.6'
+	// example with adding Spock core and Spock Spring
+	testCompile 'org.spockframework:spock-core:1.0-groovy-2.4'
+	testCompile 'org.spockframework:spock-spring:1.0-groovy-2.4'
+	testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+}
+
+
+
+
+
Gradle and Rest Assured 2.0
+
+

By default Rest Assured 3.x is added to the classpath. However in order to give the users the +opportunity to use Rest Assured 2.x it’s enough to add it to the plugins classpath.

+
+
+
+
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 will automatically see that Rest Assured 2.x is present on the classpath +and will modify the imports accordingly.

+
+
+
+
Snapshot versions for Gradle
+
+

Add the additional snapshot repository to your build.gradle to use snapshot versions which are automatically uploaded after every successful build:

+
+
+
+
buildscript {
+	repositories {
+		mavenCentral()
+		mavenLocal()
+		maven { url "http://repo.spring.io/snapshot" }
+		maven { url "http://repo.spring.io/milestone" }
+		maven { url "http://repo.spring.io/release" }
+	}
+}
+
+
+
+
+
Add stubs
+
+

By default Spring Cloud Contract Verifier is looking for stubs in src/test/resources/contracts directory.

+
+
+

Directory containing stub definitions is treated as a class name, and each stub definition is treated as a single test. +We assume that it contains at least one directory which will be used as test class name. If there is more than one level of nested directories all except the last one will be used as package name. +So with following structure

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

Spring Cloud Contract Verifier will create test class defaultBasePackage.MyService with two methods

+
+
+
    +
  • +

    shouldCreateUser()

    +
    • +
  • +

    shouldReturnUser()

    +
    • +
+
+
+
+
+
Run plugin
+
+

Plugin registers itself to be invoked before check task. You have nothing to do as long as you want it to be part of your build process. If you just want to generate tests please invoke generateContractTests task.

+
+
+
+
Default setup
+
+

Default Gradle Plugin setup creates the following Gradle part of the build (it’s a pseudocode)

+
+
+
+
contracts {
+    targetFramework = 'JUNIT'
+    testMode = 'MockMvc'
+    generatedTestSourcesDir = project.file("${project.buildDir}/generated-test-sources/contracts")
+    contractsDslDir = "${project.rootDir}/src/test/resources/contracts"
+    basePackageForTests = 'org.springframework.cloud.verifier.tests'
+    stubsOutputDir = project.file("${project.buildDir}/stubs")
+
+    // 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
+        }
+    }
+}
+
+
+
+
+
Configure plugin
+
+

To change default configuration just add contracts snippet to your Gradle config

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

    testMode - defines mode for acceptance tests. By default MockMvc which is based on Spring’s MockMvc. It can also be changed to JaxRsClient or to Explicit for real HTTP calls.

    +
    • +
  • +

    imports - array with imports that should be included in generated tests (for example ['org.myorg.Matchers']). By default empty array []

    +
    • +
  • +

    staticImports - array with static imports that should be included in generated tests(for example ['org.myorg.Matchers.*']). By default empty array []

    +
    • +
  • +

    basePackageForTests - specifies base package for all generated tests. If not set the value will be picked from baseClassForTests’s package and from +`packageWithBaseClasses. If neither of these are set then the value will be set to org.springframework.cloud.contract.verifier.tests

    +
    • +
  • +

    baseClassForTests - base class for all generated tests. By default spock.lang.Specification if using Spock tests.

    +
    • +
  • +

    packageWithBaseClasses - instead of providing a fixed value for base class you can provide a package where all the base classes lay. Takes precedence over baseClassForTests.

    +
    • +
  • +

    baseClassMappings - explicitly map contract package to a FQN of a base class. Takes precedence over packageWithBaseClasses and baseClassForTests.

    +
    • +
  • +

    ruleClassForTests - specifies Rule which should be added to generated test classes.

    +
    • +
  • +

    ignoredFiles - Ant matcher allowing defining stub files for which processing should be skipped. By default empty array []

    +
    • +
  • +

    contractsDslDir - directory containing contracts written using the GroovyDSL. By default $rootDir/src/test/resources/contracts

    +
    • +
  • +

    generatedTestSourcesDir - test source directory where tests generated from Groovy DSL should be placed. By default $buildDir/generated-test-sources/contractVerifier

    +
    • +
  • +

    stubsOutputDir - dir where the generated WireMock stubs from Groovy DSL should be placed

    +
    • +
  • +

    targetFramework - the target test framework to be used; currently Spock and JUnit are supported with JUnit being the default framework

    +
    • +
+
+
+

The following properties are used when you want to provide where the JAR with contract lays

+
+
+
    +
  • +

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

    +
    • +
  • +

    contractsPath - if contract deps are downloaded will default to groupid/artifactid where groupid will be slash separated. Otherwise will scan contracts under provided directory

    +
    • +
  • +

    contractsWorkOffline - in order not to download the dependencies each time you can download them once and work offline afterwards (reuse local Maven repo)

    +
    • +
+
+
+
+
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 endpoint which should be verified.

+
+
+
+
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
+	}
+
+}
+
+
+
+

In case of using Explicit mode, you can use base class to initialize the whole tested app similarly as in regular integration tests. In case of JAXRSCLIENT mode this base class +should also contain protected WebTarget webTarget field, right now the only option to test JAX-RS API is to start a web server.

+
+
+
+
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 via baseClassMappings

    +
    • +
+
+
+

Convention

+
+
+

The convention is such that if you have a contract under e.g. src/test/resources/contract/foo/bar/baz/ and provide the value of the packageWithBaseClasses property +to com.example.base then we will assume that there is a BarBazBase class under com.example.base package. In other words we take last two parts of package +if they exist and form a class with a Base suffix. Takes precedence over baseClassForTests. Example of usage in the contracts closure:

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

Mapping

+
+
+

You can manually map a regular expression of the contract’s package to fully qualified name of the base class for the matched contract. +Let’s take a look at 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 under + - src/test/resources/contract/com/ + - src/test/resources/contract/foo/

+
+
+

By providing the baseClassForTests we have a fallback in case mapping didn’t succeed (you could also provide +the packageWithBaseClasses as fallback). That way the tests generated from src/test/resources/contract/com/ contracts +will be extending the com.example.ComBase whereas the rest of tests will extend com.example.FooBase.

+
+
+
+
+
Invoking generated tests
+
+

To ensure that provider side is complaint with defined contracts, you need to invoke:

+
+
+
+
./gradlew generateContractTests test
+
+
+
+
+
Spring Cloud Contract Verifier on consumer side
+
+

In consumer service you need to configure Spring Cloud Contract Verifier plugin in exactly the same way as in case of provider. If you don’t want to use Stub Runner then you need to copy contracts stored in +src/test/resources/contracts and generate WireMock json stubs using:

+
+
+
+
./gradlew generateClientStubs
+
+
+
+

Note that stubsOutputDir option has to be set for stub generation to work.

+
+
+

When present, json stubs can be used in consumer automated tests.

+
+
+
+
@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
+ }
+}
+
+
+
+

Underneath LoanApplication makes a call to FraudDetection service. This request is handled by WireMock server configured using stubs generated by Spring Cloud Contract Verifier.

+
+
+
+
+

2.3.2. Using in your Maven project

+
+
Add maven plugin
+
+

Add the Spring Cloud Contract BOM

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

Next, the Spring Cloud Contract Verifier Maven plugin

+
+
+
+
<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>
+	</configuration>
+</plugin>
+
+
+
+

You can read more in the Spring Cloud Contract Maven Plugin Docs

+
+
+
Maven and Rest Assured 2.0
+
+

By default Rest Assured 3.x is added to the classpath. However in order to give the users the +opportunity to use Rest Assured 2.x it’s enough to add it to the plugins classpath.

+
+
+
+
<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>
+    </configuration>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-contract-verifier</artifactId>
+            <version>${spring-cloud-contract.version}</version>
+        </dependency>
+        <dependency>
+           <groupId>com.jayway.restassured</groupId>
+           <artifactId>rest-assured</artifactId>
+           <version>2.5.0</version>
+           <scope>compile</scope>
+        </dependency>
+        <dependency>
+           <groupId>com.jayway.restassured</groupId>
+           <artifactId>spring-mock-mvc</artifactId>
+           <version>2.5.0</version>
+           <scope>compile</scope>
+        </dependency>
+    </dependencies>
+</plugin>
+
+<dependencies>
+    <!-- all dependencies -->
+    <!-- you can exclude rest-assured from spring-cloud-contract-verifier -->
+    <dependency>
+       <groupId>com.jayway.restassured</groupId>
+       <artifactId>rest-assured</artifactId>
+       <version>2.5.0</version>
+       <scope>test</scope>
+    </dependency>
+    <dependency>
+       <groupId>com.jayway.restassured</groupId>
+       <artifactId>spring-mock-mvc</artifactId>
+       <version>2.5.0</version>
+       <scope>test</scope>
+    </dependency>
+</dependencies>
+
+
+
+

That way the plugin will automatically see that Rest Assured 3.x is present on the classpath +and will modify the imports accordingly.

+
+
+
+
Snapshot versions for Maven
+
+

For Snapshot / Milestone versions you have to add the following section to your pom.xml

+
+
+
+
<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>
+
+
+
+
+
+
Add stubs
+
+

By default Spring Cloud Contract Verifier is looking for stubs in src/test/resources/contracts directory. +Directory containing stub definitions is treated as a class name, and each stub definition is treated as a single test. +We assume that it contains at least one directory which will be used as test class name. If there is more than one level of nested directories all except the last one will be used as package name. +So with following structure

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

Spring Cloud Contract Verifier will create test class defaultBasePackage.MyService with two methods + - shouldCreateUser() + - shouldReturnUser()

+
+
+
+
Run plugin
+
+

Plugin goal generateTests is assigned to be invoked in phase generate-test-sources. You have nothing to do as long as you want it to be part of your build process. If you just want to generate tests please invoke generateTests goal.

+
+
+
+
Configure plugin
+
+

To change default configuration just add configuration section to plugin definition or execution definition.

+
+
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <executions>
+        <execution>
+            <goals>
+                <goal>convert</goal>
+                <goal>generateStubs</goal>
+                <goal>generateTests</goal>
+            </goals>
+        </execution>
+    </executions>
+    <configuration>
+        <basePackageForTests>org.springframework.cloud.verifier.twitter.place</basePackageForTests>
+        <baseClassForTests>org.springframework.cloud.verifier.twitter.place.BaseMockMvcSpec</baseClassForTests>
+    </configuration>
+</plugin>
+
+
+
+
Important configuration options
+
+
    +
  • +

    testMode - defines mode for acceptance tests. By default MockMvc which is based on Spring’s MockMvc. It can also be changed to JaxRsClient or to Explicit for real HTTP calls.

    +
    • +
  • +

    basePackageForTests - specifies base package for all generated tests. If not set the value will be picked from baseClassForTests’s package and from +`packageWithBaseClasses. If neither of these are set then the value will be set to org.springframework.cloud.contract.verifier.tests

    +
    • +
  • +

    ruleClassForTests - specifies Rule which should be added to generated test classes.

    +
    • +
  • +

    baseClassForTests - base class for generated tests. By default spock.lang.Specification if using Spock tests.

    +
    • +
  • +

    contractsDirectory - directory containing contracts written using the GroovyDSL. By default /src/test/resources/contracts.

    +
    • +
  • +

    testFramework - the target test framework to be used; currently Spock and JUnit are supported with JUnit being the default framework

    +
    • +
  • +

    packageWithBaseClasses - instead of providing a fixed value for base class you can provide a package where all the base classes lay. +The convention is such that if you have a contract under src/test/resources/contract/foo/bar/baz/ and provide the value of this property +to com.example.base then we will assume that there is a BarBazBase class under com.example.base package. Takes precedence +over baseClassForTests

    +
    • +
  • +

    baseClassMappings - list of base class mappings that where you have to provide contractPackageRegex which is checked +against the package in which the contract lays and baseClassFQN that maps to fully qualified name of the base class for the matched +contract. If you have a contract under src/test/resources/contract/foo/bar/baz/ and map the property .* → com.example.base.BaseClass then +the test class generated from these contracts will extend com.example.base.BaseClass. Takes precedence over packageWithBaseClasses + and baseClassForTests.

    +
    • +
+
+
+

If you want to download your contract definitions from a Maven repository you can use

+
+
+
    +
  • +

    contractDependency - the contract dependency that contains all the packaged contracts

    +
    • +
  • +

    contractsPath - path to concrete contracts in the JAR with packaged contracts. Defaults to groupid/artifactid where gropuid is slash separated.

    +
    • +
  • +

    contractsWorkOffline - if the dependencies should be downloaded or local Maven only should be reused

    +
    • +
  • +

    contractsRepositoryUrl - DEPRECATED PROPERTY - please use the contractRepository closure - URL to a repo with the artifacts with contracts, if not provided should use the current Maven ones

    +
    • +
  • +

    contractRepository - closure where you can define properties related to repository with contracts

    +
    +
      +
    • +

      username - username to be used to connect to the repo

      +
      • +
    • +

      password - username to be used to connect to the repo

      +
      • +
    • +

      proxyHost - proxy host to be used to connect to the repo

      +
      • +
    • +

      proxyPort - proxy port to be used to connect to the repo

      +
      • +
    • +

      cacheDownloadedContracts - if you want to reuse download JARs that contain contract definitions. +We cache only non-snapshot, explicitly provided versions (e.g. + or 1.0.0.BUILD-SNAPSHOT won’t get cached). +By default this feature is turned on.

      +
      • +
    +
    +
    • +
+
+
+
+
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 endpoint which should be verified.

+
+
+
+
package org.mycompany.tests
+
+import org.mycompany.ExampleSpringController
+import com.jayway.restassured.module.mockmvc.RestAssuredMockMvc
+import spock.lang.Specification
+
+class  MvcSpec extends Specification {
+  def setup() {
+   RestAssuredMockMvc.standaloneSetup(new ExampleSpringController())
+  }
+}
+
+
+
+

In case of using Explicit mode, you can use base class to initialize the whole tested app similarly as in regular integration tests. In case of JAXRSCLIENT mode this base class should also contain protected WebTarget webTarget field, right now the only option to test JAX-RS API is to start a web server.

+
+
+
+
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 via baseClassMappings

    +
    • +
+
+
+

Convention

+
+
+

The convention is such that if you have a contract under e.g. src/test/resources/contract/hello/v1/ and provide the value of the packageWithBaseClasses property +to hello then we will assume that there is a HelloV1Base class under hello package. In other words we take last two parts of package +if they exist and form a class with a Base suffix. Takes precedence over baseClassForTests. Example of usage:

+
+
+
+
<plugin>
+	<groupId>org.springframework.cloud</groupId>
+	<artifactId>spring-cloud-contract-maven-plugin</artifactId>
+	<configuration>
+		<packageWithBaseClasses>hello</packageWithBaseClasses>
+	</configuration>
+</plugin>
+
+
+
+

Mapping

+
+
+

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

+
+
+
+
<plugin>
+	<groupId>org.springframework.cloud</groupId>
+	<artifactId>spring-cloud-contract-maven-plugin</artifactId>
+	<configuration>
+		<baseClassForTests>com.example.FooBase</baseClassForTests>
+		<baseClassMappings>
+			<baseClassMapping>
+				<contractPackageRegex>.*com.*</contractPackageRegex>
+				<baseClassFQN>com.example.TestBase</baseClassFQN>
+			</baseClassMapping>
+		</baseClassMappings>
+	</configuration>
+</plugin>
+
+
+
+

Let’s assume that you have contracts under + - src/test/resources/contract/com/ + - src/test/resources/contract/foo/

+
+
+

By providing the baseClassForTests we have a fallback in case mapping didn’t succeed (you could also provide +the packageWithBaseClasses as fallback). That way the tests generated from src/test/resources/contract/com/ contracts +will be extending the com.example.ComBase whereas the rest of tests will extend com.example.FooBase.

+
+
+
+
+
Invoking generated tests
+
+

Spring Cloud Contract Maven Plugin generates verification code into directory /generated-test-sources/contractVerifier and attach this directory to testCompile goal.

+
+
+

For Groovy Spock code use:

+
+
+
+
<plugin>
+	<groupId>org.codehaus.gmavenplus</groupId>
+	<artifactId>gmavenplus-plugin</artifactId>
+	<version>1.5</version>
+	<executions>
+		<execution>
+			<goals>
+				<goal>testCompile</goal>
+			</goals>
+		</execution>
+	</executions>
+	<configuration>
+		<testSources>
+			<testSource>
+				<directory>${project.basedir}/src/test/groovy</directory>
+				<includes>
+					<include>**/*.groovy</include>
+				</includes>
+			</testSource>
+			<testSource>
+				<directory>${project.build.directory}/generated-test-sources/contractVerifier</directory>
+				<includes>
+					<include>**/*.groovy</include>
+				</includes>
+			</testSource>
+		</testSources>
+	</configuration>
+</plugin>
+
+
+
+

To ensure that provider side is complaint with defined contracts, you need to invoke mvn generateTest test

+
+
+
+
FAQ with Maven Plugin
+
+
Maven Plugin and STS
+
+

In case you see the following exception while using STS

+
+
+
+STS Exception +
+
+
+

when you click on the marker you should see sth like this

+
+
+
+
 plugin:1.1.0.M1:convert:default-convert:process-test-resources) org.apache.maven.plugin.PluginExecutionException: Execution default-convert of goal org.springframework.cloud:spring-
+ cloud-contract-maven-plugin:1.1.0.M1:convert failed. at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:145) at
+ org.eclipse.m2e.core.internal.embedder.MavenImpl.execute(MavenImpl.java:331) at org.eclipse.m2e.core.internal.embedder.MavenImpl$11.call(MavenImpl.java:1362) at
+...
+ org.eclipse.core.internal.jobs.Worker.run(Worker.java:55) Caused by: java.lang.NullPointerException at
+ org.eclipse.m2e.core.internal.builder.plexusbuildapi.EclipseIncrementalBuildContext.hasDelta(EclipseIncrementalBuildContext.java:53) at
+ org.sonatype.plexus.build.incremental.ThreadBuildContext.hasDelta(ThreadBuildContext.java:59) at
+
+
+
+

In order to fix this issue just provide the following section in your pom.xml

+
+
+
+
<build>
+    <pluginManagement>
+        <plugins>
+            <!--This plugin's configuration is used to store Eclipse m2e settings
+                only. It has no influence on the Maven build itself. -->
+            <plugin>
+                <groupId>org.eclipse.m2e</groupId>
+                <artifactId>lifecycle-mapping</artifactId>
+                <version>1.0.0</version>
+                <configuration>
+                    <lifecycleMappingMetadata>
+                        <pluginExecutions>
+                             <pluginExecution>
+                                <pluginExecutionFilter>
+                                    <groupId>org.springframework.cloud</groupId>
+                                    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+                                    <versionRange>[1.0,)</versionRange>
+                                    <goals>
+                                        <goal>convert</goal>
+                                    </goals>
+                                </pluginExecutionFilter>
+                                <action>
+                                    <execute />
+                                </action>
+                             </pluginExecution>
+                        </pluginExecutions>
+                    </lifecycleMappingMetadata>
+                </configuration>
+            </plugin>
+        </plugins>
+    </pluginManagement>
+</build>
+
+
+
+
+
+
Spring Cloud Contract Verifier on consumer side
+
+

You can actually use the Spring Cloud Contract Verifier also for the consumer side! +You can use the plugin so that it only converts the contracts and generates the stubs. +To achieve that you need to configure Spring Cloud Contract Verifier plugin in exactly +the same way as in case of provider. You need to copy contracts stored in +src/test/resources/contracts and generate WireMock json stubs using: +mvn generateStubs command. By default generated WireMock mapping is +stored in directory target/mappings. Your project should create from +this generated mappings additional artifact with classifier stubs for +easy deploy to maven repository.

+
+
+

Sample configuration:

+
+
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${verifier-plugin.version}</version>
+    <executions>
+        <execution>
+            <goals>
+                <goal>convert</goal>
+                <goal>generateStubs</goal>
+            </goals>
+        </execution>
+    </executions>
+</plugin>
+
+
+
+

When present, json stubs can be used in consumer automated tests.

+
+
+
+
@RunWith(SpringTestRunner.class)
+@SpringBootTest
+@AutoConfigureStubRunner
+public class LoanApplicationServiceTests {
+
+  @Autowired
+  LoanApplicationService service;
+
+  @Test
+  public void shouldSuccessfullyApplyForLoan() {
+    //given:
+ 	LoanApplication application =
+			new LoanApplication(new Client("12345678901"), 123.123);
+    //when:
+	LoanApplicationResult loanApplication = service.loanApplication(application);
+    // then:
+	assertThat(loanApplication.loanApplicationStatus).isEqualTo(LoanApplicationStatus.LOAN_APPLIED);
+	assertThat(loanApplication.rejectionReason).isNull();
+  }
+}
+
+
+
+

Underneath LoanApplication makes a call to the FraudDetection service. This request is handled by +a WireMock server configured using stubs generated by Spring Cloud Contract Verifier.

+
+
+
+
+

2.3.3. Scenarios

+
+

It’s possible to handle scenarios with Spring Cloud Contract Verifier. All you need to do is to stick to proper naming convention while creating your contracts. The convention requires to include order number followed by the underscore.

+
+
+
+
my_contracts_dir\
+  scenario1\
+    1_login.groovy
+    2_showCart.groovy
+    3_logout.groovy
+
+
+
+

Such tree will cause Spring Cloud Contract Verifier generating WireMock’s scenario with name scenario1 and three steps:

+
+
+
    +
  • +

    login marked as Started pointing to:

    +
    • +
  • +

    showCart marked as Step1 pointing to:

    +
    • +
  • +

    logout marked as Step2 which will close the scenario.

    +
    • +
+
+
+

More details about WireMock scenarios can be found under http://wiremock.org/stateful-behaviour.html

+
+
+

Spring Cloud Contract Verifier will also generate tests with guaranteed order of execution.

+
+
+
+

2.3.4. Stubs and transitive dependencies

+
+

The Maven and Gradle plugin that we’re created are adding the tasks that create the stubs jar for you. What can be problematic +is that when reusing the stubs you can by mistake import all of that stub dependencies! When building a Maven artifact +even though you have a couple of different jars, all of them share one pom:

+
+
+
+
├── github-webhook-0.0.1.BUILD-20160903.075506-1-stubs.jar
+├── github-webhook-0.0.1.BUILD-20160903.075506-1-stubs.jar.sha1
+├── github-webhook-0.0.1.BUILD-20160903.075655-2-stubs.jar
+├── github-webhook-0.0.1.BUILD-20160903.075655-2-stubs.jar.sha1
+├── github-webhook-0.0.1.BUILD-SNAPSHOT.jar
+├── github-webhook-0.0.1.BUILD-SNAPSHOT.pom
+├── github-webhook-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

+
+
+

If in the github-webhook application we would mark all of our dependencies as optional, when you include the +github-webhook stubs in another application (or when that dependency gets downloaded by Stub Runner) then, since +all of the depenencies are optional, they will not get downloaded.

+
+
+

Create a separate artifactid for stubs

+
+
+

If you create a separate artifactid then you can set it up in whatever way you wish. For example by having no dependencies at all.

+
+
+

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.

+
+
+
+
+

2.4. Spring Cloud Contract Verifier Messaging

+
+

Spring Cloud Contract Verifier allows you to verify your application that uses messaging as means of communication. +All of our integrations are working with Spring but you can also create one yourself and use it.

+
+
+

2.4.1. Integrations

+
+

You can use one of the four integration configurations:

+
+
+
    +
  • +

    Apache Camel

    +
    • +
  • +

    Spring Integration

    +
    • +
  • +

    Spring Cloud Stream

    +
    • +
  • +

    Spring AMQP

    +
    • +
+
+
+

Since we’re using Spring Boot then if you have added one of the aforementioned libraries +to the classpath then automatically all the messaging configuration will be set up.

+
+
+ + + + + +
+ + +Remember to put @AutoConfigureMessageVerifier on the base class of your +generated tests. Otherwise messaging part of Spring Cloud Contract Verifier will not work. +
+
+
+ + + + + +
+ + +If you want to use Spring Cloud Stream remember to add a +org.springframework.cloud:spring-cloud-stream-test-support dependency. +
+
+
+
Maven
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-stream-test-support</artifactId>
+    <scope>test</scope>
+</dependency>
+
+
+
+
Gradle
+
+
testCompile "org.springframework.cloud:spring-cloud-stream-test-support"
+
+
+
+
+

2.4.2. Manual Integration Testing

+
+

The main interface used by the tests is the org.springframework.cloud.contract.verifier.messaging.MessageVerifier. +It defines how to send and receive messages. You can create your own implementation to achieve the +same goal.

+
+
+

In the a test you can inject a ContractVerifierMessageExchange to send and receive messages that follow the contract. +Then add @AutoConfigureMessageVerifier to your test, e.g.

+
+
+
+
@RunWith(SpringTestRunner.class)
+@SpringBootTest
+@AutoConfigureMessageVerifier
+public static class MessagingContractTests {
+
+  @Autowired
+  private MessageVerifier verifier;
+  ...
+}
+
+
+
+ + + + + +
+ + +If your tests require stubs as well, then +@AutoConfigureStubRunner includes the messaging configuration, so +you only need the one annotation. +
+
+
+
+

2.4.3. Publisher side test generation

+
+

Having the input or outputMessage sections in your DSL will result in creation of tests on the publisher’s side. By default +JUnit tests will be created, however there is also a possibility to create Spock tests.

+
+
+

There are 3 main scenarios that we should take into consideration:

+
+
+
    +
  • +

    Scenario 1: there is no input message that produces an output one. The output message is triggered by a component +inside the application (e.g. scheduler)

    +
    • +
  • +

    Scenario 2: the input message triggers an output message

    +
    • +
  • +

    Scenario 3: the input message is consumed and there is no output message

    +
    • +
+
+
+ + + + + +
+ + +The destination passed to messageFrom or sentTo can have different meanings for different + messaging implementations. For Stream and Integration it’s first resolved as a destination of a channel, and then if + there is no such destination it’s resolved as a channel name. For Camel that’s a certain component (e.x. jms). +
+
+
+

Example for Camel:

+
+
+
Scenario 1 (no input message)
+
+

For the given contract:

+
+
+
+
def contractDsl = Contract.make {
+	label 'some_label'
+	input {
+		triggeredBy('bookReturnedTriggered()')
+	}
+	outputMessage {
+		sentTo('activemq:output')
+		body('''{ "bookName" : "foo" }''')
+		headers {
+			header('BOOK-NAME', 'foo')
+			messagingContentType(applicationJson())
+		}
+	}
+}
+
+
+
+

The following JUnit test will be created:

+
+
+
+
'''
+ // when:
+  bookReturnedTriggered();
+
+ // then:
+  ContractVerifierMessage response = contractVerifierMessaging.receive("activemq:output");
+  assertThat(response).isNotNull();
+  assertThat(response.getHeader("BOOK-NAME")).isNotNull();
+  assertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
+  assertThat(response.getHeader("contentType")).isNotNull();
+  assertThat(response.getHeader("contentType").toString()).isEqualTo("application/json");
+ // and:
+  DocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
+  assertThatJson(parsedJson).field("bookName").isEqualTo("foo");
+'''
+
+
+
+

And the following Spock test would be created:

+
+
+
+
'''
+ when:
+  bookReturnedTriggered()
+
+ then:
+  ContractVerifierMessage response = contractVerifierMessaging.receive('activemq:output')
+  assert response != null
+  response.getHeader('BOOK-NAME')?.toString()  == 'foo'
+  response.getHeader('contentType')?.toString()  == 'application/json'
+ and:
+  DocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.payload))
+  assertThatJson(parsedJson).field("bookName").isEqualTo("foo")
+
+'''
+
+
+
+
+
Scenario 2 (output triggered by input)
+
+

For the given contract:

+
+
+
+
def contractDsl = Contract.make {
+	label 'some_label'
+	input {
+		messageFrom('jms:input')
+		messageBody([
+				bookName: 'foo'
+		])
+		messageHeaders {
+			header('sample', 'header')
+		}
+	}
+	outputMessage {
+		sentTo('jms:output')
+		body([
+				bookName: 'foo'
+		])
+		headers {
+			header('BOOK-NAME', 'foo')
+		}
+	}
+}
+
+
+
+

The following JUnit test will be created:

+
+
+
+
'''
+// given:
+ ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+  "{\\"bookName\\":\\"foo\\"}"
+, headers()
+  .header("sample", "header"));
+
+// when:
+ contractVerifierMessaging.send(inputMessage, "jms:input");
+
+// then:
+ ContractVerifierMessage response = contractVerifierMessaging.receive("jms:output");
+ assertThat(response).isNotNull();
+ assertThat(response.getHeader("BOOK-NAME")).isNotNull();
+ assertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
+// and:
+ DocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
+ assertThatJson(parsedJson).field("bookName").isEqualTo("foo");
+'''
+
+
+
+

And the following Spock test would be created:

+
+
+
+
"""\
+given:
+   ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+    '''{"bookName":"foo"}''',
+    ['sample': 'header']
+  )
+
+when:
+   contractVerifierMessaging.send(inputMessage, 'jms:input')
+
+then:
+   ContractVerifierMessage response = contractVerifierMessaging.receive('jms:output')
+   assert response !- null
+   response.getHeader('BOOK-NAME')?.toString()  == 'foo'
+and:
+   DocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.payload))
+   assertThatJson(parsedJson).field("bookName").isEqualTo("foo")
+"""
+
+
+
+
+
Scenario 3 (no output message)
+
+

For the given contract:

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

The following JUnit test will be created:

+
+
+
+
'''
+// given:
+ ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+	"{\\"bookName\\":\\"foo\\"}"
+, headers()
+	.header("sample", "header"));
+
+// when:
+ contractVerifierMessaging.send(inputMessage, "jms:delete");
+
+// then:
+ bookWasDeleted();
+'''
+
+
+
+

And the following Spock test would be created:

+
+
+
+
'''
+given:
+	 ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+		\'\'\'{"bookName":"foo"}\'\'\',
+		['sample': 'header']
+	)
+
+when:
+	 contractVerifierMessaging.send(inputMessage, 'jms:delete')
+
+then:
+	 noExceptionThrown()
+	 bookWasDeleted()
+'''
+
+
+
+
+
+

2.4.4. Consumer Stub Side generation

+
+

Unlike the HTTP part - in Messaging we need to publish the Groovy DSL inside the JAR with a stub. Then it’s parsed on the consumer side +and proper stubbed routes are created.

+
+
+

For more information please consult the Stub Runner Messaging sections.

+
+
+
Maven
+
+
<dependencies>
+	<dependency>
+		<groupId>org.springframework.cloud</groupId>
+		<artifactId>spring-cloud-starter-stream-rabbit</artifactId>
+	</dependency>
+
+	<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-stream-test-support</artifactId>
+		<scope>test</scope>
+	</dependency>
+</dependencies>
+
+<dependencyManagement>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.cloud</groupId>
+			<artifactId>spring-cloud-dependencies</artifactId>
+			<version>Edgware.BUILD-SNAPSHOT</version>
+			<type>pom</type>
+			<scope>import</scope>
+		</dependency>
+	</dependencies>
+</dependencyManagement>
+
+
+
+
Gradle
+
+
ext {
+	contractsDir = file("mappings")
+	stubsOutputDirRoot = file("${project.buildDir}/production/${project.name}-stubs/")
+}
+
+// Automatically added by plugin:
+// copyContracts - copies contracts to the output folder from which JAR will be created
+// verifierStubsJar - JAR with a provided stub suffix
+// the presented publication is also added by the plugin but you can modify it as you wish
+
+publishing {
+	publications {
+		stubs(MavenPublication) {
+			artifactId "${project.name}-stubs"
+			artifact verifierStubsJar
+		}
+	}
+}
+
+
+
+
+
+

2.5. Spring Cloud Contract Stub Runner

+
+

One of the issues that you could have encountered while using Spring Cloud Contract Verifier was to pass the generated WireMock JSON stubs from the server side to the client side (or various clients). + The same takes place in terms of client side generation for messaging.

+
+
+

Copying the JSON files / setting the client side for messaging manually is out of the question.

+
+
+

That’s why we’ll introduce Spring Cloud Contract Stub Runner that can download and run the stubs +automatically for you.

+
+
+

2.5.1. Snapshot versions

+
+

Add the additional snapshot repository to your build.gradle to use snapshot versions which are automatically uploaded after every successful 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
+
+
buildscript {
+	repositories {
+		mavenCentral()
+		mavenLocal()
+		maven { url "http://repo.spring.io/snapshot" }
+		maven { url "http://repo.spring.io/milestone" }
+		maven { url "http://repo.spring.io/release" }
+	}
+
+
+
+
+

2.5.2. Publishing stubs as JARs

+
+

The easiest approach would be to centralize the way stubs are kept. For example you can keep them as JARs in a Maven repository.

+
+
+ + + + + +
+ + +For both Maven and Gradle the setup comes out of the box. But you can customize it if you want to. +
+
+
+
Maven
+
+
<!-- First disable the default jar setup in the properties section-->
+<!-- we don't want the verifier to do a jar for us -->
+<spring.cloud.contract.verifier.skip>true</spring.cloud.contract.verifier.skip>
+
+<!-- Next add the assembly plugin to your build -->
+<!-- we want the assembly plugin to generate the JAR -->
+<plugin>
+	<groupId>org.apache.maven.plugins</groupId>
+	<artifactId>maven-assembly-plugin</artifactId>
+	<executions>
+		<execution>
+			<id>stub</id>
+			<phase>prepare-package</phase>
+			<goals>
+				<goal>single</goal>
+			</goals>
+			<inherited>false</inherited>
+			<configuration>
+				<attach>true</attach>
+				<descriptor>$/Users/ryanjbaxter/git-repos/spring-cloud/scripts/docs/../src/assembly/stub.xml</descriptor>
+			</configuration>
+		</execution>
+	</executions>
+</plugin>
+
+<!-- Finally setup your assembly. Below you can find the contents of src/main/assembly/stub.xml -->
+<assembly
+	xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">
+	<id>stubs</id>
+	<formats>
+		<format>jar</format>
+	</formats>
+	<includeBaseDirectory>false</includeBaseDirectory>
+	<fileSets>
+		<fileSet>
+			<directory>src/main/java</directory>
+			<outputDirectory>/</outputDirectory>
+			<includes>
+				<include>**com/example/model/*.*</include>
+			</includes>
+		</fileSet>
+		<fileSet>
+			<directory>${project.build.directory}/classes</directory>
+			<outputDirectory>/</outputDirectory>
+			<includes>
+				<include>**com/example/model/*.*</include>
+			</includes>
+		</fileSet>
+		<fileSet>
+			<directory>${project.build.directory}/snippets/stubs</directory>
+			<outputDirectory>META-INF/${project.groupId}/${project.artifactId}/${project.version}/mappings</outputDirectory>
+			<includes>
+				<include>**/*</include>
+			</includes>
+		</fileSet>
+		<fileSet>
+			<directory>$/Users/ryanjbaxter/git-repos/spring-cloud/scripts/docs/../src/test/resources/contracts</directory>
+			<outputDirectory>META-INF/${project.groupId}/${project.artifactId}/${project.version}/contracts</outputDirectory>
+			<includes>
+				<include>**/*.groovy</include>
+			</includes>
+		</fileSet>
+	</fileSets>
+</assembly>
+
+
+
+
Gradle
+
+
ext {
+	contractsDir = file("mappings")
+	stubsOutputDirRoot = file("${project.buildDir}/production/${project.name}-stubs/")
+}
+
+// Automatically added by plugin:
+// copyContracts - copies contracts to the output folder from which JAR will be created
+// verifierStubsJar - JAR with a provided stub suffix
+// the presented publication is also added by the plugin but you can modify it as you wish
+
+publishing {
+	publications {
+		stubs(MavenPublication) {
+			artifactId "${project.name}-stubs"
+			artifact verifierStubsJar
+		}
+	}
+}
+
+
+
+
+
+

2.6. Stub Runner Core

+
+

Runs stubs for service collaborators. Treating stubs as contracts of services allows to use stub-runner as an implementation of +Consumer Driven Contracts.

+
+
+

Stub Runner allows you to automatically download the stubs of the provided dependencies (or pick those from the classpath), start WireMock servers for them and feed them with proper stub definitions. +For messaging, special stub routes are defined.

+
+
+

2.6.1. Retrieving stubs

+
+

You can pick the following options of acquiring stubs

+
+
+
    +
  • +

    Aether based solution that downloads JARs with stubs from Artifactory / Nexus

    +
    • +
  • +

    Classpath scanning solution that searches classpath via pattern to retrieve stubs

    +
    • +
  • +

    Write your own implementation of the org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder for full customization

    +
    • +
+
+
+

The latter example is described in the Custom Stub Runner section.

+
+
+
Stub downloading
+
+

If you provide the stubrunner.repositoryRoot or stubrunner.workOffline flag will be set +to true then Stub Runner will connect to the given server and download the required jars. +It will then unpack the JAR to a temporary folder and reference those files in further +contract processing.

+
+
+

Example:

+
+
+
+
@AutoConfigureStubRunner(repositoryRoot="http://foo.bar", ids = "com.example:beer-api-producer:+:stubs:8095")
+
+
+
+
+
Classpath scanning
+
+

If you DON’T provide the stubrunner.repositoryRoot and stubrunner.workOffline flag will +be set to false (that’s the default) then classpath will get scanned. Let’s look at the +following example:

+
+
+
+
@AutoConfigureStubRunner(ids = {
+    "com.example:beer-api-producer:+:stubs:8095",
+    "com.example.foo:bar:1.0.0:superstubs:8096"
+})
+
+
+
+

If you’ve added the dependencies to your classpath

+
+
+
Maven
+
+
<dependency>
+    <groupId>com.example</groupId>
+    <artifactId>beer-api-producer-restdocs</artifactId>
+    <classifier>stubs</classifier>
+    <version>0.0.1-SNAPSHOT</version>
+    <scope>test</scope>
+    <exclusions>
+        <exclusion>
+            <groupId>*</groupId>
+            <artifactId>*</artifactId>
+        </exclusion>
+    </exclusions>
+</dependency>
+<dependency>
+    <groupId>com.example.foo</groupId>
+    <artifactId>bar</artifactId>
+    <classifier>superstubs</classifier>
+    <version>1.0.0</version>
+    <scope>test</scope>
+    <exclusions>
+        <exclusion>
+            <groupId>*</groupId>
+            <artifactId>*</artifactId>
+        </exclusion>
+    </exclusions>
+</dependency>
+
+
+
+
Gradle
+
+
testCompile("com.example:beer-api-producer-restdocs:0.0.1-SNAPSHOT:stubs") {
+    transitive = false
+}
+testCompile("com.example.foo:bar:1.0.0:superstubs") {
+    transitive = false
+}
+
+
+
+

Then the following locations on your classpath will get scanned. For com.example:beer-api-producer-restdocs

+
+
+
    +
  • +

    /META-INF/com.example/beer-api-producer-restdocs/*/.*

    +
    • +
  • +

    /contracts/com.example/beer-api-producer-restdocs/*/.*

    +
    • +
  • +

    /mappings/com.example/beer-api-producer-restdocs/*/.*

    +
    • +
+
+
+

and com.example.foo:bar

+
+
+
    +
  • +

    /META-INF/com.example.foo/bar/*/.*

    +
    • +
  • +

    /contracts/com.example.foo/bar/*/.*

    +
    • +
  • +

    /mappings/com.example.foo/bar/*/.*

    +
    • +
+
+
+ + + + + +
+ + +As you can see you have to explicitly provide the group and artifact ids when packaging the +producer stubs. +
+
+
+

The producer would setup the contracts like this:

+
+
+
+
└── src
+    └── test
+        └── resources
+            └── contracts
+                └── com.example
+                    └── beer-api-producer-restdocs
+                        └── nested
+                            └── contract3.groovy
+
+
+
+

To achieve proper stub packaging.

+
+
+

Or using the Maven assembly plugin or +Gradle Jar task you have to create the following +structure in your stubs jar.

+
+
+
+
└── META-INF
+    └── com.example
+        └── beer-api-producer-restdocs
+            └── 2.0.0
+                ├── contracts
+                │   └── nested
+                │       └── contract2.groovy
+                └── mappings
+                    └── mapping.json
+
+
+
+

By maintaining this structure classpath gets scanned and you can profit from the messaging / +HTTP stubs without the need to download artifacts.

+
+
+
+
+

2.6.2. Running stubs

+
+
Limitations
+
+ + + + + +
+ + +There might be a problem with StubRunner shutting down ports between tests. You might + have a situation in which you get port conflicts. As long as you use the same context across tests + everything works fine. But when the context are different (e.g. different stubs or different profiles) + then you have to either use @DirtiesContext to shut down the stub servers, or else run them on + different ports per test. +
+
+
+
+
Running using main app
+
+

You can set the following options to the main class:

+
+
+
+
-c, --classifier                Suffix for the jar containing stubs (e.
+                                  g. 'stubs' if the stub jar would
+                                  have a 'stubs' classifier for stubs:
+                                  foobar-stubs ). Defaults to 'stubs'
+                                  (default: stubs)
+--maxPort, --maxp <Integer>     Maximum port value to be assigned to
+                                  the WireMock instance. Defaults to
+                                  15000 (default: 15000)
+--minPort, --minp <Integer>     Minimum port value to be assigned to
+                                  the WireMock instance. Defaults to
+                                  10000 (default: 10000)
+-p, --password                  Password to user when connecting to
+                                  repository
+--phost, --proxyHost            Proxy host to use for repository
+                                  requests
+--pport, --proxyPort [Integer]  Proxy port to use for repository
+                                  requests
+-r, --root                      Location of a Jar containing server
+                                  where you keep your stubs (e.g. http:
+                                  //nexus.
+                                  net/content/repositories/repository)
+-s, --stubs                     Comma separated list of Ivy
+                                  representation of jars with stubs.
+                                  Eg. groupid:artifactid1,groupid2:
+                                  artifactid2:classifier
+-u, --username                  Username to user when connecting to
+                                  repository
+--wo, --workOffline             Switch to work offline. Defaults to
+                                  'false'
+
+
+
+
+
HTTP Stubs
+
+

Stubs are defined in JSON documents, whose syntax is defined in WireMock documentation

+
+
+

Example:

+
+
+
+
{
+    "request": {
+        "method": "GET",
+        "url": "/ping"
+    },
+    "response": {
+        "status": 200,
+        "body": "pong",
+        "headers": {
+            "Content-Type": "text/plain"
+        }
+    }
+}
+
+
+
+
+
Viewing registered mappings
+
+

Every stubbed collaborator exposes list of defined mappings under __/admin/ endpoint.

+
+
+

You can also use the mappingsOutputFolder property to dump the mappings to files. + For annotation based approach it would look like this

+
+
+
+
@AutoConfigureStubRunner(ids="a.b.c:loanIssuance,a.b.c:fraudDetectionServer",
+mappingsOutputFolder = "target/outputmappings/")
+
+
+
+

and for the JUnit approach like this:

+
+
+
+
@ClassRule @Shared StubRunnerRule rule = new StubRunnerRule()
+			.repoRoot("http://some_url")
+			.downloadStub("a.b.c", "loanIssuance")
+			.downloadStub("a.b.c:fraudDetectionServer")
+			.withMappingsOutputFolder("target/outputmappings")
+
+
+
+

Then if you check out the folder target/outputmappings you would see the following structure

+
+
+
+
.
+├── fraudDetectionServer_13705
+└── loanIssuance_12255
+
+
+
+

That means that there were two stubs registered. fraudDetectionServer was registered at port 13705 +and loanIssuance at port 12255. If we take a look at one of the files we would see (for WireMock) +mappings available for the given server:

+
+
+
+
[{
+  "id" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7",
+  "request" : {
+    "url" : "/name",
+    "method" : "GET"
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "fraudDetectionServer"
+  },
+  "uuid" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7"
+},
+...
+]
+
+
+
+
+
Messaging Stubs
+
+

Depending on the provided Stub Runner dependency and the DSL the messaging routes are automatically set up.

+
+
+
+
+
+

2.7. Stub Runner JUnit Rule

+
+

Stub Runner comes with a JUnit rule thanks to which you can very easily download and run stubs for given group and artifact id:

+
+
+
+
@ClassRule public static StubRunnerRule rule = new StubRunnerRule()
+		.repoRoot(repoRoot())
+		.downloadStub("org.springframework.cloud.contract.verifier.stubs", "loanIssuance")
+		.downloadStub("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer");
+
+
+
+

After that rule gets executed Stub Runner connects to your Maven repository and for the given list of dependencies tries to:

+
+
+
    +
  • +

    download them

    +
    • +
  • +

    cache them locally

    +
    • +
  • +

    unzip them to a temporary folder

    +
    • +
  • +

    start a WireMock server for each Maven dependency on a random port from the provided range of ports / provided port

    +
    • +
  • +

    feed the WireMock server with all JSON files that are valid WireMock definitions

    +
    • +
  • +

    can also send messages (remember to pass an implementation of MessageVerifier interface)

    +
    • +
+
+
+

Stub Runner uses Eclipse Aether mechanism to download the Maven dependencies. +Check their docs for more information.

+
+
+

Since the StubRunnerRule implements the StubFinder it allows you to find the started stubs:

+
+
+
+
package org.springframework.cloud.contract.stubrunner;
+
+import java.net.URL;
+import java.util.Collection;
+import java.util.Map;
+
+import org.springframework.cloud.contract.spec.Contract;
+
+public interface StubFinder extends StubTrigger {
+	/**
+	 * For the given groupId and artifactId tries to find the matching
+	 * URL of the running stub.
+	 *
+	 * @param groupId - might be null. In that case a search only via artifactId takes place
+	 * @return URL of a running stub or throws exception if not found
+	 */
+	URL findStubUrl(String groupId, String artifactId) throws StubNotFoundException;
+
+	/**
+	 * For the given Ivy notation {@code [groupId]:artifactId:[version]:[classifier]} tries to
+	 * find the matching URL of the running stub. You can also pass only {@code artifactId}.
+	 *
+	 * @param ivyNotation - Ivy representation of the Maven artifact
+	 * @return URL of a running stub or throws exception if not found
+	 */
+	URL findStubUrl(String ivyNotation) throws StubNotFoundException;
+
+	/**
+	 * Returns all running stubs
+	 */
+	RunningStubs findAllRunningStubs();
+
+	/**
+	 * Returns the list of Contracts
+	 */
+	Map<StubConfiguration, Collection<Contract>> getContracts();
+}
+
+
+
+

Example of usage in Spock tests:

+
+
+
+
@ClassRule @Shared StubRunnerRule rule = new StubRunnerRule()
+		.repoRoot(StubRunnerRuleSpec.getResource("/m2repo/repository").toURI().toString())
+		.downloadStub("org.springframework.cloud.contract.verifier.stubs", "loanIssuance")
+		.downloadStub("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
+		.withMappingsOutputFolder("target/outputmappingsforrule")
+
+
+def 'should start WireMock servers'() {
+	expect: 'WireMocks are running'
+		rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
+		rule.findStubUrl('loanIssuance') != null
+		rule.findStubUrl('loanIssuance') == rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
+		rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
+	and:
+		rule.findAllRunningStubs().isPresent('loanIssuance')
+		rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
+		rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
+	and: 'Stubs were registered'
+		"${rule.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+		"${rule.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+}
+
+def 'should output mappings to output folder'() {
+	when:
+		def url = rule.findStubUrl('fraudDetectionServer')
+	then:
+		new File("target/outputmappingsforrule", "fraudDetectionServer_${url.port}").exists()
+}
+
+
+
+

Example of usage in JUnit tests:

+
+
+
+
@Test
+public void should_start_wiremock_servers() throws Exception {
+	// expect: 'WireMocks are running'
+		then(rule.findStubUrl("org.springframework.cloud.contract.verifier.stubs", "loanIssuance")).isNotNull();
+		then(rule.findStubUrl("loanIssuance")).isNotNull();
+		then(rule.findStubUrl("loanIssuance")).isEqualTo(rule.findStubUrl("org.springframework.cloud.contract.verifier.stubs", "loanIssuance"));
+		then(rule.findStubUrl("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")).isNotNull();
+	// and:
+		then(rule.findAllRunningStubs().isPresent("loanIssuance")).isTrue();
+		then(rule.findAllRunningStubs().isPresent("org.springframework.cloud.contract.verifier.stubs", "fraudDetectionServer")).isTrue();
+		then(rule.findAllRunningStubs().isPresent("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")).isTrue();
+	// and: 'Stubs were registered'
+		then(httpGet(rule.findStubUrl("loanIssuance").toString() + "/name")).isEqualTo("loanIssuance");
+		then(httpGet(rule.findStubUrl("fraudDetectionServer").toString() + "/name")).isEqualTo("fraudDetectionServer");
+}
+
+
+
+

Check the Common properties for JUnit and Spring for more information on how to apply global configuration of Stub Runner.

+
+
+ + + + + +
+ + +To use the JUnit rule together with messaging you have to provide an implementation of the +MessageVerifier interface to the rule builder (e.g. rule.messageVerifier(new MyMessageVerifier())). +If you don’t do this then whenever you try to send a message an exception will be thrown. +
+
+
+

2.7.1. Maven settings

+
+

The stub downloader honors Maven settings for a different local repository folder. +Authentication details for repositories and profiles are currently not taken into account, so you need to specify it using the properties mentioned above.

+
+
+
+

2.7.2. Providing fixed ports

+
+

You can also run your stubs on fixed ports. You can do it in two different ways. One is to pass it in the properties, and the other via fluent API of +JUnit rule.

+
+
+
+

2.7.3. Fluent API

+
+

When using the StubRunnerRule you can add a stub to download and then pass the port for the last downloaded stub.

+
+
+
+
@ClassRule public static StubRunnerRule rule = new StubRunnerRule()
+		.repoRoot(repoRoot())
+		.downloadStub("org.springframework.cloud.contract.verifier.stubs", "loanIssuance")
+		.withPort(12345)
+		.downloadStub("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer:12346");
+
+
+
+

You can see that for this example the following test is valid:

+
+
+
+
then(rule.findStubUrl("loanIssuance")).isEqualTo(URI.create("http://localhost:12345").toURL());
+then(rule.findStubUrl("fraudDetectionServer")).isEqualTo(URI.create("http://localhost:12346").toURL());
+
+
+
+
+

2.7.4. Stub Runner with Spring

+
+

Sets up Spring configuration of the Stub Runner project.

+
+
+

By providing a list of stubs inside your configuration file the Stub Runner automatically downloads +and registers in WireMock the selected stubs.

+
+
+

If you want to find the URL of your stubbed dependency you can autowire the StubFinder interface and use +its methods as presented below:

+
+
+
+
@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest(properties = [" stubrunner.cloud.enabled=false",
+		"stubrunner.camel.enabled=false",
+		'foo=${stubrunner.runningstubs.fraudDetectionServer.port}'])
+@AutoConfigureStubRunner(mappingsOutputFolder = "target/outputmappings/")
+@DirtiesContext
+@ActiveProfiles("test")
+class StubRunnerConfigurationSpec extends Specification {
+
+	@Autowired StubFinder stubFinder
+	@Autowired Environment environment
+	@Value('${foo}') Integer foo
+
+	@BeforeClass
+	@AfterClass
+	void setupProps() {
+		System.clearProperty("stubrunner.repository.root")
+		System.clearProperty("stubrunner.classifier")
+	}
+
+	def 'should start WireMock servers'() {
+		expect: 'WireMocks are running'
+			stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
+			stubFinder.findStubUrl('loanIssuance') != null
+			stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
+			stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance')
+			stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs')
+			stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
+		and:
+			stubFinder.findAllRunningStubs().isPresent('loanIssuance')
+			stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
+			stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
+		and: 'Stubs were registered'
+			"${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+			"${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+	}
+
+	def 'should throw an exception when stub is not found'() {
+		when:
+			stubFinder.findStubUrl('nonExistingService')
+		then:
+			thrown(StubNotFoundException)
+		when:
+			stubFinder.findStubUrl('nonExistingGroupId', 'nonExistingArtifactId')
+		then:
+			thrown(StubNotFoundException)
+	}
+
+	def 'should register started servers as environment variables'() {
+		expect:
+			environment.getProperty("stubrunner.runningstubs.loanIssuance.port") != null
+			stubFinder.findAllRunningStubs().getPort("loanIssuance") == (environment.getProperty("stubrunner.runningstubs.loanIssuance.port") as Integer)
+		and:
+			environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") != null
+			stubFinder.findAllRunningStubs().getPort("fraudDetectionServer") == (environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") as Integer)
+	}
+
+	def 'should be able to interpolate a running stub in the passed test property'() {
+		given:
+			int fraudPort = stubFinder.findAllRunningStubs().getPort("fraudDetectionServer")
+		expect:
+			fraudPort > 0
+			environment.getProperty("foo", Integer) == fraudPort
+			foo == fraudPort
+	}
+
+	def 'should dump all mappings to a file'() {
+		when:
+			def url = stubFinder.findStubUrl("fraudDetectionServer")
+		then:
+			new File("target/outputmappings/", "fraudDetectionServer_${url.port}").exists()
+	}
+
+	@Configuration
+	@EnableAutoConfiguration
+	static class Config {}
+}
+
+
+
+

for the following configuration file:

+
+
+
+
stubrunner:
+  repositoryRoot: classpath:m2repo/repository/
+  ids:
+    - org.springframework.cloud.contract.verifier.stubs:loanIssuance
+    - org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer
+    - org.springframework.cloud.contract.verifier.stubs:bootService
+  cloud:
+    enabled: false
+  camel:
+    enabled: false
+
+spring.cloud:
+  consul.enabled: false
+  service-registry.enabled: false
+
+
+
+

Instead of using the properties you can also use the properties inside the @AutoConfigureStubRunner. +Below you can find an example of achieving the same result by setting values on the annotation.

+
+
+
+
@AutoConfigureStubRunner(
+		ids = ["org.springframework.cloud.contract.verifier.stubs:loanIssuance",
+		"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer",
+		"org.springframework.cloud.contract.verifier.stubs:bootService"],
+		repositoryRoot = "classpath:m2repo/repository/")
+
+
+
+

Stub Runner Spring registers environment variables in the following manner +for every registered WireMock server. Example for Stub Runner ids + com.example:foo, com.example:bar.

+
+
+
    +
  • +

    stubrunner.runningstubs.foo.port

    +
    • +
  • +

    stubrunner.runningstubs.bar.port

    +
    • +
+
+
+

Which you can reference in your code.

+
+
+
+
+

2.8. Stub Runner Spring Cloud

+
+

Stub Runner can integrate with Spring Cloud.

+
+
+

For real life examples you can check the

+
+
+ +
+
+

2.8.1. Stubbing Service Discovery

+
+

The most important feature of Stub Runner Spring Cloud is the fact that it’s stubbing

+
+
+
    +
  • +

    DiscoveryClient

    +
    • +
  • +

    Ribbon ServerList

    +
    • +
+
+
+

that means that regardless of the fact whether you’re using Zookeeper, Consul, Eureka or anything else, you don’t need that in your tests. +We’re starting WireMock instances of your dependencies and we’re telling your application whenever you’re using Feign, load balanced RestTemplate +or DiscoveryClient directly, to call those stubbed servers instead of calling the real Service Discovery tool.

+
+
+

For example this test will pass

+
+
+
+
def 'should make service discovery work'() {
+	expect: 'WireMocks are running'
+		"${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+		"${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+	and: 'Stubs can be reached via load service discovery'
+		restTemplate.getForObject('http://loanIssuance/name', String) == 'loanIssuance'
+		restTemplate.getForObject('http://someNameThatShouldMapFraudDetectionServer/name', String) == 'fraudDetectionServer'
+}
+
+
+
+

for the following configuration file

+
+
+
+
spring.cloud:
+  zookeeper.enabled: false
+  consul.enabled: false
+eureka.client.enabled: false
+stubrunner:
+  camel.enabled: false
+  idsToServiceIds:
+    ivyNotation: someValueInsideYourCode
+    fraudDetectionServer: someNameThatShouldMapFraudDetectionServer
+
+
+
+
Test profiles and service discovery
+
+

In your integration tests you typically don’t want to call neither a discovery service (e.g. Eureka) +or Config Server. That’s why you create an additional test configuration in which you want to disable +these features.

+
+
+

Due to certain limitations of spring-cloud-commons to achieve this you have disable these properties +via a static block like presented below (example for Eureka)

+
+
+
+
    //Hack to work around https://github.com/spring-cloud/spring-cloud-commons/issues/156
+    static {
+        System.setProperty("eureka.client.enabled", "false");
+        System.setProperty("spring.cloud.config.failFast", "false");
+    }
+
+
+
+
+
+

2.8.2. Additional Configuration

+
+

You can match the artifactId of the stub with the name of your app by using the stubrunner.idsToServiceIds: map. +You can disable Stub Runner Ribbon support by providing: stubrunner.cloud.ribbon.enabled equal to false +You can disable Stub Runner support by providing: stubrunner.cloud.enabled equal to false

+
+
+ + + + + +
+ + +By default all service discovery will be stubbed. That means that regardless of the fact if you have +an existing DiscoveryClient its results will be ignored. However, if you want to reuse it, just set + stubrunner.cloud.delegate.enabled to true and then your existing DiscoveryClient results will be + merged with the stubbed ones. +
+
+
+
+
+

2.9. Stub Runner Boot Application

+
+

Spring Cloud Contract Stub Runner Boot is a Spring Boot application that exposes REST endpoints to +trigger the messaging labels and to access started WireMock servers.

+
+
+

One of the use-cases is to run some smoke (end to end) tests on a deployed application. +You can check out the Spring Cloud Pipelines +project for more information.

+
+
+

2.9.1. How to use it?

+
+
Stub Runner Server
+
+

Just add the

+
+
+
+
compile "org.springframework.cloud:spring-cloud-starter-stub-runner"
+
+
+
+

Annotate a class with @EnableStubRunnerServer, build a fat-jar and you’re ready to go!

+
+
+

For the properties check the Stub Runner Spring section.

+
+
+
+
Spring Cloud CLI
+
+

Starting from 1.4.0.RELEASE version of the Spring Cloud CLI +project you can start Stub Runner Boot by executing spring cloud stubrunner.

+
+
+

In order to pass the configuration just create a stubrunner.yml file in the current working directory +or a subdirectory called config or in ~/.spring-cloud. The file could look like this +(example for running stubs installed locally)

+
+
+
stubrunner.yml
+
+
stubrunner:
+  workOffline: true
+  ids:
+    - com.example:beer-api-producer:+:9876
+
+
+
+

and then just call spring cloud stubrunner from your terminal window to start +the Stub Runner server. It will be available at port 8750.

+
+
+
+
+

2.9.2. Endpoints

+
+
HTTP
+
+
    +
  • +

    GET /stubs - returns a list of all running stubs in ivy:integer notation

    +
    • +
  • +

    GET /stubs/{ivy} - returns a port for the given ivy notation (when calling the endpoint ivy can also be artifactId only)

    +
    • +
+
+
+
+
Messaging
+
+

For Messaging

+
+
+
    +
  • +

    GET /triggers - returns a list of all running labels in ivy : [ label1, label2 …​] notation

    +
    • +
  • +

    POST /triggers/{label} - executes a trigger with label

    +
    • +
  • +

    POST /triggers/{ivy}/{label} - executes a trigger with label for the given ivy notation (when calling the endpoint ivy can also be artifactId only)

    +
    • +
+
+
+
+
+

2.9.3. Example

+
+
+
@ContextConfiguration(classes = StubRunnerBoot, loader = SpringBootContextLoader)
+@SpringBootTest(properties = "spring.cloud.zookeeper.enabled=false")
+@ActiveProfiles("test")
+class StubRunnerBootSpec extends Specification {
+
+	@Autowired StubRunning stubRunning
+
+	def setup() {
+		RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning),
+				new TriggerController(stubRunning))
+	}
+
+	def 'should return a list of running stub servers in "full ivy:port" notation'() {
+		when:
+			String response = RestAssuredMockMvc.get('/stubs').body.asString()
+		then:
+			def root = new JsonSlurper().parseText(response)
+			root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs' instanceof Integer
+	}
+
+	def 'should return a port on which a [#stubId] stub is running'() {
+		when:
+			def response = RestAssuredMockMvc.get("/stubs/${stubId}")
+		then:
+			response.statusCode == 200
+			response.body.as(Integer) > 0
+		where:
+			stubId << ['org.springframework.cloud.contract.verifier.stubs:bootService:+:stubs',
+					   'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs',
+					   'org.springframework.cloud.contract.verifier.stubs:bootService:+',
+					   'org.springframework.cloud.contract.verifier.stubs:bootService',
+					   'bootService']
+	}
+
+	def 'should return 404 when missing stub was called'() {
+		when:
+			def response = RestAssuredMockMvc.get("/stubs/a:b:c:d")
+		then:
+			response.statusCode == 404
+	}
+
+	def 'should return a list of messaging labels that can be triggered when version and classifier are passed'() {
+		when:
+			String response = RestAssuredMockMvc.get('/triggers').body.asString()
+		then:
+			def root = new JsonSlurper().parseText(response)
+			root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs'?.containsAll(["delete_book","return_book_1","return_book_2"])
+	}
+
+	def 'should trigger a messaging label'() {
+		given:
+			StubRunning stubRunning = Mock()
+			RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
+		when:
+			def response = RestAssuredMockMvc.post("/triggers/delete_book")
+		then:
+			response.statusCode == 200
+		and:
+			1 * stubRunning.trigger('delete_book')
+	}
+
+	def 'should trigger a messaging label for a stub with [#stubId] ivy notation'() {
+		given:
+			StubRunning stubRunning = Mock()
+			RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
+		when:
+			def response = RestAssuredMockMvc.post("/triggers/$stubId/delete_book")
+		then:
+			response.statusCode == 200
+		and:
+			1 * stubRunning.trigger(stubId, 'delete_book')
+		where:
+			stubId << ['org.springframework.cloud.contract.verifier.stubs:bootService:stubs', 'org.springframework.cloud.contract.verifier.stubs:bootService', 'bootService']
+	}
+
+	def 'should throw exception when trigger is missing'() {
+		when:
+			RestAssuredMockMvc.post("/triggers/missing_label")
+		then:
+			Exception e = thrown(Exception)
+			e.message.contains("Exception occurred while trying to return [missing_label] label.")
+			e.message.contains("Available labels are")
+			e.message.contains("org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs=[]")
+			e.message.contains("org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs=")
+	}
+
+}
+
+
+
+
+

2.9.4. Stub Runner Boot with Service Discovery

+
+

One of the possibilities of using Stub Runner Boot is to use it as a feed of stubs for "smoke-tests". What does it mean? + Let’s assume that you don’t want to deploy 50 microservice to a test environment in order + to check if your application is working fine. You’ve already executed a suite of tests during the build process + but you would also like to ensure that the packaging of your application is fine. What you can do + is to deploy your application to an environment, start it and run a couple of tests on it to see if + it’s working fine. We can call those tests smoke-tests since their idea is to check only a handful + of testing scenarios.

+
+
+

The problem with this approach is such that if you’re doing microservices most likely you’re + using a service discovery tool. Stub Runner Boot allows you to solve this issue by starting the + required stubs and register them in a service discovery tool. Let’s take a look at an example of + such a setup with Eureka. Let’s assume that Eureka was already running.

+
+
+
+
@SpringBootApplication
+@EnableStubRunnerServer
+@EnableEurekaClient
+@AutoConfigureStubRunner
+public class StubRunnerBootEurekaExample {
+
+	public static void main(String[] args) {
+		SpringApplication.run(StubRunnerBootEurekaExample.class, args);
+	}
+
+}
+
+
+
+

As you can see we want to start a Stub Runner Boot server @EnableStubRunnerServer, enable Eureka client @EnableEurekaClient +and we want to have the stub runner feature turned on @AutoConfigureStubRunner.

+
+
+

Now let’s assume that we want to start this application so that the stubs get automatically registered. + We can do it by running the app java -jar ${SYSTEM_PROPS} stub-runner-boot-eureka-example.jar where + ${SYSTEM_PROPS} would contain the following list of properties

+
+
+
+
-Dstubrunner.repositoryRoot=http://repo.spring.io/snapshots (1)
+-Dstubrunner.cloud.stubbed.discovery.enabled=false (2)
+-Dstubrunner.ids=org.springframework.cloud.contract.verifier.stubs:loanIssuance,org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer,org.springframework.cloud.contract.verifier.stubs:bootService (3)
+-Dstubrunner.idsToServiceIds.fraudDetectionServer=someNameThatShouldMapFraudDetectionServer (4)
+
+(1) - we tell Stub Runner where all the stubs reside
+(2) - we don't want the default behaviour where the discovery service is stubbed. That's why the stub registration will be picked
+(3) - we provide a list of stubs to download
+(4) - we provide a list of artifactId to serviceId mapping
+
+
+
+

That way your deployed application can send requests to started WireMock servers via the service +discovery. Most likely points 1-3 could be set by default in application.yml cause they are not +likely to change. That way you can provide only the list of stubs to download whenever you start +the Stub Runner Boot.

+
+
+
+
+

2.10. Stubs Per Consumer

+
+

There are cases in which 2 consumers of the same endpoint want to have 2 different responses.

+
+
+ + + + + +
+ + +This approach also allows you to immediately know which consumer is using which part of your API. +You can remove part of a response that your API produces and you can see which of your autogenerated tests +fails. If none fails then you can safely delete that part of the response cause nobody is using it. +
+
+
+

Let’s look at the following example for contract defined for the producer called producer. +There are 2 consumers: foo-consumer and bar-consumer.

+
+
+

Consumer foo-service

+
+
+
+
request {
+   url '/foo'
+   method GET()
+}
+response {
+    status 200
+    body(
+       foo: "foo"
+    }
+}
+
+
+
+

Consumer bar-service

+
+
+
+
request {
+   url '/foo'
+   method GET()
+}
+response {
+    status 200
+    body(
+       bar: "bar"
+    }
+}
+
+
+
+

You can’t produce for the same request 2 different responses. That’s why you can properly package the +contracts and then profit from the stubsPerConsumer feature.

+
+
+

On the producer side the consumers can have a folder that contains contracts related only to them. +By setting the stubrunner.stubs-per-consumer flag to true we no longer register all stubs but only those that +correspond to the consumer application’s name. In other words we’ll scan the path of every stub and +if it contains the subfolder with name of the consumer in the path only then will it get registered.

+
+
+

On the foo producer side the contracts would look like this

+
+
+
+
.
+└── contracts
+    ├── bar-consumer
+    │   ├── bookReturnedForBar.groovy
+    │   └── shouldCallBar.groovy
+    └── foo-consumer
+        ├── bookReturnedForFoo.groovy
+        └── shouldCallFoo.groovy
+
+
+
+

Being the bar-consumer consumer you can either set the spring.application.name or the stubrunner.consumer-name to bar-consumer +Or set the test as follows:

+
+
+
+
@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest(properties = ["spring.application.name=bar-consumer"])
+@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
+		repositoryRoot = "classpath:m2repo/repository/",
+		stubsPerConsumer = true)
+@DirtiesContext
+class StubRunnerStubsPerConsumerSpec extends Specification {
+...
+}
+
+
+
+

Then only the stubs registered under a path that contains the bar-consumer in its name (i.e. those from the +src/test/resources/contracts/bar-consumer/some/contracts/…​ folder) will be allowed to be referenced.

+
+
+

Or set the consumer name explicitly

+
+
+
+
@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest
+@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
+		repositoryRoot = "classpath:m2repo/repository/",
+		consumerName = "foo-consumer",
+		stubsPerConsumer = true)
+@DirtiesContext
+class StubRunnerStubsPerConsumerWithConsumerNameSpec extends Specification {
+...
+}
+
+
+
+

Then only the stubs registered under a path that contains the foo-consumer in its name (i.e. those from the +src/test/resources/contracts/foo-consumer/some/contracts/…​ folder) will be allowed to be referenced.

+
+
+

You can check out issue 224 for more +information about the reasons behind this change.

+
+
+
+

2.11. Common

+
+

2.11.1. Common properties for JUnit and Spring

+
+

Some of the properties that are repetitive can be set using system properties or configuration properties (for Spring). Here are their names with their default values:

+
+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Property nameDefault valueDescription

stubrunner.minPort

10000

Minimal value of a port for a started WireMock with stubs

stubrunner.maxPort

15000

Minimal value of a port for a started WireMock with stubs

stubrunner.repositoryRoot

Maven repo url. If blank then will call the local maven repo

stubrunner.classifier

stubs

Default classifier for the stub artifacts

stubrunner.workOffline

false

If true then will not contact any remote repositories to download stubs

stubrunner.ids

Array of Ivy notation stubs to download

stubrunner.username

Optional username to access the tool that stores the JARs with stubs

stubrunner.password

Optional password to access the tool that stores the JARs with stubs

stubrunner.stubsPerConsumer

false

Set to true if you want to use different stubs per each consumer instead of registering all stubs for every consumer

stubrunner.consumerName

If you want to use stubs per consumer and want to override the consumer name just change this value

+
+
Stub runner stubs ids
+
+

You can provide the stubs to download via the stubrunner.ids system property. They follow the following pattern:

+
+
+
+
groupId:artifactId:version:classifier:port
+
+
+
+

version, classifier and port are optional.

+
+
+
    +
  • +

    If you don’t provide the port then a random one will be picked

    +
    • +
  • +

    If you don’t provide the classifier then the default one will be taken. (NOTE that you can pass an empty classifier like this groupId:artifactId:version:)

    +
    • +
  • +

    If you don’t provide the version then the + will be passed and the latest one will be downloaded

    +
    • +
+
+
+

Where port means the port of the WireMock server.

+
+
+ + + + + +
+ + +Starting from version 1.0.4 as a version you can provide a range of versions that you would like +the Stub Runner to take into consideration. You can read more about the Aether versioning ranges here. +
+
+
+

Taken from Aether Docs:

+
+
+
+
+

This scheme accepts versions of any form, interpreting a version as a sequence of numeric and alphabetic segments. The characters '-', '_', and '.' as well as the mere +transitions from digit to letter and vice versa delimit the version segments. Delimiters are treated as equivalent.

+
+
+

Numeric segments are compared mathematically, alphabetic segments are compared lexicographically and case-insensitively. However, the following qualifier strings are +recognized and treated specially: "alpha" = "a" < "beta" = "b" < "milestone" = "m" < "cr" = "rc" < "snapshot" < "final" = "ga" < "sp". All of those well-known qualifiers +are considered smaller/older than other strings. An empty segment/string is equivalent to 0.

+
+
+

In addition to the above mentioned qualifiers, the tokens "min" and "max" may be used as final version segment to denote the smallest/greatest version having a given prefix. +For example, "1.2.min" denotes the smallest version in the 1.2 line, "1.2.max" denotes the greatest version in the 1.2 line. A version range of the form "[M.N.*]" is short for "[M.N.min, M.N.max]".

+
+
+

Numbers and strings are considered incomparable against each other. Where version segments of different kind would collide, comparison will instead assume that the previous +segments are padded with trailing 0 or "ga" segments, respectively, until the kind mismatch is resolved, e.g. "1-alpha" = "1.0.0-alpha" < "1.0.1-ga" = "1.0.1".

+
+
+
+
+
+
+
+

2.12. Stub Runner for Messaging

+
+

Stub Runner has the functionality to run the published stubs in memory. It can integrate with the following frameworks out of the box

+
+
+
    +
  • +

    Spring Integration

    +
    • +
  • +

    Spring Cloud Stream

    +
    • +
  • +

    Apache Camel

    +
    • +
  • +

    Spring AMQP

    +
    • +
+
+
+

It also provides points of entry to integrate with any other solution on the market.

+
+
+

2.12.1. Stub triggering

+
+

To trigger a message it’s enough to use the StubTrigger interface:

+
+
+
+
package org.springframework.cloud.contract.stubrunner;
+
+import java.util.Collection;
+import java.util.Map;
+
+public interface StubTrigger {
+
+	/**
+	 * Triggers an event by a given label for a given {@code groupid:artifactid} notation. You can use only {@code artifactId} too.
+	 *
+	 * Feature related to messaging.
+	 *
+	 * @return true - if managed to run a trigger
+	 */
+	boolean trigger(String ivyNotation, String labelName);
+
+	/**
+	 * Triggers an event by a given label.
+	 *
+	 * Feature related to messaging.
+	 *
+	 * @return true - if managed to run a trigger
+	 */
+	boolean trigger(String labelName);
+
+	/**
+	 * Triggers all possible events.
+	 *
+	 * Feature related to messaging.
+	 *
+	 * @return true - if managed to run a trigger
+	 */
+	boolean trigger();
+
+	/**
+	 * Returns a mapping of ivy notation of a dependency to all the labels it has.
+	 *
+	 * Feature related to messaging.
+	 */
+	Map<String, Collection<String>> labels();
+}
+
+
+
+

For convenience the StubFinder interface extends StubTrigger so it’s enough to use only one in your tests.

+
+
+

StubTrigger gives you the following options to trigger a message:

+
+
+
Trigger by label
+
+
+
stubFinder.trigger('return_book_1')
+
+
+
+
Trigger by group and artifact ids
+
+
+
stubFinder.trigger('org.springframework.cloud.contract.verifier.stubs:camelService', 'return_book_1')
+
+
+
+
+
Trigger by artifact ids
+
+
+
stubFinder.trigger('camelService', 'return_book_1')
+
+
+
+
+
+
Trigger all messages
+
+
+
stubFinder.trigger()
+
+
+
+
+
+
+

2.13. Stub Runner Camel

+
+

Spring Cloud Contract Verifier Stub Runner’s messaging module gives you an easy way to integrate with Apache Camel. +For the provided artifacts it will automatically download the stubs and register the required +routes.

+
+
+

2.13.1. Adding it to the project

+
+

It’s enough to have both Apache Camel and Spring Cloud Contract Stub Runner on classpath. +Remember to annotate your test class with @AutoConfigureStubRunner.

+
+
+
+

2.13.2. Examples

+
+
Stubs structure
+
+

Let us assume that we have the following Maven repository with a deployed stubs for the +camelService application.

+
+
+
+
└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── camelService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── camelService-0.0.1-SNAPSHOT.pom
+                            │   ├── camelService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml
+
+
+
+

And the stubs contain the following structure:

+
+
+
+
├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings
+
+
+
+

Let’s consider the following contracts (let' number it with 1):

+
+
+
+
Contract.make {
+	label 'return_book_1'
+	input {
+		triggeredBy('bookReturnedTriggered()')
+	}
+	outputMessage {
+		sentTo('jms:output')
+		body('''{ "bookName" : "foo" }''')
+		headers {
+			header('BOOK-NAME', 'foo')
+		}
+	}
+}
+
+
+
+

and number 2

+
+
+
+
Contract.make {
+	label 'return_book_2'
+	input {
+		messageFrom('jms:input')
+		messageBody([
+				bookName: 'foo'
+		])
+		messageHeaders {
+			header('sample', 'header')
+		}
+	}
+	outputMessage {
+		sentTo('jms:output')
+		body([
+				bookName: 'foo'
+		])
+		headers {
+			header('BOOK-NAME', 'foo')
+		}
+	}
+}
+
+
+
+
+
Scenario 1 (no input message)
+
+

So as to trigger a message via the return_book_1 label we’ll use the StubTigger interface as follows

+
+
+
+
stubFinder.trigger('return_book_1')
+
+
+
+

Next we’ll want to listen to the output of the message sent to jms:output

+
+
+
+
Exchange receivedMessage = camelContext.createConsumerTemplate().receive('jms:output', 5000)
+
+
+
+

And the received message would pass the following assertions

+
+
+
+
receivedMessage != null
+assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
+receivedMessage.in.headers.get('BOOK-NAME') == 'foo'
+
+
+
+
+
Scenario 2 (output triggered by input)
+
+

Since the route is set for you it’s enough to just send a message to the jms:output destination.

+
+
+
+
camelContext.createProducerTemplate().sendBodyAndHeaders('jms:input', new BookReturned('foo'), [sample: 'header'])
+
+
+
+

Next we’ll want to listen to the output of the message sent to jms:output

+
+
+
+
Exchange receivedMessage = camelContext.createConsumerTemplate().receive('jms:output', 5000)
+
+
+
+

And the received message would pass the following assertions

+
+
+
+
receivedMessage != null
+assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
+receivedMessage.in.headers.get('BOOK-NAME') == 'foo'
+
+
+
+
+
Scenario 3 (input with no output)
+
+

Since the route is set for you it’s enough to just send a message to the jms:output destination.

+
+
+
+
camelContext.createProducerTemplate().sendBodyAndHeaders('jms:delete', new BookReturned('foo'), [sample: 'header'])
+
+
+
+
+
+
+

2.14. Stub Runner Integration

+
+

Spring Cloud Contract Verifier Stub Runner’s messaging module gives you an easy way to integrate with Spring Integration. +For the provided artifacts it will automatically download the stubs and register the required +routes.

+
+
+

2.14.1. Adding it to the project

+
+

It’s enough to have both Spring Integration and Spring Cloud Contract Stub Runner on classpath. +Remember to annotate your test class with @AutoConfigureStubRunner.

+
+
+
+

2.14.2. Examples

+
+
Stubs structure
+
+

Let us assume that we have the following Maven repository with a deployed stubs for the +integrationService application.

+
+
+
+
└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── integrationService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── integrationService-0.0.1-SNAPSHOT.pom
+                            │   ├── integrationService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml
+
+
+
+

And the stubs contain the following structure:

+
+
+
+
├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings
+
+
+
+

Let’s consider the following contracts (let' number it with 1):

+
+
+
+
Contract.make {
+	label 'return_book_1'
+	input {
+		triggeredBy('bookReturnedTriggered()')
+	}
+	outputMessage {
+		sentTo('output')
+		body('''{ "bookName" : "foo" }''')
+		headers {
+			header('BOOK-NAME', 'foo')
+		}
+	}
+}
+
+
+
+

and number 2

+
+
+
+
Contract.make {
+	label 'return_book_2'
+	input {
+		messageFrom('input')
+		messageBody([
+				bookName: 'foo'
+		])
+		messageHeaders {
+			header('sample', 'header')
+		}
+	}
+	outputMessage {
+		sentTo('output')
+		body([
+				bookName: 'foo'
+		])
+		headers {
+			header('BOOK-NAME', 'foo')
+		}
+	}
+}
+
+
+
+

and the following Spring Integration Route:

+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<beans:beans xmlns="http://www.springframework.org/schema/integration"
+			 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+			 xmlns:beans="http://www.springframework.org/schema/beans"
+			 xsi:schemaLocation="http://www.springframework.org/schema/beans
+			http://www.springframework.org/schema/beans/spring-beans.xsd
+			http://www.springframework.org/schema/integration
+			http://www.springframework.org/schema/integration/spring-integration.xsd">
+
+
+	<!-- REQUIRED FOR TESTING -->
+	<bridge input-channel="output"
+			output-channel="outputTest"/>
+
+	<channel id="outputTest">
+		<queue/>
+	</channel>
+
+</beans:beans>
+
+
+
+
+
Scenario 1 (no input message)
+
+

So as to trigger a message via the return_book_1 label we’ll use the StubTigger interface as follows

+
+
+
+
stubFinder.trigger('return_book_1')
+
+
+
+

Next we’ll want to listen to the output of the message sent to output

+
+
+
+
Message<?> receivedMessage = messaging.receive('outputTest')
+
+
+
+

And the received message would pass the following assertions

+
+
+
+
receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'
+
+
+
+
+
Scenario 2 (output triggered by input)
+
+

Since the route is set for you it’s enough to just send a message to the output destination.

+
+
+
+
messaging.send(new BookReturned('foo'), [sample: 'header'], 'input')
+
+
+
+

Next we’ll want to listen to the output of the message sent to output

+
+
+
+
Message<?> receivedMessage = messaging.receive('outputTest')
+
+
+
+

And the received message would pass the following assertions

+
+
+
+
receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'
+
+
+
+
+
Scenario 3 (input with no output)
+
+

Since the route is set for you it’s enough to just send a message to the input destination.

+
+
+
+
messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')
+
+
+
+
+
+
+

2.15. Stub Runner Stream

+
+

Spring Cloud Contract Verifier Stub Runner’s messaging module gives you an easy way to integrate with Spring Stream. +For the provided artifacts it will automatically download the stubs and register the required +routes.

+
+
+ + + + + +
+ + +In Stub Runner’s integration with Stream the messageFrom or sentTo Strings are resolved +first as a destination of a channel, and then if there is no such destination it’s resolved as a +channel name. +
+
+
+ + + + + +
+ + +If you want to use Spring Cloud Stream remember to add a +org.springframework.cloud:spring-cloud-stream-test-support dependency. +
+
+
+
Maven
+
+
<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-stream-test-support</artifactId>
+    <scope>test</scope>
+</dependency>
+
+
+
+
Gradle
+
+
testCompile "org.springframework.cloud:spring-cloud-stream-test-support"
+
+
+
+

2.15.1. Adding it to the project

+
+

It’s enough to have both Spring Cloud Stream and Spring Cloud Contract Stub Runner on classpath. +Remember to annotate your test class with @AutoConfigureStubRunner.

+
+
+
+

2.15.2. Examples

+
+
Stubs structure
+
+

Let us assume that we have the following Maven repository with a deployed stubs for the +streamService application.

+
+
+
+
└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── streamService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── streamService-0.0.1-SNAPSHOT.pom
+                            │   ├── streamService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml
+
+
+
+

And the stubs contain the following structure:

+
+
+
+
├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings
+
+
+
+

Let’s consider the following contracts (let' number it with 1):

+
+
+
+
Contract.make {
+	label 'return_book_1'
+	input { triggeredBy('bookReturnedTriggered()') }
+	outputMessage {
+		sentTo('returnBook')
+		body('''{ "bookName" : "foo" }''')
+		headers { header('BOOK-NAME', 'foo') }
+	}
+}
+
+
+
+

and number 2

+
+
+
+
Contract.make {
+	label 'return_book_2'
+	input {
+		messageFrom('bookStorage')
+		messageBody([
+			bookName: 'foo'
+		])
+		messageHeaders { header('sample', 'header') }
+	}
+	outputMessage {
+		sentTo('returnBook')
+		body([
+			bookName: 'foo'
+		])
+		headers { header('BOOK-NAME', 'foo') }
+	}
+}
+
+
+
+

and the following Spring configuration:

+
+
+
+
stubrunner.repositoryRoot: classpath:m2repo/repository/
+stubrunner.ids: org.springframework.cloud.contract.verifier.stubs:streamService:0.0.1-SNAPSHOT:stubs
+
+spring:
+  cloud:
+    stream:
+      bindings:
+        output:
+          destination: returnBook
+        input:
+          destination: bookStorage
+
+server:
+  port: 0
+
+debug: true
+
+
+
+
+
Scenario 1 (no input message)
+
+

So as to trigger a message via the return_book_1 label we’ll use the StubTrigger interface as follows

+
+
+
+
stubFinder.trigger('return_book_1')
+
+
+
+

Next we’ll want to listen to the output of the message sent to a channel whose destination is returnBook

+
+
+
+
Message<?> receivedMessage = messaging.receive('returnBook')
+
+
+
+

And the received message would pass the following assertions

+
+
+
+
receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'
+
+
+
+
+
Scenario 2 (output triggered by input)
+
+

Since the route is set for you it’s enough to just send a message to the bookStorage destination.

+
+
+
+
messaging.send(new BookReturned('foo'), [sample: 'header'], 'bookStorage')
+
+
+
+

Next we’ll want to listen to the output of the message sent to returnBook

+
+
+
+
Message<?> receivedMessage = messaging.receive('returnBook')
+
+
+
+

And the received message would pass the following assertions

+
+
+
+
receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'
+
+
+
+
+
Scenario 3 (input with no output)
+
+

Since the route is set for you it’s enough to just send a message to the output destination.

+
+
+
+
messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')
+
+
+
+
+
+
+

2.16. Stub Runner Spring AMQP

+
+

Spring Cloud Contract Verifier Stub Runner’s messaging module provides an easy way to integrate with Spring AMQP’s Rabbit Template. +For the provided artifacts it will automatically download the stubs and register the required +routes.

+
+
+

The integration tries to work standalone, that is without interaction with a running RabbitMQ message broker. +It expects a RabbitTemplate on the application context and uses it as a spring boot test @SpyBean. +Thus it can use the mockito spy functionality to verify and introspect messages sent by the application.

+
+
+

On the message consumer side, it considers all @RabbitListener annotated endpoints as well as all `SimpleMessageListenerContainer`s on the application context.

+
+
+

As messages are usually sent to exchanges in AMQP the message contract contains the exchange name as the destination. +Message listeners on the other side are bound to queues. Bindings connect an exchange to a queue. +If message contracts are triggered the Spring AMQP stub runner integration will look for bindings on the application context that match this exchange. +Then it collects the queues from the Spring exchanges and tries to find messages listeners bound to these queues. +The message is triggered to all matching message listeners.

+
+
+

2.16.1. Adding it to the project

+
+

It’s enough to have both Spring AMQP and Spring Cloud Contract Stub Runner on the classpath and set the property stubrunner.amqp.enabled=true. +Remember to annotate your test class with @AutoConfigureStubRunner.

+
+
+
+

2.16.2. Examples

+
+
Stubs structure
+
+

Let us assume that we have the following Maven repository with a deployed stubs for the +spring-cloud-contract-amqp-test application.

+
+
+
+
└── .m2
+    └── repository
+        └── com
+            └── example
+                └── spring-cloud-contract-amqp-test
+                    ├── 0.4.0-SNAPSHOT
+                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT.pom
+                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT-stubs.jar
+                    │   └── maven-metadata-local.xml
+                    └── maven-metadata-local.xml
+
+
+
+

And the stubs contain the following structure:

+
+
+
+
├── META-INF
+│   └── MANIFEST.MF
+└── contracts
+    └── shouldProduceValidPersonData.groovy
+
+
+
+

Let’s consider the following contract:

+
+
+
+
Contract.make {
+    // Human readable description
+    description 'Should produce valid person data'
+    // Label by means of which the output message can be triggered
+    label 'contract-test.person.created.event'
+    // input to the contract
+    input {
+        // the contract will be triggered by a method
+        triggeredBy('createPerson()')
+    }
+    // output message of the contract
+    outputMessage {
+        // destination to which the output message will be sent
+        sentTo 'contract-test.exchange'
+        headers {
+            header('contentType': 'application/json')
+            header('__TypeId__': 'org.springframework.cloud.contract.stubrunner.messaging.amqp.Person')
+        }
+        // the body of the output message
+        body ([
+                id: $(consumer(9), producer(regex("[0-9]+"))),
+                name: "me"
+        ])
+    }
+}
+
+
+
+

and the following Spring configuration:

+
+
+
+
stubrunner:
+  repositoryRoot: classpath:m2repo/repository/
+  ids: org.springframework.cloud.contract.verifier.stubs.amqp:spring-cloud-contract-amqp-test:0.4.0-SNAPSHOT:stubs
+  amqp:
+    enabled: true
+server:
+  port: 0
+
+
+
+
+
Triggering the message
+
+

So to trigger a message using the contract above we’ll use the StubTrigger interface as follows.

+
+
+
+
stubTrigger.trigger("contract-test.person.created.event")
+
+
+
+

The message has the destination contract-test.exchange so the Spring AMQP stub runner integration looks for bindings related to this exchange.

+
+
+
+
@Bean
+public Binding binding() {
+	return BindingBuilder.bind(new Queue("test.queue")).to(new DirectExchange("contract-test.exchange")).with("#");
+}
+
+
+
+

The binding definition binds the queue test.queue. +So the following listener definition is a match and is invoked with the contract message.

+
+
+
+
@Bean
+public SimpleMessageListenerContainer simpleMessageListenerContainer(ConnectionFactory connectionFactory,
+																		MessageListenerAdapter listenerAdapter) {
+	SimpleMessageListenerContainer container = new SimpleMessageListenerContainer();
+	container.setConnectionFactory(connectionFactory);
+	container.setQueueNames("test.queue");
+	container.setMessageListener(listenerAdapter);
+
+	return container;
+}
+
+
+
+

Also, the following annotated listener represents a match and would be invoked.

+
+
+
+
@RabbitListener(bindings = @QueueBinding(
+		value = @Queue(value = "test.queue"),
+		exchange = @Exchange(value = "contract-test.exchange", ignoreDeclarationExceptions = "true")))
+public void handlePerson(Person person) {
+	this.person = person;
+}
+
+
+
+ + + + + +
+ + +The message is directly handed over to the onMessage method of the MessageListener associated with the matching SimpleMessageListenerContainer. +
+
+
+
+
Spring AMQP Test Configuration
+
+

In order to avoid that Spring AMQP is trying to connect to a running broker during our tests we configure a mock ConnectionFactory.

+
+
+

To disable the mocked ConnectionFactory set the property stubrunner.amqp.mockConnection=false

+
+
+
+
stubrunner:
+  amqp:
+    mockConnection: false
+
+
+
+
+
+
+

2.17. Contract DSL

+
+ + + + + +
+ + +Remember that inside the contract file you have to provide the fully qualified name to +the Contract class and the make static import i.e. org.springframework.cloud.spec.Contract.make { …​ }. +You can also provide an import to the Contract class import org.springframework.cloud.spec.Contract and then call + Contract.make { …​ } +
+
+
+

Contract DSL is written in Groovy, but don’t be alarmed if you didn’t use Groovy before. Knowledge of the language is not really needed as our DSL uses only +a tiny subset of it (namely literals, method calls and closures). What’s more the DSL is designed to be programmer-readable without any knowledge of the DSL itself - + it’s statically typed.

+
+
+ + + + + +
+ + +Spring Cloud Contract supports defining multiple contracts in a single file! +
+
+
+

The Contract is present in the spring-cloud-contract-spec module of the Spring Cloud Contract Verifier repository.

+
+
+

Let’s look at full example of a contract definition.

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method 'PUT'
+		url '/api/12'
+		headers {
+			header 'Content-Type': 'application/vnd.org.springframework.cloud.contract.verifier.twitter-places-analyzer.v1+json'
+		}
+		body '''\
+		[{
+			"created_at": "Sat Jul 26 09:38:57 +0000 2014",
+			"id": 492967299297845248,
+			"id_str": "492967299297845248",
+			"text": "Gonna see you at Warsaw",
+			"place":
+			{
+				"attributes":{},
+				"bounding_box":
+				{
+					"coordinates":
+						[[
+							[-77.119759,38.791645],
+							[-76.909393,38.791645],
+							[-76.909393,38.995548],
+							[-77.119759,38.995548]
+						]],
+					"type":"Polygon"
+				},
+				"country":"United States",
+				"country_code":"US",
+				"full_name":"Washington, DC",
+				"id":"01fbe706f872cb32",
+				"name":"Washington",
+				"place_type":"city",
+				"url": "http://api.twitter.com/1/geo/id/01fbe706f872cb32.json"
+			}
+		}]
+	'''
+	}
+	response {
+		status 200
+	}
+}
+
+
+
+

Not all features of the DSL are used in example above. If you didn’t find what you are looking for, please check next paragraphs on this page.

+
+
+
+
+

You can easily compile Contracts to WireMock stubs mapping using standalone maven command: mvn org.springframework.cloud:spring-cloud-contract-maven-plugin:convert.

+
+
+
+
+

2.17.1. Limitations

+
+ + + + + +
+ + +Spring Cloud Contract Verifier doesn’t support XML properly. Please use JSON or help us implement this feature. +
+
+
+ + + + + +
+ + +The support for the verification of size of JSON arrays is experimental. If you want to turn it on please provide +the value of a system property spring.cloud.contract.verifier.assert.size equal to true. By default this feature is set to +false. You can also provide the assertJsonSize property in the plugin configuration. +
+
+
+ + + + + +
+ + +Due to the fact that JSON structure can have any form it’s sometimes impossible to parse it properly when using +the value(consumer(…​), producer(…​)) notation when using that in GString. That’s why we highly recommend using the +Groovy Map notation. +
+
+
+
+

2.17.2. Common Top-Level elements

+
+
Description
+
+

You can add a description to your contract that is nothing else but an arbitrary text. Example:

+
+
+
+
		org.springframework.cloud.contract.spec.Contract.make {
+			description('''
+given:
+	An input
+when:
+	Sth happens
+then:
+	Output
+''')
+		}
+
+
+
+
+
Name
+
+

You can provide a name of your contract. Let’s assume that you’ve provided a name should register a user. +If you do this then the name of the autogenerated test will be equal to validate_should_register_a_user. +Also the name of the stub will be should_register_a_user.json in case of a WireMock stub.

+
+
+ + + + + +
+ + +Please ensure that the name doesn’t contain any characters that will make the generated test + not possible to compile. Also remember that if you provide the same name for multiple contracts then your + autogenerated tests will fail to compile and your generated stubs will override each other. +
+
+
+
+
Ignoring contracts
+
+

If you want to ignore a contract you can either set a value of ignored contracts in the plugin configuration +or just set the ignored property on the contract itself:

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	ignored()
+}
+
+
+
+
+
Passing values from files
+
+

Starting with version 1.2.0 it’s possible to pass values from files. Let’s assume that we have +the following resources in our project.

+
+
+
+
└── src
+    └── test
+        └── resources
+            └── contracts
+                ├── readFromFile.groovy
+                ├── request.json
+                └── response.json
+
+
+
+

And our contract looks like this:

+
+
+
+
import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+	request {
+		method('PUT')
+		headers {
+			contentType(applicationJson())
+		}
+		body(file("request.json"))
+		url("/1")
+	}
+	response {
+		status 200
+		body(file("response.json"))
+		headers {
+			contentType(textPlain())
+		}
+	}
+}
+
+
+
+

and the json files look like this:

+
+
+

request.json

+
+
+
+
{ "status" : "REQUEST" }
+
+
+
+

response.json

+
+
+
+
{ "status" : "RESPONSE" }
+
+
+
+

When test / stub generation takes place then the contents of the file will be +passed to the body of request / response. All thanks to the file(…​) method. +The argument of that method needs to be a file with location relative to the +folder in which the contract lays.

+
+
+
+
+

2.17.3. HTTP Top-Level Elements

+
+

Following methods can be called in the top-level closure of a contract definition. Request and response are mandatory, priority is optional.

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	// Definition of HTTP request part of the contract
+	// (this can be a valid request or invalid depending
+	// on type of contract being specified).
+	request {
+		//...
+	}
+
+	// Definition of HTTP response part of the contract
+	// (a service implementing this contract should respond
+	// with following response after receiving request
+	// specified in "request" part above).
+	response {
+		//...
+	}
+
+	// Contract priority, which can be used for overriding
+	// contracts (1 is highest). Priority is optional.
+	priority 1
+}
+
+
+
+
+

2.17.4. Request

+
+

HTTP protocol requires only method and address to be specified in a request. The same information is mandatory in request definition of the Contract.

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		// HTTP request method (GET/POST/PUT/DELETE).
+		method 'GET'
+
+		// Path component of request URL is specified as follows.
+		urlPath('/users')
+	}
+
+	response {
+		//...
+	}
+}
+
+
+
+

It is possible to specify whole url instead of just path, but urlPath is the recommended way as it makes the tests host-independent.

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method 'GET'
+
+		// Specifying `url` and `urlPath` in one contract is illegal.
+		url('http://localhost:8888/users')
+	}
+
+	response {
+		//...
+	}
+}
+
+
+
+

Request may contain query parameters, which are specified in a closure nested in a call to urlPath or url.

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		//...
+
+		urlPath('/users') {
+
+			// Each parameter is specified in form
+			// `'paramName' : paramValue` where parameter value
+			// may be a simple literal or one of matcher functions,
+			// all of which are used in this example.
+			queryParameters {
+
+				// If a simple literal is used as value
+				// default matcher function is used (equalTo)
+				parameter 'limit': 100
+
+				// `equalTo` function simply compares passed value
+				// using identity operator (==).
+				parameter 'filter': equalTo("email")
+
+				// `containing` function matches strings
+				// that contains passed substring.
+				parameter 'gender': value(consumer(containing("[mf]")), producer('mf'))
+
+				// `matching` function tests parameter
+				// against passed regular expression.
+				parameter 'offset': value(consumer(matching("[0-9]+")), producer(123))
+
+				// `notMatching` functions tests if parameter
+				// does not match passed regular expression.
+				parameter 'loginStartsWith': value(consumer(notMatching(".{0,2}")), producer(3))
+			}
+		}
+
+		//...
+	}
+
+	response {
+		//...
+	}
+}
+
+
+
+

It may contain additional request headers…​

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		//...
+
+		// Each header is added in form `'Header-Name' : 'Header-Value'`.
+		// there are also some helper methods
+		headers {
+			header 'key': 'value'
+			contentType(applicationJson())
+		}
+
+		//...
+	}
+
+	response {
+		//...
+	}
+}
+
+
+
+

…​and a request body.

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		//...
+
+		// Currently only JSON format of request body is supported.
+		// Format will be determined from a header or body's content.
+		body '''{ "login" : "john", "name": "John The Contract" }'''
+	}
+
+	response {
+		//...
+	}
+}
+
+
+
+

Request may contain multipart elements. Just call the multipart() method.

+
+
+
+
org.springframework.cloud.contract.spec.Contract contractDsl = org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method "PUT"
+		url "/multipart"
+		headers {
+			contentType('multipart/form-data;boundary=AaB03x')
+		}
+		multipart(
+				// key (parameter name), value (parameter value) pair
+				formParameter: $(c(regex('".+"')), p('"formParameterValue"')),
+				someBooleanParameter: $(c(regex(anyBoolean())), p('true')),
+				// a named parameter (e.g. with `file` name) that represents file with
+				// `name` and `content`. You can also call `named("fileName", "fileContent")`
+				file: named(
+						// name of the file
+						name: $(c(regex(nonEmpty())), p('filename.csv')),
+						// content of the file
+						content: $(c(regex(nonEmpty())), p('file content')))
+		)
+	}
+	response {
+		status 200
+	}
+}
+
+
+
+

In this example we defined parameters either directly by using the map notation, +where the value can be a dynamic property (e.g. formParameter: $(consumer(…​), producer(…​))) + or by using the named(…​) method that allows you to set a named parameter. + A named parameter can set a name and content. You can call it either via + a method with 2 arguments: e.g. named("fileName", "fileContent") or + via a map notation named(name: "fileName", content: "fileContent").

+
+
+

From this contract the generated test will look more or less like this:

+
+
+
+
// given:
+ MockMvcRequestSpecification request = given()
+   .header("Content-Type", "multipart/form-data;boundary=AaB03x")
+   .param("formParameter", "\"formParameterValue\"")
+   .param("someBooleanParameter", "true")
+   .multiPart("file", "filename.csv", "file content".getBytes());
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .put("/multipart");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);
+
+
+
+

The WireMock stub will look more or less like this:

+
+
+
+
			'''
+{
+  "request" : {
+	"url" : "/multipart",
+	"method" : "PUT",
+	"headers" : {
+	  "Content-Type" : {
+		"matches" : "multipart/form-data;boundary=AaB03x.*"
+	  }
+	},
+	"bodyPatterns" : [ {
+		"matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"formParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n\\".+\\"\\r\\n--\\\\1.*"
+  		}, {
+    			"matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"someBooleanParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n(true|false)\\r\\n--\\\\1.*"
+  		}, {
+	  "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"file\\"; filename=\\".+\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n.+\\r\\n--\\\\1.*"
+	} ]
+  },
+  "response" : {
+	"status" : 200,
+	"transformers" : [ "response-template" ]
+  }
+}
+	'''
+
+
+
+
+

2.17.5. Response

+
+

Minimal response must contain HTTP status code.

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		//...
+	}
+	response {
+		// Status code sent by the server
+		// in response to request specified above.
+		status 200
+	}
+}
+
+
+
+

Besides status response may contain headers and body, which are specified the same way as in the request (see previous paragraph).

+
+
+
+

2.17.6. Dynamic properties

+
+

The contract can contain some dynamic properties - timestamps / ids etc. You don’t want to enforce the consumers to stub their +clocks to always return the same value of time so that it gets matched by the stub. That’s why we allow you to provide the dynamic +parts in your contracts in two ways. One is to pass them directly in the +body and one to set them in a separate section called testMatchers and stubMatchers.

+
+
+
Dynamic properties inside the body
+
+

You can set the properties inside the body either via the value method

+
+
+
+
value(consumer(...), producer(...))
+value(c(...), p(...))
+value(stub(...), test(...))
+value(client(...), server(...))
+
+
+
+

or if you’re using the Groovy map notation for body you can use the $() method

+
+
+
+
$(consumer(...), producer(...))
+$(c(...), p(...))
+$(stub(...), test(...))
+$(client(...), server(...))
+
+
+
+

All of the aforementioned approaches are equal. That means that stub and client methods are aliases over the consumer +method. Let’s take a closer look at what we can do with those values in the subsequent sections.

+
+
+
Regular expressions
+
+

You can use regular expressions to write your requests in Contract DSL. It is particularly useful when you want to indicate that a given response +should be provided for requests that follow a given pattern. Also, you can use it when you need to use patterns and not exact values both +for your test and your server side tests.

+
+
+

Please see the example below:

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method('GET')
+		url $(consumer(~/\/[0-9]{2}/), producer('/12'))
+	}
+	response {
+		status 200
+		body(
+				id: $(anyNumber()),
+				surname: $(
+						consumer('Kowalsky'),
+						producer(regex('[a-zA-Z]+'))
+				),
+				name: 'Jan',
+				created: $(consumer('2014-02-02 12:23:43'), producer(execute('currentDate(it)'))),
+				correlationId: value(consumer('5d1f9fef-e0dc-4f3d-a7e4-72d2220dd827'),
+						producer(regex('[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}'))
+				)
+		)
+		headers {
+			header 'Content-Type': 'text/plain'
+		}
+	}
+}
+
+
+
+

You can also provide only one side of the communication using a regular expression. If you do that then automatically we’ll +provide the generated string that matches the provided regular expression. For example:

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method 'PUT'
+		url value(consumer(regex('/foo/[0-9]{5}')))
+		body([
+			requestElement: $(consumer(regex('[0-9]{5}')))
+		])
+		headers {
+			header('header', $(consumer(regex('application\\/vnd\\.fraud\\.v1\\+json;.*'))))
+		}
+	}
+	response {
+		status 200
+		body([
+			responseElement: $(producer(regex('[0-9]{7}')))
+		])
+		headers {
+			contentType("application/vnd.fraud.v1+json")
+		}
+	}
+}
+
+
+
+

In this example for request and response the opposite side of the communication will have the respective data generated.

+
+
+

Spring Cloud Contract comes with a series of predefined regular expressions that you can use in your contracts.

+
+
+
+
protected static final Pattern TRUE_OR_FALSE = Pattern.compile(/(true|false)/)
+protected static final Pattern ONLY_ALPHA_UNICODE = Pattern.compile(/[\p{L}]*/)
+protected static final Pattern NUMBER = Pattern.compile('-?\\d*(\\.\\d+)?')
+protected static final Pattern IP_ADDRESS = Pattern.compile('([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])')
+protected static final Pattern HOSTNAME_PATTERN = Pattern.compile('((http[s]?|ftp):/)/?([^:/\\s]+)(:[0-9]{1,5})?')
+protected static final Pattern EMAIL = Pattern.compile('[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,6}')
+protected static final Pattern URL = UrlHelper.URL
+protected static final Pattern UUID = Pattern.compile('[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}')
+protected static final Pattern ANY_DATE = Pattern.compile('(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])')
+protected static final Pattern ANY_DATE_TIME = Pattern.compile('([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])')
+protected static final Pattern ANY_TIME = Pattern.compile('(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])')
+protected static final Pattern NON_EMPTY = Pattern.compile(/.+/)
+protected static final Pattern NON_BLANK = Pattern.compile(/.*(\S+|\R).*|!^\R*$/)
+protected static final Pattern ISO8601_WITH_OFFSET = Pattern.compile(/([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])(\.\d{3})?(Z|[+-][01]\d:[0-5]\d)/)
+
+protected static Pattern anyOf(String... values){
+	return Pattern.compile(values.collect({"^$it\$"}).join("|"))
+}
+
+String onlyAlphaUnicode() {
+	return ONLY_ALPHA_UNICODE.pattern()
+}
+
+String number() {
+	return NUMBER.pattern()
+}
+
+String anyBoolean() {
+	return TRUE_OR_FALSE.pattern()
+}
+
+String ipAddress() {
+	return IP_ADDRESS.pattern()
+}
+
+String hostname() {
+	return HOSTNAME_PATTERN.pattern()
+}
+
+String email() {
+	return EMAIL.pattern()
+}
+
+String url() {
+	return URL.pattern()
+}
+
+String uuid(){
+	return UUID.pattern()
+}
+
+String isoDate() {
+	return ANY_DATE.pattern()
+}
+
+String isoDateTime() {
+	return ANY_DATE_TIME.pattern()
+}
+
+String isoTime() {
+	return ANY_TIME.pattern()
+}
+
+String iso8601WithOffset() {
+	return ISO8601_WITH_OFFSET.pattern()
+}
+
+String nonEmpty() {
+	return NON_EMPTY.pattern()
+}
+
+String nonBlank() {
+	return NON_BLANK.pattern()
+}
+
+
+
+

so in your contract you can use it like this

+
+
+
+
Contract dslWithOptionalsInString = Contract.make {
+	priority 1
+	request {
+		method POST()
+		url '/users/password'
+		headers {
+			contentType(applicationJson())
+		}
+		body(
+				email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
+				callback_url: $(consumer(regex(hostname())), producer('http://partners.com'))
+		)
+	}
+	response {
+		status 404
+		headers {
+			contentType(applicationJson())
+		}
+		body(
+				code: value(consumer("123123"), producer(optional("123123"))),
+				message: "User not found by email = [${value(producer(regex(email())), consumer('not.existing@user.com'))}]"
+		)
+	}
+}
+
+
+
+
+
Passing optional parameters
+
+

It is possible to provide optional parameters in your contract. It’s only possible to have optional parameter for the:

+
+
+
    +
  • +

    STUB side of the Request

    +
    • +
  • +

    TEST side of the Response

    +
    • +
+
+
+

Example:

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	priority 1
+	request {
+		method 'POST'
+		url '/users/password'
+		headers {
+			contentType(applicationJson())
+		}
+		body(
+				email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
+				callback_url: $(consumer(regex(hostname())), producer('http://partners.com'))
+		)
+	}
+	response {
+		status 404
+		headers {
+			header 'Content-Type': 'application/json'
+		}
+		body(
+				code: value(consumer("123123"), producer(optional("123123")))
+		)
+	}
+}
+
+
+
+

By wrapping a part of the body with the optional() method you are in fact creating a regular expression that should be present 0 or more times.

+
+
+

That way for the example above the following test would be generated if you pick Spock:

+
+
+
+
"""
+ given:
+  def request = given()
+    .header("Content-Type", "application/json")
+    .body('''{"email":"abc@abc.com","callback_url":"http://partners.com"}''')
+
+ when:
+  def response = given().spec(request)
+    .post("/users/password")
+
+ then:
+  response.statusCode == 404
+  response.header('Content-Type')  == 'application/json'
+ and:
+  DocumentContext parsedJson = JsonPath.parse(response.body.asString())
+  assertThatJson(parsedJson).field("['code']").matches("(123123)?")
+"""
+
+
+
+

and the following stub:

+
+
+
+
'''
+{
+  "request" : {
+    "url" : "/users/password",
+    "method" : "POST",
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['email'] =~ /([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\\\.[a-zA-Z]{2,6})?/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['callback_url'] =~ /((http[s]?|ftp):\\\\/)\\\\/?([^:\\\\/\\\\s]+)(:[0-9]{1,5})?/)]"
+    } ],
+    "headers" : {
+      "Content-Type" : {
+        "equalTo" : "application/json"
+      }
+    }
+  },
+  "response" : {
+    "status" : 404,
+    "body" : "{\\"code\\":\\"123123\\",\\"message\\":\\"User not found by email == [not.existing@user.com]\\"}",
+    "headers" : {
+      "Content-Type" : "application/json"
+    }
+  },
+  "priority" : 1
+}
+'''
+
+
+
+
+
Executing custom methods on server side
+
+

It is also possible to define a method call to be executed on the server side during the test. Such a method can be added to the class defined as "baseClassForTests" +in the configuration. Example:

+
+
+

Contract

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method 'PUT'
+		url $(consumer(regex('^/api/[0-9]{2}$')), producer('/api/12'))
+		headers {
+			header 'Content-Type': 'application/json'
+		}
+		body '''\
+				[{
+					"text": "Gonna see you at Warsaw"
+				}]
+			'''
+	}
+	response {
+		body (
+				path: $(consumer('/api/12'), producer(regex('^/api/[0-9]{2}$'))),
+				correlationId: $(consumer('1223456'), producer(execute('isProperCorrelationId($it)')))
+		)
+		status 200
+	}
+}
+
+
+
+

Base class

+
+
+
+
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
+	}
+
+}
+
+
+
+ + + + + +
+ + +You can’t use both a String and execute to perform concatenation. E.g. calling +header('Authorization', 'Bearer ' + execute('authToken()')) will lead to improper results. +To make this work just call header('Authorization', execute('authToken()')) and ensure that +the authToken() method returns everything that you need. +
+
+
+

The type of the object read from the JSON can be one of the followings depending on the +JSON path:

+
+
+
    +
  • +

    String if you point to a String value in a JSON

    +
    • +
  • +

    JSONArray if you point to a List in a JSON

    +
    • +
  • +

    Map if you point to a Map in a JSON

    +
    • +
  • +

    proper Number if you point to Integer, Double etc. in a JSON

    +
    • +
  • +

    Boolean if you point to a Boolean in a JSON

    +
    • +
+
+
+

In the request part of the contract you can specify that the body should be +taken from a method.

+
+
+ + + + + +
+ + +You have to provide both the consumer and the producer side +and the execute part can be applied for the whole body. Not for parts of it! +
+
+
+

Example:

+
+
+
+
Contract contractDsl = Contract.make {
+	request {
+		method 'GET'
+		url '/something'
+		body(
+				$(c("foo"), p(execute("hashCode()")))
+		)
+	}
+	response {
+		status 200
+	}
+}
+
+
+
+

This will result in calling the hashCode() method in the request body. +It would more or less like this:

+
+
+
+
// given:
+ MockMvcRequestSpecification request = given()
+   .body(hashCode());
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .get("/something");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);
+
+
+
+
+
+
Referencing request from response
+
+

The best situation is to provide fixed values but sometimes you need to reference a request in your response. +In order to do this you can profit from the fromRequest() method that allows you to reference a bunch +of elements from the HTTP request. You can use the following options:

+
+
+
    +
  • +

    fromRequest().url() - return the request URL

    +
    • +
  • +

    fromRequest().query(String key) - return the first query parameter with a given name

    +
    • +
  • +

    fromRequest().query(String key, int index) - return the nth query parameter with a given name

    +
    • +
  • +

    fromRequest().header(String key) - return the first header with a given name

    +
    • +
  • +

    fromRequest().header(String key, int index) - return the nth header with a given name

    +
    • +
  • +

    fromRequest().body() - return the full request body

    +
    • +
  • +

    fromRequest().body(String jsonPath) - return the element from the request that matches the JSON Path

    +
    • +
+
+
+

Let’s take a look at the following contract

+
+
+
+
Contract contractDsl = Contract.make {
+	request {
+		method 'GET'
+		url('/api/v1/xxxx') {
+			queryParameters {
+				parameter("foo", "bar")
+				parameter("foo", "bar2")
+			}
+		}
+		headers {
+			header(authorization(), "secret")
+			header(authorization(), "secret2")
+		}
+		body(foo: "bar", baz: 5)
+	}
+	response {
+		status 200
+		headers {
+			header(authorization(), "foo ${fromRequest().header(authorization())} bar")
+		}
+		body(
+				url: fromRequest().url(),
+				param: fromRequest().query("foo"),
+				paramIndex: fromRequest().query("foo", 1),
+				authorization: fromRequest().header("Authorization"),
+				authorization2: fromRequest().header("Authorization", 1),
+				fullBody: fromRequest().body(),
+				responseFoo: fromRequest().body('$.foo'),
+				responseBaz: fromRequest().body('$.baz'),
+				responseBaz2: "Bla bla ${fromRequest().body('$.foo')} bla bla"
+		)
+	}
+}
+
+
+
+

Running a JUnit test generation will lead in creation of a test looking more or less like this

+
+
+
+
// given:
+ MockMvcRequestSpecification request = given()
+   .header("Authorization", "secret")
+   .header("Authorization", "secret2")
+   .body("{\"foo\":\"bar\",\"baz\":5}");
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .queryParam("foo","bar")
+   .queryParam("foo","bar2")
+   .get("/api/v1/xxxx");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);
+ assertThat(response.header("Authorization")).isEqualTo("foo secret bar");
+// and:
+ DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+ assertThatJson(parsedJson).field("url").isEqualTo("/api/v1/xxxx");
+ assertThatJson(parsedJson).field("fullBody").isEqualTo("{\"foo\":\"bar\",\"baz\":5}");
+ assertThatJson(parsedJson).field("paramIndex").isEqualTo("bar2");
+ assertThatJson(parsedJson).field("responseFoo").isEqualTo("bar");
+ assertThatJson(parsedJson).field("authorization2").isEqualTo("secret2");
+ assertThatJson(parsedJson).field("responseBaz").isEqualTo(5);
+ assertThatJson(parsedJson).field("responseBaz2").isEqualTo("Bla bla bar bla bla");
+ assertThatJson(parsedJson).field("param").isEqualTo("bar");
+ assertThatJson(parsedJson).field("authorization").isEqualTo("secret");
+
+
+
+

As you can see elements from the request have been properly referenced in the response.

+
+
+

The generated WireMock stub will look more or less like this:

+
+
+
+
{
+  "request" : {
+    "urlPath" : "/api/v1/xxxx",
+    "method" : "POST",
+    "headers" : {
+      "Authorization" : {
+        "equalTo" : "secret2"
+      }
+    },
+    "queryParameters" : {
+      "foo" : {
+        "equalTo" : "bar2"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.baz == 5)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.foo == 'bar')]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\"url\":\"{{{request.url}}}\",\"param\":\"{{{request.query.foo.[0]}}}\",\"paramIndex\":\"{{{request.query.foo.[1]}}}\",\"authorization\":\"{{{request.headers.Authorization.[0]}}}\",\"authorization2\":\"{{{request.headers.Authorization.[1]}}}\",\"fullBody\":\"{{{escapejsonbody}}}\",\"responseFoo\":\"{{{jsonpath this '$.foo'}}}\",\"responseBaz\":{{{jsonpath this '$.baz'}}} ,\"responseBaz2\":\"Bla bla {{{jsonpath this '$.foo'}}} bla bla\"}",
+    "headers" : {
+      "Authorization" : "{{{request.headers.Authorization.[0]}}}"
+    },
+    "transformers" : [ "response-template" ]
+  }
+}
+
+
+
+

So sending a request as the one presented in the request part of the contract will lead in sending the following +response body

+
+
+
+
{
+  "url" : "/api/v1/xxxx?foo=bar&foo=bar2",
+  "param" : "bar",
+  "paramIndex" : "bar2",
+  "authorization" : "secret",
+  "authorization2" : "secret2",
+  "fullBody" : "{\"foo\":\"bar\",\"baz\":5}",
+  "responseFoo" : "bar",
+  "responseBaz" : 5,
+  "responseBaz2" : "Bla bla bar bla bla"
+}
+
+
+
+ + + + + +
+ + +This feature will work only with WireMock having version greater or equal to 2.5.1. We’re using WireMock’s +response-template response transformer. It’s using Handlebars to convert the Mustache {{{ }}} templates into +proper values. Additionally we’re registering 2 helper functions. escapejsonbody - that escapes the request +body in a format that can be embedded in a JSON. Another is jsonpath that for a given parameter knows how to +find an object in the request body. +
+
+
+
+
Dynamic properties in matchers sections
+
+

If you’ve been working with Pact this might seem familiar. Quite a few users +are used to having a separation between the body and setting dynamic parts of your contract.

+
+
+

That’s why you can profit from two separate sections. One is called stubMatchers where you can +define the dynamic values that should end up in a stub. You can set it in the request or inputMessage +part of your contract. The other is called testMatchers which is present in the response or +outputMessage side of the contract.

+
+
+

Currently we support only JSON Path based matchers with the following matching possibilities. +For stubMatchers:

+
+
+
    +
  • +

    byEquality() - the value taken from the response via the provided JSON Path needs +to be equal to the provided value in the contract

    +
    • +
  • +

    byRegex(…​) - the value taken from the response via the provided JSON Path needs +to match the regex

    +
    • +
  • +

    byDate() - the value taken from the response via the provided JSON Path needs to +match the regex for ISO Date

    +
    • +
  • +

    byTimestamp() - the value taken from the response via the provided JSON Path needs +to match the regex for ISO DateTime

    +
    • +
  • +

    byTime() - the value taken from the response via the provided JSON Path needs to +match the regex for ISO Time

    +
    • +
+
+
+

For testMatchers:

+
+
+
    +
  • +

    byEquality() - the value taken from the response via the provided JSON Path needs +to be equal to the provided value in the contract

    +
    • +
  • +

    byRegex(…​) - the value taken from the response via the provided JSON Path needs +to match the regex

    +
    • +
  • +

    byDate() - the value taken from the response via the provided JSON Path needs to +match the regex for ISO Date

    +
    • +
  • +

    byTimestamp() - the value taken from the response via the provided JSON Path needs +to match the regex for ISO DateTime

    +
    • +
  • +

    byTime() - the value taken from the response via the provided JSON Path needs to +match the regex for ISO Time

    +
    • +
  • +

    byType() - the value taken from the response via the provided JSON Path needs to +be of the same type as the type defined in the body of the response in the contract. +byType can take a closure where you can set minOccurrence and maxOccurrence. +That way you can assert on the size of the collection.

    +
    • +
  • +

    byCommand(…​) - the value taken from the response via the provided JSON Path will be +passed as an input to the custom method that you’re providing. E.g. byCommand('foo($it)') +will result in calling a foo method to which the value matching the JSON Path will get + passed.

    +
    +
      +
    • +

      The type of the object read from the JSON can be one of the followings depending on the +JSON path:

      +
      +
        +
      • +

        String if you point to a String value in a JSON

        +
        • +
      • +

        JSONArray if you point to a List in a JSON

        +
        • +
      • +

        Map if you point to a Map in a JSON

        +
        • +
      • +

        proper Number if you point to Integer, Double etc. in a JSON

        +
        • +
      • +

        Boolean if you point to a Boolean in a JSON

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

Let’s take a look at the following example:

+
+
+
+
Contract contractDsl = Contract.make {
+	request {
+		method 'GET'
+		urlPath '/get'
+		body([
+				duck: 123,
+				alpha: "abc",
+				number: 123,
+				aBoolean: true,
+				date: "2017-01-01",
+				dateTime: "2017-01-01T01:23:45",
+				time: "01:02:34",
+				valueWithoutAMatcher: "foo",
+				valueWithTypeMatch: "string",
+				key: [
+						'complex.key' : 'foo'
+				]
+		])
+		stubMatchers {
+			jsonPath('$.duck', byRegex("[0-9]{3}"))
+			jsonPath('$.duck', byEquality())
+			jsonPath('$.alpha', byRegex(onlyAlphaUnicode()))
+			jsonPath('$.alpha', byEquality())
+			jsonPath('$.number', byRegex(number()))
+			jsonPath('$.aBoolean', byRegex(anyBoolean()))
+			jsonPath('$.date', byDate())
+			jsonPath('$.dateTime', byTimestamp())
+			jsonPath('$.time', byTime())
+			jsonPath("\$.['key'].['complex.key']", byEquality())
+		}
+		headers {
+			contentType(applicationJson())
+		}
+	}
+	response {
+		status 200
+		body([
+				duck: 123,
+				alpha: "abc",
+				number: 123,
+				aBoolean: true,
+				date: "2017-01-01",
+				dateTime: "2017-01-01T01:23:45",
+				time: "01:02:34",
+				valueWithoutAMatcher: "foo",
+				valueWithTypeMatch: "string",
+				valueWithMin: [
+					1,2,3
+				],
+				valueWithMax: [
+					1,2,3
+				],
+				valueWithMinMax: [
+					1,2,3
+				],
+				valueWithMinEmpty: [],
+				valueWithMaxEmpty: [],
+				key: [
+				        'complex.key' : 'foo'
+				]
+		])
+		testMatchers {
+			// asserts the jsonpath value against manual regex
+			jsonPath('$.duck', byRegex("[0-9]{3}"))
+			// asserts the jsonpath value against the provided value
+			jsonPath('$.duck', byEquality())
+			// asserts the jsonpath value against some default regex
+			jsonPath('$.alpha', byRegex(onlyAlphaUnicode()))
+			jsonPath('$.alpha', byEquality())
+			jsonPath('$.number', byRegex(number()))
+			jsonPath('$.aBoolean', byRegex(anyBoolean()))
+			// asserts vs inbuilt time related regex
+			jsonPath('$.date', byDate())
+			jsonPath('$.dateTime', byTimestamp())
+			jsonPath('$.time', byTime())
+			// asserts that the resulting type is the same as in response body
+			jsonPath('$.valueWithTypeMatch', byType())
+			jsonPath('$.valueWithMin', byType {
+				// results in verification of size of array (min 1)
+				minOccurrence(1)
+			})
+			jsonPath('$.valueWithMax', byType {
+				// results in verification of size of array (max 3)
+				maxOccurrence(3)
+			})
+			jsonPath('$.valueWithMinMax', byType {
+				// results in verification of size of array (min 1 & max 3)
+				minOccurrence(1)
+				maxOccurrence(3)
+			})
+			jsonPath('$.valueWithMinEmpty', byType {
+				// results in verification of size of array (min 0)
+				minOccurrence(0)
+			})
+			jsonPath('$.valueWithMaxEmpty', byType {
+				// results in verification of size of array (max 0)
+				maxOccurrence(0)
+			})
+			// will execute a method `assertThatValueIsANumber`
+			jsonPath('$.duck', byCommand('assertThatValueIsANumber($it)'))
+			jsonPath("\$.['key'].['complex.key']", byEquality())
+		}
+		headers {
+			contentType(applicationJson())
+		}
+	}
+}
+
+
+
+

In this example we’re providing the dynamic portions of the contract in the matchers sections. + For the request part you can see that for all fields but valueWithoutAMatcher we’re setting + explicitly the values of regular expressions we’d like the stub to contain. For the valueWithoutAMatcher + the verification will take place in the same way as without the usage of matchers - the test + will perform an equality check in this case.

+
+
+

For the response side in the testMatchers section we’re defining all the dynamic parts + in a similar manner. The only difference is that we have the byType matchers too. In that + case we’re checking 4 fields in the way that we’re verifying whether the response from the test + has a value whose JSON path matching the given field is of the same type as the one defined in the response body and:

+
+
+
    +
  • +

    for $.valueWithTypeMatch - we’re just checking the whether the type is the same

    +
    • +
  • +

    for $.valueWithMin - we’re checking the type and assert if the size is greater or equal to the min occurrence

    +
    • +
  • +

    for $.valueWithMax - we’re checking the type and assert if the size is smaller or equal to the max occurrence

    +
    • +
  • +

    for $.valueWithMinMax - we’re checking the type and assert if the size is between the min and max occurrence

    +
    • +
+
+
+

The resulting test would look more or less like this (note that we’re separating the autogenerated +assertions and the one from matchers with an and section):

+
+
+
+
// given:
+ MockMvcRequestSpecification request = given()
+   .header("Content-Type", "application/json")
+   .body("{\"duck\":123,\"alpha\":\"abc\",\"number\":123,\"aBoolean\":true,\"date\":\"2017-01-01\",\"dateTime\":\"2017-01-01T01:23:45\",\"time\":\"01:02:34\",\"valueWithoutAMatcher\":\"foo\",\"valueWithTypeMatch\":\"string\"}");
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .get("/get");
+
+// 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("valueWithoutAMatcher").isEqualTo("foo");
+// and:
+ assertThat(parsedJson.read("$.duck", String.class)).matches("[0-9]{3}");
+ assertThat(parsedJson.read("$.duck", Integer.class)).isEqualTo(123);
+ assertThat(parsedJson.read("$.alpha", String.class)).matches("[\\p{L}]*");
+ assertThat(parsedJson.read("$.alpha", String.class)).isEqualTo("abc");
+ assertThat(parsedJson.read("$.number", String.class)).matches("-?\\d*(\\.\\d+)?");
+ assertThat(parsedJson.read("$.aBoolean", String.class)).matches("(true|false)");
+ assertThat(parsedJson.read("$.date", String.class)).matches("(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])");
+ assertThat(parsedJson.read("$.dateTime", String.class)).matches("([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+ assertThat(parsedJson.read("$.time", String.class)).matches("(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+ assertThat((Object) parsedJson.read("$.valueWithTypeMatch")).isInstanceOf(java.lang.String.class);
+ assertThat((Object) parsedJson.read("$.valueWithMin")).isInstanceOf(java.util.List.class);
+ assertThat(parsedJson.read("$.valueWithMin", java.util.Collection.class)).hasSizeGreaterThanOrEqualTo(1);
+ assertThat((Object) parsedJson.read("$.valueWithMax")).isInstanceOf(java.util.List.class);
+ assertThat(parsedJson.read("$.valueWithMax", java.util.Collection.class)).hasSizeLessThanOrEqualTo(3);
+ assertThat((Object) parsedJson.read("$.valueWithMinMax")).isInstanceOf(java.util.List.class);
+ assertThat(parsedJson.read("$.valueWithMinMax", java.util.Collection.class)).hasSizeBetween(1, 3);
+ assertThat((Object) parsedJson.read("$.valueWithMinEmpty")).isInstanceOf(java.util.List.class);
+ assertThat(parsedJson.read("$.valueWithMinEmpty", java.util.Collection.class)).hasSizeGreaterThanOrEqualTo(0);
+ assertThat((Object) parsedJson.read("$.valueWithMaxEmpty")).isInstanceOf(java.util.List.class);
+ assertThat(parsedJson.read("$.valueWithMaxEmpty", java.util.Collection.class)).hasSizeLessThanOrEqualTo(0);
+ assertThatValueIsANumber(parsedJson.read("$.duck"));
+
+
+
+

and the WireMock stub like this:

+
+
+
+
				'''
+{
+  "request" : {
+    "urlPath" : "/get",
+    "method" : "POST",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "application/json.*"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['valueWithoutAMatcher'] == 'foo')]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['valueWithTypeMatch'] == 'string')]"
+    }, {
+      "matchesJsonPath" : "$.['list'].['some'].['nested'][?(@.['anothervalue'] == 4)]"
+    }, {
+      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['anothervalue'] == 4)]"
+    }, {
+      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['json'] == 'with value')]"
+    }, {
+      "matchesJsonPath" : "$[?(@.duck =~ /([0-9]{3})/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.duck == 123)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.alpha =~ /([\\\\p{L}]*)/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.alpha == 'abc')]"
+    }, {
+      "matchesJsonPath" : "$[?(@.number =~ /(-?\\\\d*(\\\\.\\\\d+)?)/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.aBoolean =~ /((true|false))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.date =~ /((\\\\d\\\\d\\\\d\\\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01]))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.dateTime =~ /(([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.time =~ /((2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
+    }, {
+      "matchesJsonPath" : "$.list.some.nested[?(@.json =~ /(.*)/)]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\\"duck\\":123,\\"alpha\\":\\"abc\\",\\"number\\":123,\\"aBoolean\\":true,\\"date\\":\\"2017-01-01\\",\\"dateTime\\":\\"2017-01-01T01:23:45\\",\\"time\\":\\"01:02:34\\",\\"valueWithoutAMatcher\\":\\"foo\\",\\"valueWithTypeMatch\\":\\"string\\",\\"valueWithMin\\":[1,2,3],\\"valueWithMax\\":[1,2,3],\\"valueWithMinMax\\":[1,2,3]}",
+    "headers" : {
+      "Content-Type" : "application/json"
+    }
+  }
+}
+'''
+
+
+
+ + + + + +
+ + +If you use a matcher then the part of the request / response that the matcher is addressing +via the JSON Path will get removed from assertion. In case of verifying a collection you have to create +matchers for all elements of the collection. +
+
+
+

Let’s look at the following example:

+
+
+
+
Contract.make {
+    request {
+        method 'GET'
+        url("/foo")
+    }
+    response {
+        status 200
+        body(events: [[
+                                 operation          : 'EXPORT',
+                                 eventId            : '16f1ed75-0bcc-4f0d-a04d-3121798faf99',
+                                 status             : 'OK'
+                         ], [
+                                 operation          : 'INPUT_PROCESSING',
+                                 eventId            : '3bb4ac82-6652-462f-b6d1-75e424a0024a',
+                                 status             : 'OK'
+                         ]
+                ]
+        )
+        testMatchers {
+            jsonPath('$.events[0].operation', byRegex('.+'))
+            jsonPath('$.events[0].eventId', byRegex('^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$'))
+            jsonPath('$.events[0].status', byRegex('.+'))
+        }
+    }
+}
+
+
+
+

This will lead in creating the following test (showing just the assertion section)

+
+
+
+
and:
+	DocumentContext parsedJson = JsonPath.parse(response.body.asString())
+	assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("16f1ed75-0bcc-4f0d-a04d-3121798faf99")
+	assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("EXPORT")
+	assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("INPUT_PROCESSING")
+	assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("3bb4ac82-6652-462f-b6d1-75e424a0024a")
+	assertThatJson(parsedJson).array("['events']").contains("['status']").isEqualTo("OK")
+and:
+	assertThat(parsedJson.read("\$.events[0].operation", String.class)).matches(".+")
+	assertThat(parsedJson.read("\$.events[0].eventId", String.class)).matches("^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})\$")
+	assertThat(parsedJson.read("\$.events[0].status", String.class)).matches(".+")
+
+
+
+

As you can see the assertion is malformed. That’s because only the first element of the array got asserted. +In order to fix this it’s best to apply the assertion to the whole $.events collection and assert it +via the byCommand(…​) method.

+
+
+
+
+

2.17.7. JAX-RS support

+
+

We support JAX-RS 2 Client API. Base class needs to define protected WebTarget webTarget and server initialization, right now the only option how to test JAX-RS API is to start a web server.

+
+
+

Request with a body needs to have a content type set otherwise application/octet-stream is going to be used.

+
+
+

In order to use JAX-RS mode, use the following settings:

+
+
+
+
testMode === 'JAXRSCLIENT'
+
+
+
+

Example of a test API generated:

+
+
+
+
'''
+ // 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()
+    .method("GET");
+
+  String responseAsString = response.readEntity(String.class);
+
+ // then:
+  assertThat(response.getStatus()).isEqualTo(200);
+ // and:
+  DocumentContext parsedJson = JsonPath.parse(responseAsString);
+  assertThatJson(parsedJson).field("['property1']").isEqualTo("a");
+'''
+
+
+
+
+

2.17.8. Async support

+
+

If you’re using asynchronous communication on the server side (your controllers are returning +Callable, DeferredResult etc. then inside your contract you have to provide in the response +section a async() method. Example:

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method GET()
+        url '/get'
+    }
+    response {
+        status 200
+        body 'Passed'
+        async()
+    }
+}
+
+
+
+
+

2.17.9. Working with Context Paths

+
+

Spring Cloud Contract supports context paths.

+
+
+ + + + + +
+ + +The only thing that changes in order to fully support context paths is the switch +on the PRODUCER side. The autogenerated tests need to be using the EXPLICIT mode. +
+
+
+

The consumer side remains untouched, in order for the generated test to pass you have to switch the EXPLICIT mode.

+
+
+
Maven
+
+
<plugin>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-contract-maven-plugin</artifactId>
+    <version>${spring-cloud-contract.version}</version>
+    <extensions>true</extensions>
+    <configuration>
+        <testMode>EXPLICIT</testMode>
+    </configuration>
+</plugin>
+
+
+
+
Gradle
+
+
contracts {
+		testMode = 'EXPLICIT'
+}
+
+
+
+

That way you’ll generate a test that DOES NOT use MockMvc. It means that you’re generating +real requests and you need to setup your generated test’s base class to work on a real socket.

+
+
+

Let’s imagine the following contract:

+
+
+
+
org.springframework.cloud.contract.spec.Contract.make {
+	request {
+		method 'GET'
+		url '/my-context-path/url'
+	}
+	response {
+		status 200
+	}
+}
+
+
+
+

Here is an example of how to set up a base class and Rest Assured for everything to work correctly.

+
+
+
+
import io.restassured.RestAssured;
+import org.junit.Before;
+import org.springframework.boot.context.embedded.LocalServerPort;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest(classes = ContextPathTestingBaseClass.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+class ContextPathTestingBaseClass {
+
+	@LocalServerPort int port;
+
+	@Before
+	public void setup() {
+		RestAssured.baseURI = "http://localhost";
+		RestAssured.port = this.port;
+	}
+}
+
+
+
+

That way all:

+
+
+
    +
  • +

    all your requests in the autogenerated tests will be sent to the real endpoint with your context path included (e.g. /my-context-path/url)

    +
    • +
  • +

    your contracts reflect that you have a context path, thus your generated stubs will also +have that information (e.g. in the stubs you’ll see that you have too call /my-context-path/url)

    +
    • +
+
+
+
+

2.17.10. Messaging Top-Level Elements

+
+

The DSL for messaging looks a little bit different than the one that focuses on HTTP.

+
+
+
Output triggered by a method
+
+

The output message can be triggered by calling a method (e.g. a Scheduler was started and a message was sent)

+
+
+
+
def dsl = Contract.make {
+	// Human readable description
+	description 'Some description'
+	// Label by means of which the output message can be triggered
+	label 'some_label'
+	// input to the contract
+	input {
+		// the contract will be triggered by a method
+		triggeredBy('bookReturnedTriggered()')
+	}
+	// output message of the contract
+	outputMessage {
+		// destination to which the output message will be sent
+		sentTo('output')
+		// the body of the output message
+		body('''{ "bookName" : "foo" }''')
+		// the headers of the output message
+		headers {
+			header('BOOK-NAME', 'foo')
+		}
+	}
+}
+
+
+
+

In this case the output message will be sent to output if a method called bookReturnedTriggered will be executed. In the message publisher’s side +we will generate a test that will call that method to trigger the message. On the consumer side you can use the some_label to trigger the message.

+
+
+
+
Output triggered by a message
+
+

The output message can be triggered by receiving a message.

+
+
+
+
def dsl = Contract.make {
+	description 'Some Description'
+	label 'some_label'
+	// input is a message
+	input {
+		// the message was received from this destination
+		messageFrom('input')
+		// has the following body
+		messageBody([
+		        bookName: 'foo'
+		])
+		// and the following headers
+		messageHeaders {
+			header('sample', 'header')
+		}
+	}
+	outputMessage {
+		sentTo('output')
+		body([
+		        bookName: 'foo'
+		])
+		headers {
+			header('BOOK-NAME', 'foo')
+		}
+	}
+}
+
+
+
+

In this case the output message will be sent to output if a proper message will be received on the input destination. In the message publisher’s side +we will generate a test that will send the input message to the defined destination. On the consumer side you can either send a message to the input +destination or use the some_label to trigger the message.

+
+
+
+
Consumer / Producer
+
+

In HTTP you have a notion of client/stub and `server/test notation. You can use them also in messaging but we’re providing also the consumer and produer methods +as presented below (note you can use either $ or value methods to provide consumer and producer parts)

+
+
+
+
Contract.make {
+	label 'some_label'
+	input {
+		messageFrom value(consumer('jms:output'), producer('jms:input'))
+		messageBody([
+				bookName: 'foo'
+		])
+		messageHeaders {
+			header('sample', 'header')
+		}
+	}
+	outputMessage {
+		sentTo $(consumer('jms:input'), producer('jms:output'))
+		body([
+				bookName: 'foo'
+		])
+	}
+}
+
+
+
+
+
+

2.17.11. Multiple contracts in one file

+
+

It’s possible to define multiple contracts in one file. An example of such a contract can look like this

+
+
+
+
import org.springframework.cloud.contract.spec.Contract
+
+[
+        Contract.make {
+            name("should post a user")
+            request {
+                method 'POST'
+                url('/users/1')
+            }
+            response {
+                status 200
+            }
+        },
+        Contract.make {
+            request {
+                method 'POST'
+                url('/users/2')
+            }
+            response {
+                status 200
+            }
+        }
+]
+
+
+
+

In this example one contract has the name field and the other doesn’t. This will lead to generation of +two tests that will look more or less like this:

+
+
+
+
package org.springframework.cloud.contract.verifier.tests.com.hello;
+
+import com.example.TestBase;
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import com.jayway.restassured.module.mockmvc.specification.MockMvcRequestSpecification;
+import com.jayway.restassured.response.ResponseOptions;
+import org.junit.Test;
+
+import static com.jayway.restassured.module.mockmvc.RestAssuredMockMvc.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.assertj.core.api.Assertions.assertThat;
+
+public class V1Test extends TestBase {
+
+	@Test
+	public void validate_should_post_a_user() throws Exception {
+		// given:
+			MockMvcRequestSpecification request = given();
+
+		// when:
+			ResponseOptions response = given().spec(request)
+					.post("/users/1");
+
+		// then:
+			assertThat(response.statusCode()).isEqualTo(200);
+	}
+
+	@Test
+	public void validate_withList_1() throws Exception {
+		// given:
+			MockMvcRequestSpecification request = given();
+
+		// when:
+			ResponseOptions response = given().spec(request)
+					.post("/users/2");
+
+		// then:
+			assertThat(response.statusCode()).isEqualTo(200);
+	}
+
+}
+
+
+
+

Notice that for the contract that has the name field the generated test method is named +validate_should_post_a_user. For the one that doesn’t have the name it’s called +validate_withList_1. It corresponds to the name of the file WithList.groovy and the +index of the contract in the list.

+
+
+

The generated stubs will look like this

+
+
+
+
should post a user.json
+1_WithList.json
+
+
+
+

As you can see the first file got the name parameter from the contract. The second +got the name of the contract file WithList.groovy prefixed with the index (in this case +contract had index 1 in the list of contracts in the file).

+
+
+ + + + + +
+ + +As you can see it’s much better if you name your contracts since then your tests + are far more meaningful. +
+
+
+
+
+

2.18. Customization

+
+

2.18.1. Extending the DSL

+
+

It is possible to provide your own functions to the DSL. The key requirement for this +feature was to maintain the static compatibility. Below you will be able to see an example +of:

+
+
+
    +
  • +

    creation of a JAR with reusable classes

    +
    • +
  • +

    referencing of these classes in the DSLs

    +
    • +
+
+
+

The full example can be found here.

+
+
+
Common JAR
+
+

Below you can find three classes that we will reuse in the DSLs.

+
+
+

PatternUtils contains functions used by both the consumer and the producer.

+
+
+
+
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.

+
+
+
+
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.

+
+
+
+
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[]
+
+
+
+
+
Adding the dependency to project
+
+

In order for the plugins and IDE to be able to reference the common JAR classes you need +to pass the dependency to your project.

+
+
+
Test dependency in project’s dependencies
+
+

First add the common jar dependency as a test dependency. That way since your +contracts files are available at test resources path, automatically the +common jar classes will be visible in your Groovy files.

+
+
+
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-SNAPSHOT")
+
+
+
+
+
Test dependency in plugin’s dependencies
+
+

Now you have to add the dependency for the plugin to reuse at runtime.

+
+
+
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-SNAPSHOT"
+
+
+
+
+
Referencing classes in DSLs
+
+

Now you can reference your classes in your DSL. Example:

+
+
+
+
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())
+		}
+	}
+}
+
+
+
+
+
+
+
+

2.19. Pluggable architecture

+
+

There are cases where you have your contracts defined in other formats +like YAML, RAML or PACT. On the other hand you’d like to profit from +the test and stubs generation. It’s really easy to add your own implementation +of either of those. Also you can customize the way tests are generated (for example you can generate +tests for other languages) and you can do the same for stubs generation (you can generate +stubs for other stub http server implementations).

+
+
+

2.19.1. Custom contract converter

+
+

Let’s assume that your contract is written in a YAML file like this:

+
+
+
+
request:
+  url: /foo
+  method: PUT
+  headers:
+    foo: bar
+  body:
+    foo: bar
+response:
+  status: 200
+  headers:
+    foo2: bar
+  body:
+    foo2: bar
+
+
+
+

Thanks to the interface

+
+
+
+
package org.springframework.cloud.contract.spec
+
+/**
+ * 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
+ */
+interface ContractConverter<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)
+}
+
+
+
+

you can register your own implementation of a contract structure converter. +Your implementation needs to state the condition on which it should start the +conversion. Also you have to define how to perform that conversion in both ways.

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

Example of a spring.factories file

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

and the YAML implementation

+
+
+
+
package org.springframework.cloud.contract.verifier.converter
+
+import java.nio.file.Files
+
+import groovy.transform.CompileStatic
+import org.springframework.cloud.contract.spec.Contract
+import org.springframework.cloud.contract.spec.ContractConverter
+import org.springframework.cloud.contract.spec.internal.Headers
+import org.yaml.snakeyaml.Yaml
+
+/**
+ * Simple converter from and to a {@link YamlContract} to a collection of {@link Contract}
+ */
+@CompileStatic
+class YamlContractConverter implements ContractConverter<List<YamlContract>> {
+
+	@Override
+	public boolean isAccepted(File file) {
+		String name = file.getName()
+		return name.endsWith(".yml") || name.endsWith(".yaml")
+	}
+
+	@Override
+	public Collection<Contract> convertFrom(File file) {
+		try {
+			YamlContract yamlContract = new Yaml().loadAs(
+					Files.newInputStream(file.toPath()), YamlContract.class)
+			return [Contract.make {
+				request {
+					method(yamlContract?.request?.method)
+					url(yamlContract?.request?.url)
+					headers {
+						yamlContract?.request?.headers?.each { String key, Object value ->
+							header(key, value)
+						}
+					}
+					body(yamlContract?.request?.body)
+				}
+				response {
+					status(yamlContract?.response?.status)
+					headers {
+						yamlContract?.response?.headers?.each { String key, Object value ->
+							header(key, value)
+						}
+					}
+					body(yamlContract?.response?.body)
+				}
+			}]
+		}
+		catch (FileNotFoundException e) {
+			throw new IllegalStateException(e)
+		}
+	}
+
+	@Override
+	public List<YamlContract> convertTo(Collection<Contract> contracts) {
+		return contracts.collect { Contract contract ->
+			YamlContract yamlContract = new YamlContract()
+			yamlContract.request.with {
+				method = contract?.request?.method?.clientValue
+				url = contract?.request?.url?.clientValue
+				headers = (contract?.request?.headers as Headers)?.asStubSideMap()
+				body = contract?.request?.body?.clientValue as Map
+			}
+			yamlContract.response.with {
+				status = contract?.response?.status?.clientValue as Integer
+				headers = (contract?.response?.headers as Headers)?.asStubSideMap()
+				body = contract?.response?.body?.clientValue as Map
+			}
+			return yamlContract
+		}
+	}
+}
+
+
+
+
Pact converter
+
+

Spring Cloud Contract comes with an out of the box support for Pact representation of contracts. +In other words instead of using the Groovy DSL you can use Pact files. In this section +we will present how to add such a support for your project.

+
+
+
Pact contract
+
+

We will be working on the following example of a Pact contract. We’ve placed this file under +the src/test/resources/contracts folder.

+
+
+
+
{
+  "provider": {
+    "name": "Provider"
+  },
+  "consumer": {
+    "name": "Consumer"
+  },
+  "interactions": [
+    {
+      "description": "",
+      "request": {
+        "method": "PUT",
+        "path": "/fraudcheck",
+        "headers": {
+          "Content-Type": "application/vnd.fraud.v1+json"
+        },
+        "body": {
+          "clientId": "1234567890",
+          "loanAmount": 99999
+        },
+        "matchingRules": {
+          "$.body.clientId": {
+            "match": "regex",
+            "regex": "[0-9]{10}"
+          }
+        }
+      },
+      "response": {
+        "status": 200,
+        "headers": {
+          "Content-Type": "application/vnd.fraud.v1+json;charset=UTF-8"
+        },
+        "body": {
+          "fraudCheckStatus": "FRAUD",
+          "rejectionReason": "Amount too high"
+        },
+        "matchingRules": {
+          "$.body.fraudCheckStatus": {
+            "match": "regex",
+            "regex": "FRAUD"
+          }
+        }
+      }
+    }
+  ],
+  "metadata": {
+    "pact-specification": {
+      "version": "2.0.0"
+    },
+    "pact-jvm": {
+      "version": "2.4.18"
+    }
+  }
+}
+
+
+
+
+
Pact for producers
+
+

On the producer side you have add to your plugin configuration two additional dependencies. +One is the Spring Cloud Contract Pact support and the other represents the current +Pact version that you’re using.

+
+
+
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.fraud</packageWithBaseClasses>
+	</configuration>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.cloud</groupId>
+			<artifactId>spring-cloud-contract-spec-pact</artifactId>
+			<version>${spring-cloud-contract.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>au.com.dius</groupId>
+			<artifactId>pact-jvm-model</artifactId>
+			<version>2.4.18</version>
+		</dependency>
+	</dependencies>
+</plugin>
+
+
+
+
Gradle
+
+
classpath "org.springframework.cloud:spring-cloud-contract-spec-pact:${findProperty('verifierVersion') ?: verifierVersion}"
+classpath 'au.com.dius:pact-jvm-model:2.4.18'
+
+
+
+

When you execute the build of your application a test, looking more or less like this, will be generated

+
+
+
+
@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")).isEqualTo("application/vnd.fraud.v1+json;charset=UTF-8");
+	// 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");
+}
+
+
+
+

and the stub looking like this

+
+
+
+
{
+  "uuid" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
+  "request" : {
+    "url" : "/fraudcheck",
+    "method" : "PUT",
+    "headers" : {
+      "Content-Type" : {
+        "equalTo" : "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"
+    }
+  }
+}
+
+
+
+
+
Pact for consumers
+
+

On the producer side you have add to your project dependencies two additional dependencies. +One is the Spring Cloud Contract Pact support and the other represents the current +Pact version that you’re using.

+
+
+
Maven
+
+
<dependency>
+	<groupId>org.springframework.cloud</groupId>
+	<artifactId>spring-cloud-contract-spec-pact</artifactId>
+	<scope>test</scope>
+</dependency>
+<dependency>
+	<groupId>au.com.dius</groupId>
+	<artifactId>pact-jvm-model</artifactId>
+	<version>2.4.18</version>
+	<scope>test</scope>
+</dependency>
+
+
+
+
Gradle
+
+
testCompile "org.springframework.cloud:spring-cloud-contract-spec-pact"
+testCompile 'au.com.dius:pact-jvm-model:2.4.18'
+
+
+
+
+
+
+

2.19.2. Custom test generator

+
+

If you want to generate tests for different languages than Java or you’re +not happy with the way we’re building Java tests for you then you can register +your own implementation to do that.

+
+
+

Thanks to the interface

+
+
+
+
package org.springframework.cloud.contract.verifier.builder
+
+import org.springframework.cloud.contract.verifier.config.ContractVerifierConfigProperties
+import org.springframework.cloud.contract.verifier.file.ContractMetadata
+/**
+ * Builds a single test.
+ *
+ * @since 1.1.0
+ */
+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
+	 */
+	String buildClass(ContractVerifierConfigProperties properties, Collection<ContractMetadata> listOfFiles,
+					  String className, String classPackage, String includedDirectoryRelativePath)
+
+	/**
+	 * Extension that should be appended to the generated test class. E.g. {@code .java} or {@code .php}
+	 *
+	 * @param properties - properties passed to the plugin
+	 */
+	String fileExtension(ContractVerifierConfigProperties properties)
+}
+
+
+
+

you can register your own implementation that generates a test. Again, it’s enough to provide +a proper spring.factories file. Example:

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

2.19.3. Custom stub generator

+
+

If you want to generate stubs for other stub server than WireMock it’s enough to + plug in your own implementation of this interface:

+
+
+
+
package org.springframework.cloud.contract.verifier.converter
+
+import groovy.transform.CompileStatic
+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
+ */
+@CompileStatic
+interface StubGenerator {
+
+	/**
+	 * Returns {@code true} if the converter can handle the file to convert it into a stub.
+	 */
+	boolean canHandleFileName(String fileName)
+
+	/**
+	 * Returns the collection of converted contracts into stubs. One contract can
+	 * result in multiple stubs.
+	 */
+	Map<Contract, String> convertContents(String rootName, ContractMetadata content)
+
+	/**
+	 * Returns 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)
+}
+
+
+
+

you can register your own implementation that generate Stubs. Again, it’s enough to provide +a proper spring.factories file. 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. That way for example from a single +DSL as input you can e.g. produce WireMock stubs and Pact files too! +
+
+
+
+

2.19.4. Custom Stub Runner

+
+

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

+
+
+

Let us assume that you’re using Moco to build your stubs. +You wrote a proper stub generator and your stubs got placed 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. It can look like this:

+
+
+
+
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.util.logging.Slf4j
+import org.springframework.cloud.contract.stubrunner.HttpServerStub
+import org.springframework.util.SocketUtils
+
+@Slf4j
+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().withStream(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")
+	}
+}
+
+
+
+

and just register it in your spring.factories file

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

that way you’ll be able to run stubs using Moco.

+
+
+ + + + + +
+ + +If you don’t provide any implementation then the default one - WireMock based +will be picked. If you provide more than one then the first one on the list will be picked. +
+
+
+
+

2.19.5. Custom Stub Downloader

+
+

You can customize the way your stubs are downloaded. It’s enough to create an +implementation of the StubDownloaderBuilder

+
+
+
+
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
+			}
+}
+
+
+
+

and just register it in your spring.factories file

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

that way you’ll be able to pick a folder with the source of your stubs.

+
+
+ + + + + +
+ + +If you don’t provide any implementation then the default one will be picked. + If you provide repositoryRoot property or workOffline flag then Aether based + that will download stubs from a remote repo will be picked. If you don’t provide these + values then the ClasspathStubProvider will be picked that will scan the classpath. + If you provide more than one, then the first one on the list will be picked. +
+
+
+
+
+

2.20. Links

+
+

Here you can find interesting links related to Spring Cloud Contract Verifier:

+
+
+ +
+
+
+
+
+

3. Spring Cloud Contract WireMock

+
+
+

Modules giving you the possibility to use +WireMock with different servers by using the +"ambient" server embedded in a Spring Boot application. Check out the +samples +for more details.

+
+
+ + + + + +
+ + +The Spring Cloud Release Train BOM imports spring-cloud-contract-dependencies + which in turn has exclusions for the dependencies needed by WireMock. This might lead to a situation that + even if you’re not using Spring Cloud Contract then your dependencies will be influenced + anyways. +
+
+
+

If you have a Spring Boot application that uses Tomcat as an embedded +server, for example (the default with spring-boot-starter-web), then +you can simply add spring-cloud-contract-wiremock to your classpath +and add @AutoConfigureWireMock in order to be able to use Wiremock +in your tests. Wiremock runs as a stub server and you can register +stub behaviour using a Java API or via static JSON declarations as +part of your test. Here’s a simple example:

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+@AutoConfigureWireMock(port = 0)
+public class WiremockForDocsTests {
+	// A service that calls out over HTTP
+	@Autowired private Service service;
+
+	// Using the WireMock APIs in the normal way:
+	@Test
+	public void contextLoads() throws Exception {
+		// Stubbing WireMock
+		stubFor(get(urlEqualTo("/resource"))
+				.willReturn(aResponse().withHeader("Content-Type", "text/plain").withBody("Hello World!")));
+		// We're asserting if WireMock responded properly
+		assertThat(this.service.go()).isEqualTo("Hello World!");
+	}
+
+}
+
+
+
+

To start the stub server on a different port use @AutoConfigureWireMock(port=9999) (for example), and for a random port use the value 0. The stub server port will be bindable in the test application context as "wiremock.server.port". Using @AutoConfigureWireMock adds a bean of type WiremockConfiguration to your test application context, where it will be cached in between methods and classes having the same context, just like for normal Spring integration tests.

+
+
+

3.1. Registering Stubs Automatically

+
+

If you use @AutoConfigureWireMock then it will register WireMock +JSON stubs from the file system or classpath, by default from +file:src/test/resources/mappings. You can customize the locations +using the stubs attribute in the annotation, which can be a resource +pattern (ant-style) or a directory, in which case */.json is +appended. Example:

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureWireMock(stubs="classpath:/stubs")
+public class WiremockImportApplicationTests {
+
+	@Autowired
+	private Service service;
+
+	@Test
+	public void contextLoads() throws Exception {
+		assertThat(this.service.go()).isEqualTo("Hello World!");
+	}
+
+}
+
+
+
+ + + + + +
+ + +Actually WireMock always loads mappings from +src/test/resources/mappings as well as the custom locations in the +stubs attribute. To change this behaviour you have to also specify a +files root as described next. +
+
+
+
+

3.2. Using Files to Specify the Stub Bodies

+
+

WireMock can read response bodies from files on the classpath or file +system. In that case you will see in the JSON DSL that the response +has a "bodyFileName" instead of a (literal) "body". The files are +resolved relative to a root directory src/test/resources/__files by +default. To customize this location you can set the files attribute +in the @AutoConfigureWireMock annotation to the location of the +parent directory (i.e. the place __files is a +subdirectory). You can use Spring resource notation to refer to +file:…​ or classpath:…​ locations (but generic URLs are not +supported). A list of values can be given and WireMock will resolve +the first file that exists when it needs to find a response body.

+
+
+ + + + + +
+ + +when you configure the files root, then it affects the +automatic loading of stubs as well (they come from the root location +in a subdirectory called "mappings"). The value of files has no +effect on the stubs loaded explicitly from the stubs attribute. +
+
+
+
+

3.3. Alternative: Using JUnit Rules

+
+

For a more conventional WireMock experience, using JUnit @Rules to +start and stop the server, just use the WireMockSpring convenience +class to obtain an Options instance:

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+public class WiremockForDocsClassRuleTests {
+
+	// Start WireMock on some dynamic port
+	// for some reason `dynamicPort()` is not working properly
+	@ClassRule
+	public static WireMockClassRule wiremock = new WireMockClassRule(
+			WireMockSpring.options().dynamicPort());
+	// A service that calls out over HTTP to localhost:${wiremock.port}
+	@Autowired
+	private Service service;
+
+	// Using the WireMock APIs in the normal way:
+	@Test
+	public void contextLoads() throws Exception {
+		// Stubbing WireMock
+		wiremock.stubFor(get(urlEqualTo("/resource"))
+				.willReturn(aResponse().withHeader("Content-Type", "text/plain").withBody("Hello World!")));
+		// We're asserting if WireMock responded properly
+		assertThat(this.service.go()).isEqualTo("Hello World!");
+	}
+
+}
+
+
+
+

The use @ClassRule means that the server will shut down after all the methods in this class.

+
+
+
+
+
+

4. Relaxed SSL Validation for Rest Template

+
+
+

WireMock allows you to stub a "secure" server with an "https" URL protocol. If your application wants to +contact that stub server in an integration test, then it will find that the SSL certificates are not +valid (it’s the usual problem with self-installed certificates). The best option is often to just +re-configure the client to use "http", but if that’s not open to you then you can ask Spring to configure +an HTTP client that ignores SSL validation errors (just for tests).

+
+
+

To make this work with minimum fuss you need to be using the Spring Boot RestTemplateBuilder in your app, +e.g.

+
+
+
+
@Bean
+public RestTemplate restTemplate(RestTemplateBuilder builder) {
+	return builder.build();
+}
+
+
+
+

This is because the builder is passed through callbacks to initalize it, so the SSL validation can be set up +in the client at that point. This will happen automatically in your test if you are using the +@AutoConfigureWireMock annotation (or the stub runner). If you are using the JUnit @Rule approach you need +to add the @AutoConfigureHttpClient annotation as well:

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest("app.baseUrl=https://localhost:6443")
+@AutoConfigureHttpClient
+public class WiremockHttpsServerApplicationTests {
+
+	@ClassRule
+	public static WireMockClassRule wiremock = new WireMockClassRule(
+			WireMockSpring.options().httpsPort(6443));
+...
+}
+
+
+
+

If you are using spring-boot-starter-test then you will have the Apache HTTP client on the classpath and it will +be selected by the RestTemplateBuilder and configured to ignore SSL errors. If you are using the default java.net +client you don’t need the annotation (but it won’t do any harm). There is no support currently for other clients, but +it may be added in future releases.

+
+
+
+
+

5. WireMock and Spring MVC Mocks

+
+
+

Spring Cloud Contract provides a convenience class that can load JSON WireMock stubs into a +Spring MockRestServiceServer. Here’s an example:

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.NONE)
+public class WiremockForDocsMockServerApplicationTests {
+
+	@Autowired
+	private RestTemplate restTemplate;
+
+	@Autowired
+	private Service service;
+
+	@Test
+	public void contextLoads() throws Exception {
+		// will read stubs classpath
+		MockRestServiceServer server = WireMockRestServiceServer.with(this.restTemplate)
+				.baseUrl("http://example.org").stubs("classpath:/stubs/resource.json")
+				.build();
+		// We're asserting if WireMock responded properly
+		assertThat(this.service.go()).isEqualTo("Hello World");
+		server.verify();
+	}
+}
+
+
+
+

The baseUrl is prepended to all mock calls, and the stubs() +method takes a stub path resource pattern as an argument. So in this +example the stub defined at /stubs/resource.json is loaded into the +mock server, so if the RestTemplate is asked to visit +http://example.org/ it will get the responses as declared +there. More than one stub pattern can be specified, and each one can +be a directory (for a recursive list of all ".json"), or a fixed +filename (like in the example above) or an ant-style pattern. The JSON +format is the normal WireMock format which you can read about in the +WireMock website.

+
+
+

Currently we support Tomcat, Jetty and Undertow as Spring Boot +embedded servers, and Wiremock itself has "native" support for a +particular version of Jetty (currently 9.2). To use the native Jetty +you need to add the native wiremock dependencies and exclude the +Spring Boot container if there is one.

+
+
+
+
+

6. Generating Stubs using RestDocs

+
+
+

Spring RestDocs can be +used to generate documentation (e.g. in asciidoctor format) for an +HTTP API with Spring MockMvc or Rest Assured. At the same time as you +generate documentation for your API, you can also generate WireMock +stubs, by using Spring Cloud Contract WireMock. Just write your normal +RestDocs test cases and use @AutoConfigureRestDocs to have stubs +automatically in the restdocs output directory. For example:

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureMockMvc
+public class ApplicationTests {
+
+	@Autowired
+	private MockMvc mockMvc;
+
+	@Test
+	public void contextLoads() throws Exception {
+		mockMvc.perform(get("/resource"))
+				.andExpect(content().string("Hello World"))
+				.andDo(document("resource"));
+	}
+}
+
+
+
+

From this test will be generated a WireMock stub at +"target/snippets/stubs/resource.json". It matches all GET requests to +the "/resource" path.

+
+
+

Without any additional configuration this will create a stub with a +request matcher for the HTTP method and all headers except "host" and +"content-length". To match the request more precisely, for example to +match the body of a POST or PUT, we need to explicitly create a +request matcher. This will do two things: 1) create a stub that only +matches the way you specify, 2) assert that the request in the test +case also matches the same conditions.

+
+
+

The main entry point for this is WireMockRestDocs.verify() which can +be used as a substitute for the document() convenience method. For +example:

+
+
+
+
@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureMockMvc
+public class ApplicationTests {
+
+	@Autowired
+	private MockMvc mockMvc;
+
+	@Test
+	public void contextLoads() throws Exception {
+		mockMvc.perform(post("/resource")
+                .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
+				.andExpect(status().isOk())
+				.andDo(verify().jsonPath("$.id")
+                        .stub("resource"));
+	}
+}
+
+
+
+

So this contract is saying: any valid POST with an "id" field will get +back an the same response as in this test. You can chain together +calls to .jsonPath() to add additional matchers. The +JayWay documentation can help you +to get up to speed with JSON Path if it is unfamiliar to you.

+
+
+

Instead of the jsonPath and contentType convenience methods, you +can also use the WireMock APIs to verify the request matches the +created stub. Example:

+
+
+
+
@Test
+public void contextLoads() throws Exception {
+	mockMvc.perform(post("/resource")
+               .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
+			.andExpect(status().isOk())
+			.andDo(verify()
+					.wiremock(WireMock.post(
+						urlPathEquals("/resource"))
+						.withRequestBody(matchingJsonPath("$.id"))
+                       .stub("post-resource"));
+}
+
+
+
+

The WireMock API is rich - you can match headers, query parameters, +and request body by regex as well as by json path - so this can useful +to create stubs with a wider range of parameters. The above example +will generate a stub something like this:

+
+
+
post-resource.json
+
+
{
+  "request" : {
+    "url" : "/resource",
+    "method" : "POST",
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$.id"
+    }]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "Hello World",
+    "headers" : {
+      "X-Application-Context" : "application:-1",
+      "Content-Type" : "text/plain"
+    }
+  }
+}
+
+
+
+ + + + + +
+ + +You can use either the wiremock() method or the jsonPath() +and contentType() methods to create request matchers, but not both. +
+
+
+

On the consumer side, you can make the resource.json generated above +available on the classpath (by publishing stubs as JARs for example). +After that, you can create a stub using WireMock in a +number of different ways, including as described above using +@AutoConfigureWireMock(stubs="classpath:resource.json").

+
+
+
+
+

7. Generating Contracts using RestDocs

+
+
+

Another thing that can be generated with Spring RestDocs is the Spring Cloud +Contract DSL file and documentation. If you combine that with Spring Cloud +WireMock then you’re getting both the contracts and stubs.

+
+
+

Why would you want to use this feature? Some people in the community asked questions +about situation in which they would like to move to DSL based contract definition +but they already have a lot of Spring MVC tests. Using this feature allows you to generate +the contract files that you can later modify and move to proper folders so that the +plugin picks them up.

+
+
+ + + + + +
+ + +You might wonder why this functionality is in the WireMock module. +Come to think of it, it does make sense since it makes little sense to generate +only contracts and not generate the stubs. That’s why we suggest to do both. +
+
+
+

Let’s imagine the following test:

+
+
+
+
		this.mockMvc.perform(post("/foo")
+					.accept(MediaType.APPLICATION_PDF)
+					.accept(MediaType.APPLICATION_JSON)
+					.contentType(MediaType.APPLICATION_JSON)
+					.content("{\"foo\": 23 }"))
+				.andExpect(status().isOk())
+				.andExpect(content().string("bar"))
+				// first WireMock
+				.andDo(WireMockRestDocs.verify()
+						.jsonPath("$[?(@.foo >= 20)]")
+						.contentType(MediaType.valueOf("application/json"))
+						.stub("shouldGrantABeerIfOldEnough"))
+				// then Contract DSL documentation
+				.andDo(document("index", SpringCloudContractRestDocs.dslContract()));
+
+
+
+

This will lead in the creation of the stub as presented in the previous +section, contract will get generated and a documentation file too.

+
+
+

The contract will be called index.groovy and look more like this.

+
+
+
+
import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    request {
+        method 'POST'
+        url '/foo'
+        body('''
+            {"foo": 23 }
+        ''')
+        headers {
+            header('''Accept''', '''application/json''')
+            header('''Content-Type''', '''application/json''')
+        }
+    }
+    response {
+        status 200
+        body('''
+        bar
+        ''')
+        headers {
+            header('''Content-Type''', '''application/json;charset=UTF-8''')
+            header('''Content-Length''', '''3''')
+        }
+        testMatchers {
+            jsonPath('$[?(@.foo >= 20)]', byType())
+        }
+    }
+}
+
+
+
+

the generated document (example for Asciidoc) will contain a formatted contract +(the location of this file would be index/dsl-contract.adoc).

+
+
+
+
+

8. Migrations

+
+
+

In the following document we will write about necessary migration steps between versions.

+
+
+

8.1. 1.0.x → 1.1.x

+
+

8.1.1. New structure of generated stubs

+
+

In 1.1.x we have introduced a changed structure of generated stubs. So if you’ve +been using the following @AutoConfigureWireMock notation to use the stubs from classpath

+
+
+
+
@AutoConfigureWireMock(stubs = "classpath:/customer-stubs/mappings", port = 8084)
+
+
+
+

It will no longer work with the new stubs. You have to either change the location of stubs +to : classpath:…​/META-INF/groupId/artifactId/version/mappings as follows

+
+
+
+
@AutoConfigureWireMock(stubs = "classpath:customer-stubs/META-INF/travel.components/customer-contract/1.0.2-SNAPSHOT/mappings/", port = 8084)
+
+
+
+

Or migrate to the new classpath based @AutoConfigureStubRunner.

+
+
+

If however you don’t want to do that and you want to remain with the old structure +just set your plugin tasks accordingly. Example for the structure presented in the +snippet above.

+
+
+
Maven
+
+
<!-- start of pom.xml -->
+
+<properties>
+    <!-- we don't want the verifier to do a jar for us -->
+    <spring.cloud.contract.verifier.skip>true</spring.cloud.contract.verifier.skip>
+</properties>
+
+<!-- ... -->
+
+<!-- You need to set up the assembly plugin -->
+<build>
+    <plugins>
+        <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-assembly-plugin</artifactId>
+            <executions>
+                <execution>
+                    <id>stub</id>
+                    <phase>prepare-package</phase>
+                    <goals>
+                        <goal>single</goal>
+                    </goals>
+                    <inherited>false</inherited>
+                    <configuration>
+                        <attach>true</attach>
+                        <descriptor>$/Users/ryanjbaxter/git-repos/spring-cloud/scripts/docs/../src/assembly/stub.xml</descriptor>
+                    </configuration>
+                </execution>
+            </executions>
+        </plugin>
+    </plugins>
+</build>
+<!-- end of pom.xml -->
+
+<!-- start of stub.xml-->
+
+<assembly
+	xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">
+	<id>stubs</id>
+	<formats>
+		<format>jar</format>
+	</formats>
+	<includeBaseDirectory>false</includeBaseDirectory>
+	<fileSets>
+		<fileSet>
+			<directory>${project.build.directory}/snippets/stubs</directory>
+			<outputDirectory>customer-stubs/mappings</outputDirectory>
+			<includes>
+				<include>**/*</include>
+			</includes>
+		</fileSet>
+		<fileSet>
+			<directory>$/Users/ryanjbaxter/git-repos/spring-cloud/scripts/docs/../src/test/resources/contracts</directory>
+			<outputDirectory>customer-stubs/contracts</outputDirectory>
+			<includes>
+				<include>**/*.groovy</include>
+			</includes>
+		</fileSet>
+	</fileSets>
+</assembly>
+
+<!-- end of stub.xml-->
+
+
+
+
Gradle
+
+
task copyStubs(type: Copy, dependsOn: 'generateWireMockClientStubs') {
+//    Preserve directory structure from 1.0.X of spring-cloud-contract
+    from "${project.buildDir}/resources/main/customer-stubs/META-INF/${project.group}/${project.name}/${project.version}"
+    into "${project.buildDir}/resources/main/customer-stubs"
+}
+
+
+
+
+
+

8.2. 1.1.x → 1.2.x

+
+

8.2.1. Custom HttpServerStub

+
+

By introducing a method String registeredMappings() in the public interface +HttpServerStub, if you wrote a custom HttpServerStub implementation, you’ll +have to implement that method too. It should return a String representing +all mappings available in a single HttpServerStub. Related to +issue 355.

+
+
+
+

8.2.2. New packages for generated tests

+
+

The flow for setting the generated tests package name will look like this:

+
+
+
    +
  • +

    pick basePackageForTests

    +
    • +
  • +

    if basePackageForTests wasn’t set pick the package from baseClassForTests

    +
    • +
  • +

    if baseClassForTests wasn’t set pick packageWithBaseClasses

    +
    • +
  • +

    if nothing got set pick the default org.springframework.cloud.contract.verifier.tests value

    +
    • +
+
+
+

Related to +issue 260.

+
+
+
+
+
+

Spring Cloud Vault

+
+
+
+

© 2016-2017 The original authors.

+
+
+ + + + + +
+ + +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. +
+
+
+

Spring Cloud Vault Config provides client-side support for externalized configuration in a distributed system. With HashiCorp’s Vault you have a central place to manage external secret properties for applications across all environments. Vault can manage static and dynamic secrets such as username/password for remote applications/resources and provide credentials for external services such as MySQL, PostgreSQL, Apache Cassandra, MongoDB, Consul, AWS and more.

+
+
+
+
+

9. Quick Start

+
+
+

Prerequisites

+
+
+

To get started with Vault and this guide you need a +*NIX-like operating systems that provides:

+
+
+
    +
  • +

    wget, openssl and unzip

    +
    • +
  • +

    at least Java 7 and a properly configured JAVA_HOME environment variable

    +
    • +
+
+
+

Install Vault

+
+
+
+
$ src/test/bash/install_vault.sh
+
+
+
+

Create SSL certificates for Vault

+
+
+
+
$ src/test/bash/create_certificates.sh
+
+
+
+ + + + + +
+ + +create_certificates.sh creates certificates in work/ca and a JKS truststore work/keystore.jks. If you want to run Spring Cloud Vault using this quickstart guide you need to configure the truststore the spring.cloud.vault.ssl.trust-store property to file:work/keystore.jks. +
+
+
+

Start Vault server

+
+
+
+
$ src/test/bash/local_run_vault.sh
+
+
+
+

Vault is started listening on 0.0.0.0:8200 using the inmem storage and +https. +Vault is sealed and not initialized when starting up.

+
+
+ + + + + +
+ + +If you want to run tests, leave Vault uninitialized. The tests will +initialize Vault and create a root token 00000000-0000-0000-0000-000000000000. +
+
+
+

If you want to use Vault for your application or give it a try then you need to initialize it first.

+
+
+
+
$ export VAULT_ADDR="https://localhost:8200"
+$ export VAULT_SKIP_VERIFY=true # Don't do this for production
+$ vault init
+
+
+
+

You should see something like:

+
+
+
+
Key 1: 7149c6a2e16b8833f6eb1e76df03e47f6113a3288b3093faf5033d44f0e70fe701
+Key 2: 901c534c7988c18c20435a85213c683bdcf0efcd82e38e2893779f152978c18c02
+Key 3: 03ff3948575b1165a20c20ee7c3e6edf04f4cdbe0e82dbff5be49c63f98bc03a03
+Key 4: 216ae5cc3ddaf93ceb8e1d15bb9fc3176653f5b738f5f3d1ee00cd7dccbe926e04
+Key 5: b2898fc8130929d569c1677ee69dc5f3be57d7c4b494a6062693ce0b1c4d93d805
+Initial Root Token: 19aefa97-cccc-bbbb-aaaa-225940e63d76
+
+Vault initialized with 5 keys and a key threshold of 3. Please
+securely distribute the above keys. When the Vault is re-sealed,
+restarted, or stopped, you must provide at least 3 of these keys
+to unseal it again.
+
+Vault does not store the master key. Without at least 3 keys,
+your Vault will remain permanently sealed.
+
+
+
+

Vault will initialize and return a set of unsealing keys and the root token. +Pick 3 keys and unseal Vault. Store the Vault token in the VAULT_TOKEN + environment variable.

+
+
+
+
$ vault unseal (Key 1)
+$ vault unseal (Key 2)
+$ vault unseal (Key 3)
+$ export VAULT_TOKEN=(Root token)
+# Required to run Spring Cloud Vault tests after manual initialization
+$ vault token-create -id="00000000-0000-0000-0000-000000000000" -policy="root"
+
+
+
+

Spring Cloud Vault accesses different resources. By default, the secret +backend is enabled which accesses secret config settings via JSON endpoints.

+
+
+

The HTTP service has resources in the form:

+
+
+
+
/secret/{application}/{profile}
+/secret/{application}
+/secret/{defaultContext}/{profile}
+/secret/{defaultContext}
+
+
+
+

where the "application" is injected as the spring.application.name in the +SpringApplication (i.e. what is normally "application" in a regular +Spring Boot app), "profile" is an active profile (or comma-separated +list of properties). Properties retrieved from Vault will be used "as-is" +without further prefixing of the property names.

+
+
+
+
+

10. Client Side Usage

+
+
+

To use these features in an application, just build it as a Spring +Boot application that depends on spring-cloud-vault-config (e.g. see +the test cases). Example Maven configuration:

+
+
+
Example 1. pom.xml
+
+
+
+
<parent>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-parent</artifactId>
+    <version>1.5.4.RELEASE</version>
+    <relativePath /> <!-- lookup parent from repository -->
+</parent>
+
+<dependencies>
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-starter-vault-config</artifactId>
+        <version>Edgware.M1</version>
+    </dependency>
+    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-test</artifactId>
+        <scope>test</scope>
+    </dependency>
+</dependencies>
+
+<build>
+    <plugins>
+        <plugin>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-maven-plugin</artifactId>
+        </plugin>
+    </plugins>
+</build>
+
+<!-- repositories also needed for snapshots and milestones -->
+
+
+
+
+
+

Then you can create a standard Spring Boot application, like this simple HTTP server:

+
+
+
+
+
+
@SpringBootApplication
+@RestController
+public class Application {
+
+    @RequestMapping("/")
+    public String home() {
+        return "Hello World!";
+    }
+
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+}
+
+
+
+
+
+

When it runs it will pick up the external configuration from the +default local Vault server on port 8200 if it is running. To modify +the startup behavior you can change the location of the Vault server +using bootstrap.properties (like application.properties but for +the bootstrap phase of an application context), e.g.

+
+
+
Example 2. bootstrap.yml
+
+
+
+
spring.cloud.vault:
+    host: localhost
+    port: 8200
+    scheme: https
+    uri: https://localhost:8200
+    connection-timeout: 5000
+    read-timeout: 15000
+    config:
+        order: -10
+
+
+
+
+
+
    +
  • +

    host sets the hostname of the Vault host. The host name will be used +for SSL certificate validation

    +
    • +
  • +

    port sets the Vault port

    +
    • +
  • +

    scheme setting the scheme to http will use plain HTTP. +Supported schemes are http and https.

    +
    • +
  • +

    uri configure the Vault endpoint with an URI. Takes precedence over host/port/scheme configuration

    +
    • +
  • +

    connection-timeout sets the connection timeout in milliseconds

    +
    • +
  • +

    read-timeout sets the read timeout in milliseconds

    +
    • +
  • +

    config.order sets the order for the property source

    +
    • +
+
+
+

Enabling further integrations requires additional dependencies and +configuration. Depending on how you have set up Vault you might need +additional configuration like +SSL and +authentication.

+
+
+

If the application imports the spring-boot-starter-actuator project, the +status of the vault server will be available via the /health endpoint.

+
+
+

The vault health indicator can be enabled or disabled through the +property health.vault.enabled (default true).

+
+
+

10.1. Authentication

+
+

Vault requires an authentication mechanism to authorize client requests.

+
+
+

Spring Cloud Vault supports multiple authentication mechanisms to authenticate applications with Vault.

+
+
+

For a quickstart, use the root token printed by the Vault initialization.

+
+
+
Example 3. bootstrap.yml
+
+
+
+
spring.cloud.vault:
+    token: 19aefa97-cccc-bbbb-aaaa-225940e63d76
+
+
+
+
+
+ + + + + +
+ + +Consider carefully your security requirements. Static token authentication is fine if you want quickly get started with Vault, but a static token is not protected any further. Any disclosure to unintended parties allows Vault use with the associated token roles. +
+
+
+
+
+
+

11. Authentication methods

+
+
+

Different organizations have different requirements for security +and authentication. Vault reflects that need by shipping multiple authentication +methods. Spring Cloud Vault supports token and AppId authentication.

+
+
+

11.1. Token authentication

+
+

Tokens are the core method for authentication within Vault. +Token authentication requires a static token to be provided using the +Bootstrap Application Context.

+
+
+ + + + + +
+ + +Token authentication is the default authentication method. +If a token is disclosed an unintended party gains access to Vault and +can access secrets for the intended client. +
+
+
+
Example 4. bootstrap.yml
+
+
+
+
spring.cloud.vault:
+    authentication: TOKEN
+    token: 00000000-0000-0000-0000-000000000000
+
+
+
+
+
+
    +
  • +

    authentication setting this value to TOKEN selects the Token +authentication method

    +
    • +
  • +

    token sets the static token to use

    +
    • +
+
+
+

See also: Vault Documentation: Tokens

+
+
+
+

11.2. AppId authentication

+
+

Vault supports AppId +authentication that consists of two hard to guess tokens. The AppId +defaults to spring.application.name that is statically configured. +The second token is the UserId which is a part determined by the application, +usually related to the runtime environment. IP address, Mac address or a +Docker container name are good examples. Spring Cloud Vault Config supports +IP address, Mac address and static UserId’s (e.g. supplied via System properties). +The IP and Mac address are represented as Hex-encoded SHA256 hash.

+
+
+

IP address-based UserId’s use the local host’s IP address.

+
+
+
Example 5. bootstrap.yml using SHA256 IP-Address UserId’s
+
+
+
+
spring.cloud.vault:
+    authentication: APPID
+    app-id:
+        user-id: IP_ADDRESS
+
+
+
+
+
+
    +
  • +

    authentication setting this value to APPID selects the AppId +authentication method

    +
    • +
  • +

    app-id-path sets the path of the AppId mount to use

    +
    • +
  • +

    user-id sets the UserId method. Possible values are IP_ADDRESS, +MAC_ADDRESS or a class name implementing a custom AppIdUserIdMechanism

    +
    • +
+
+
+

The corresponding command to generate the IP address UserId from a command line is:

+
+
+
+
$ echo -n 192.168.99.1 | sha256sum
+
+
+
+ + + + + +
+ + +Including the line break of echo leads to a different hash value +so make sure to include the -n flag. +
+
+
+

Mac address-based UserId’s obtain their network device from the +localhost-bound device. The configuration also allows specifying +a network-interface hint to pick the right device. The value of +network-interface is optional and can be either an interface +name or interface index (0-based).

+
+
+
Example 6. bootstrap.yml using SHA256 Mac-Address UserId’s
+
+
+
+
spring.cloud.vault:
+    authentication: APPID
+    app-id:
+        user-id: MAC_ADDRESS
+        network-interface: eth0
+
+
+
+
+
+
    +
  • +

    network-interface sets network interface to obtain the physical address

    +
    • +
+
+
+

The corresponding command to generate the IP address UserId from a command line is:

+
+
+
+
$ echo -n 0AFEDE1234AC | sha256sum
+
+
+
+ + + + + +
+ + +The Mac address is specified uppercase and without colons. +Including the line break of echo leads to a different hash value +so make sure to include the -n flag. +
+
+
+

11.2.1. Custom UserId

+
+

The UserId generation is an open mechanism. You can set +spring.cloud.vault.app-id.user-id to any string and the configured +value will be used as static UserId.

+
+
+

A more advanced approach lets you set spring.cloud.vault.app-id.user-id to a +classname. This class must be on your classpath and must implement +the org.springframework.cloud.vault.AppIdUserIdMechanism interface +and the createUserId method. Spring Cloud Vault will obtain the UserId +by calling createUserId each time it authenticates using AppId to +obtain a token.

+
+
+
Example 7. bootstrap.yml
+
+
+
+
spring.cloud.vault:
+    authentication: APPID
+    app-id:
+        user-id: com.examlple.MyUserIdMechanism
+
+
+
+
+
+
Example 8. MyUserIdMechanism.java
+
+
+
+
public class MyUserIdMechanism implements AppIdUserIdMechanism {
+
+  @Override
+  public String createUserId() {
+    String userId = ...
+    return userId;
+  }
+}
+
+
+
+
+
+

See also: Vault Documentation: Using the App ID auth backend

+
+
+
+
+

11.3. AppRole authentication

+
+

AppRole is intended for machine +authentication, like the deprecated (since Vault 0.6.1) AppId authentication. +AppRole authentication consists of two hard to guess (secret) tokens: RoleId and SecretId.

+
+
+

Spring Vault supports AppRole authentication by providing either RoleId only +or together with a provided SecretId (push or pull mode).

+
+
+

RoleId and optionally SecretId must be provided by configuration, +Spring Vault will not look up these or create a custom SecretId.

+
+
+
Example 9. bootstrap.yml with AppRole authentication properties
+
+
+
+
spring.cloud.vault:
+    authentication: APPROLE
+    app-role:
+        role-id: bde2076b-cccb-3cf0-d57e-bca7b1e83a52
+
+
+
+
+
+
    +
  • +

    role-id sets the RoleId.

    +
    • +
+
+
+
Example 10. bootstrap.yml with all AppRole authentication properties
+
+
+
+
spring.cloud.vault:
+    authentication: APPROLE
+    app-role:
+        role-id: bde2076b-cccb-3cf0-d57e-bca7b1e83a52
+        secret-id: 1696536f-1976-73b1-b241-0b4213908d39
+        app-auth-path: approle
+
+
+
+
+
+
    +
  • +

    role-id sets the RoleId.

    +
    • +
  • +

    secret-id sets the SecretId. SecretId can be omitted if AppRole is configured without requiring SecretId (See bind_secret_id)

    +
    • +
  • +

    approle-path sets the path of the approle authentication mount to use

    +
    • +
+
+
+

See also: Vault Documentation: Using the AppRole auth backend

+
+
+
+

11.4. AWS-EC2 authentication

+
+

The aws-ec2 +auth backend provides a secure introduction mechanism +for AWS EC2 instances, allowing automated retrieval of a Vault +token. Unlike most Vault authentication backends, this backend +does not require first-deploying, or provisioning security-sensitive +credentials (tokens, username/password, client certificates, etc.). +Instead, it treats AWS as a Trusted Third Party and uses the +cryptographically signed dynamic metadata information that uniquely +represents each EC2 instance.

+
+
+
Example 11. bootstrap.yml using AWS-EC2 Authentication
+
+
+
+
spring.cloud.vault:
+    authentication: AWS_EC2
+
+
+
+
+
+

AWS-EC2 authentication enables nonce by default to follow +the Trust On First Use (TOFU) principle. Any unintended party that +gains access to the PKCS#7 identity metadata can authenticate +against Vault.

+
+
+

During the first login, Spring Cloud Vault generates a nonce +that is stored in the auth backend aside the instance Id. +Re-authentication requires the same nonce to be sent. Any other +party does not have the nonce and can raise an alert in Vault for +further investigation.

+
+
+

The nonce is kept in memory and is lost during application restart. +You can configure a static nonce with spring.cloud.vault.aws-ec2.nonce.

+
+
+

AWS-EC2 authentication roles are optional and default to the AMI. +You can configure the authentication role by setting the +spring.cloud.vault.aws-ec2.role property.

+
+
+
Example 12. bootstrap.yml with configured role
+
+
+
+
spring.cloud.vault:
+    authentication: AWS_EC2
+    aws-ec2:
+        role: application-server
+
+
+
+
+
+
Example 13. bootstrap.yml with all AWS EC2 authentication properties
+
+
+
+
spring.cloud.vault:
+    authentication: AWS_EC2
+    aws-ec2:
+        role: application-server
+        aws-ec2-path: aws-ec2
+        identity-document: http://...
+        nonce: my-static-nonce
+
+
+
+
+
+
    +
  • +

    authentication setting this value to AWS_EC2 selects the AWS EC2 +authentication method

    +
    • +
  • +

    role sets the role name of the AWS EC2 role definition

    +
    • +
  • +

    aws-ec2-path sets the path of the AWS EC2 mount to use

    +
    • +
  • +

    identity-document sets URL of the PKCS#7 AWS EC2 identity document

    +
    • +
  • +

    nonce used for AWS-EC2 authentication. An empty nonce defaults to nonce generation

    +
    • +
+
+
+

See also: Vault Documentation: Using the aws-ec2 auth backend

+
+
+
+

11.5. TLS certificate authentication

+
+

The cert auth backend allows authentication using SSL/TLS client +certificates that are either signed by a CA or self-signed.

+
+
+

To enable cert authentication you need to:

+
+
+
    +
  1. +

    Use SSL, see Vault Client SSL configuration

    +
    2. +
  2. +

    Configure a Java Keystore that contains the client +certificate and the private key

    +
    3. +
  3. +

    Set the spring.cloud.vault.authentication to CERT

    +
    4. +
+
+
+
Example 14. bootstrap.yml
+
+
+
+
spring.cloud.vault:
+    authentication: CERT
+    ssl:
+        key-store: classpath:keystore.jks
+        key-store-password: changeit
+        cert-auth-path: cert
+
+
+
+
+
+

See also: Vault Documentation: Using the Cert auth backend

+
+
+
+

11.6. Cubbyhole authentication

+
+

Cubbyhole authentication uses Vault primitives to provide a secured authentication +workflow. Cubbyhole authentication uses tokens as primary login method. +An ephemeral token is used to obtain a second, login VaultToken from Vault’s +Cubbyhole secret backend. The login token is usually longer-lived and used to +interact with Vault. The login token will be retrieved from a wrapped +response stored at /cubbyhole/response.

+
+
+

Creating a wrapped token

+
+
+ + + + + +
+ + +Response Wrapping for token creation requires Vault 0.6.0 or higher. +
+
+
+
Example 15. Crating and storing tokens
+
+
+
+
$ vault token-create -wrap-ttl="10m"
+Key                            Value
+---                            -----
+wrapping_token:                397ccb93-ff6c-b17b-9389-380b01ca2645
+wrapping_token_ttl:            0h10m0s
+wrapping_token_creation_time:  2016-09-18 20:29:48.652957077 +0200 CEST
+wrapped_accessor:              46b6aebb-187f-932a-26d7-4f3d86a68319
+
+
+
+
+
+
Example 16. bootstrap.yml
+
+
+
+
spring.cloud.vault:
+    authentication: CUBBYHOLE
+    token: 397ccb93-ff6c-b17b-9389-380b01ca2645
+
+
+
+
+
+

See also:

+
+
+ +
+
+
+
+
+

12. Secret Backends

+
+
+

12.1. Generic Backend

+
+

Spring Cloud Vault supports at the basic level the generic secret +backend. The generic secret backend allows storage of arbitrary +values as key-value store. A single context can store one or many +key-value tuples. Contexts can be organized hierarchically. +Spring Cloud Vault allows using the Application name +and a default context name (application) in combination with active +profiles.

+
+
+
+
/secret/{application}/{profile}
+/secret/{application}
+/secret/{default-context}/{profile}
+/secret/{default-context}
+
+
+
+

The application name is determined by the properties:

+
+
+
    +
  • +

    spring.cloud.vault.generic.application-name

    +
    • +
  • +

    spring.cloud.vault.application-name

    +
    • +
  • +

    spring.application.name

    +
    • +
+
+
+

Secrets can be obtained from other folders within the generic backend by adding their +paths to the application name, separated by commas. For example, given the application +name usefulapp,mysql1,projectx/aws, each of these folders will be used:

+
+
+
    +
  • +

    /secret/usefulapp

    +
    • +
  • +

    /secret/mysql1

    +
    • +
  • +

    /secret/projectx/aws

    +
    • +
+
+
+

Spring Cloud Vault adds all active profiles to the list of possible context paths. +No active profiles will skip accessing contexts with a profile name.

+
+
+

Properties are exposed like they are stored (i.e. without additional prefixes).

+
+
+
+
+
+
spring.cloud.vault:
+    generic:
+        enabled: true
+        backend: secret
+        profile-separator: '/'
+        default-context: application
+        application-name: my-app
+
+
+
+
+
+
    +
  • +

    enabled setting this value to false disables the secret backend +config usage

    +
    • +
  • +

    backend sets the path of the secret mount to use

    +
    • +
  • +

    default-context sets the context name used by all applications

    +
    • +
  • +

    application-name overrides the application name for use in the generic backend

    +
    • +
  • +

    profile-separator separates the profile name from the context in +property sources with profiles

    +
    • +
+
+
+

See also: Vault Documentation: Using the generic secret backend

+
+
+
+

12.2. Consul

+
+

Spring Cloud Vault can obtain credentials for HashiCorp Consul. +The Consul integration requires the spring-cloud-vault-config-consul +dependency.

+
+
+
Example 17. pom.xml
+
+
+
+
<dependencies>
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-vault-config-consul</artifactId>
+        <version>Edgware.M1</version>
+    </dependency>
+</dependencies>
+
+
+
+
+
+

The integration can be enabled by setting +spring.cloud.vault.consul.enabled=true (default false) and +providing the role name with spring.cloud.vault.consul.role=….

+
+
+

The obtained token is stored in spring.cloud.consul.token +so using Spring Cloud Consul can pick up the generated +credentials without further configuration. You can configure +the property name by setting spring.cloud.vault.consul.token-property.

+
+
+
+
+
+
spring.cloud.vault:
+    consul:
+        enabled: true
+        role: readonly
+        backend: consul
+        token-property: spring.cloud.consul.token
+
+
+
+
+
+
    +
  • +

    enabled setting this value to true enables the Consul backend config usage

    +
    • +
  • +

    role sets the role name of the Consul role definition

    +
    • +
  • +

    backend sets the path of the Consul mount to use

    +
    • +
  • +

    token-property sets the property name in which the Consul ACL token is stored

    +
    • +
+
+
+

See also: Vault Documentation: Setting up Consul with Vault

+
+
+
+

12.3. RabbitMQ

+
+

Spring Cloud Vault can obtain credentials for RabbitMQ.

+
+
+

The RabbitMQ integration requires the spring-cloud-vault-config-rabbitmq +dependency.

+
+
+
Example 18. pom.xml
+
+
+
+
<dependencies>
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-vault-config-rabbitmq</artifactId>
+        <version>Edgware.M1</version>
+    </dependency>
+</dependencies>
+
+
+
+
+
+

The integration can be enabled by setting +spring.cloud.vault.rabbitmq.enabled=true (default false) +and providing the role name with spring.cloud.vault.rabbitmq.role=….

+
+
+

Username and password are stored in spring.rabbitmq.username +and spring.rabbitmq.password so using Spring Boot will pick up the generated +credentials without further configuration. You can configure the property names +by setting spring.cloud.vault.rabbitmq.username-property and +spring.cloud.vault.rabbitmq.password-property.

+
+
+
+
+
+
spring.cloud.vault:
+    rabbitmq:
+        enabled: true
+        role: readonly
+        backend: rabbitmq
+        username-property: spring.rabbitmq.username
+        password-property: spring.rabbitmq.password
+
+
+
+
+
+
    +
  • +

    enabled setting this value to true enables the RabbitMQ backend config usage

    +
    • +
  • +

    role sets the role name of the RabbitMQ role definition

    +
    • +
  • +

    backend sets the path of the RabbitMQ mount to use

    +
    • +
  • +

    username-property sets the property name in which the RabbitMQ username is stored

    +
    • +
  • +

    password-property sets the property name in which the RabbitMQ password is stored

    +
    • +
+
+
+

See also: Vault Documentation: Setting up RabbitMQ with Vault

+
+
+
+

12.4. AWS

+
+

Spring Cloud Vault can obtain credentials for AWS.

+
+
+

The AWS integration requires the spring-cloud-vault-config-aws +dependency.

+
+
+
Example 19. pom.xml
+
+
+
+
<dependencies>
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-vault-config-aws</artifactId>
+        <version>Edgware.M1</version>
+    </dependency>
+</dependencies>
+
+
+
+
+
+

The integration can be enabled by setting +spring.cloud.vault.aws=true (default false) +and providing the role name with spring.cloud.vault.aws.role=….

+
+
+

The access key and secret key are stored in cloud.aws.credentials.accessKey +and cloud.aws.credentials.secretKey so using Spring Cloud AWS will pick up the generated +credentials without further configuration. You can configure the property names +by setting spring.cloud.vault.aws.access-key-property and +spring.cloud.vault.aws.secret-key-property.

+
+
+
+
+
+
spring.cloud.vault:
+    aws:
+        enabled: true
+        role: readonly
+        backend: aws
+        access-key-property: cloud.aws.credentials.accessKey
+        secret-key-property: cloud.aws.credentials.secretKey
+
+
+
+
+
+
    +
  • +

    enabled setting this value to true enables the AWS backend config usage

    +
    • +
  • +

    role sets the role name of the AWS role definition

    +
    • +
  • +

    backend sets the path of the AWS mount to use

    +
    • +
  • +

    access-key-property sets the property name in which the AWS access key is stored

    +
    • +
  • +

    secret-key-property sets the property name in which the AWS secret key is stored

    +
    • +
+
+
+

See also: Vault Documentation: Setting up AWS with Vault

+
+
+
+
+
+

13. Database backends

+
+
+

Vault supports several database secret backends to generate database +credentials dynamically based on configured roles. This means +services that need to access a database no longer need to configure +credentials: they can request them from Vault, and use Vault’s leasing +mechanism to more easily roll keys.

+
+
+

Spring Cloud Vault integrates with these backends:

+
+
+ +
+
+

Using a database secret backend requires to enable the +backend in the configuration and the spring-cloud-vault-config-databases +dependency.

+
+
+
Example 20. pom.xml
+
+
+
+
<dependencies>
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-vault-config-databases</artifactId>
+        <version>Edgware.M1</version>
+    </dependency>
+</dependencies>
+
+
+
+
+
+ + + + + +
+ + +Enabling multiple JDBC-compliant databases will generate credentials +and store them by default in the same property keys hence property names for +JDBC secrets need to be configured separately. +
+
+
+

13.1. Apache Cassandra

+
+

Spring Cloud Vault can obtain credentials for Apache Cassandra. +The integration can be enabled by setting +spring.cloud.vault.cassandra.enabled=true (default false) and +providing the role name with spring.cloud.vault.cassandra.role=….

+
+
+

Username and password are stored in spring.data.cassandra.username +and spring.data.cassandra.password so using Spring Boot will pick +up the generated credentials without further configuration. +You can configure the property names by setting +spring.cloud.vault.cassandra.username-property and +spring.cloud.vault.cassandra.password-property.

+
+
+
+
+
+
spring.cloud.vault:
+    cassandra:
+        enabled: true
+        role: readonly
+        backend: cassandra
+        username-property: spring.data.cassandra.username
+        password-property: spring.data.cassandra.username
+
+
+
+
+
+
    +
  • +

    enabled setting this value to true enables the Cassandra backend config usage

    +
    • +
  • +

    role sets the role name of the Cassandra role definition

    +
    • +
  • +

    backend sets the path of the Cassandra mount to use

    +
    • +
  • +

    username-property sets the property name in which the Cassandra username is stored

    +
    • +
  • +

    password-property sets the property name in which the Cassandra password is stored

    +
    • +
+
+
+

See also: Vault Documentation: Setting up Apache Cassandra with Vault

+
+
+
+

13.2. MongoDB

+
+

Spring Cloud Vault can obtain credentials for MongoDB. +The integration can be enabled by setting +spring.cloud.vault.mongodb.enabled=true (default false) and +providing the role name with spring.cloud.vault.mongodb.role=….

+
+
+

Username and password are stored in spring.data.mongodb.username +and spring.data.mongodb.password so using Spring Boot will +pick up the generated credentials without further configuration. +You can configure the property names by setting +spring.cloud.vault.mongodb.username-property and +spring.cloud.vault.mongodb.password-property.

+
+
+
+
+
+
spring.cloud.vault:
+    mongodb:
+        enabled: true
+        role: readonly
+        backend: mongodb
+        username-property: spring.data.mongodb.username
+        password-property: spring.data.mongodb.password
+
+
+
+
+
+
    +
  • +

    enabled setting this value to true enables the MongodB backend config usage

    +
    • +
  • +

    role sets the role name of the MongoDB role definition

    +
    • +
  • +

    backend sets the path of the MongoDB mount to use

    +
    • +
  • +

    username-property sets the property name in which the MongoDB username is stored

    +
    • +
  • +

    password-property sets the property name in which the MongoDB password is stored

    +
    • +
+
+
+

See also: Vault Documentation: Setting up MongoDB with Vault

+
+
+
+

13.3. MySQL

+
+

Spring Cloud Vault can obtain credentials for MySQL. +The integration can be enabled by setting +spring.cloud.vault.mysql.enabled=true (default false) and +providing the role name with spring.cloud.vault.mysql.role=….

+
+
+

Username and password are stored in spring.datasource.username +and spring.datasource.password so using Spring Boot will +pick up the generated credentials without further configuration. +You can configure the property names by setting +spring.cloud.vault.mysql.username-property and +spring.cloud.vault.mysql.password-property.

+
+
+
+
+
+
spring.cloud.vault:
+    mysql:
+        enabled: true
+        role: readonly
+        backend: mysql
+        username-property: spring.datasource.username
+        password-property: spring.datasource.username
+
+
+
+
+
+
    +
  • +

    enabled setting this value to true enables the MySQL backend config usage

    +
    • +
  • +

    role sets the role name of the MySQL role definition

    +
    • +
  • +

    backend sets the path of the MySQL mount to use

    +
    • +
  • +

    username-property sets the property name in which the MySQL username is stored

    +
    • +
  • +

    password-property sets the property name in which the MySQL password is stored

    +
    • +
+
+
+

See also: Vault Documentation: Setting up MySQL with Vault

+
+
+
+

13.4. PostgreSQL

+
+

Spring Cloud Vault can obtain credentials for PostgreSQL. +The integration can be enabled by setting +spring.cloud.vault.postgresql.enabled=true (default false) and +providing the role name with spring.cloud.vault.postgresql.role=….

+
+
+

Username and password are stored in spring.datasource.username +and spring.datasource.password so using Spring Boot will +pick up the generated credentials without further configuration. +You can configure the property names by setting +spring.cloud.vault.postgresql.username-property and +spring.cloud.vault.postgresql.password-property.

+
+
+
+
+
+
spring.cloud.vault:
+    postgresql:
+        enabled: true
+        role: readonly
+        backend: postgresql
+        username-property: spring.datasource.username
+        password-property: spring.datasource.username
+
+
+
+
+
+
    +
  • +

    enabled setting this value to true enables the PostgreSQL backend config usage

    +
    • +
  • +

    role sets the role name of the PostgreSQL role definition

    +
    • +
  • +

    backend sets the path of the PostgreSQL mount to use

    +
    • +
  • +

    username-property sets the property name in which the PostgreSQL username is stored

    +
    • +
  • +

    password-property sets the property name in which the PostgreSQL password is stored

    +
    • +
+
+
+

See also: Vault Documentation: Setting up PostgreSQL with Vault

+
+
+
+
+
+

14. Configure PropertySourceLocator behavior

+
+
+

Spring Cloud Vault uses property-based configuration to create PropertySources +for generic and discovered secret backends.

+
+
+

Discovered backends provide VaultSecretBackendDescriptor beans to describe the configuration +state to use secret backend as PropertySource. A SecretBackendMetadataFactory is required +to create a SecretBackendMetadata object which contains path, name and property transformation +configuration.

+
+
+

SecretBackendMetadata is used to back a particular PropertySource.

+
+
+

You can register an arbitrary number of beans implementing VaultConfigurer for customization. +Default generic and discovered backend registration is disabled if Spring Cloud Vault discovers +at least one VaultConfigurer bean. You can however enable default registration with +SecretBackendConfigurer.registerDefaultGenericSecretBackends() and SecretBackendConfigurer.registerDefaultDiscoveredSecretBackends().

+
+
+
+
+
+
public class CustomizationBean implements VaultConfigurer {
+
+    @Override
+    public void addSecretBackends(SecretBackendConfigurer configurer) {
+
+        configurer.add("secret/my-application");
+
+        configurer.registerDefaultGenericSecretBackends(false);
+        configurer.registerDefaultDiscoveredSecretBackends(true);
+    }
+}
+
+
+
+
+
+ + + + + +
+ + +All customization is required to happen in the bootstrap context. Add your configuration +classes to META-INF/spring.factories at org.springframework.cloud.bootstrap.BootstrapConfiguration +in your application. +
+
+
+
+
+

15. Service Registry Configuration

+
+
+

You can use a DiscoveryClient (such as from Spring Cloud Consul) to locate +a Vault server by setting spring.cloud.vault.discovery.enabled=true (default false). +The net result of that is that your apps need a bootstrap.yml (or an environment variable) +with the appropriate discovery configuration. +The benefit is that the Vault can change its co-ordinates, as long as the discovery service +is a fixed point. The default service id is vault but you can change that on the client with +spring.cloud.vault.discovery.serviceId.

+
+
+

The discovery client implementations all support some kind of metadata map +(e.g. for Eureka we have eureka.instance.metadataMap). Some additional properties of the service +may need to be configured in its service registration metadata so that clients can connect +correctly. Service registries that do not provide details about transport layer security +need to provide a scheme metadata entry to be set either to https or http. +If no scheme is configured and the service is not exposed as secure service, then +configuration defaults to spring.cloud.vault.scheme which is https when it’s not set.

+
+
+
+
+
+
spring.cloud.vault.discovery:
+    enabled: true
+    service-id: my-vault-service
+
+
+
+
+
+
+
+

16. Vault Client Fail Fast

+
+
+

In some cases, it may be desirable to fail startup of a service if +it cannot connect to the Vault Server. If this is the desired +behavior, set the bootstrap configuration property +spring.cloud.vault.fail-fast=true and the client will halt with +an Exception.

+
+
+
+
+
+
spring.cloud.vault:
+    fail-fast: true
+
+
+
+
+
+
+
+

17. Vault Client SSL configuration

+
+
+

SSL can be configured declaratively by setting various properties. +You can set either javax.net.ssl.trustStore to configure +JVM-wide SSL settings or spring.cloud.vault.ssl.trust-store +to set SSL settings only for Spring Cloud Vault Config.

+
+
+
+
+
+
spring.cloud.vault:
+    ssl:
+        trust-store: classpath:keystore.jks
+        trust-store-password: changeit
+
+
+
+
+
+
    +
  • +

    trust-store sets the resource for the trust-store. SSL-secured Vault +communication will validate the Vault SSL certificate with the specified +trust-store.

    +
    • +
  • +

    trust-store-password sets the trust-store password

    +
    • +
+
+
+

Please note that configuring spring.cloud.vault.ssl.* can be only +applied when either Apache Http Components or the OkHttp client +is on your class-path.

+
+
+
+
+

18. Lease lifecycle management (renewal and revocation)

+
+
+

With every secret, Vault creates a lease: +metadata containing information such as a time duration, +renewability, and more.

+
+
+

Vault promises that the data will be valid for the given duration, +or Time To Live (TTL). Once the lease is expired, Vault can +revoke the data, and the consumer of the secret can no longer +be certain that it is valid.

+
+
+

Spring Cloud Vault maintains a lease lifecycle beyond +the creation of login tokens and secrets. That said, +login tokens and secrets associated with a lease +are scheduled for renewal just before the lease expires +until terminal expiry. +Application shutdown revokes obtained login tokens and renewable +leases.

+
+
+

Secret service and database backends (such as MongoDB or MySQL) +usually generate a renewable lease so generated credentials will +be disabled on application shutdown.

+
+
+ + + + + +
+ + +Static tokens are not renewed or revoked. +
+
+
+

Lease renewal and revocation is enabled by default and can +be disabled by setting spring.cloud.vault.config.lifecycle.enabled +to false. This is not recommended as leases can expire and +Spring Cloud Vault cannot longer access Vault or services +using generated credentials and valid credentials remain active +after application shutdown.

+
+
+
+
+
+
spring.cloud.vault:
+    config.lifecycle.enabled: true
+
+
+
+
+
+

See also: Vault Documentation: Lease, Renew, and Revoke

+
+
+
+

Appendix: Compendium of Configuration Properties

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

encrypt.fail-on-error

true

Flag to say that a process should fail if there is an encryption or decryption + error.

encrypt.key

A symmetric key. As a stronger alternative consider using a keystore.

encrypt.key-store.alias

Alias for a key in the store.

encrypt.key-store.location

Location of the key store file, e.g. classpath:/keystore.jks.

encrypt.key-store.password

Password that locks the keystore.

encrypt.key-store.secret

Secret protecting the key (defaults to the same as the password).

encrypt.rsa.algorithm

The RSA algorithm to use (DEFAULT or OEAP). Once it is set do not change it (or + existing ciphers will not a decryptable).

encrypt.rsa.salt

deadbeef

Salt for the random secret used to encrypt cipher text. Once it is set do not + change it (or existing ciphers will not a decryptable).

encrypt.rsa.strong

false

Flag to indicate that "strong" AES encryption should be used internally. If + true then the GCM algorithm is applied to the AES encrypted bytes. Default is + false (in which case "standard" CBC is used instead). Once it is set do not + change it (or existing ciphers will not a decryptable).

endpoints.bus.enabled

endpoints.bus.id

endpoints.bus.sensitive

endpoints.consul.enabled

endpoints.consul.id

endpoints.consul.sensitive

endpoints.env.post.enabled

true

Enable changing the Environment through a POST to /env.

endpoints.features.enabled

endpoints.features.id

endpoints.features.sensitive

endpoints.pause.enabled

true

Enable the /pause endpoint (to send Lifecycle.stop()).

endpoints.pause.id

endpoints.pause.sensitive

endpoints.refresh.enabled

true

Enable the /refresh endpoint to refresh configuration and re-initialize refresh scoped beans.

endpoints.refresh.id

endpoints.refresh.sensitive

endpoints.restart.enabled

true

Enable the /restart endpoint to restart the application context.

endpoints.restart.id

endpoints.restart.pause-endpoint.enabled

endpoints.restart.pause-endpoint.id

endpoints.restart.pause-endpoint.sensitive

endpoints.restart.resume-endpoint.enabled

endpoints.restart.resume-endpoint.id

endpoints.restart.resume-endpoint.sensitive

endpoints.restart.sensitive

endpoints.restart.timeout

0

endpoints.resume.enabled

true

Enable the /resume endpoint (to send Lifecycle.start()).

endpoints.resume.id

endpoints.resume.sensitive

endpoints.zookeeper.enabled

true

Enable the /zookeeper endpoint to inspect the state of zookeeper.

eureka.client.allow-redirects

false

Indicates whether server can redirect a client request to a backup server/cluster. + If set to false, the server will handle the request directly, If set to true, it + may send HTTP redirect to the client, with a new server location.

eureka.client.availability-zones

Gets the list of availability zones (used in AWS data centers) for the region in + which this instance resides. +

The changes are effective at runtime at the next registry fetch cycle as specified + by registryFetchIntervalSeconds.

eureka.client.backup-registry-impl

Gets the name of the implementation which implements BackupRegistry to fetch the + registry information as a fall back option for only the first time when the eureka + client starts. +

This may be needed for applications which needs additional resiliency for registry + information without which it cannot operate.

eureka.client.cache-refresh-executor-exponential-back-off-bound

10

Cache refresh executor exponential back off related property. It is a maximum + multiplier value for retry delay, in case where a sequence of timeouts occurred.

eureka.client.cache-refresh-executor-thread-pool-size

2

The thread pool size for the cacheRefreshExecutor to initialise with

eureka.client.client-data-accept

EurekaAccept name for client data accept

eureka.client.decoder-name

This is a transient config and once the latest codecs are stable, can be removed + (as there will only be one)

eureka.client.disable-delta

false

Indicates whether the eureka client should disable fetching of delta and should + rather resort to getting the full registry information. +

Note that the delta fetches can reduce the traffic tremendously, because the rate + of change with the eureka server is normally much lower than the rate of fetches. +

The changes are effective at runtime at the next registry fetch cycle as specified + by registryFetchIntervalSeconds

eureka.client.dollar-replacement

_-

Get a replacement string for Dollar sign <code>$</code> during + serializing/deserializing information in eureka server.

eureka.client.enabled

true

Flag to indicate that the Eureka client is enabled.

eureka.client.encoder-name

This is a transient config and once the latest codecs are stable, can be removed + (as there will only be one)

eureka.client.escape-char-replacement

__

Get a replacement string for underscore sign <code>_</code> during + serializing/deserializing information in eureka server.

eureka.client.eureka-connection-idle-timeout-seconds

30

Indicates how much time (in seconds) that the HTTP connections to eureka server can + stay idle before it can be closed. +

In the AWS environment, it is recommended that the values is 30 seconds or less, + since the firewall cleans up the connection information after a few mins leaving + the connection hanging in limbo

eureka.client.eureka-server-connect-timeout-seconds

5

Indicates how long to wait (in seconds) before a connection to eureka server needs + to timeout. Note that the connections in the client are pooled by + org.apache.http.client.HttpClient and this setting affects the actual connection + creation and also the wait time to get the connection from the pool.

eureka.client.eureka-server-d-n-s-name

Gets the DNS name to be queried to get the list of eureka servers.This information + is not required if the contract returns the service urls by implementing + serviceUrls. +

The DNS mechanism is used when useDnsForFetchingServiceUrls is set to true and the + eureka client expects the DNS to configured a certain way so that it can fetch + changing eureka servers dynamically. +

The changes are effective at runtime.

eureka.client.eureka-server-port

Gets the port to be used to construct the service url to contact eureka server when + the list of eureka servers come from the DNS.This information is not required if + the contract returns the service urls eurekaServerServiceUrls(String). +

The DNS mechanism is used when useDnsForFetchingServiceUrls is set to true and the + eureka client expects the DNS to configured a certain way so that it can fetch + changing eureka servers dynamically. +

The changes are effective at runtime.

eureka.client.eureka-server-read-timeout-seconds

8

Indicates how long to wait (in seconds) before a read from eureka server needs to + timeout.

eureka.client.eureka-server-total-connections

200

Gets the total number of connections that is allowed from eureka client to all + eureka servers.

eureka.client.eureka-server-total-connections-per-host

50

Gets the total number of connections that is allowed from eureka client to a eureka + server host.

eureka.client.eureka-server-u-r-l-context

Gets the URL context to be used to construct the service url to contact eureka + server when the list of eureka servers come from the DNS. This information is not + required if the contract returns the service urls from eurekaServerServiceUrls. +

The DNS mechanism is used when useDnsForFetchingServiceUrls is set to true and the + eureka client expects the DNS to configured a certain way so that it can fetch + changing eureka servers dynamically. The changes are effective at runtime.

eureka.client.eureka-service-url-poll-interval-seconds

0

Indicates how often(in seconds) to poll for changes to eureka server information. + Eureka servers could be added or removed and this setting controls how soon the + eureka clients should know about it.

eureka.client.fetch-registry

true

Indicates whether this client should fetch eureka registry information from eureka + server.

eureka.client.fetch-remote-regions-registry

Comma separated list of regions for which the eureka registry information will be + fetched. It is mandatory to define the availability zones for each of these regions + as returned by availabilityZones. Failing to do so, will result in failure of + discovery client startup.

eureka.client.filter-only-up-instances

true

Indicates whether to get the applications after filtering the applications for + instances with only InstanceStatus UP states.

eureka.client.g-zip-content

true

Indicates whether the content fetched from eureka server has to be compressed + whenever it is supported by the server. The registry information from the eureka + server is compressed for optimum network traffic.

eureka.client.heartbeat-executor-exponential-back-off-bound

10

Heartbeat executor exponential back off related property. It is a maximum + multiplier value for retry delay, in case where a sequence of timeouts occurred.

eureka.client.heartbeat-executor-thread-pool-size

2

The thread pool size for the heartbeatExecutor to initialise with

eureka.client.initial-instance-info-replication-interval-seconds

40

Indicates how long initially (in seconds) to replicate instance info to the eureka + server

eureka.client.instance-info-replication-interval-seconds

30

Indicates how often(in seconds) to replicate instance changes to be replicated to + the eureka server.

eureka.client.log-delta-diff

false

Indicates whether to log differences between the eureka server and the eureka + client in terms of registry information. +

Eureka client tries to retrieve only delta changes from eureka server to minimize + network traffic. After receiving the deltas, eureka client reconciles the + information from the server to verify it has not missed out some information. + Reconciliation failures could happen when the client has had network issues + communicating to server.If the reconciliation fails, eureka client gets the full + registry information. +

While getting the full registry information, the eureka client can log the + differences between the client and the server and this setting controls that. +

The changes are effective at runtime at the next registry fetch cycle as specified + by registryFetchIntervalSecondsr

eureka.client.on-demand-update-status-change

true

If set to true, local status updates via ApplicationInfoManager will trigger + on-demand (but rate limited) register/updates to remote eureka servers

eureka.client.prefer-same-zone-eureka

true

Indicates whether or not this instance should try to use the eureka server in the + same zone for latency and/or other reason. +

Ideally eureka clients are configured to talk to servers in the same zone +

The changes are effective at runtime at the next registry fetch cycle as specified + by registryFetchIntervalSeconds

eureka.client.property-resolver

eureka.client.proxy-host

Gets the proxy host to eureka server if any.

eureka.client.proxy-password

Gets the proxy password if any.

eureka.client.proxy-port

Gets the proxy port to eureka server if any.

eureka.client.proxy-user-name

Gets the proxy user name if any.

eureka.client.region

us-east-1

Gets the region (used in AWS datacenters) where this instance resides.

eureka.client.register-with-eureka

true

Indicates whether or not this instance should register its information with eureka + server for discovery by others. +

In some cases, you do not want your instances to be discovered whereas you just + want do discover other instances.

eureka.client.registry-fetch-interval-seconds

30

Indicates how often(in seconds) to fetch the registry information from the eureka + server.

eureka.client.registry-refresh-single-vip-address

Indicates whether the client is only interested in the registry information for a + single VIP.

eureka.client.service-url

Map of availability zone to list of fully qualified URLs to communicate with eureka + server. Each value can be a single URL or a comma separated list of alternative + locations. +

Typically the eureka server URLs carry protocol,host,port,context and version + information if any. Example: + http://ec2-256-156-243-129.compute-1.amazonaws.com:7001/eureka/ +

The changes are effective at runtime at the next service url refresh cycle as + specified by eurekaServiceUrlPollIntervalSeconds.

eureka.client.transport

eureka.client.use-dns-for-fetching-service-urls

false

Indicates whether the eureka client should use the DNS mechanism to fetch a list of + eureka servers to talk to. When the DNS name is updated to have additional servers, + that information is used immediately after the eureka client polls for that + information as specified in eurekaServiceUrlPollIntervalSeconds. +

Alternatively, the service urls can be returned serviceUrls, but the users should + implement their own mechanism to return the updated list in case of changes. +

The changes are effective at runtime.

eureka.dashboard.enabled

true

Flag to enable the Eureka dashboard. Default true.

eureka.dashboard.path

/

The path to the Eureka dashboard (relative to the servlet path). Defaults to "/".

eureka.instance.a-s-g-name

Gets the AWS autoscaling group name associated with this instance. This information + is specifically used in an AWS environment to automatically put an instance out of + service after the instance is launched and it has been disabled for traffic..

eureka.instance.app-group-name

Get the name of the application group to be registered with eureka.

eureka.instance.appname

unknown

Get the name of the application to be registered with eureka.

eureka.instance.data-center-info

Returns the data center this instance is deployed. This information is used to get + some AWS specific instance information if the instance is deployed in AWS.

eureka.instance.default-address-resolution-order

[]

eureka.instance.environment

eureka.instance.health-check-url

Gets the absolute health check page URL for this instance. The users can provide + the healthCheckUrlPath if the health check page resides in the same instance + talking to eureka, else in the cases where the instance is a proxy for some other + server, users can provide the full URL. If the full URL is provided it takes + precedence. +

<p> + It is normally used for making educated decisions based on the health of the + instance - for example, it can be used to determine whether to proceed deployments + to an entire farm or stop the deployments without causing further damage. The full + URL should follow the format http://${eureka.hostname}:7001/ where the value + ${eureka.hostname} is replaced at runtime.

eureka.instance.health-check-url-path

/health

Gets the relative health check URL path for this instance. The health check page + URL is then constructed out of the hostname and the type of communication - secure + or unsecure as specified in securePort and nonSecurePort. +

It is normally used for making educated decisions based on the health of the + instance - for example, it can be used to determine whether to proceed deployments + to an entire farm or stop the deployments without causing further damage.

eureka.instance.home-page-url

Gets the absolute home page URL for this instance. The users can provide the + homePageUrlPath if the home page resides in the same instance talking to eureka, + else in the cases where the instance is a proxy for some other server, users can + provide the full URL. If the full URL is provided it takes precedence. +

It is normally used for informational purposes for other services to use it as a + landing page. The full URL should follow the format http://${eureka.hostname}:7001/ + where the value ${eureka.hostname} is replaced at runtime.

eureka.instance.home-page-url-path

/

Gets the relative home page URL Path for this instance. The home page URL is then + constructed out of the hostName and the type of communication - secure or unsecure. +

It is normally used for informational purposes for other services to use it as a + landing page.

eureka.instance.host-info

eureka.instance.hostname

The hostname if it can be determined at configuration time (otherwise it will be + guessed from OS primitives).

eureka.instance.inet-utils

eureka.instance.initial-status

Initial status to register with rmeote Eureka server.

eureka.instance.instance-enabled-onit

false

Indicates whether the instance should be enabled for taking traffic as soon as it + is registered with eureka. Sometimes the application might need to do some + pre-processing before it is ready to take traffic.

eureka.instance.instance-id

Get the unique Id (within the scope of the appName) of this instance to be + registered with eureka.

eureka.instance.ip-address

Get the IPAdress of the instance. This information is for academic purposes only as + the communication from other instances primarily happen using the information + supplied in {@link #getHostName(boolean)}.

eureka.instance.lease-expiration-duration-in-seconds

90

Indicates the time in seconds that the eureka server waits since it received the + last heartbeat before it can remove this instance from its view and there by + disallowing traffic to this instance. +

Setting this value too long could mean that the traffic could be routed to the + instance even though the instance is not alive. Setting this value too small could + mean, the instance may be taken out of traffic because of temporary network + glitches.This value to be set to atleast higher than the value specified in + leaseRenewalIntervalInSeconds.

eureka.instance.lease-renewal-interval-in-seconds

30

Indicates how often (in seconds) the eureka client needs to send heartbeats to + eureka server to indicate that it is still alive. If the heartbeats are not + received for the period specified in leaseExpirationDurationInSeconds, eureka + server will remove the instance from its view, there by disallowing traffic to this + instance. +

Note that the instance could still not take traffic if it implements + HealthCheckCallback and then decides to make itself unavailable.

eureka.instance.metadata-map

Gets the metadata name/value pairs associated with this instance. This information + is sent to eureka server and can be used by other instances.

eureka.instance.namespace

eureka

Get the namespace used to find properties. Ignored in Spring Cloud.

eureka.instance.non-secure-port

80

Get the non-secure port on which the instance should receive traffic.

eureka.instance.non-secure-port-enabled

true

Indicates whether the non-secure port should be enabled for traffic or not.

eureka.instance.prefer-ip-address

false

Flag to say that, when guessing a hostname, the IP address of the server should be + used in prference to the hostname reported by the OS.

eureka.instance.registry.default-open-for-traffic-count

1

Value used in determining when leases are cancelled, default to 1 for standalone. + Should be set to 0 for peer replicated eurekas

eureka.instance.registry.expected-number-of-renews-per-min

1

eureka.instance.secure-health-check-url

Gets the absolute secure health check page URL for this instance. The users can + provide the secureHealthCheckUrl if the health check page resides in the same + instance talking to eureka, else in the cases where the instance is a proxy for + some other server, users can provide the full URL. If the full URL is provided it + takes precedence. +

<p> + It is normally used for making educated decisions based on the health of the + instance - for example, it can be used to determine whether to proceed deployments + to an entire farm or stop the deployments without causing further damage. The full + URL should follow the format http://${eureka.hostname}:7001/ where the value + ${eureka.hostname} is replaced at runtime.

eureka.instance.secure-port

443

Get the Secure port on which the instance should receive traffic.

eureka.instance.secure-port-enabled

false

Indicates whether the secure port should be enabled for traffic or not.

eureka.instance.secure-virtual-host-name

unknown

Gets the secure virtual host name defined for this instance. +

This is typically the way other instance would find this instance by using the + secure virtual host name.Think of this as similar to the fully qualified domain + name, that the users of your services will need to find this instance.

eureka.instance.status-page-url

Gets the absolute status page URL path for this instance. The users can provide the + statusPageUrlPath if the status page resides in the same instance talking to + eureka, else in the cases where the instance is a proxy for some other server, + users can provide the full URL. If the full URL is provided it takes precedence. +

It is normally used for informational purposes for other services to find about the + status of this instance. Users can provide a simple HTML indicating what is the + current status of the instance.

eureka.instance.status-page-url-path

/info

Gets the relative status page URL path for this instance. The status page URL is + then constructed out of the hostName and the type of communication - secure or + unsecure as specified in securePort and nonSecurePort. +

It is normally used for informational purposes for other services to find about the + status of this instance. Users can provide a simple HTML indicating what is the + current status of the instance.

eureka.instance.virtual-host-name

unknown

Gets the virtual host name defined for this instance. +

This is typically the way other instance would find this instance by using the + virtual host name.Think of this as similar to the fully qualified domain name, that + the users of your services will need to find this instance.

eureka.server.a-s-g-cache-expiry-timeout-ms

0

eureka.server.a-s-g-query-timeout-ms

300

eureka.server.a-s-g-update-interval-ms

0

eureka.server.a-w-s-access-id

eureka.server.a-w-s-secret-key

eureka.server.batch-replication

false

eureka.server.binding-strategy

eureka.server.delta-retention-timer-interval-in-ms

0

eureka.server.disable-delta

false

eureka.server.disable-delta-for-remote-regions

false

eureka.server.disable-transparent-fallback-to-other-region

false

eureka.server.e-i-p-bind-rebind-retries

3

eureka.server.e-i-p-binding-retry-interval-ms

0

eureka.server.e-i-p-binding-retry-interval-ms-when-unbound

0

eureka.server.enable-replicated-request-compression

false

eureka.server.enable-self-preservation

true

eureka.server.eviction-interval-timer-in-ms

0

eureka.server.g-zip-content-from-remote-region

true

eureka.server.json-codec-name

eureka.server.list-auto-scaling-groups-role-name

ListAutoScalingGroups

eureka.server.log-identity-headers

true

eureka.server.max-elements-in-peer-replication-pool

10000

eureka.server.max-elements-in-status-replication-pool

10000

eureka.server.max-idle-thread-age-in-minutes-for-peer-replication

15

eureka.server.max-idle-thread-in-minutes-age-for-status-replication

10

eureka.server.max-threads-for-peer-replication

20

eureka.server.max-threads-for-status-replication

1

eureka.server.max-time-for-replication

30000

eureka.server.min-threads-for-peer-replication

5

eureka.server.min-threads-for-status-replication

1

eureka.server.number-of-replication-retries

5

eureka.server.peer-eureka-nodes-update-interval-ms

0

eureka.server.peer-eureka-status-refresh-time-interval-ms

0

eureka.server.peer-node-connect-timeout-ms

200

eureka.server.peer-node-connection-idle-timeout-seconds

30

eureka.server.peer-node-read-timeout-ms

200

eureka.server.peer-node-total-connections

1000

eureka.server.peer-node-total-connections-per-host

500

eureka.server.prime-aws-replica-connections

true

eureka.server.property-resolver

eureka.server.rate-limiter-burst-size

10

eureka.server.rate-limiter-enabled

false

eureka.server.rate-limiter-full-fetch-average-rate

100

eureka.server.rate-limiter-privileged-clients

eureka.server.rate-limiter-registry-fetch-average-rate

500

eureka.server.rate-limiter-throttle-standard-clients

false

eureka.server.registry-sync-retries

0

eureka.server.registry-sync-retry-wait-ms

0

eureka.server.remote-region-app-whitelist

eureka.server.remote-region-connect-timeout-ms

1000

eureka.server.remote-region-connection-idle-timeout-seconds

30

eureka.server.remote-region-fetch-thread-pool-size

20

eureka.server.remote-region-read-timeout-ms

1000

eureka.server.remote-region-registry-fetch-interval

30

eureka.server.remote-region-total-connections

1000

eureka.server.remote-region-total-connections-per-host

500

eureka.server.remote-region-trust-store

eureka.server.remote-region-trust-store-password

changeit

eureka.server.remote-region-urls

eureka.server.remote-region-urls-with-name

eureka.server.renewal-percent-threshold

0.85

eureka.server.renewal-threshold-update-interval-ms

0

eureka.server.response-cache-auto-expiration-in-seconds

180

eureka.server.response-cache-update-interval-ms

0

eureka.server.retention-time-in-m-s-in-delta-queue

0

eureka.server.route53-bind-rebind-retries

3

eureka.server.route53-binding-retry-interval-ms

0

eureka.server.route53-domain-t-t-l

30

eureka.server.sync-when-timestamp-differs

true

eureka.server.use-read-only-response-cache

true

eureka.server.wait-time-in-ms-when-sync-empty

0

eureka.server.xml-codec-name

feign.compression.request.mime-types

[text/xml, application/xml, application/json]

The list of supported mime types.

feign.compression.request.min-request-size

2048

The minimum threshold content size.

health.config.enabled

false

Flag to indicate that the config server health indicator should be installed.

health.config.time-to-live

0

Time to live for cached result, in milliseconds. Default 300000 (5 min).

hystrix.metrics.enabled

true

Enable Hystrix metrics polling. Defaults to true.

hystrix.metrics.polling-interval-ms

2000

Interval between subsequent polling of metrics. Defaults to 2000 ms.

management.health.refresh.enabled

true

Enable the health endpoint for the refresh scope.

management.health.zookeeper.enabled

true

Enable the health endpoint for zookeeper.

netflix.atlas.batch-size

10000

netflix.atlas.enabled

true

netflix.atlas.uri

netflix.metrics.servo.cache-warning-threshold

1000

When the ServoMonitorCache reaches this size, a warning is logged. + This will be useful if you are using string concatenation in RestTemplate urls.

netflix.metrics.servo.registry-class

com.netflix.servo.BasicMonitorRegistry

Fully qualified class name for monitor registry used by Servo.

proxy.auth.load-balanced

proxy.auth.routes

Authentication strategy per route.

spring.cloud.bus.ack.destination-service

Service that wants to listen to acks. By default null (meaning all services).

spring.cloud.bus.ack.enabled

true

Flag to switch off acks (default on).

spring.cloud.bus.destination

springCloudBus

Name of Spring Cloud Stream destination for messages.

spring.cloud.bus.enabled

true

Flag to indicate that the bus is enabled.

spring.cloud.bus.env.enabled

true

Flag to switch off environment change events (default on).

spring.cloud.bus.refresh.enabled

true

Flag to switch off refresh events (default on).

spring.cloud.bus.trace.enabled

false

Flag to switch on tracing of acks (default off).

spring.cloud.cloudfoundry.discovery.enabled

true

Flag to indicate that discovery is enabled.

spring.cloud.cloudfoundry.discovery.heartbeat-frequency

5000

Frequency in milliseconds of poll for heart beat. The client will poll on this + frequency and broadcast a list of service ids.

spring.cloud.cloudfoundry.discovery.org

Organization name to authenticate with (default to user’s default).

spring.cloud.cloudfoundry.discovery.password

Password for user to authenticate and obtain token.

spring.cloud.cloudfoundry.discovery.space

Space name to authenticate with (default to user’s default).

spring.cloud.cloudfoundry.discovery.url

https://api.run.pivotal.io

URL of Cloud Foundry API (Cloud Controller).

spring.cloud.cloudfoundry.discovery.username

Username to authenticate (usually an email address).

spring.cloud.config.allow-override

true

Flag to indicate that {@link #isSystemPropertiesOverride() + systemPropertiesOverride} can be used. Set to false to prevent users from changing + the default accidentally. Default true.

spring.cloud.config.authorization

Authorization token used by the client to connect to the server.

spring.cloud.config.discovery.enabled

false

Flag to indicate that config server discovery is enabled (config server URL will be + looked up via discovery).

spring.cloud.config.discovery.service-id

configserver

Service id to locate config server.

spring.cloud.config.enabled

true

Flag to say that remote configuration is enabled. Default true;

spring.cloud.config.fail-fast

false

Flag to indicate that failure to connect to the server is fatal (default false).

spring.cloud.config.label

The label name to use to pull remote configuration properties. The default is set + on the server (generally "master" for a git based server).

spring.cloud.config.name

Name of application used to fetch remote properties.

spring.cloud.config.override-none

false

Flag to indicate that when {@link #setAllowOverride(boolean) allowOverride} is + true, external properties should take lowest priority, and not override any + existing property sources (including local config files). Default false.

spring.cloud.config.override-system-properties

true

Flag to indicate that the external properties should override system properties. + Default true.

spring.cloud.config.password

The password to use (HTTP Basic) when contacting the remote server.

spring.cloud.config.profile

default

The default profile to use when fetching remote configuration (comma-separated). + Default is "default".

spring.cloud.config.retry.initial-interval

1000

Initial retry interval in milliseconds.

spring.cloud.config.retry.max-attempts

6

Maximum number of attempts.

spring.cloud.config.retry.max-interval

2000

Maximum interval for backoff.

spring.cloud.config.retry.multiplier

1.1

Multiplier for next interval.

spring.cloud.config.server.bootstrap

false

Flag indicating that the config server should initialize its own Environment with + properties from the remote repository. Off by default because it delays startup but + can be useful when embedding the server in another application.

spring.cloud.config.server.default-application-name

application

Default application name when incoming requests do not have a specific one.

spring.cloud.config.server.default-label

Default repository label when incoming requests do not have a specific label.

spring.cloud.config.server.default-profile

default

Default application profile when incoming requests do not have a specific one.

spring.cloud.config.server.encrypt.enabled

true

Enable decryption of environment properties before sending to client.

spring.cloud.config.server.git.basedir

Base directory for local working copy of repository.

spring.cloud.config.server.git.clone-on-start

Flag to indicate that the repository should be cloned on startup (not on demand). + Generally leads to slower startup but faster first query.

spring.cloud.config.server.git.default-label

spring.cloud.config.server.git.environment

spring.cloud.config.server.git.force-pull

Flag to indicate that the repository should force pull. If true discard any local + changes and take from remote repository.

spring.cloud.config.server.git.git-factory

spring.cloud.config.server.git.password

Password for authentication with remote repository.

spring.cloud.config.server.git.repos

Map of repository identifier to location and other properties.

spring.cloud.config.server.git.search-paths

Search paths to use within local working copy. By default searches only the root.

spring.cloud.config.server.git.timeout

Timeout (in seconds) for obtaining HTTP or SSH connection (if applicable). Default + 5 seconds.

spring.cloud.config.server.git.uri

URI of remote repository.

spring.cloud.config.server.git.username

Username for authentication with remote repository.

spring.cloud.config.server.health.repositories

spring.cloud.config.server.native.fail-on-error

false

Flag to determine how to handle exceptions during decryption (default false).

spring.cloud.config.server.native.search-locations

[]

Locations to search for configuration files. Defaults to the same as a Spring Boot + app so [classpath:/,classpath:/config/,file:./,file:./config/].

spring.cloud.config.server.native.version

Version string to be reported for native repository

spring.cloud.config.server.overrides

Extra map for a property source to be sent to all clients unconditionally.

spring.cloud.config.server.prefix

Prefix for configuration resource paths (default is empty). Useful when embedding + in another application when you don’t want to change the context path or servlet + path.

spring.cloud.config.server.strip-document-from-yaml

true

Flag to indicate that YAML documents that are text or collections (not a map) + should be returned in "native" form.

spring.cloud.config.server.svn.basedir

Base directory for local working copy of repository.

spring.cloud.config.server.svn.default-label

trunk

The default label for environment properties requests.

spring.cloud.config.server.svn.environment

spring.cloud.config.server.svn.password

Password for authentication with remote repository.

spring.cloud.config.server.svn.search-paths

Search paths to use within local working copy. By default searches only the root.

spring.cloud.config.server.svn.uri

URI of remote repository.

spring.cloud.config.server.svn.username

Username for authentication with remote repository.

spring.cloud.config.token

Security Token passed thru to underlying environment repository.

spring.cloud.config.uri

http://localhost:8888

The URI of the remote server (default http://localhost:8888).

spring.cloud.config.username

The username to use (HTTP Basic) when contacting the remote server.

spring.cloud.consul.config.acl-token

spring.cloud.consul.config.data-key

data

If format is Format.PROPERTIES or Format.YAML + then the following field is used as key to look up consul for configuration.

spring.cloud.consul.config.default-context

application

spring.cloud.consul.config.enabled

true

spring.cloud.consul.config.fail-fast

true

Throw exceptions during config lookup if true, otherwise, log warnings.

spring.cloud.consul.config.format

spring.cloud.consul.config.prefix

config

spring.cloud.consul.config.profile-separator

,

spring.cloud.consul.config.watch.delay

1000

The value of the fixed delay for the watch in millis. Defaults to 1000.

spring.cloud.consul.config.watch.enabled

true

If the watch is enabled. Defaults to true.

spring.cloud.consul.config.watch.wait-time

55

The number of seconds to wait (or block) for watch query, defaults to 55. + Needs to be less than default ConsulClient (defaults to 60). To increase ConsulClient + timeout create a ConsulClient bean with a custom ConsulRawClient with a custom + HttpClient.

spring.cloud.consul.discovery.acl-token

spring.cloud.consul.discovery.catalog-services-watch-delay

10

spring.cloud.consul.discovery.catalog-services-watch-timeout

2

spring.cloud.consul.discovery.default-query-tag

Tag to query for in service list if one is not listed in serverListQueryTags.

spring.cloud.consul.discovery.default-zone-metadata-name

zone

Service instance zone comes from metadata. + This allows changing the metadata tag name.

spring.cloud.consul.discovery.enabled

true

Is service discovery enabled?

spring.cloud.consul.discovery.fail-fast

true

Throw exceptions during service registration if true, otherwise, log + warnings (defaults to true).

spring.cloud.consul.discovery.health-check-interval

10s

How often to perform the health check (e.g. 10s)

spring.cloud.consul.discovery.health-check-path

/health

Alternate server path to invoke for health checking

spring.cloud.consul.discovery.health-check-timeout

Timeout for health check (e.g. 10s)

spring.cloud.consul.discovery.health-check-url

Custom health check url to override default

spring.cloud.consul.discovery.heartbeat.enabled

false

spring.cloud.consul.discovery.heartbeat.heartbeat-interval

spring.cloud.consul.discovery.heartbeat.interval-ratio

spring.cloud.consul.discovery.heartbeat.ttl-unit

s

spring.cloud.consul.discovery.heartbeat.ttl-value

30

spring.cloud.consul.discovery.host-info

spring.cloud.consul.discovery.hostname

Hostname to use when accessing server

spring.cloud.consul.discovery.instance-id

Unique service instance id

spring.cloud.consul.discovery.instance-zone

Service instance zone

spring.cloud.consul.discovery.ip-address

IP address to use when accessing service (must also set preferIpAddress + to use)

spring.cloud.consul.discovery.lifecycle.enabled

true

spring.cloud.consul.discovery.management-port

Port to register the management service under (defaults to management port)

spring.cloud.consul.discovery.management-suffix

management

Suffix to use when registering management service

spring.cloud.consul.discovery.management-tags

Tags to use when registering management service

spring.cloud.consul.discovery.port

Port to register the service under (defaults to listening port)

spring.cloud.consul.discovery.prefer-agent-address

false

Source of how we will determine the address to use

spring.cloud.consul.discovery.prefer-ip-address

false

Use ip address rather than hostname during registration

spring.cloud.consul.discovery.query-passing

false

Add the 'passing` parameter to /v1/health/service/serviceName. + This pushes health check passing to the server.

spring.cloud.consul.discovery.register

true

Register as a service in consul.

spring.cloud.consul.discovery.register-health-check

true

Register health check in consul. Useful during development of a service.

spring.cloud.consul.discovery.scheme

http

Whether to register an http or https service

spring.cloud.consul.discovery.server-list-query-tags

Map of serviceId’s → tag to query for in server list. + This allows filtering services by a single tag.

spring.cloud.consul.discovery.service-name

Service name

spring.cloud.consul.discovery.tags

Tags to use when registering service

spring.cloud.consul.enabled

true

Is spring cloud consul enabled

spring.cloud.consul.host

localhost

Consul agent hostname. Defaults to 'localhost'.

spring.cloud.consul.port

8500

Consul agent port. Defaults to '8500'.

spring.cloud.consul.retry.initial-interval

1000

Initial retry interval in milliseconds.

spring.cloud.consul.retry.max-attempts

6

Maximum number of attempts.

spring.cloud.consul.retry.max-interval

2000

Maximum interval for backoff.

spring.cloud.consul.retry.multiplier

1.1

Multiplier for next interval.

spring.cloud.hypermedia.refresh.fixed-delay

5000

spring.cloud.hypermedia.refresh.initial-delay

10000

spring.cloud.inetutils.default-hostname

localhost

The default hostname. Used in case of errors.

spring.cloud.inetutils.default-ip-address

127.0.0.1

The default ipaddress. Used in case of errors.

spring.cloud.inetutils.ignored-interfaces

List of Java regex expressions for network interfaces that will be ignored.

spring.cloud.inetutils.preferred-networks

List of Java regex expressions for network addresses that will be ignored.

spring.cloud.inetutils.timeout-seconds

1

Timeout in seconds for calculating hostname.

spring.cloud.inetutils.use-only-site-local-interfaces

false

Use only interfaces with site local addresses. See {@link InetAddress#isSiteLocalAddress()} for more details.

spring.cloud.loadbalancer.retry.enabled

false

spring.cloud.stream.binders

spring.cloud.stream.bindings

spring.cloud.stream.consul.binder.event-timeout

5

spring.cloud.stream.consumer-defaults

spring.cloud.stream.default-binder

spring.cloud.stream.dynamic-destinations

[]

spring.cloud.stream.ignore-unknown-properties

true

spring.cloud.stream.instance-count

1

spring.cloud.stream.instance-index

0

spring.cloud.stream.producer-defaults

spring.cloud.stream.rabbit.binder.admin-adresses

[]

spring.cloud.stream.rabbit.binder.compression-level

0

spring.cloud.stream.rabbit.binder.nodes

[]

spring.cloud.stream.rabbit.bindings

spring.cloud.zookeeper.base-sleep-time-ms

50

Initial amount of time to wait between retries

spring.cloud.zookeeper.block-until-connected-unit

The unit of time related to blocking on connection to Zookeeper

spring.cloud.zookeeper.block-until-connected-wait

10

Wait time to block on connection to Zookeeper

spring.cloud.zookeeper.connect-string

localhost:2181

Connection string to the Zookeeper cluster

spring.cloud.zookeeper.default-health-endpoint

Default health endpoint that will be checked to verify that a dependency is alive

spring.cloud.zookeeper.dependencies

Mapping of alias to ZookeeperDependency. From Ribbon perspective the alias + is actually serviceID since Ribbon can’t accept nested structures in serviceID

spring.cloud.zookeeper.dependency-configurations

spring.cloud.zookeeper.dependency-names

spring.cloud.zookeeper.discovery.enabled

true

spring.cloud.zookeeper.discovery.instance-host

Predefined host with which a service can register itself in Zookeeper. Corresponds + to the {code address} from the URI spec.

spring.cloud.zookeeper.discovery.instance-port

Port to register the service under (defaults to listening port)

spring.cloud.zookeeper.discovery.metadata

Gets the metadata name/value pairs associated with this instance. This information + is sent to zookeeper and can be used by other instances.

spring.cloud.zookeeper.discovery.register

true

Register as a service in zookeeper.

spring.cloud.zookeeper.discovery.root

/services

Root Zookeeper folder in which all instances are registered

spring.cloud.zookeeper.discovery.uri-spec

{scheme}://{address}:{port}

The URI specification to resolve during service registration in Zookeeper

spring.cloud.zookeeper.enabled

true

Is Zookeeper enabled

spring.cloud.zookeeper.max-retries

10

Max number of times to retry

spring.cloud.zookeeper.max-sleep-ms

500

Max time in ms to sleep on each retry

spring.cloud.zookeeper.prefix

Common prefix that will be applied to all Zookeeper dependencies' paths

spring.integration.poller.fixed-delay

1000

Fixed delay for default poller.

spring.integration.poller.max-messages-per-poll

1

Maximum messages per poll for the default poller.

spring.sleuth.integration.enabled

true

Enable Spring Integration sleuth instrumentation.

spring.sleuth.integration.patterns

*

An array of simple patterns against which channel names will be matched. Default is * (all channels). See org.springframework.util.PatternMatchUtils.simpleMatch(String, String).

spring.sleuth.keys.async.class-name-key

class

Simple name of the class with a method annotated with {@code @Async} + from which the asynchronous process started +

@see org.springframework.scheduling.annotation.Async

spring.sleuth.keys.async.method-name-key

method

Name of the method annotated with {@code @Async} +

@see org.springframework.scheduling.annotation.Async

spring.sleuth.keys.async.prefix

Prefix for header names if they are added as tags.

spring.sleuth.keys.async.thread-name-key

thread

Name of the thread that executed the async method +

@see org.springframework.scheduling.annotation.Async

spring.sleuth.keys.http.headers

Additional headers that should be added as tags if they exist. If the header + value is multi-valued, the tag value will be a comma-separated, single-quoted + list.

spring.sleuth.keys.http.host

http.host

The domain portion of the URL or host header. Example: + "mybucket.s3.amazonaws.com". Used to filter by host as opposed to ip address.

spring.sleuth.keys.http.method

http.method

The HTTP method, or verb, such as "GET" or "POST". Used to filter against an + http route.

spring.sleuth.keys.http.path

http.path

The absolute http path, without any query parameters. Example: + "/objects/abcd-ff". Used to filter against an http route, portably with zipkin + v1. In zipkin v1, only equals filters are supported. Dropping query parameters + makes the number of distinct URIs less. For example, one can query for the same + resource, regardless of signing parameters encoded in the query line. This does + not reduce cardinality to a HTTP single route. For example, it is common to + express a route as an http URI template like "/resource/{resource_id}". In + systems where only equals queries are available, searching for + {@code http.uri=/resource} won’t match if the actual request was + "/resource/abcd-ff". Historical note: This was commonly expressed as "http.uri" + in zipkin, eventhough it was most often just a path.

spring.sleuth.keys.http.prefix

http.

Prefix for header names if they are added as tags.

spring.sleuth.keys.http.request-size

http.request.size

The size of the non-empty HTTP request body, in bytes. Ex. "16384" +

<p>Large uploads can exceed limits or contribute directly to latency.

spring.sleuth.keys.http.response-size

http.response.size

The size of the non-empty HTTP response body, in bytes. Ex. "16384" +

<p>Large downloads can exceed limits or contribute directly to latency.

spring.sleuth.keys.http.status-code

http.status_code

The HTTP response code, when not in 2xx range. Ex. "503" Used to filter for + error status. 2xx range are not logged as success codes are less interesting + for latency troubleshooting. Omitting saves at least 20 bytes per span.

spring.sleuth.keys.http.url

http.url

The entire URL, including the scheme, host and query parameters if available. + Ex. + "https://mybucket.s3.amazonaws.com/objects/abcd-ff?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Algorithm=AWS4-HMAC-SHA256…​" + Combined with {@link #method}, you can understand the fully-qualified + request line. This is optional as it may include private data or be of + considerable length.

spring.sleuth.keys.hystrix.command-group

commandGroup

Name of the command group. Hystrix uses the command group key to group + together commands such as for reporting, alerting, dashboards, + or team/library ownership. +

@see com.netflix.hystrix.HystrixCommandGroupKey

spring.sleuth.keys.hystrix.command-key

commandKey

Name of the command key. Describes the name for the given command. + A key to represent a {@link com.netflix.hystrix.HystrixCommand} for + monitoring, circuit-breakers, metrics publishing, caching and other such uses. +

@see com.netflix.hystrix.HystrixCommandKey

spring.sleuth.keys.hystrix.prefix

Prefix for header names if they are added as tags.

spring.sleuth.keys.hystrix.thread-pool-key

threadPoolKey

Name of the thread pool key. The thread-pool key represents a {@link com.netflix.hystrix.HystrixThreadPool} + for monitoring, metrics publishing, caching, and other such uses. A {@link com.netflix.hystrix.HystrixCommand} + is associated with a single {@link com.netflix.hystrix.HystrixThreadPool} as + retrieved by the {@link com.netflix.hystrix.HystrixThreadPoolKey} injected into it, + or it defaults to one created using the {@link com.netflix.hystrix.HystrixCommandGroupKey} + it is created with. +

@see com.netflix.hystrix.HystrixThreadPoolKey

spring.sleuth.keys.message.headers

Additional headers that should be added as tags if they exist. If the header + value is not a String it will be converted to a String using its toString() + method.

spring.sleuth.keys.message.payload.size

message/payload-size

An estimate of the size of the payload if available.

spring.sleuth.keys.message.payload.type

message/payload-type

The type of the payload.

spring.sleuth.keys.message.prefix

message/

Prefix for header names if they are added as tags.

spring.sleuth.keys.mvc.controller-class

mvc.controller.class

The lower case, hyphen delimited name of the class that processes the request. + Ex. class named "BookController" will result in "book-controller" tag value.

spring.sleuth.keys.mvc.controller-method

mvc.controller.method

The lower case, hyphen delimited name of the class that processes the request. + Ex. method named "listOfBooks" will result in "list-of-books" tag value.

spring.sleuth.metric.span.accepted-name

counter.span.accepted

spring.sleuth.metric.span.dropped-name

counter.span.dropped

spring.sleuth.sampler.percentage

0.1

Percentage of requests that should be sampled. E.g. 1.0 - 100% requests should be + sampled. The precision is whole-numbers only (i.e. there’s no support for 0.1% of + the traces).

spring.sleuth.trace-id128

false

When true, generate 128-bit trace IDs instead of 64-bit ones.

zuul.add-host-header

false

Flag to determine whether the proxy forwards the Host header.

zuul.add-proxy-headers

true

Flag to determine whether the proxy adds X-Forwarded-* headers.

zuul.host.max-per-route-connections

20

The maximum number of connections that can be used by a single route.

zuul.host.max-total-connections

200

The maximum number of total connections the proxy can hold open to backends.

zuul.ignore-local-service

true

zuul.ignore-security-headers

true

Flag to say that SECURITY_HEADERS are added to ignored headers if spring security is on the classpath. + By setting ignoreSecurityHeaders to false we can switch off this default behaviour. This should be used together with + disabling the default spring security headers + see https://docs.spring.io/spring-security/site/docs/current/reference/html/headers.html#default-security-headers

zuul.ignored-headers

Names of HTTP headers to ignore completely (i.e. leave them out of downstream + requests and drop them from downstream responses).

zuul.ignored-patterns

zuul.ignored-services

Set of service names not to consider for proxying automatically. By default all + services in the discovery client will be proxied.

zuul.prefix

A common prefix for all routes.

zuul.remove-semicolon-content

true

Flag to say that path elements past the first semicolon can be dropped.

zuul.retryable

Flag for whether retry is supported by default (assuming the routes themselves + support it).

zuul.ribbon-isolation-strategy

zuul.routes

Map of route names to properties.

zuul.s-e-c-u-r-i-t-y-h-e-a-d-e-r-s

Headers that are generally expected to be added by Spring Security, and hence often + duplicated if the proxy and the backend are secured with Spring. By default they + are added to the ignored headers if Spring Security is present and ignoreSecurityHeaders = true.

zuul.semaphore.max-semaphores

100

The maximum number of total semaphores for Hystrix.

zuul.sensitive-headers

List of sensitive headers that are not passed to downstream requests. Defaults to a + "safe" set of headers that commonly contain user credentials. It’s OK to remove + those from the list if the downstream service is part of the same system as the + proxy, so they are sharing authentication data. If using a physical URL outside + your own domain, then generally it would be a bad idea to leak user credentials.

zuul.servlet-path

/zuul

Path to install Zuul as a servlet (not part of Spring MVC). The servlet is more + memory efficient for requests with large bodies, e.g. file uploads.

zuul.ssl-hostname-validation-enabled

true

Flag to say whether the hostname for ssl connections should be verified or not. Default is true. + This should only be used in test setups!

zuul.strip-prefix

true

Flag saying whether to strip the prefix from the path before forwarding.

zuul.trace-request-body

true

Flag to say that request bodies can be traced.

+
+
+
+ + \ No newline at end of file