├── .gitignore ├── README.md ├── build.gradle.kts ├── gradle.properties ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat └── src ├── main ├── kotlin │ └── functional │ │ ├── Application.kt │ │ ├── Extensions.kt │ │ ├── Model.kt │ │ ├── NativeHints.kt │ │ ├── Routes.kt │ │ └── UserHandler.kt └── resources │ ├── messages.properties │ ├── static │ ├── spring.png │ └── sse.js │ └── templates │ ├── footer.mustache │ ├── header.mustache │ ├── home.mustache │ ├── sse.mustache │ └── users.mustache └── test └── kotlin └── functional └── IntegrationTests.kt /.gitignore: -------------------------------------------------------------------------------- 1 | .idea/ 2 | .gradle/ 3 | out/ 4 | build/ 5 | .idea/ 6 | *.iml 7 | 8 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | This project is designed to demonstrate: 2 | - [Spring Framework Kotlin support](https://docs.spring.io/spring-framework/docs/current/reference/html/languages.html#kotlin) 3 | - [Spring MVC functional web APIs](https://docs.spring.io/spring-framework/docs/current/reference/html/languages.html#kotlin-web) 4 | - Leveraging [Kotlin serialization](https://github.com/Kotlin/kotlinx.serialization) 5 | - [Gradle Kotlin DSL configuration](https://docs.gradle.org/current/userguide/kotlin_dsl.html) 6 | - [Spring Boot GraalVM native images support](https://docs.spring.io/spring-boot/docs/current/reference/html/native-image.html) 7 | 8 | This sample does not use functional bean registration for 3 main reasons: 9 | - This is not yet well supporting with native/AOT, see [spring-framework#29555](https://github.com/spring-projects/spring-framework/issues/29555) related issue. 10 | - [Spring Fu](https://github.com/spring-projects-experimental/spring-fu) development is frozen while the Spring team figures out a better option to provide first class support for functional configuration well integrated in Spring Boot, see [spring-boot#8115](https://github.com/spring-projects/spring-boot/issues/8115) related issue. 11 | - Spring AOT transforms automatically annotation-based JavaConfig configuration model to functional bean registration executed at runtime. 12 | 13 | ## Getting started 14 | 15 | - Build the project and run tests with `./gradlew build` 16 | - Run the application with `./gradlew bootRun` 17 | - Create a native executable with `./gradlew nativeCompile` then run `build/native/nativeCompile/spring-kotlin-functional` executable (add `.exe` on Windows) 18 | - Build an optimized native container with `./gradlew bootBuildImage` 19 | 20 | ## AOT on the JVM 21 | 22 | AOT generation happens when either `id("org.graalvm.buildtools.native")` or `id("org.springframework.boot.aot")` plugins are activated. 23 | 24 | If you want to leverage to speedup the application startup on the JVM: 25 | - Unpack the executable JAR with `jar -xf myapp.jar` as documented [here](https://docs.spring.io/spring-boot/docs/current/reference/html/container-images.html#container-images.efficient-images.unpacking) 26 | - Run the `java` command with `-Dspring.aot.enabled=true`, for example `java -Dspring.aot.enabled=true -cp BOOT-INF/classes:BOOT-INF/lib/* com.example.MyApplication` 27 | -------------------------------------------------------------------------------- /build.gradle.kts: -------------------------------------------------------------------------------- 1 | import org.jetbrains.kotlin.gradle.dsl.JvmTarget 2 | import org.jetbrains.kotlin.gradle.tasks.KotlinCompile 3 | 4 | plugins { 5 | id("org.springframework.boot") version "3.0.5" 6 | id("io.spring.dependency-management") version "1.1.0" 7 | kotlin("jvm") version "1.8.20" 8 | kotlin("plugin.spring") version "1.8.20" 9 | kotlin("plugin.serialization") version "1.8.20" 10 | id("org.graalvm.buildtools.native") version "0.9.20" 11 | } 12 | 13 | group = "com.example" 14 | version = "0.0.1-SNAPSHOT" 15 | java.sourceCompatibility = JavaVersion.VERSION_17 16 | 17 | repositories { 18 | mavenCentral() 19 | } 20 | 21 | configurations.all { 22 | // Logback + the XML infrastructure that it makes reachable are worth to exclude to get a smaller native footprint 23 | exclude(module = "spring-boot-starter-logging") 24 | // We use Kotlin Serialization so no need for Jackson and kotlin-reflect 25 | exclude(module = "spring-boot-starter-json") 26 | // We use tomcat-embed-programmatic instead 27 | exclude(module = "tomcat-embed-core") 28 | exclude(module = "tomcat-embed-websocket") 29 | } 30 | 31 | dependencies { 32 | implementation("org.springframework.boot:spring-boot-starter-mustache") 33 | implementation("org.springframework.boot:spring-boot-starter-web") 34 | implementation("org.apache.tomcat.experimental:tomcat-embed-programmatic:${dependencyManagement.importedProperties["tomcat.version"]}") 35 | implementation("org.springframework.boot:spring-boot-starter") 36 | implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.0") 37 | testImplementation("org.springframework.boot:spring-boot-starter-test") 38 | testImplementation("org.springframework.boot:spring-boot-starter-webflux") 39 | testImplementation("io.projectreactor:reactor-test") 40 | testImplementation("io.projectreactor.kotlin:reactor-kotlin-extensions") 41 | } 42 | 43 | tasks.withType { 44 | compilerOptions { 45 | freeCompilerArgs = listOf("-Xjsr305=strict") 46 | jvmTarget = JvmTarget.JVM_17 47 | } 48 | } 49 | 50 | tasks.withType { 51 | useJUnitPlatform() 52 | } 53 | -------------------------------------------------------------------------------- /gradle.properties: -------------------------------------------------------------------------------- 1 | systemProp.org.gradle.unsafe.kotlin.assignment=true 2 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/sdeleuze/spring-kotlin-functional/026c2cf8c84f4dbb208d966ed7b66c8022946638/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | distributionBase=GRADLE_USER_HOME 2 | distributionPath=wrapper/dists 3 | distributionUrl=https\://services.gradle.org/distributions/gradle-8.1-rc-3-bin.zip 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env sh 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Attempt to set APP_HOME 10 | # Resolve links: $0 may be a link 11 | PRG="$0" 12 | # Need this for relative symlinks. 13 | while [ -h "$PRG" ] ; do 14 | ls=`ls -ld "$PRG"` 15 | link=`expr "$ls" : '.*-> \(.*\)$'` 16 | if expr "$link" : '/.*' > /dev/null; then 17 | PRG="$link" 18 | else 19 | PRG=`dirname "$PRG"`"/$link" 20 | fi 21 | done 22 | SAVED="`pwd`" 23 | cd "`dirname \"$PRG\"`/" >/dev/null 24 | APP_HOME="`pwd -P`" 25 | cd "$SAVED" >/dev/null 26 | 27 | APP_NAME="Gradle" 28 | APP_BASE_NAME=`basename "$0"` 29 | 30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 31 | DEFAULT_JVM_OPTS="" 32 | 33 | # Use the maximum available, or set MAX_FD != -1 to use that value. 34 | MAX_FD="maximum" 35 | 36 | warn () { 37 | echo "$*" 38 | } 39 | 40 | die () { 41 | echo 42 | echo "$*" 43 | echo 44 | exit 1 45 | } 46 | 47 | # OS specific support (must be 'true' or 'false'). 48 | cygwin=false 49 | msys=false 50 | darwin=false 51 | nonstop=false 52 | case "`uname`" in 53 | CYGWIN* ) 54 | cygwin=true 55 | ;; 56 | Darwin* ) 57 | darwin=true 58 | ;; 59 | MINGW* ) 60 | msys=true 61 | ;; 62 | NONSTOP* ) 63 | nonstop=true 64 | ;; 65 | esac 66 | 67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 68 | 69 | # Determine the Java command to use to start the JVM. 70 | if [ -n "$JAVA_HOME" ] ; then 71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 72 | # IBM's JDK on AIX uses strange locations for the executables 73 | JAVACMD="$JAVA_HOME/jre/sh/java" 74 | else 75 | JAVACMD="$JAVA_HOME/bin/java" 76 | fi 77 | if [ ! -x "$JAVACMD" ] ; then 78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 79 | 80 | Please set the JAVA_HOME variable in your environment to match the 81 | location of your Java installation." 82 | fi 83 | else 84 | JAVACMD="java" 85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 86 | 87 | Please set the JAVA_HOME variable in your environment to match the 88 | location of your Java installation." 89 | fi 90 | 91 | # Increase the maximum file descriptors if we can. 92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then 93 | MAX_FD_LIMIT=`ulimit -H -n` 94 | if [ $? -eq 0 ] ; then 95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 96 | MAX_FD="$MAX_FD_LIMIT" 97 | fi 98 | ulimit -n $MAX_FD 99 | if [ $? -ne 0 ] ; then 100 | warn "Could not set maximum file descriptor limit: $MAX_FD" 101 | fi 102 | else 103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 104 | fi 105 | fi 106 | 107 | # For Darwin, add options to specify how the application appears in the dock 108 | if $darwin; then 109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 110 | fi 111 | 112 | # For Cygwin, switch paths to Windows format before running java 113 | if $cygwin ; then 114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 116 | JAVACMD=`cygpath --unix "$JAVACMD"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Escape application args 158 | save () { 159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done 160 | echo " " 161 | } 162 | APP_ARGS=$(save "$@") 163 | 164 | # Collect all arguments for the java command, following the shell quoting and substitution rules 165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" 166 | 167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong 168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then 169 | cd "$(dirname "$0")" 170 | fi 171 | 172 | exec "$JAVACMD" "$@" 173 | -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | set DIRNAME=%~dp0 12 | if "%DIRNAME%" == "" set DIRNAME=. 13 | set APP_BASE_NAME=%~n0 14 | set APP_HOME=%DIRNAME% 15 | 16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 17 | set DEFAULT_JVM_OPTS= 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windows variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | 53 | :win9xME_args 54 | @rem Slurp the command line arguments. 55 | set CMD_LINE_ARGS= 56 | set _SKIP=2 57 | 58 | :win9xME_args_slurp 59 | if "x%~1" == "x" goto execute 60 | 61 | set CMD_LINE_ARGS=%* 62 | 63 | :execute 64 | @rem Setup the command line 65 | 66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 67 | 68 | @rem Execute Gradle 69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 70 | 71 | :end 72 | @rem End local scope for the variables with windows NT shell 73 | if "%ERRORLEVEL%"=="0" goto mainEnd 74 | 75 | :fail 76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 77 | rem the _cmd.exe /c_ return code! 78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 79 | exit /b 1 80 | 81 | :mainEnd 82 | if "%OS%"=="Windows_NT" endlocal 83 | 84 | :omega 85 | -------------------------------------------------------------------------------- /src/main/kotlin/functional/Application.kt: -------------------------------------------------------------------------------- 1 | package functional 2 | 3 | import org.springframework.aot.hint.* 4 | import org.springframework.boot.autoconfigure.SpringBootApplication 5 | import org.springframework.boot.runApplication 6 | import org.springframework.context.annotation.ImportRuntimeHints 7 | 8 | @SpringBootApplication(proxyBeanMethods = false) 9 | @ImportRuntimeHints(NativeHints::class) 10 | class Application 11 | 12 | fun main(args: Array) { 13 | runApplication(*args) 14 | } -------------------------------------------------------------------------------- /src/main/kotlin/functional/Extensions.kt: -------------------------------------------------------------------------------- 1 | package functional 2 | 3 | import org.springframework.web.servlet.function.ServerRequest 4 | import java.time.LocalDate 5 | import java.time.format.DateTimeFormatterBuilder 6 | import java.time.temporal.ChronoField 7 | import java.util.* 8 | import java.util.stream.Collectors 9 | import java.util.stream.IntStream 10 | 11 | fun ServerRequest.locale() = 12 | this.headers().asHttpHeaders().acceptLanguageAsLocales.firstOrNull() ?: Locale.ENGLISH!! 13 | 14 | fun LocalDate.formatDate(): String = this.format(englishDateFormatter) 15 | 16 | private val daysLookup: Map = 17 | IntStream.rangeClosed(1, 31).boxed().collect(Collectors.toMap(Int::toLong, ::getOrdinal)) 18 | 19 | private val englishDateFormatter = DateTimeFormatterBuilder() 20 | .appendPattern("MMMM") 21 | .appendLiteral(" ") 22 | .appendText(ChronoField.DAY_OF_MONTH, daysLookup) 23 | .appendLiteral(" ") 24 | .appendPattern("yyyy") 25 | .toFormatter(Locale.ENGLISH) 26 | 27 | private fun getOrdinal(n: Int) = when { 28 | n in 11..13 -> "${n}th" 29 | n % 10 == 1 -> "${n}st" 30 | n % 10 == 2 -> "${n}nd" 31 | n % 10 == 3 -> "${n}rd" 32 | else -> "${n}th" 33 | } -------------------------------------------------------------------------------- /src/main/kotlin/functional/Model.kt: -------------------------------------------------------------------------------- 1 | package functional 2 | 3 | import kotlinx.serialization.KSerializer 4 | import kotlinx.serialization.Serializable 5 | import kotlinx.serialization.descriptors.PrimitiveKind 6 | import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor 7 | import kotlinx.serialization.descriptors.SerialDescriptor 8 | import kotlinx.serialization.encoding.Decoder 9 | import kotlinx.serialization.encoding.Encoder 10 | import java.time.LocalDate 11 | 12 | @Serializable 13 | data class User(val firstName: String, val lastName: String, @Serializable(with = LocalDateAsLongSerializer::class) val birthDate: LocalDate) 14 | 15 | object LocalDateAsLongSerializer : KSerializer { 16 | override val descriptor: SerialDescriptor = PrimitiveSerialDescriptor("LocalDate", PrimitiveKind.LONG) 17 | override fun serialize(encoder: Encoder, value: LocalDate) = encoder.encodeLong(value.toEpochDay()) 18 | override fun deserialize(decoder: Decoder): LocalDate = LocalDate.ofEpochDay(decoder.decodeLong()) 19 | } -------------------------------------------------------------------------------- /src/main/kotlin/functional/NativeHints.kt: -------------------------------------------------------------------------------- 1 | package functional 2 | 3 | import org.springframework.aot.hint.* 4 | 5 | class NativeHints : RuntimeHintsRegistrar { 6 | 7 | override fun registerHints(hints: RuntimeHints, classLoader: ClassLoader?) { 8 | hints.resources().registerPattern("messages.properties") 9 | 10 | // @RegisterReflectionForBinding(UserDto::class, User:class) can be used instead when using kotlin-reflection 11 | hints.reflection().registerType(MemberCategory.INVOKE_DECLARED_METHODS) 12 | hints.reflection().registerType(MemberCategory.INVOKE_DECLARED_METHODS, MemberCategory.DECLARED_FIELDS) 13 | hints.reflection().registerType(MemberCategory.INVOKE_DECLARED_METHODS) 14 | 15 | // TODO Remove when GraalVM reachability 0.2.8 is released 16 | hints.reflection().registerType(TypeReference.of("kotlin.internal.jdk8.JDK8PlatformImplementations"), MemberCategory.INVOKE_PUBLIC_CONSTRUCTORS) 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /src/main/kotlin/functional/Routes.kt: -------------------------------------------------------------------------------- 1 | package functional 2 | 3 | import com.samskivert.mustache.Mustache 4 | import org.springframework.context.MessageSource 5 | import org.springframework.context.annotation.Bean 6 | import org.springframework.context.annotation.Configuration 7 | import org.springframework.http.MediaType.* 8 | import org.springframework.web.servlet.function.* 9 | import java.util.* 10 | 11 | @Configuration(proxyBeanMethods = false) 12 | class Routes { 13 | 14 | @Bean 15 | fun userRouter(userHandler: UserHandler, messageSource: MessageSource) = router { 16 | accept(TEXT_HTML).nest { 17 | GET("/") { 18 | ok().render("home") 19 | } 20 | GET("/sse") { ok().render("sse") } 21 | GET("/users", userHandler::findAllView) 22 | } 23 | "/api".nest { 24 | accept(APPLICATION_JSON).nest { 25 | GET("/users", userHandler::findAll) 26 | } 27 | accept(TEXT_EVENT_STREAM).nest { 28 | GET("/users", userHandler::stream) 29 | } 30 | } 31 | }.filter { request, next -> 32 | next.handle(request).let { 33 | if (it is RenderingResponse) RenderingResponse.from(it) 34 | .modelAttributes(attributes(request.locale(), messageSource)).build() else it 35 | } 36 | } 37 | 38 | private fun attributes(locale: Locale, messageSource: MessageSource) = mutableMapOf( 39 | "i18n" to Mustache.Lambda { frag, out -> 40 | val tokens = frag.execute().split("|") 41 | out.write( 42 | messageSource.getMessage( 43 | tokens[0], 44 | tokens.slice(IntRange(1, tokens.size - 1)).toTypedArray(), 45 | locale 46 | ) 47 | ) 48 | } 49 | ) 50 | } -------------------------------------------------------------------------------- /src/main/kotlin/functional/UserHandler.kt: -------------------------------------------------------------------------------- 1 | package functional 2 | 3 | import org.springframework.stereotype.Service 4 | import org.springframework.web.servlet.function.ServerRequest 5 | 6 | import org.springframework.web.servlet.function.ServerResponse.ok 7 | import org.springframework.web.servlet.function.ServerResponse.sse 8 | import org.springframework.web.servlet.function.bodyWithType 9 | import java.time.LocalDate 10 | import kotlin.concurrent.timer 11 | 12 | @Service 13 | class UserHandler { 14 | 15 | private val users = listOf( 16 | User("Foo", "Foo", LocalDate.now().minusDays(1)), 17 | User("Bar", "Bar", LocalDate.now().minusDays(10)), 18 | User("Baz", "Baz", LocalDate.now().minusDays(100))) 19 | 20 | fun findAll(req: ServerRequest) = 21 | ok().bodyWithType>(users) 22 | 23 | fun findAllView(req: ServerRequest) = 24 | ok().render("users", mapOf("users" to users.map { it.toDto() })) 25 | 26 | fun stream(req: ServerRequest) = sse { sseBuilder -> 27 | timer(period = 100) { 28 | sseBuilder.send(users.random()) 29 | } 30 | } 31 | } 32 | 33 | class UserDto(val firstName: String, val lastName: String, val birthDate: String) 34 | 35 | fun User.toDto() = UserDto(firstName, lastName, birthDate.formatDate()) 36 | -------------------------------------------------------------------------------- /src/main/resources/messages.properties: -------------------------------------------------------------------------------- 1 | index.welcome=Welcome to this application designed to demonstrate how to build a micro-framework style application with Spring Framework 5 and Kotlin. 2 | index.list=You can have a look to: 3 | index.mustache=An HTML page rendered with JMustache 4 | index.json=An JSON REST endpoint 5 | index.sse=An HTML page using Server-Sent Events to display a stream of data 6 | 7 | sse.list=User stream: 8 | 9 | users.list=Users: 10 | 11 | -------------------------------------------------------------------------------- /src/main/resources/static/spring.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/sdeleuze/spring-kotlin-functional/026c2cf8c84f4dbb208d966ed7b66c8022946638/src/main/resources/static/spring.png -------------------------------------------------------------------------------- /src/main/resources/static/sse.js: -------------------------------------------------------------------------------- 1 | var eventSource = new EventSource("/api/users"); 2 | eventSource.onmessage = function(e) { 3 | var li = document.createElement("li"); 4 | var user = JSON.parse(e.data); 5 | li.innerText = "User: " + user.firstName + " " + user.lastName + " - " + user.birthDate; 6 | document.getElementById("users").appendChild(li); 7 | } -------------------------------------------------------------------------------- /src/main/resources/templates/footer.mustache: -------------------------------------------------------------------------------- 1 |
2 | 3 | 4 | -------------------------------------------------------------------------------- /src/main/resources/templates/header.mustache: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | {{#title}}{{title}}{{/title}} 5 | 6 | 7 | 8 | 9 |
10 |
11 |
12 |
13 |

-------------------------------------------------------------------------------- /src/main/resources/templates/home.mustache: -------------------------------------------------------------------------------- 1 | {{> header}} 2 | 3 |
4 |

{{#i18n}}index.welcome{{/i18n}}

5 | 6 | {{#i18n}}index.list{{/i18n}} 7 | 12 |
13 | 14 | {{> footer}} 15 | -------------------------------------------------------------------------------- /src/main/resources/templates/sse.mustache: -------------------------------------------------------------------------------- 1 | {{> header}} 2 | 3 | 4 | 5 | {{#i18n}}sse.list{{/i18n}} 6 |
    7 | 8 |
9 | 10 | {{> footer}} -------------------------------------------------------------------------------- /src/main/resources/templates/users.mustache: -------------------------------------------------------------------------------- 1 | {{> header}} 2 | 3 | {{#i18n}}users.list{{/i18n}} 4 |
    5 | {{#users}} 6 |
  • {{firstName}} {{lastName}} - {{birthDate}}
    • 7 | {{/users}} 8 |
9 | 10 | {{> footer}} 11 | -------------------------------------------------------------------------------- /src/test/kotlin/functional/IntegrationTests.kt: -------------------------------------------------------------------------------- 1 | package functional 2 | 3 | import org.assertj.core.api.Assertions 4 | import org.junit.jupiter.api.Test 5 | import org.springframework.beans.factory.annotation.Autowired 6 | import org.springframework.boot.test.context.SpringBootTest 7 | import org.springframework.http.MediaType.* 8 | import org.springframework.test.web.reactive.server.WebTestClient 9 | import org.springframework.test.web.reactive.server.expectBody 10 | import org.springframework.test.web.reactive.server.expectBodyList 11 | import org.springframework.test.web.reactive.server.returnResult 12 | import reactor.kotlin.test.test 13 | import java.time.LocalDate 14 | 15 | @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) 16 | class IntegrationTests(@Autowired val client: WebTestClient) { 17 | 18 | @Test 19 | fun `Find all users on JSON REST endpoint`() { 20 | client.get().uri("/api/users") 21 | .accept(APPLICATION_JSON) 22 | .exchange() 23 | .expectStatus().is2xxSuccessful 24 | .expectBodyList() 25 | .hasSize(3) 26 | .contains(User("Foo", "Foo", LocalDate.now().minusDays(1))) 27 | .contains(User("Bar", "Bar", LocalDate.now().minusDays(10))) 28 | .contains(User("Baz", "Baz", LocalDate.now().minusDays(100))) 29 | } 30 | 31 | @Test 32 | fun `Find all users on HTML page`() { 33 | client.get().uri("/users") 34 | .accept(TEXT_HTML) 35 | .exchange() 36 | .expectStatus().is2xxSuccessful 37 | .expectBody() 38 | .consumeWith { Assertions.assertThat(it.responseBody).contains("Foo", "Bar", "Baz") } 39 | } 40 | 41 | @Test 42 | fun `Receive a stream of users via Server-Sent-Events`() { 43 | client.get().uri("/api/users") 44 | .accept(TEXT_EVENT_STREAM) 45 | .exchange() 46 | .expectStatus().is2xxSuccessful 47 | .returnResult() 48 | .responseBody 49 | .test() 50 | .expectNextMatches { it.firstName == "Foo" && it.lastName == "Foo" && it.birthDate.isBefore(LocalDate.now()) } 51 | .expectNextMatches { it.firstName == "Bar" && it.lastName == "Bar" && it.birthDate.isBefore(LocalDate.now()) } 52 | .expectNextMatches { it.firstName == "Baz" && it.lastName == "Baz" && it.birthDate.isBefore(LocalDate.now()) } 53 | .expectNextMatches { it.firstName == "Foo" && it.lastName == "Foo" && it.birthDate.isBefore(LocalDate.now()) } 54 | .expectNextMatches { it.firstName == "Bar" && it.lastName == "Bar" && it.birthDate.isBefore(LocalDate.now()) } 55 | .expectNextMatches { it.firstName == "Baz" && it.lastName == "Baz" && it.birthDate.isBefore(LocalDate.now()) } 56 | .thenCancel() 57 | .verify() 58 | } 59 | 60 | } 61 | --------------------------------------------------------------------------------