├── .gitignore ├── acme-example-api ├── .gitignore ├── .mvn │ └── wrapper │ │ └── maven-wrapper.properties ├── mvnw ├── mvnw.cmd ├── pom.xml └── src │ └── main │ └── java │ └── com │ └── acme │ └── app │ └── api │ └── GreetingController.java ├── acme-example-app ├── pom.xml └── src │ └── main │ ├── java │ └── com │ │ └── acme │ │ └── app │ │ ├── App.java │ │ └── web │ │ └── WebMvcConfig.java │ └── resources │ └── application.yml ├── acme-example-ui ├── .babelrc ├── package-lock.json ├── package.json ├── pom.xml ├── src │ └── main │ │ └── frontend │ │ ├── index.html │ │ ├── main │ │ ├── hello.ts │ │ └── main.js │ │ └── style │ │ ├── main.css │ │ └── main.less └── yarn.lock ├── pom.xml └── readme.md /.gitignore: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | # Created by https://www.gitignore.io/api/osx,java,maven,eclipse,intellij+all,visualstudiocode,node 5 | # Edit at https://www.gitignore.io/?templates=osx,java,maven,eclipse,intellij+all,visualstudiocode,node 6 | 7 | ### Eclipse ### 8 | 9 | .metadata 10 | bin/ 11 | tmp/ 12 | *.tmp 13 | *.bak 14 | *.swp 15 | *~.nib 16 | local.properties 17 | .settings/ 18 | .loadpath 19 | .recommenders 20 | 21 | # External tool builders 22 | .externalToolBuilders/ 23 | 24 | # Locally stored "Eclipse launch configurations" 25 | *.launch 26 | 27 | # PyDev specific (Python IDE for Eclipse) 28 | *.pydevproject 29 | 30 | # CDT-specific (C/C++ Development Tooling) 31 | .cproject 32 | 33 | # CDT- autotools 34 | .autotools 35 | 36 | # Java annotation processor (APT) 37 | .factorypath 38 | 39 | # PDT-specific (PHP Development Tools) 40 | .buildpath 41 | 42 | # sbteclipse plugin 43 | .target 44 | 45 | # Tern plugin 46 | .tern-project 47 | 48 | # TeXlipse plugin 49 | .texlipse 50 | 51 | # STS (Spring Tool Suite) 52 | .springBeans 53 | 54 | # Code Recommenders 55 | .recommenders/ 56 | 57 | # Annotation Processing 58 | .apt_generated/ 59 | 60 | # Scala IDE specific (Scala & Java development for Eclipse) 61 | .cache-main 62 | .scala_dependencies 63 | .worksheet 64 | 65 | ### Eclipse Patch ### 66 | # Eclipse Core 67 | .project 68 | 69 | # JDT-specific (Eclipse Java Development Tools) 70 | .classpath 71 | 72 | # Annotation Processing 73 | .apt_generated 74 | 75 | .sts4-cache/ 76 | 77 | ### Intellij+all ### 78 | # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm 79 | # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839 80 | 81 | # User-specific stuff 82 | .idea/**/workspace.xml 83 | .idea/**/tasks.xml 84 | .idea/**/usage.statistics.xml 85 | .idea/**/dictionaries 86 | .idea/**/shelf 87 | 88 | # Generated files 89 | .idea/**/contentModel.xml 90 | 91 | # Sensitive or high-churn files 92 | .idea/**/dataSources/ 93 | .idea/**/dataSources.ids 94 | .idea/**/dataSources.local.xml 95 | .idea/**/sqlDataSources.xml 96 | .idea/**/dynamic.xml 97 | .idea/**/uiDesigner.xml 98 | .idea/**/dbnavigator.xml 99 | 100 | # Gradle 101 | .idea/**/gradle.xml 102 | .idea/**/libraries 103 | 104 | # Gradle and Maven with auto-import 105 | # When using Gradle or Maven with auto-import, you should exclude module files, 106 | # since they will be recreated, and may cause churn. Uncomment if using 107 | # auto-import. 108 | # .idea/modules.xml 109 | # .idea/*.iml 110 | # .idea/modules 111 | 112 | # CMake 113 | cmake-build-*/ 114 | 115 | # Mongo Explorer plugin 116 | .idea/**/mongoSettings.xml 117 | 118 | # File-based project format 119 | *.iws 120 | 121 | # IntelliJ 122 | out/ 123 | 124 | # mpeltonen/sbt-idea plugin 125 | .idea_modules/ 126 | 127 | # JIRA plugin 128 | atlassian-ide-plugin.xml 129 | 130 | # Cursive Clojure plugin 131 | .idea/replstate.xml 132 | 133 | # Crashlytics plugin (for Android Studio and IntelliJ) 134 | com_crashlytics_export_strings.xml 135 | crashlytics.properties 136 | crashlytics-build.properties 137 | fabric.properties 138 | 139 | # Editor-based Rest Client 140 | .idea/httpRequests 141 | 142 | # Android studio 3.1+ serialized cache file 143 | .idea/caches/build_file_checksums.ser 144 | 145 | ### Intellij+all Patch ### 146 | # Ignores the whole .idea folder and all .iml files 147 | # See https://github.com/joeblau/gitignore.io/issues/186 and https://github.com/joeblau/gitignore.io/issues/360 148 | 149 | .idea/ 150 | 151 | # Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-249601023 152 | 153 | *.iml 154 | modules.xml 155 | .idea/misc.xml 156 | *.ipr 157 | 158 | ### Java ### 159 | # Compiled class file 160 | *.class 161 | 162 | # Log file 163 | *.log 164 | 165 | # BlueJ files 166 | *.ctxt 167 | 168 | # Mobile Tools for Java (J2ME) 169 | .mtj.tmp/ 170 | 171 | # Package Files # 172 | *.jar 173 | *.war 174 | *.nar 175 | *.ear 176 | *.zip 177 | *.tar.gz 178 | *.rar 179 | 180 | # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml 181 | hs_err_pid* 182 | 183 | ### Maven ### 184 | target/ 185 | pom.xml.tag 186 | pom.xml.releaseBackup 187 | pom.xml.versionsBackup 188 | pom.xml.next 189 | release.properties 190 | dependency-reduced-pom.xml 191 | buildNumber.properties 192 | .mvn/timing.properties 193 | .mvn/wrapper/maven-wrapper.jar 194 | 195 | ### OSX ### 196 | # General 197 | .DS_Store 198 | .AppleDouble 199 | .LSOverride 200 | 201 | # Icon must end with two \r 202 | Icon 203 | 204 | # Thumbnails 205 | ._* 206 | 207 | # Files that might appear in the root of a volume 208 | .DocumentRevisions-V100 209 | .fseventsd 210 | .Spotlight-V100 211 | .TemporaryItems 212 | .Trashes 213 | .VolumeIcon.icns 214 | .com.apple.timemachine.donotpresent 215 | 216 | # Directories potentially created on remote AFP share 217 | .AppleDB 218 | .AppleDesktop 219 | Network Trash Folder 220 | Temporary Items 221 | .apdisk 222 | 223 | ### VisualStudioCode ### 224 | .vscode/* 225 | !.vscode/settings.json 226 | !.vscode/tasks.json 227 | !.vscode/launch.json 228 | !.vscode/extensions.json 229 | 230 | ### VisualStudioCode Patch ### 231 | # Ignore all local history of files 232 | .history 233 | 234 | 235 | 236 | # Created by https://www.gitignore.io/api/node 237 | # Edit at https://www.gitignore.io/?templates=node 238 | 239 | ### Node ### 240 | # Logs 241 | logs 242 | *.log 243 | npm-debug.log* 244 | yarn-debug.log* 245 | yarn-error.log* 246 | 247 | # Runtime data 248 | pids 249 | *.pid 250 | *.seed 251 | *.pid.lock 252 | 253 | # Directory for instrumented libs generated by jscoverage/JSCover 254 | lib-cov 255 | 256 | # Coverage directory used by tools like istanbul 257 | coverage 258 | 259 | # nyc test coverage 260 | .nyc_output 261 | 262 | # Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files) 263 | .grunt 264 | 265 | # Bower dependency directory (https://bower.io/) 266 | bower_components 267 | 268 | # node-waf configuration 269 | .lock-wscript 270 | 271 | # Compiled binary addons (https://nodejs.org/api/addons.html) 272 | build/Release 273 | 274 | # Dependency directories 275 | node_modules/ 276 | jspm_packages/ 277 | 278 | # TypeScript v1 declaration files 279 | typings/ 280 | 281 | # Optional npm cache directory 282 | .npm 283 | 284 | # Optional eslint cache 285 | .eslintcache 286 | 287 | # Optional REPL history 288 | .node_repl_history 289 | 290 | # Output of 'npm pack' 291 | *.tgz 292 | 293 | # Yarn Integrity file 294 | .yarn-integrity 295 | 296 | # dotenv environment variables file 297 | .env 298 | .env.test 299 | 300 | # parcel-bundler cache (https://parceljs.org/) 301 | .cache 302 | 303 | # next.js build output 304 | .next 305 | 306 | # nuxt.js build output 307 | .nuxt 308 | 309 | # vuepress build output 310 | .vuepress/dist 311 | 312 | # Serverless directories 313 | .serverless/ 314 | 315 | # FuseBox cache 316 | .fusebox/ 317 | 318 | # DynamoDB Local files 319 | .dynamodb/ 320 | 321 | 322 | # End of https://www.gitignore.io/api/osx,java,maven,eclipse,intellij+all,visualstudiocode,node 323 | -------------------------------------------------------------------------------- /acme-example-api/.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 | .sts4-cache 12 | 13 | ### IntelliJ IDEA ### 14 | .idea 15 | *.iws 16 | *.iml 17 | *.ipr 18 | 19 | ### NetBeans ### 20 | /nbproject/private/ 21 | /nbbuild/ 22 | /dist/ 23 | /nbdist/ 24 | /.nb-gradle/ 25 | /build/ 26 | -------------------------------------------------------------------------------- /acme-example-api/.mvn/wrapper/maven-wrapper.properties: -------------------------------------------------------------------------------- 1 | distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.0/apache-maven-3.6.0-bin.zip 2 | -------------------------------------------------------------------------------- /acme-example-api/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 | # http://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 Mingw, 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 | ########################################################################################## 204 | # Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 205 | # This allows using the maven wrapper in projects that prohibit checking in binary data. 206 | ########################################################################################## 207 | if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then 208 | if [ "$MVNW_VERBOSE" = true ]; then 209 | echo "Found .mvn/wrapper/maven-wrapper.jar" 210 | fi 211 | else 212 | if [ "$MVNW_VERBOSE" = true ]; then 213 | echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." 214 | fi 215 | jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.4.2/maven-wrapper-0.4.2.jar" 216 | while IFS="=" read key value; do 217 | case "$key" in (wrapperUrl) jarUrl="$value"; break ;; 218 | esac 219 | done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" 220 | if [ "$MVNW_VERBOSE" = true ]; then 221 | echo "Downloading from: $jarUrl" 222 | fi 223 | wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" 224 | 225 | if command -v wget > /dev/null; then 226 | if [ "$MVNW_VERBOSE" = true ]; then 227 | echo "Found wget ... using wget" 228 | fi 229 | wget "$jarUrl" -O "$wrapperJarPath" 230 | elif command -v curl > /dev/null; then 231 | if [ "$MVNW_VERBOSE" = true ]; then 232 | echo "Found curl ... using curl" 233 | fi 234 | curl -o "$wrapperJarPath" "$jarUrl" 235 | else 236 | if [ "$MVNW_VERBOSE" = true ]; then 237 | echo "Falling back to using Java to download" 238 | fi 239 | javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" 240 | if [ -e "$javaClass" ]; then 241 | if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then 242 | if [ "$MVNW_VERBOSE" = true ]; then 243 | echo " - Compiling MavenWrapperDownloader.java ..." 244 | fi 245 | # Compiling the Java class 246 | ("$JAVA_HOME/bin/javac" "$javaClass") 247 | fi 248 | if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then 249 | # Running the downloader 250 | if [ "$MVNW_VERBOSE" = true ]; then 251 | echo " - Running MavenWrapperDownloader.java ..." 252 | fi 253 | ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") 254 | fi 255 | fi 256 | fi 257 | fi 258 | ########################################################################################## 259 | # End of extension 260 | ########################################################################################## 261 | 262 | export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} 263 | if [ "$MVNW_VERBOSE" = true ]; then 264 | echo $MAVEN_PROJECTBASEDIR 265 | fi 266 | MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" 267 | 268 | # For Cygwin, switch paths to Windows format before running java 269 | if $cygwin; then 270 | [ -n "$M2_HOME" ] && 271 | M2_HOME=`cygpath --path --windows "$M2_HOME"` 272 | [ -n "$JAVA_HOME" ] && 273 | JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` 274 | [ -n "$CLASSPATH" ] && 275 | CLASSPATH=`cygpath --path --windows "$CLASSPATH"` 276 | [ -n "$MAVEN_PROJECTBASEDIR" ] && 277 | MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` 278 | fi 279 | 280 | WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 281 | 282 | exec "$JAVACMD" \ 283 | $MAVEN_OPTS \ 284 | -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ 285 | "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ 286 | ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" 287 | -------------------------------------------------------------------------------- /acme-example-api/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 http://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 set title of command window 39 | title %0 40 | @REM enable echoing my setting MAVEN_BATCH_ECHO to 'on' 41 | @if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% 42 | 43 | @REM set %HOME% to equivalent of $HOME 44 | if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") 45 | 46 | @REM Execute a user defined script before this one 47 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre 48 | @REM check for pre script, once with legacy .bat ending and once with .cmd ending 49 | if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat" 50 | if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd" 51 | :skipRcPre 52 | 53 | @setlocal 54 | 55 | set ERROR_CODE=0 56 | 57 | @REM To isolate internal variables from possible post scripts, we use another setlocal 58 | @setlocal 59 | 60 | @REM ==== START VALIDATION ==== 61 | if not "%JAVA_HOME%" == "" goto OkJHome 62 | 63 | echo. 64 | echo Error: JAVA_HOME not found in your environment. >&2 65 | echo Please set the JAVA_HOME variable in your environment to match the >&2 66 | echo location of your Java installation. >&2 67 | echo. 68 | goto error 69 | 70 | :OkJHome 71 | if exist "%JAVA_HOME%\bin\java.exe" goto init 72 | 73 | echo. 74 | echo Error: JAVA_HOME is set to an invalid directory. >&2 75 | echo JAVA_HOME = "%JAVA_HOME%" >&2 76 | echo Please set the JAVA_HOME variable in your environment to match the >&2 77 | echo location of your Java installation. >&2 78 | echo. 79 | goto error 80 | 81 | @REM ==== END VALIDATION ==== 82 | 83 | :init 84 | 85 | @REM Find the project base dir, i.e. the directory that contains the folder ".mvn". 86 | @REM Fallback to current working directory if not found. 87 | 88 | set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% 89 | IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir 90 | 91 | set EXEC_DIR=%CD% 92 | set WDIR=%EXEC_DIR% 93 | :findBaseDir 94 | IF EXIST "%WDIR%"\.mvn goto baseDirFound 95 | cd .. 96 | IF "%WDIR%"=="%CD%" goto baseDirNotFound 97 | set WDIR=%CD% 98 | goto findBaseDir 99 | 100 | :baseDirFound 101 | set MAVEN_PROJECTBASEDIR=%WDIR% 102 | cd "%EXEC_DIR%" 103 | goto endDetectBaseDir 104 | 105 | :baseDirNotFound 106 | set MAVEN_PROJECTBASEDIR=%EXEC_DIR% 107 | cd "%EXEC_DIR%" 108 | 109 | :endDetectBaseDir 110 | 111 | IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig 112 | 113 | @setlocal EnableExtensions EnableDelayedExpansion 114 | for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a 115 | @endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% 116 | 117 | :endReadAdditionalConfig 118 | 119 | SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" 120 | set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" 121 | set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 122 | 123 | set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.4.2/maven-wrapper-0.4.2.jar" 124 | FOR /F "tokens=1,2 delims==" %%A IN (%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties) DO ( 125 | IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B 126 | ) 127 | 128 | @REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 129 | @REM This allows using the maven wrapper in projects that prohibit checking in binary data. 130 | if exist %WRAPPER_JAR% ( 131 | echo Found %WRAPPER_JAR% 132 | ) else ( 133 | echo Couldn't find %WRAPPER_JAR%, downloading it ... 134 | echo Downloading from: %DOWNLOAD_URL% 135 | powershell -Command "(New-Object Net.WebClient).DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')" 136 | echo Finished downloading %WRAPPER_JAR% 137 | ) 138 | @REM End of extension 139 | 140 | %MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* 141 | if ERRORLEVEL 1 goto error 142 | goto end 143 | 144 | :error 145 | set ERROR_CODE=1 146 | 147 | :end 148 | @endlocal & set ERROR_CODE=%ERROR_CODE% 149 | 150 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost 151 | @REM check for post script, once with legacy .bat ending and once with .cmd ending 152 | if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat" 153 | if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd" 154 | :skipRcPost 155 | 156 | @REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' 157 | if "%MAVEN_BATCH_PAUSE%" == "on" pause 158 | 159 | if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE% 160 | 161 | exit /B %ERROR_CODE% 162 | -------------------------------------------------------------------------------- /acme-example-api/pom.xml: -------------------------------------------------------------------------------- 1 | 2 | 5 | 4.0.0 6 | 7 | com.github.thomasdarimont.training 8 | acme-example 9 | 2.0.0.0-SNAPSHOT 10 | 11 | acme-example-api 12 | 13 | 14 | 15 | org.springframework.boot 16 | spring-boot-starter-web 17 | 18 | 19 | 20 | org.springframework.boot 21 | spring-boot-starter-test 22 | test 23 | 24 | 25 | 26 | 27 | -------------------------------------------------------------------------------- /acme-example-api/src/main/java/com/acme/app/api/GreetingController.java: -------------------------------------------------------------------------------- 1 | package com.acme.app.api; 2 | 3 | import lombok.extern.slf4j.Slf4j; 4 | import org.springframework.web.bind.annotation.GetMapping; 5 | import org.springframework.web.bind.annotation.RequestMapping; 6 | import org.springframework.web.bind.annotation.RequestParam; 7 | import org.springframework.web.bind.annotation.RestController; 8 | 9 | import java.util.Map; 10 | 11 | @Slf4j 12 | @RestController 13 | @RequestMapping("/api/greetings") 14 | class GreetingController { 15 | 16 | @GetMapping 17 | Object greet(@RequestParam(defaultValue = "world") String name) { 18 | Map data = Map.of("greeting", "Hello " + name, "time", System.currentTimeMillis()); 19 | log.info("\nReturning: {}", data); 20 | return data; 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /acme-example-app/pom.xml: -------------------------------------------------------------------------------- 1 | 4 | 4.0.0 5 | 6 | com.github.thomasdarimont.training 7 | acme-example 8 | 2.0.0.0-SNAPSHOT 9 | 10 | acme-example-app 11 | 12 | 13 | 14 | org.springframework.boot 15 | spring-boot-starter-web 16 | 17 | 18 | org.springframework.boot 19 | spring-boot-starter-tomcat 20 | 21 | 22 | 23 | 24 | 25 | org.springframework.boot 26 | spring-boot-starter-jetty 27 | 28 | 29 | 30 | com.github.thomasdarimont.training 31 | acme-example-api 32 | 33 | 34 | 35 | com.github.thomasdarimont.training 36 | acme-example-ui 37 | 38 | 39 | 40 | org.springframework.boot 41 | spring-boot-devtools 42 | true 43 | 44 | 45 | 46 | org.springframework.boot 47 | spring-boot-starter-test 48 | test 49 | 50 | 51 | 52 | 53 | 54 | 55 | org.springframework.boot 56 | spring-boot-maven-plugin 57 | 58 | 59 | 60 | -------------------------------------------------------------------------------- /acme-example-app/src/main/java/com/acme/app/App.java: -------------------------------------------------------------------------------- 1 | package com.acme.app; 2 | 3 | import org.springframework.boot.SpringApplication; 4 | import org.springframework.boot.autoconfigure.SpringBootApplication; 5 | 6 | @SpringBootApplication 7 | public class App { 8 | 9 | public static void main(String[] args) { 10 | SpringApplication.run(App.class, args); 11 | } 12 | } 13 | 14 | -------------------------------------------------------------------------------- /acme-example-app/src/main/java/com/acme/app/web/WebMvcConfig.java: -------------------------------------------------------------------------------- 1 | package com.acme.app.web; 2 | 3 | import lombok.RequiredArgsConstructor; 4 | import org.springframework.context.annotation.Configuration; 5 | import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; 6 | import org.springframework.web.servlet.config.annotation.ViewControllerRegistry; 7 | import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; 8 | 9 | @Configuration 10 | @RequiredArgsConstructor 11 | class WebMvcConfig implements WebMvcConfigurer { 12 | 13 | @Override 14 | public void addResourceHandlers(ResourceHandlerRegistry registry) { 15 | registry.addResourceHandler("/app/**").addResourceLocations("classpath:/public/"); 16 | } 17 | 18 | @Override 19 | public void addViewControllers(ViewControllerRegistry registry) { 20 | registry.addViewController("/app/").setViewName("forward:/app/index.html"); 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /acme-example-app/src/main/resources/application.yml: -------------------------------------------------------------------------------- 1 | server: 2 | servlet: 3 | context-path: /acme 4 | -------------------------------------------------------------------------------- /acme-example-ui/.babelrc: -------------------------------------------------------------------------------- 1 | { 2 | "presets": [ 3 | [ 4 | "latest" 5 | ] 6 | ], 7 | "plugins": [ 8 | ] 9 | } -------------------------------------------------------------------------------- /acme-example-ui/package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "acme-example-ui-plain", 3 | "version": "1.0.1", 4 | "private": true, 5 | "license": "Apache-2.0", 6 | "scripts": { 7 | "clean": "rm -rf target/classes/public", 8 | "start": "parcel --public-url ./ -d target/classes/public src/main/frontend/index.html", 9 | "watch": "parcel watch --public-url ./ -d target/classes/public src/main/frontend/index.html", 10 | "build": "parcel build --public-url ./ -d target/classes/public src/main/frontend/index.html" 11 | }, 12 | "devDependencies": { 13 | "@babel/core": "^7.0.0-0", 14 | "@babel/plugin-proposal-async-generator-functions": "^7.2.0", 15 | "babel-preset-latest": "^6.24.1", 16 | "less": "^3.9.0", 17 | "typescript": "^3.3.3" 18 | }, 19 | "dependencies": { 20 | "@babel/polyfill": "^7.2.5", 21 | "parcel": "^1.12.4" 22 | } 23 | } 24 | -------------------------------------------------------------------------------- /acme-example-ui/pom.xml: -------------------------------------------------------------------------------- 1 | 4 | 4.0.0 5 | 6 | com.github.thomasdarimont.training 7 | acme-example 8 | 2.0.0.0-SNAPSHOT 9 | 10 | acme-example-ui 11 | 12 | 13 | v12.13.0 14 | v1.19.1 15 | 1.7.6 16 | 17 | 18 | 19 | 20 | 21 | pl.project13.maven 22 | git-commit-id-plugin 23 | 24 | 25 | 26 | 27 | com.github.eirslett 28 | frontend-maven-plugin 29 | ${frontend-maven-plugin.version} 30 | 31 | target 32 | ${basedir} 33 | ${node.version} 34 | ${yarn.version} 35 | 36 | 37 | 38 | 39 | install node and yarn 40 | 41 | install-node-and-yarn 42 | 43 | 44 | 45 | 46 | yarn install 47 | 48 | yarn 49 | 50 | 51 | install 52 | 53 | 54 | 55 | 56 | yarn build 57 | 58 | yarn 59 | 60 | 61 | build 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 72 | 73 | org.eclipse.m2e 74 | lifecycle-mapping 75 | 1.0.0 76 | 77 | 78 | 79 | 80 | 81 | com.github.eirslett 82 | frontend-maven-plugin 83 | [0,) 84 | 85 | install-node-and-yarn 86 | yarn 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | -------------------------------------------------------------------------------- /acme-example-ui/src/main/frontend/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | Acme App 6 | 7 | 8 | 9 | 10 | 11 |

