├── .gitignore ├── LICENSE ├── README.adoc ├── docs ├── Head-first Reactive with Spring and Reactor.pdf └── README.adoc └── stock-quotes ├── .gitignore ├── .mvn └── wrapper │ ├── maven-wrapper.jar │ └── maven-wrapper.properties ├── mvnw ├── mvnw.cmd ├── pom.xml └── src ├── main ├── java │ └── io │ │ └── spring │ │ └── workshop │ │ └── stockquotes │ │ ├── Quote.java │ │ ├── QuoteGenerator.java │ │ ├── QuoteHandler.java │ │ ├── QuoteRouter.java │ │ └── StockQuotesApplication.java └── resources │ └── application.properties └── test └── java └── io └── spring └── workshop └── stockquotes └── StockQuotesApplicationTests.java /.gitignore: -------------------------------------------------------------------------------- 1 | *.sw[op] 2 | .idea 3 | target 4 | 5 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright [yyyy] [name of copyright owner] 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | -------------------------------------------------------------------------------- /README.adoc: -------------------------------------------------------------------------------- 1 | = head-first-reactive-with-spring-and-reactor is no longer actively maintained by VMware, Inc. 2 | 3 | = Head-First Reactive Workshop 4 | 5 | This repository hosts a complete workshop on Spring + Reactor. 6 | You can follow the script 7 | https://reactor.github.io/head-first-reactive-with-spring-and-reactor/[follow the script] 8 | (the source document is in the "docs" folder) to create your first 9 | WebFlux applications! 10 | Each step of this workshop has its companion commit in the git history with a detailed commit message. 11 | -------------------------------------------------------------------------------- /docs/Head-first Reactive with Spring and Reactor.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/spring-attic/head-first-reactive-with-spring-and-reactor/663a1817335c972a607e8209f08bb0d3c8c49a6c/docs/Head-first Reactive with Spring and Reactor.pdf -------------------------------------------------------------------------------- /docs/README.adoc: -------------------------------------------------------------------------------- 1 | = Head-First Reactive Workshop 2 | Stephane Maldini, Ben Hale, Madhura Bhave - Pivotal 3 | :sectanchors: true 4 | :source-highlighter: prettify 5 | :icons: font 6 | :toc: 7 | :spring-boot-version: 2.0.4.RELEASE 8 | :spring-framework-version: 5.0.8.RELEASE 9 | :reactor-version: BISMUTH-SR10 10 | :spring-framework-doc-base: https://docs.spring.io/spring-framework/docs/{spring-framework-version} 11 | 12 | This repository hosts a complete workshop on Spring + Reactor. 13 | Just follow this README and create your first reactive Spring applications! 14 | Each step of this workshop has its companion commit in the git history with a detailed commit message. 15 | 16 | At the end of the workshop, we will have created three applications: 17 | 18 | * `stock-quotes` is a functional WebFlux app which streams stock quotes 19 | * `stock-details` is an annotation-based WebFlux app using a reactive datastore 20 | * `trading-service` is an annotation-based WebFlux app that consumes data from `stock-quotes` and `stock-details` 21 | 22 | Reference documentations can be useful while working on those apps: 23 | 24 | * https://projectreactor.io/docs[Reactor Core documentation] 25 | * https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Flux.html[API documentation for Flux] 26 | * https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html[API documentation for Mono] 27 | * Spring WebFlux 28 | {spring-framework-doc-base}/spring-framework-reference/web.html#web-reactive[reference documentation] 29 | and {spring-framework-doc-base}/javadoc-api/[javadoc] 30 | 31 | Clone the repository: 32 | 33 | git clone https://github.com/reactor/head-first-reactive-with-spring-and-reactor.git 34 | 35 | We will start off by creating the Trading Service application which gets data from a pre-existing Stock Quotes application. 36 | 37 | == Trading Service application 38 | 39 | === Create this application 40 | 41 | Go to `https://start.spring.io` and create a Maven project with Spring Boot {spring-boot-version}, 42 | with groupId `io.spring.workshop` and artifactId `trading-service`. Select the `Reactive Web` and `Devtools` dependencies. 43 | Unzip the given file into a directory and import that application into your IDE. 44 | 45 | If generated right, you should have a main `Application` class that looks like this: 46 | 47 | [source,java] 48 | .stock-quotes/src/main/java/io/spring/workshop/tradingservice/TradingServiceApplication.java 49 | ---- 50 | include::../trading-service/src/main/java/io/spring/workshop/tradingservice/TradingServiceApplication.java[] 51 | ---- 52 | 53 | Note that, by default, `spring-boot-starter-webflux` transitively brings `spring-boot-starter-reactor-netty` 54 | and Spring Boot auto-configures Reactor Netty as a web server. 55 | 56 | Spring Boot supports Tomcat, Undertow and Jetty as well. 57 | 58 | === Use the WebClient to stream JSON to the browser 59 | 60 | In this section, we'll call our remote `stock-quotes` service to get Quotes from it, so we first need to: 61 | 62 | * copy over the `Quote` class to this application 63 | * add the Jackson JSR310 module dependency 64 | 65 | Create a `QuotesClient` annotated with `@Component` and inject a `WebClient.Builder`. Now, create a method in the `QuotesClient` called 66 | `quotesFeed` which will use the `webClient` to consume the stream of quotes via Server Sent Events (SSE). 67 | 68 | NOTE: There are two ways to use a `WebClient`, directly via the static factory or by injecting the `WebClient.Builder`. 69 | The latter is used by libraries such as Spring Cloud Sleuth that enrich `WebClient` with extra features. 70 | 71 | Now create a `QuotesController` annotated with `@Controller` and inject it with the `QuotesClient`. 72 | Add a method that responds to `"GET /quotes/feed"` requests with the `"text/event-stream"` content-type, 73 | with a `Flux` as the response body. The data can be retrieved from the `quotesFeed` method on `QuotesClient`. 74 | 75 | You can test it by starting both applications. First, start the Stock Quotes application. 76 | It can be started from your IDE or with `mvn spring-boot:run` and it should run a Netty server on port 8081. 77 | You should see in the logs something like: 78 | 79 | [source,bash] 80 | ---- 81 | INFO 2208 --- [ restartedMain] o.s.b.web.embedded.netty.NettyWebServer : Netty started on port(s): 8081 82 | INFO 2208 --- [ restartedMain] i.s.w.s.StockQuotesApplication : Started StockQuotesApplication in 1.905 seconds (JVM running for 3.075) 83 | ---- 84 | 85 | Start the Trading Service application from your IDE or with `mvn spring-boot:run`. This should run a Netty server on port 8080. 86 | 87 | [source,bash] 88 | ---- 89 | INFO 2208 --- [ restartedMain] o.s.b.web.embedded.netty.NettyWebServer : Netty started on port(s): 8080 90 | INFO 2208 --- [ restartedMain] i.s.w.t.TradingServiceApplication : Started TradingServiceApplication in 1.905 seconds (JVM running for 3.075) 91 | ---- 92 | 93 | You can hit http://localhost:8080/quotes/feed to consume the stream of quotes. 94 | 95 | Now, let's create another application that can provide the details for a trading company. 96 | 97 | == Stock Details application 98 | 99 | === Create this application 100 | 101 | Go to `https://start.spring.io` and create a Maven project with Spring Boot {spring-boot-version}, 102 | with groupId `io.spring.workshop` and artifactId `stock-details`. Select the `Reactive Web`, `Devtools` 103 | and `Reactive Mongo` dependencies. 104 | 105 | Unzip the given file into a directory and import that application into your IDE. 106 | 107 | If generated right, you should have a main `Application` class that looks like this: 108 | 109 | [source,java] 110 | .stock-details/src/main/java/io/spring/workshop/stockdetails/StockDetailsApplication.java 111 | ---- 112 | include::../stock-details/src/main/java/io/spring/workshop/stockdetails/StockDetailsApplication.java[] 113 | ---- 114 | 115 | Edit your `application.properties` file to start the server on port 8082. 116 | 117 | [source,properties] 118 | .stock-details/src/main/resources/application.properties 119 | ---- 120 | include::../stock-details/src/main/resources/application.properties[] 121 | ---- 122 | 123 | === Use a reactive datastore 124 | 125 | In this application, we’ll use a MongoDB datastore with its reactive driver; for this workshop, we’ll use an in-memory instance of MongoDB. So add the following: 126 | 127 | [source,xml] 128 | .stock-details/pom.xml 129 | ---- 130 | include::../stock-details/pom.xml[tags=inMemMongo] 131 | ---- 132 | 133 | We'd like to manage `TradingCompany` with our datastore. 134 | 135 | [source,java] 136 | .stock-details/src/main/java/io/spring/workshop/stockdetails/TradingCompany.java 137 | ---- 138 | include::../stock-details/src/main/java/io/spring/workshop/stockdetails/TradingCompany.java[] 139 | ---- 140 | 141 | Now create a `TradingCompanyRepository` interface that extends `ReactiveMongoRepository`. 142 | Add a `findByTicker(String ticker)` method that returns a single `TradingCompany` in a reactive fashion. 143 | 144 | We'd like to insert trading companies in our datastore when the application starts up. For that, create a `TradingCompanyCommandLineRunner` 145 | component that implements Spring Boot's `CommandLineRunner`. In the `run` method, use the reactive repository 146 | to insert `TradingCompany` instances in the datastore. 147 | 148 | NOTE: Since the `run` method returns void, it expects a blocking implementation. This is why you should use the 149 | `blockLast(Duration)` operator on the `Flux` returned by the repository when inserting data. 150 | You can also `then().block(Duration)` to turn that `Flux` into a `Mono` that waits for completion. 151 | 152 | === Create a JSON web service 153 | 154 | We're now going to expose `TradingCompany` through a Controller. 155 | First, create a `TradingCompanyController` annotated with `@RestController` and inject the `TradingCompanyRepository`. 156 | Then add two new Controller methods in order to handle: 157 | 158 | * GET requests to `"/details"`, returning all `TradingCompany` instances, serializing them with content-type `"application/json"` 159 | * GET requests to `"/details/{ticker}"`, returning a single `TradingCompany` instance, serializing it with content-type `"application/json"` 160 | 161 | It can be started from your IDE or with `mvn spring-boot:run` and it should run a Netty server on port 8082. 162 | You should see in the logs something like: 163 | 164 | [source,bash] 165 | ---- 166 | INFO 2208 --- [ restartedMain] o.s.b.web.embedded.netty.NettyWebServer : Netty started on port(s): 8082 167 | INFO 2208 --- [ restartedMain] i.s.w.s.StockDetailsApplication : Started StockDetailsApplication in 1.905 seconds (JVM running for 3.075) 168 | ---- 169 | 170 | Now that we have an application that can return the details for a company with a given ticker, we can update the Trading Service application 171 | to use those details and return a combination of the latest quote for that ticker along with the company's details. 172 | 173 | == Update Trading Service application 174 | 175 | We will first create a service that will use a `WebClient` to get data from the Stock Details application. 176 | Create a `TradingCompanyClient` annotated with `@Component`. 177 | Then add two methods: 178 | 179 | * `findAllCompanies` will return a `Flux` by using the webClient to get data from the `/details` endpoint from the Stock details application 180 | * `getTradingCompany` will return a `Mono` by using the webClient to get data from the `/details/{ticker}` endpoint from the Stock details application 181 | - If no trading company is found for the given ticker, the `Mono` will complete without any data. Instead, we will emit a `TickerNotFoundException` error using the `switchIfEmpty` operator. 182 | 183 | Let's expose the two `TradingCompanyClient` methods with a local `TradingCompanyController`. 184 | 185 | You might have updated an already running `TradingServiceApplication`. Since DevTools is present, you can just recompile to automatically restart the application. 186 | 187 | You can test the new endpoints by hitting: 188 | 189 | * http://localhost:8080/details to list all trading companies 190 | * http://localhost:8080/details/MSFT to get details for a particular ticker 191 | * http://localhost:8080/details/PIZZA to see what happens for an unknown ticker 192 | 193 | Let's add a method called `getLatestQuote(String ticker)` on the `QuotesClient` which will get the latest quote for a given ticker from the quotes feed. 194 | 195 | * Reuse `quotesFeed` to get the actual feed 196 | * Filter the stream of quotes with quotes matching the given ticker 197 | * Take the next matching quote 198 | * If no matching quote is found within 15 seconds, then return a fallback `Quote` for the ticker. 199 | 200 | Now, we want to combine data produced by `stock-quotes` and `stock-details` as a `TradingCompanySummary`. 201 | 202 | Copy the following class to your project. 203 | 204 | [source,java] 205 | .trading-service/src/main/java/io/spring/workshop/tradingservice/TradingCompanySummary.java 206 | ---- 207 | include::../trading-service/src/main/java/io/spring/workshop/tradingservice/TradingCompanySummary.java[] 208 | ---- 209 | 210 | Now, add another method to the `QuotesController` which can handle requests to `/quotes/summary/{ticker}`. 211 | 212 | * Use the `TradingCompanyClient` to get the details for the company with the given ticker 213 | * Create a `TradingCompanySummary` by composing the details with the latest quote from the `QuotesClient` 214 | 215 | TIP: You can compose two reactive results using `Mono.zip(monoA, monoB, biFunction)` or `monoA.zipWith(monoB, biFunction)`. 216 | 217 | We need to handle the `TickerNotFoundException` emitted by the `TradingCompanyClient` as an HTTP 404. 218 | You will need to create a method annotated with `@ExceptionHandler`. 219 | 220 | Again, because of DevTools we can just recompile and test by hitting: 221 | 222 | * http://localhost:8080/quotes/summary/MSFT to get the summary for a particular ticker 223 | * http://localhost:8080/quotes/summary/PIZZA to test the 404 NOT FOUND an unknown ticker 224 | 225 | Now, we will look at creating a functional-style WebFlux application by re-creating the Stock Quotes Application. 226 | Fasten your seatbelt and remove the stock-quotes directory! 227 | 228 | == Stock Quotes application 229 | 230 | === Create this application 231 | 232 | Go to `https://start.spring.io` and create a Maven project with Spring Boot {spring-boot-version}, 233 | with groupId `io.spring.workshop` and artifactId `stock-quotes`. Select the `Reactive Web` and `Devtools` 234 | dependencies. 235 | Unzip the given file into a directory and import that application into your IDE. 236 | 237 | If generated right, you should have a main `Application` class that looks like this: 238 | 239 | [source,java] 240 | .stock-quotes/src/main/java/io/spring/workshop/stockquotes/StockQuotesApplication.java 241 | ---- 242 | include::../stock-quotes/src/main/java/io/spring/workshop/stockquotes/StockQuotesApplication.java[] 243 | ---- 244 | 245 | Edit your `application.properties` file to start the server on port 8081. 246 | 247 | [source,properties] 248 | .stock-quotes/src/main/resources/application.properties 249 | ---- 250 | include::../stock-quotes/src/main/resources/application.properties[] 251 | ---- 252 | 253 | Launching it from your IDE or with `mvn spring-boot:run` should start a Netty server on port 8081. 254 | You should see in the logs something like: 255 | 256 | [source,bash] 257 | ---- 258 | INFO 2208 --- [ restartedMain] o.s.b.web.embedded.netty.NettyWebServer : Netty started on port(s): 8081 259 | INFO 2208 --- [ restartedMain] i.s.w.s.StockQuotesApplication : Started StockQuotesApplication in 1.905 seconds (JVM running for 3.075) 260 | ---- 261 | 262 | === Create a Quote Generator 263 | 264 | To simulate real stock values, we'll create a generator that emits such values at a specific interval. 265 | Copy the following classes to your project. 266 | 267 | [source,java] 268 | .stock-quotes/src/main/java/io/spring/workshop/stockquotes/Quote.java 269 | ---- 270 | include::../stock-quotes/src/main/java/io/spring/workshop/stockquotes/Quote.java[] 271 | ---- 272 | 273 | [source,java] 274 | .stock-quotes/src/main/java/io/spring/workshop/stockquotes/QuoteGenerator.java 275 | ---- 276 | include::../stock-quotes/src/main/java/io/spring/workshop/stockquotes/QuoteGenerator.java[] 277 | ---- 278 | 279 | Because we're working with `java.time.Instant` and Jackson, we should import the dedicated module in our app. 280 | 281 | NOTE: The `QuoteGenerator` instantiates a `Flux` that emits a `Quote` every 200 msec and can be **shared** between 282 | multiple subscribers (look at the `Flux` operators for that). This instance is kept as an attribute for reusability. 283 | 284 | [source,xml] 285 | .stock-quotes/pom.xml 286 | ---- 287 | include::../stock-quotes/pom.xml[tags=jacksonJSR310] 288 | ---- 289 | 290 | === Functional web applications with "WebFlux.fn" 291 | 292 | Spring WebFlux comes in two flavors of web applications: annotation based and functional. 293 | For this first application, we'll use the functional variant. 294 | 295 | Incoming HTTP requests are handled by a `HandlerFunction`, which is essentially a function 296 | that takes a ServerRequest and returns a `Mono`. The annotation counterpart 297 | to a handler function would be a Controller method. 298 | 299 | But how those incoming requests are routed to the right handler? 300 | 301 | We're using a `RouterFunction`, which is a function that takes a `ServerRequest`, and returns 302 | a `Mono`. If a request matches a particular route, a handler function is returned; 303 | otherwise it returns an empty `Mono`. The `RouterFunction` has a similar purpose as the `@RequestMapping` 304 | annotation in `@Controller` classes. 305 | 306 | Take a look at the code samples in 307 | {spring-framework-doc-base}/spring-framework-reference/web.html#web-reactive-server-functional[the Spring WebFlux.fn reference documentation] 308 | 309 | === Create your first HandlerFunction + RouterFunction 310 | 311 | First, create a `QuoteHandler` class and mark is as a `@Component`;this class will have all our handler functions as methods. 312 | Let's inject our `QuoteGenerator` instance in our `QuoteHandler`. 313 | 314 | Now create a `streamQuotes` handler that streams the generated quotes with the `"application/stream+json"` content type. 315 | 316 | To route requests to that handler, you need to expose a `RouterFunction` to Spring Boot. 317 | Create a `QuoteRouter` configuration class (i.e. annotated with `@Configuration`) 318 | that creates a bean of type `RouterFunction`. 319 | 320 | Modify that class so that GET requests to `"/quotes"` are routed to the handler you just implemented. 321 | 322 | TIP: Since `QuoteHandler` is a component, you can inject it in `@Bean` methods as a method parameter. 323 | 324 | Your application should now behave like this: 325 | 326 | [source,bash] 327 | ---- 328 | $ curl http://localhost:8081/quotes -i -H "Accept: application/stream+json" 329 | HTTP/1.1 200 OK 330 | transfer-encoding: chunked 331 | Content-Type: application/stream+json 332 | 333 | {"ticker":"CTXS","price":84.0,"instant":1494841666.633000000} 334 | {"ticker":"DELL","price":67.1,"instant":1494841666.834000000} 335 | {"ticker":"GOOG","price":869,"instant":1494841667.034000000} 336 | {"ticker":"MSFT","price":66.5,"instant":1494841667.231000000} 337 | {"ticker":"ORCL","price":46.13,"instant":1494841667.433000000} 338 | {"ticker":"RHT","price":86.9,"instant":1494841667.634000000} 339 | {"ticker":"VMW","price":93.7,"instant":1494841667.833000000} 340 | ---- 341 | 342 | === Integration tests with WebTestClient 343 | 344 | Spring WebFlux (actually the `spring-test` module) includes a `WebTestClient` 345 | that can be used to test WebFlux server endpoints with or without a running server. 346 | Tests without a running server are comparable to MockMvc from Spring MVC where mock request 347 | and response are used instead of connecting over the network using a socket. 348 | The WebTestClient however can also perform tests against a running server. 349 | 350 | You can check that your last endpoint is working properly with the following 351 | integration test: 352 | 353 | [source,java] 354 | .stock-quotes/src/test/java/io/spring/workshop/stockquotes/StockQuotesApplicationTests.java 355 | ---- 356 | include::../stock-quotes/src/test/java/io/spring/workshop/stockquotes/StockQuotesApplicationTests.java[] 357 | ---- 358 | 359 | == Additional Resources 360 | 361 | Talks on Spring Reactive: 362 | 363 | * https://content.pivotal.io/springone-platform-2017/designing-implementing-and-using-reactive-apis-ben-hale-paul-harris[Designing, Implementing, and Using Reactive APIs (Ben Hale, Paul Harris)] 364 | * https://content.pivotal.io/springone-platform-2017/reactive-spring-josh-long-mark-heckler[Reactive Spring (Josh Long, Mark Heckler)] 365 | 366 | Hands-on Reactor: 367 | 368 | * https://github.com/reactor/lite-rx-api-hands-on[Reactor Hands-on] 369 | -------------------------------------------------------------------------------- /stock-quotes/.gitignore: -------------------------------------------------------------------------------- 1 | target/ 2 | !.mvn/wrapper/maven-wrapper.jar 3 | 4 | ### STS ### 5 | .apt_generated 6 | .classpath 7 | .factorypath 8 | .project 9 | .settings 10 | .springBeans 11 | 12 | ### IntelliJ IDEA ### 13 | .idea 14 | *.iws 15 | *.iml 16 | *.ipr 17 | 18 | ### NetBeans ### 19 | nbproject/private/ 20 | build/ 21 | nbbuild/ 22 | dist/ 23 | nbdist/ 24 | .nb-gradle/ -------------------------------------------------------------------------------- /stock-quotes/.mvn/wrapper/maven-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/spring-attic/head-first-reactive-with-spring-and-reactor/663a1817335c972a607e8209f08bb0d3c8c49a6c/stock-quotes/.mvn/wrapper/maven-wrapper.jar -------------------------------------------------------------------------------- /stock-quotes/.mvn/wrapper/maven-wrapper.properties: -------------------------------------------------------------------------------- 1 | distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.0/apache-maven-3.5.0-bin.zip 2 | -------------------------------------------------------------------------------- /stock-quotes/mvnw: -------------------------------------------------------------------------------- 1 | #!/bin/sh 2 | # ---------------------------------------------------------------------------- 3 | # Licensed to the Apache Software Foundation (ASF) under one 4 | # or more contributor license agreements. See the NOTICE file 5 | # distributed with this work for additional information 6 | # regarding copyright ownership. The ASF licenses this file 7 | # to you under the Apache License, Version 2.0 (the 8 | # "License"); you may not use this file except in compliance 9 | # with the License. You may obtain a copy of the License at 10 | # 11 | # https://www.apache.org/licenses/LICENSE-2.0 12 | # 13 | # Unless required by applicable law or agreed to in writing, 14 | # software distributed under the License is distributed on an 15 | # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16 | # KIND, either express or implied. See the License for the 17 | # specific language governing permissions and limitations 18 | # under the License. 19 | # ---------------------------------------------------------------------------- 20 | 21 | # ---------------------------------------------------------------------------- 22 | # Maven2 Start Up Batch script 23 | # 24 | # Required ENV vars: 25 | # ------------------ 26 | # JAVA_HOME - location of a JDK home dir 27 | # 28 | # Optional ENV vars 29 | # ----------------- 30 | # M2_HOME - location of maven2's installed home dir 31 | # MAVEN_OPTS - parameters passed to the Java VM when running Maven 32 | # e.g. to debug Maven itself, use 33 | # set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 34 | # MAVEN_SKIP_RC - flag to disable loading of mavenrc files 35 | # ---------------------------------------------------------------------------- 36 | 37 | if [ -z "$MAVEN_SKIP_RC" ] ; then 38 | 39 | if [ -f /etc/mavenrc ] ; then 40 | . /etc/mavenrc 41 | fi 42 | 43 | if [ -f "$HOME/.mavenrc" ] ; then 44 | . "$HOME/.mavenrc" 45 | fi 46 | 47 | fi 48 | 49 | # OS specific support. $var _must_ be set to either true or false. 50 | cygwin=false; 51 | darwin=false; 52 | mingw=false 53 | case "`uname`" in 54 | CYGWIN*) cygwin=true ;; 55 | MINGW*) mingw=true;; 56 | Darwin*) darwin=true 57 | # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home 58 | # See https://developer.apple.com/library/mac/qa/qa1170/_index.html 59 | if [ -z "$JAVA_HOME" ]; then 60 | if [ -x "/usr/libexec/java_home" ]; then 61 | export JAVA_HOME="`/usr/libexec/java_home`" 62 | else 63 | export JAVA_HOME="/Library/Java/Home" 64 | fi 65 | fi 66 | ;; 67 | esac 68 | 69 | if [ -z "$JAVA_HOME" ] ; then 70 | if [ -r /etc/gentoo-release ] ; then 71 | JAVA_HOME=`java-config --jre-home` 72 | fi 73 | fi 74 | 75 | if [ -z "$M2_HOME" ] ; then 76 | ## resolve links - $0 may be a link to maven's home 77 | PRG="$0" 78 | 79 | # need this for relative symlinks 80 | while [ -h "$PRG" ] ; do 81 | ls=`ls -ld "$PRG"` 82 | link=`expr "$ls" : '.*-> \(.*\)$'` 83 | if expr "$link" : '/.*' > /dev/null; then 84 | PRG="$link" 85 | else 86 | PRG="`dirname "$PRG"`/$link" 87 | fi 88 | done 89 | 90 | saveddir=`pwd` 91 | 92 | M2_HOME=`dirname "$PRG"`/.. 93 | 94 | # make it fully qualified 95 | M2_HOME=`cd "$M2_HOME" && pwd` 96 | 97 | cd "$saveddir" 98 | # echo Using m2 at $M2_HOME 99 | fi 100 | 101 | # For Cygwin, ensure paths are in UNIX format before anything is touched 102 | if $cygwin ; then 103 | [ -n "$M2_HOME" ] && 104 | M2_HOME=`cygpath --unix "$M2_HOME"` 105 | [ -n "$JAVA_HOME" ] && 106 | JAVA_HOME=`cygpath --unix "$JAVA_HOME"` 107 | [ -n "$CLASSPATH" ] && 108 | CLASSPATH=`cygpath --path --unix "$CLASSPATH"` 109 | fi 110 | 111 | # For Migwn, ensure paths are in UNIX format before anything is touched 112 | if $mingw ; then 113 | [ -n "$M2_HOME" ] && 114 | M2_HOME="`(cd "$M2_HOME"; pwd)`" 115 | [ -n "$JAVA_HOME" ] && 116 | JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`" 117 | # TODO classpath? 118 | fi 119 | 120 | if [ -z "$JAVA_HOME" ]; then 121 | javaExecutable="`which javac`" 122 | if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then 123 | # readlink(1) is not available as standard on Solaris 10. 124 | readLink=`which readlink` 125 | if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then 126 | if $darwin ; then 127 | javaHome="`dirname \"$javaExecutable\"`" 128 | javaExecutable="`cd \"$javaHome\" && pwd -P`/javac" 129 | else 130 | javaExecutable="`readlink -f \"$javaExecutable\"`" 131 | fi 132 | javaHome="`dirname \"$javaExecutable\"`" 133 | javaHome=`expr "$javaHome" : '\(.*\)/bin'` 134 | JAVA_HOME="$javaHome" 135 | export JAVA_HOME 136 | fi 137 | fi 138 | fi 139 | 140 | if [ -z "$JAVACMD" ] ; then 141 | if [ -n "$JAVA_HOME" ] ; then 142 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 143 | # IBM's JDK on AIX uses strange locations for the executables 144 | JAVACMD="$JAVA_HOME/jre/sh/java" 145 | else 146 | JAVACMD="$JAVA_HOME/bin/java" 147 | fi 148 | else 149 | JAVACMD="`which java`" 150 | fi 151 | fi 152 | 153 | if [ ! -x "$JAVACMD" ] ; then 154 | echo "Error: JAVA_HOME is not defined correctly." >&2 155 | echo " We cannot execute $JAVACMD" >&2 156 | exit 1 157 | fi 158 | 159 | if [ -z "$JAVA_HOME" ] ; then 160 | echo "Warning: JAVA_HOME environment variable is not set." 161 | fi 162 | 163 | CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher 164 | 165 | # traverses directory structure from process work directory to filesystem root 166 | # first directory with .mvn subdirectory is considered project base directory 167 | find_maven_basedir() { 168 | 169 | if [ -z "$1" ] 170 | then 171 | echo "Path not specified to find_maven_basedir" 172 | return 1 173 | fi 174 | 175 | basedir="$1" 176 | wdir="$1" 177 | while [ "$wdir" != '/' ] ; do 178 | if [ -d "$wdir"/.mvn ] ; then 179 | basedir=$wdir 180 | break 181 | fi 182 | # workaround for JBEAP-8937 (on Solaris 10/Sparc) 183 | if [ -d "${wdir}" ]; then 184 | wdir=`cd "$wdir/.."; pwd` 185 | fi 186 | # end of workaround 187 | done 188 | echo "${basedir}" 189 | } 190 | 191 | # concatenates all lines of a file 192 | concat_lines() { 193 | if [ -f "$1" ]; then 194 | echo "$(tr -s '\n' ' ' < "$1")" 195 | fi 196 | } 197 | 198 | BASE_DIR=`find_maven_basedir "$(pwd)"` 199 | if [ -z "$BASE_DIR" ]; then 200 | exit 1; 201 | fi 202 | 203 | export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} 204 | echo $MAVEN_PROJECTBASEDIR 205 | MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" 206 | 207 | # For Cygwin, switch paths to Windows format before running java 208 | if $cygwin; then 209 | [ -n "$M2_HOME" ] && 210 | M2_HOME=`cygpath --path --windows "$M2_HOME"` 211 | [ -n "$JAVA_HOME" ] && 212 | JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` 213 | [ -n "$CLASSPATH" ] && 214 | CLASSPATH=`cygpath --path --windows "$CLASSPATH"` 215 | [ -n "$MAVEN_PROJECTBASEDIR" ] && 216 | MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` 217 | fi 218 | 219 | WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 220 | 221 | exec "$JAVACMD" \ 222 | $MAVEN_OPTS \ 223 | -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ 224 | "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ 225 | ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" 226 | -------------------------------------------------------------------------------- /stock-quotes/mvnw.cmd: -------------------------------------------------------------------------------- 1 | @REM ---------------------------------------------------------------------------- 2 | @REM Licensed to the Apache Software Foundation (ASF) under one 3 | @REM or more contributor license agreements. See the NOTICE file 4 | @REM distributed with this work for additional information 5 | @REM regarding copyright ownership. The ASF licenses this file 6 | @REM to you under the Apache License, Version 2.0 (the 7 | @REM "License"); you may not use this file except in compliance 8 | @REM with the License. You may obtain a copy of the License at 9 | @REM 10 | @REM https://www.apache.org/licenses/LICENSE-2.0 11 | @REM 12 | @REM Unless required by applicable law or agreed to in writing, 13 | @REM software distributed under the License is distributed on an 14 | @REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | @REM KIND, either express or implied. See the License for the 16 | @REM specific language governing permissions and limitations 17 | @REM under the License. 18 | @REM ---------------------------------------------------------------------------- 19 | 20 | @REM ---------------------------------------------------------------------------- 21 | @REM Maven2 Start Up Batch script 22 | @REM 23 | @REM Required ENV vars: 24 | @REM JAVA_HOME - location of a JDK home dir 25 | @REM 26 | @REM Optional ENV vars 27 | @REM M2_HOME - location of maven2's installed home dir 28 | @REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands 29 | @REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a key stroke before ending 30 | @REM MAVEN_OPTS - parameters passed to the Java VM when running Maven 31 | @REM e.g. to debug Maven itself, use 32 | @REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 33 | @REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files 34 | @REM ---------------------------------------------------------------------------- 35 | 36 | @REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' 37 | @echo off 38 | @REM enable echoing my setting MAVEN_BATCH_ECHO to 'on' 39 | @if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% 40 | 41 | @REM set %HOME% to equivalent of $HOME 42 | if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") 43 | 44 | @REM Execute a user defined script before this one 45 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre 46 | @REM check for pre script, once with legacy .bat ending and once with .cmd ending 47 | if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat" 48 | if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd" 49 | :skipRcPre 50 | 51 | @setlocal 52 | 53 | set ERROR_CODE=0 54 | 55 | @REM To isolate internal variables from possible post scripts, we use another setlocal 56 | @setlocal 57 | 58 | @REM ==== START VALIDATION ==== 59 | if not "%JAVA_HOME%" == "" goto OkJHome 60 | 61 | echo. 62 | echo Error: JAVA_HOME not found in your environment. >&2 63 | echo Please set the JAVA_HOME variable in your environment to match the >&2 64 | echo location of your Java installation. >&2 65 | echo. 66 | goto error 67 | 68 | :OkJHome 69 | if exist "%JAVA_HOME%\bin\java.exe" goto init 70 | 71 | echo. 72 | echo Error: JAVA_HOME is set to an invalid directory. >&2 73 | echo JAVA_HOME = "%JAVA_HOME%" >&2 74 | echo Please set the JAVA_HOME variable in your environment to match the >&2 75 | echo location of your Java installation. >&2 76 | echo. 77 | goto error 78 | 79 | @REM ==== END VALIDATION ==== 80 | 81 | :init 82 | 83 | @REM Find the project base dir, i.e. the directory that contains the folder ".mvn". 84 | @REM Fallback to current working directory if not found. 85 | 86 | set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% 87 | IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir 88 | 89 | set EXEC_DIR=%CD% 90 | set WDIR=%EXEC_DIR% 91 | :findBaseDir 92 | IF EXIST "%WDIR%"\.mvn goto baseDirFound 93 | cd .. 94 | IF "%WDIR%"=="%CD%" goto baseDirNotFound 95 | set WDIR=%CD% 96 | goto findBaseDir 97 | 98 | :baseDirFound 99 | set MAVEN_PROJECTBASEDIR=%WDIR% 100 | cd "%EXEC_DIR%" 101 | goto endDetectBaseDir 102 | 103 | :baseDirNotFound 104 | set MAVEN_PROJECTBASEDIR=%EXEC_DIR% 105 | cd "%EXEC_DIR%" 106 | 107 | :endDetectBaseDir 108 | 109 | IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig 110 | 111 | @setlocal EnableExtensions EnableDelayedExpansion 112 | for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a 113 | @endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% 114 | 115 | :endReadAdditionalConfig 116 | 117 | SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" 118 | 119 | set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" 120 | set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 121 | 122 | %MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* 123 | if ERRORLEVEL 1 goto error 124 | goto end 125 | 126 | :error 127 | set ERROR_CODE=1 128 | 129 | :end 130 | @endlocal & set ERROR_CODE=%ERROR_CODE% 131 | 132 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost 133 | @REM check for post script, once with legacy .bat ending and once with .cmd ending 134 | if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat" 135 | if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd" 136 | :skipRcPost 137 | 138 | @REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' 139 | if "%MAVEN_BATCH_PAUSE%" == "on" pause 140 | 141 | if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE% 142 | 143 | exit /B %ERROR_CODE% 144 | -------------------------------------------------------------------------------- /stock-quotes/pom.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 4.0.0 5 | 6 | io.spring.workshop 7 | stock-quotes 8 | 0.0.1-SNAPSHOT 9 | jar 10 | 11 | stock-quotes 12 | Demo project for Spring Boot 13 | 14 | 15 | org.springframework.boot 16 | spring-boot-starter-parent 17 | 2.0.0.BUILD-SNAPSHOT 18 | 19 | 20 | 21 | 22 | UTF-8 23 | UTF-8 24 | 1.8 25 | Bismuth-BUILD-SNAPSHOT 26 | 27 | 28 | 29 | 30 | org.springframework.boot 31 | spring-boot-starter-webflux 32 | 33 | 34 | 35 | com.fasterxml.jackson.datatype 36 | jackson-datatype-jsr310 37 | 38 | 39 | 40 | org.springframework.boot 41 | spring-boot-starter-test 42 | test 43 | 44 | 45 | 46 | 47 | 48 | 49 | org.springframework.boot 50 | spring-boot-maven-plugin 51 | 52 | 53 | 54 | 55 | 56 | 57 | spring-snapshots 58 | Spring Snapshots 59 | https://repo.spring.io/snapshot 60 | 61 | true 62 | 63 | 64 | 65 | spring-milestones 66 | Spring Milestones 67 | https://repo.spring.io/milestone 68 | 69 | false 70 | 71 | 72 | 73 | 74 | 75 | 76 | spring-snapshots 77 | Spring Snapshots 78 | https://repo.spring.io/snapshot 79 | 80 | true 81 | 82 | 83 | 84 | spring-milestones 85 | Spring Milestones 86 | https://repo.spring.io/milestone 87 | 88 | false 89 | 90 | 91 | 92 | 93 | 94 | 95 | -------------------------------------------------------------------------------- /stock-quotes/src/main/java/io/spring/workshop/stockquotes/Quote.java: -------------------------------------------------------------------------------- 1 | package io.spring.workshop.stockquotes; 2 | 3 | import java.math.BigDecimal; 4 | import java.math.MathContext; 5 | import java.time.Instant; 6 | 7 | public class Quote { 8 | 9 | private static final MathContext MATH_CONTEXT = new MathContext(2); 10 | 11 | private String ticker; 12 | 13 | private BigDecimal price; 14 | 15 | private Instant instant = Instant.now(); 16 | 17 | public Quote() { 18 | } 19 | 20 | public Quote(String ticker, BigDecimal price) { 21 | this.ticker = ticker; 22 | this.price = price; 23 | } 24 | 25 | public Quote(String ticker, Double price) { 26 | this(ticker, new BigDecimal(price, MATH_CONTEXT)); 27 | } 28 | 29 | public String getTicker() { 30 | return ticker; 31 | } 32 | 33 | public void setTicker(String ticker) { 34 | this.ticker = ticker; 35 | } 36 | 37 | public BigDecimal getPrice() { 38 | return price; 39 | } 40 | 41 | public void setPrice(BigDecimal price) { 42 | this.price = price; 43 | } 44 | 45 | public Instant getInstant() { 46 | return instant; 47 | } 48 | 49 | public void setInstant(Instant instant) { 50 | this.instant = instant; 51 | } 52 | 53 | @Override 54 | public String toString() { 55 | return "Quote{" + 56 | "ticker='" + ticker + '\'' + 57 | ", price=" + price + 58 | ", instant=" + instant + 59 | '}'; 60 | } 61 | } -------------------------------------------------------------------------------- /stock-quotes/src/main/java/io/spring/workshop/stockquotes/QuoteGenerator.java: -------------------------------------------------------------------------------- 1 | package io.spring.workshop.stockquotes; 2 | 3 | import java.math.BigDecimal; 4 | import java.math.MathContext; 5 | import java.time.Duration; 6 | import java.time.Instant; 7 | import java.util.ArrayList; 8 | import java.util.List; 9 | import java.util.Random; 10 | import java.util.stream.Collectors; 11 | 12 | import reactor.core.publisher.Flux; 13 | 14 | import org.springframework.stereotype.Component; 15 | 16 | @Component 17 | public class QuoteGenerator { 18 | 19 | private final MathContext mathContext = new MathContext(2); 20 | 21 | private final Random random = new Random(); 22 | 23 | private final List prices = new ArrayList<>(); 24 | 25 | private final Flux quoteStream; 26 | 27 | /** 28 | * Bootstraps the generator with tickers and initial prices 29 | */ 30 | public QuoteGenerator() { 31 | initializeQuotes(); 32 | this.quoteStream = getQuoteStream(); 33 | } 34 | 35 | public Flux fetchQuoteStream() { 36 | return quoteStream; 37 | } 38 | 39 | private void initializeQuotes() { 40 | this.prices.add(new Quote("CTXS", 82.26)); 41 | this.prices.add(new Quote("DELL", 63.74)); 42 | this.prices.add(new Quote("GOOG", 847.24)); 43 | this.prices.add(new Quote("MSFT", 65.11)); 44 | this.prices.add(new Quote("ORCL", 45.71)); 45 | this.prices.add(new Quote("RHT", 84.29)); 46 | this.prices.add(new Quote("VMW", 92.21)); 47 | } 48 | 49 | 50 | private Flux getQuoteStream() { 51 | return Flux.interval(Duration.ofMillis(200)) 52 | .onBackpressureDrop() 53 | .map(this::generateQuotes) 54 | .flatMapIterable(quotes -> quotes) 55 | .share(); 56 | } 57 | 58 | private List generateQuotes(long i) { 59 | Instant instant = Instant.now(); 60 | return prices.stream() 61 | .map(baseQuote -> { 62 | BigDecimal priceChange = baseQuote.getPrice() 63 | .multiply(new BigDecimal(0.05 * this.random.nextDouble()), this.mathContext); 64 | 65 | Quote result = new Quote(baseQuote.getTicker(), baseQuote.getPrice().add(priceChange)); 66 | result.setInstant(instant); 67 | return result; 68 | }) 69 | .collect(Collectors.toList()); 70 | } 71 | } 72 | -------------------------------------------------------------------------------- /stock-quotes/src/main/java/io/spring/workshop/stockquotes/QuoteHandler.java: -------------------------------------------------------------------------------- 1 | package io.spring.workshop.stockquotes; 2 | 3 | import reactor.core.publisher.Mono; 4 | 5 | import org.springframework.stereotype.Component; 6 | import org.springframework.web.reactive.function.server.ServerRequest; 7 | import org.springframework.web.reactive.function.server.ServerResponse; 8 | 9 | import static org.springframework.http.MediaType.APPLICATION_STREAM_JSON; 10 | import static org.springframework.web.reactive.function.server.ServerResponse.ok; 11 | 12 | @Component 13 | public class QuoteHandler { 14 | 15 | private final QuoteGenerator quoteGenerator; 16 | 17 | public QuoteHandler(QuoteGenerator quoteGenerator) { 18 | this.quoteGenerator = quoteGenerator; 19 | } 20 | 21 | public Mono streamQuotes(ServerRequest request) { 22 | return ok() 23 | .contentType(APPLICATION_STREAM_JSON) 24 | .body(this.quoteGenerator.fetchQuoteStream(), Quote.class); 25 | } 26 | } 27 | -------------------------------------------------------------------------------- /stock-quotes/src/main/java/io/spring/workshop/stockquotes/QuoteRouter.java: -------------------------------------------------------------------------------- 1 | package io.spring.workshop.stockquotes; 2 | 3 | import org.springframework.context.annotation.Bean; 4 | import org.springframework.context.annotation.Configuration; 5 | import org.springframework.web.reactive.function.server.RouterFunction; 6 | import org.springframework.web.reactive.function.server.RouterFunctions; 7 | import org.springframework.web.reactive.function.server.ServerResponse; 8 | 9 | import static org.springframework.http.MediaType.APPLICATION_JSON; 10 | import static org.springframework.http.MediaType.APPLICATION_STREAM_JSON; 11 | import static org.springframework.http.MediaType.TEXT_PLAIN; 12 | import static org.springframework.web.reactive.function.server.RequestPredicates.GET; 13 | import static org.springframework.web.reactive.function.server.RequestPredicates.POST; 14 | import static org.springframework.web.reactive.function.server.RequestPredicates.accept; 15 | import static org.springframework.web.reactive.function.server.RequestPredicates.contentType; 16 | 17 | @Configuration 18 | public class QuoteRouter { 19 | 20 | @Bean 21 | public RouterFunction route(QuoteHandler quoteHandler) { 22 | return RouterFunctions 23 | .route(GET("/quotes").and(accept(APPLICATION_STREAM_JSON)), quoteHandler::streamQuotes) ; 24 | } 25 | } -------------------------------------------------------------------------------- /stock-quotes/src/main/java/io/spring/workshop/stockquotes/StockQuotesApplication.java: -------------------------------------------------------------------------------- 1 | package io.spring.workshop.stockquotes; 2 | 3 | import org.springframework.boot.SpringApplication; 4 | import org.springframework.boot.autoconfigure.SpringBootApplication; 5 | 6 | @SpringBootApplication 7 | public class StockQuotesApplication { 8 | 9 | public static void main(String[] args) { 10 | SpringApplication.run(StockQuotesApplication.class, args); 11 | } 12 | } 13 | -------------------------------------------------------------------------------- /stock-quotes/src/main/resources/application.properties: -------------------------------------------------------------------------------- 1 | server.port=8081 -------------------------------------------------------------------------------- /stock-quotes/src/test/java/io/spring/workshop/stockquotes/StockQuotesApplicationTests.java: -------------------------------------------------------------------------------- 1 | package io.spring.workshop.stockquotes; 2 | 3 | import java.util.List; 4 | 5 | import org.junit.Test; 6 | import org.junit.runner.RunWith; 7 | 8 | import org.springframework.beans.factory.annotation.Autowired; 9 | import org.springframework.boot.test.context.SpringBootTest; 10 | import org.springframework.http.MediaType; 11 | import org.springframework.test.context.junit4.SpringRunner; 12 | import org.springframework.test.web.reactive.server.WebTestClient; 13 | 14 | import static org.assertj.core.api.Assertions.assertThat; 15 | 16 | @RunWith(SpringRunner.class) 17 | // We create a `@SpringBootTest`, starting an actual server on a `RANDOM_PORT` 18 | @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) 19 | public class StockQuotesApplicationTests { 20 | 21 | // Spring Boot will create a `WebTestClient` for you, 22 | // already configure and ready to issue requests against "localhost:RANDOM_PORT" 23 | @Autowired 24 | private WebTestClient webTestClient; 25 | 26 | @Test 27 | public void fetchQuotes() { 28 | List result = 29 | webTestClient 30 | // We then create a GET request to test an endpoint 31 | .get().uri("/quotes") 32 | .accept(MediaType.APPLICATION_STREAM_JSON) 33 | .exchange() 34 | // and use the dedicated DSL to test assertions against the response 35 | .expectStatus().isOk() 36 | .expectHeader().contentType(MediaType.APPLICATION_STREAM_JSON) 37 | .returnResult(Quote.class) 38 | .getResponseBody() 39 | .take(20) 40 | .collectList() 41 | .block(); 42 | 43 | assertThat(result).allSatisfy(quote -> assertThat(quote.getPrice()).isPositive()); 44 | } 45 | 46 | } --------------------------------------------------------------------------------