Acme App

12 |

This is cool

13 | 14 |
15 | 16 | 17 | 18 | -------------------------------------------------------------------------------- /acme-example-ui/src/main/frontend/main/hello.ts: -------------------------------------------------------------------------------- 1 | interface Person { 2 | firstName: string; 3 | lastName: string; 4 | } 5 | 6 | function greet(person: Person) { 7 | return "Hello, " + person.firstName + " " + person.lastName; 8 | } 9 | 10 | let user = { firstName: "Buddy", lastName: "Holly" }; 11 | 12 | console.log(greet(user)); 13 | -------------------------------------------------------------------------------- /acme-example-ui/src/main/frontend/main/main.js: -------------------------------------------------------------------------------- 1 | import "@babel/polyfill"; 2 | 3 | function main() { 4 | console.log("Initializing app..."); 5 | 6 | btnGetData.onclick = async () => 7 | { 8 | const resp = await fetch("../api/greetings"); 9 | const payload = await resp.json(); 10 | console.log(payload); 11 | 12 | responseText.innerText = JSON.stringify(payload); 13 | } 14 | } 15 | 16 | main(); 17 | -------------------------------------------------------------------------------- /acme-example-ui/src/main/frontend/style/main.css: -------------------------------------------------------------------------------- 1 | body { 2 | --main-fg-color: red; 3 | --main-bg-color: yellow; 4 | } 5 | 6 | h1 { 7 | color: var(--main-fg-color); 8 | } 9 | 10 | #responseText { 11 | background: var(--main-bg-color); 12 | } 13 | -------------------------------------------------------------------------------- /acme-example-ui/src/main/frontend/style/main.less: -------------------------------------------------------------------------------- 1 | body { 2 | --main-fg-color: red; 3 | --main-bg-color: yellow; 4 | } 5 | 6 | h1 { 7 | color: var(--main-fg-color); 8 | } 9 | 10 | #responseText { 11 | background: var(--main-bg-color); 12 | } 13 | -------------------------------------------------------------------------------- /pom.xml: -------------------------------------------------------------------------------- 1 | 4 | 4.0.0 5 | com.github.thomasdarimont.training 6 | acme-example 7 | 2.0.0.0-SNAPSHOT 8 | pom 9 | 10 | 11 | org.springframework.boot 12 | spring-boot-starter-parent 13 | 2.2.1.RELEASE 14 | 15 | 16 | 17 | 18 | acme-example-api 19 | acme-example-ui 20 | acme-example-app 21 | 22 | 23 | 24 | 11 25 | ${java.version} 26 | ${java.version} 27 | ${java.version} 28 | UTF-8 29 | UTF-8 30 | 31 | 32 | 33 | 34 | org.projectlombok 35 | lombok 36 | true 37 | 38 | 39 | 40 | 41 | 42 | 43 | com.github.thomasdarimont.training 44 | acme-example-api 45 | ${project.version} 46 | 47 | 48 | 49 | com.github.thomasdarimont.training 50 | acme-example-ui 51 | ${project.version} 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | org.springframework.boot 61 | spring-boot-maven-plugin 62 | 63 | true 64 | 65 | 66 | 67 | 68 | build-info 69 | 70 | 71 | 72 | 73 | 74 | 75 | pl.project13.maven 76 | git-commit-id-plugin 77 | 78 | true 79 | 80 | true 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | -------------------------------------------------------------------------------- /readme.md: -------------------------------------------------------------------------------- 1 | # Spring Boot Frontend Integration with ParcelJS 2 | 3 | This example demonstrates a simple approach for including a Javascript frontend in a Spring Boot App. 4 | 5 | ## Overview 6 | The example contains 3 maven modules: 7 | * acme-example-api 8 | * acme-example-ui-plain 9 | * acme-example-app 10 | 11 | The `acme-example-api` contains the backend API and the `acme-example-ui-plain` contains 12 | the Javascript based frontend. Both modules are pulled in as a dependency by `acme-example-app`. 13 | 14 | The `acme-example-ui-plain` maven module uses the `com.github.eirslett:frontend-maven-plugin` 15 | to delegate to the yarn / node tooling during the maven build process. 16 | 17 | As a build tool we use `yarn` which delegates to the [parceljs](https://parceljs.org/) web-application bundler. 18 | 19 | ## Setup 20 | To build the example execute the following in your shell: 21 | ``` 22 | mvn clean verify 23 | ``` 24 | 25 | ## Running 26 | To run the example execute the following in your shell: 27 | ``` 28 | java -jar acme-example-app/target/*.jar 29 | ``` 30 | 31 | Then open http://localhost:8080/acme/app/ in your browser. 32 | 33 | ## Workflow 34 | 35 | For development start the Spring Boot app `acme-example-app` in debug mode and run the `yarn watch` command 36 | in the `acme-example-ui-plain` folder. This will automatically rebuild the Javascript/CSS/html 37 | artifacts when any code beneath the `src/main/frontend` is changed. Source maps and Live-reload are 38 | also enabled by default. 39 | 40 | For deployment simply build the `acme-example-app` maven project via `mvn clean verify` and run the resulting jar. 41 | The artifact from the `acme-example-ui-plain` module will be included in the generated fat-jar. 42 | --------------------------------------------------------------------------------