├── .gitignore ├── README.MD ├── build.gradle ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat ├── kotlinbackend ├── build.gradle └── src │ └── main │ └── kotlin │ └── Main.kt ├── kotlinfrontend ├── build.gradle └── src │ └── main │ ├── kotlin │ └── main.kt │ └── resources │ ├── css │ └── style.css │ └── index.html └── settings.gradle /.gitignore: -------------------------------------------------------------------------------- 1 | .gradle 2 | .idea 3 | out 4 | build 5 | kotlinfrontend/.gradle 6 | kotlinfrontend/out 7 | kotlinfrontend/build 8 | kotlinbackend/.gradle 9 | kotlinbackend/out 10 | kotlinbackend/.gradle 11 | kotlinfrontend/web 12 | -------------------------------------------------------------------------------- /README.MD: -------------------------------------------------------------------------------- 1 | # Kotlin fullstack example 2 | 3 | A sample project using Kotlin for backend code as well as front-end JavaScript code. 4 | 5 | ## Setup 6 | 7 | Open IntelliJ IDEA and `File > Open` navigate to the directory of the project and select the `build.gradle` file of the root directory. 8 | 9 | After the project is setup, `Build > Build Project`. 10 | 11 | Right-click on `kotlinbackend/.../kotlin/Main.kt` and select `Run 'MainKt'` 12 | 13 | Then, right-click on `out/production/kotlinfrontend/index.html` and select Open in browser. It eveything works, you should see a page with some output from the API call. 14 | 15 | You can call the API's directly by openinng `http://localhost:8080/api/ping` in your browser. You can additionally call pass a path parameter `http://localhost:8080/api/ping/3`. 16 | 17 | You can find more details on my Medium blog [Building a fullstack web-app in Kotlin](https://medium.com/@ali.muzaffar/building-a-full-stack-web-app-in-kotlin-af8e8fe1f5dc) 18 | -------------------------------------------------------------------------------- /build.gradle: -------------------------------------------------------------------------------- 1 | group 'com.alimuzaffar.demo' 2 | version '1.0-SNAPSHOT' 3 | 4 | buildscript { 5 | ext.kotlin_version = '1.1.3' 6 | 7 | repositories { 8 | mavenCentral() 9 | } 10 | dependencies { 11 | classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" 12 | } 13 | } 14 | 15 | apply plugin: 'java' 16 | apply plugin: 'kotlin' 17 | 18 | sourceCompatibility = 1.8 19 | 20 | repositories { 21 | mavenCentral() 22 | } 23 | 24 | dependencies { 25 | compile "org.jetbrains.kotlin:kotlin-stdlib-jre8:$kotlin_version" 26 | testCompile group: 'junit', name: 'junit', version: '4.12' 27 | } 28 | 29 | compileKotlin { 30 | kotlinOptions.jvmTarget = "1.8" 31 | } 32 | compileTestKotlin { 33 | kotlinOptions.jvmTarget = "1.8" 34 | } -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/alphamu/KotlinFullstackSample/f6a323552fd5f052abde26688b75428086b17224/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Tue Jun 27 14:44:35 AEST 2017 2 | distributionBase=GRADLE_USER_HOME 3 | distributionPath=wrapper/dists 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | distributionUrl=https\://services.gradle.org/distributions/gradle-3.3-all.zip 7 | -------------------------------------------------------------------------------- /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 | -------------------------------------------------------------------------------- /kotlinbackend/build.gradle: -------------------------------------------------------------------------------- 1 | group 'com.alimuzaffar.demo' 2 | version '1.0-SNAPSHOT' 3 | 4 | buildscript { 5 | ext.kotlin_version = '1.1.3' 6 | ext.ktorVersion = '0.3.3' 7 | 8 | repositories { 9 | mavenCentral() 10 | } 11 | dependencies { 12 | classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" 13 | } 14 | } 15 | 16 | apply plugin: 'java' 17 | apply plugin: 'kotlin' 18 | 19 | sourceCompatibility = 1.8 20 | 21 | repositories { 22 | mavenCentral() 23 | jcenter() 24 | maven { url "https://dl.bintray.com/kotlin/kotlinx" } 25 | maven { url "https://dl.bintray.com/kotlin/ktor" } 26 | } 27 | 28 | dependencies { 29 | compile "org.jetbrains.kotlin:kotlin-stdlib-jre8:$kotlin_version" 30 | compile "org.jetbrains.ktor:ktor-core:$ktorVersion" 31 | compile "org.jetbrains.ktor:ktor-jetty:$ktorVersion" 32 | compile "org.jetbrains.ktor:ktor-netty:$ktorVersion" 33 | compile group: 'com.google.code.gson', name: 'gson', version: '2.3.1' 34 | testCompile group: 'junit', name: 'junit', version: '4.12' 35 | } 36 | 37 | compileKotlin { 38 | kotlinOptions.jvmTarget = "1.8" 39 | } 40 | compileTestKotlin { 41 | kotlinOptions.jvmTarget = "1.8" 42 | } -------------------------------------------------------------------------------- /kotlinbackend/src/main/kotlin/Main.kt: -------------------------------------------------------------------------------- 1 | /** 2 | * Created by muzaffar ali on 27/6/17. 3 | */ 4 | import com.google.gson.Gson 5 | import org.jetbrains.ktor.application.call 6 | import org.jetbrains.ktor.host.embeddedServer 7 | import org.jetbrains.ktor.http.ContentType 8 | import org.jetbrains.ktor.netty.Netty 9 | import org.jetbrains.ktor.response.header 10 | import org.jetbrains.ktor.response.respondText 11 | import org.jetbrains.ktor.routing.get 12 | import org.jetbrains.ktor.routing.routing 13 | 14 | fun main(args: Array) { 15 | embeddedServer(Netty, 8080) { 16 | routing { 17 | get("/api/ping/{count?}") { 18 | var count: Int = Integer.valueOf(call.parameters["count"]?: "1") 19 | if (count < 1) { 20 | count = 1 21 | } 22 | var obj = Array(count, {i -> Entry("$i: Hello, World!")}) 23 | val gson = Gson() 24 | var str = gson.toJson(obj) 25 | call.response.header("Access-Control-Allow-Origin", "*") 26 | call.respondText(str, ContentType.Application.Json) 27 | 28 | } 29 | } 30 | }.start(wait = true) 31 | } 32 | 33 | data class Entry(val message: String) -------------------------------------------------------------------------------- /kotlinfrontend/build.gradle: -------------------------------------------------------------------------------- 1 | group 'com.alimuzaffar.demo' 2 | version '1.0-SNAPSHOT' 3 | 4 | buildscript { 5 | ext.kotlin_version = '1.1.3' 6 | 7 | repositories { 8 | mavenCentral() 9 | } 10 | dependencies { 11 | classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" 12 | } 13 | } 14 | 15 | apply plugin: 'kotlin2js' 16 | 17 | repositories { 18 | mavenCentral() 19 | } 20 | 21 | dependencies { 22 | compile "org.jetbrains.kotlin:kotlin-stdlib-js:$kotlin_version" 23 | } 24 | 25 | compileKotlin2Js.kotlinOptions.sourceMap = true 26 | compileKotlin2Js.kotlinOptions.outputFile = "${projectDir}/web/js/app.js" 27 | compileKotlin2Js.kotlinOptions.suppressWarnings = true 28 | compileKotlin2Js.kotlinOptions.verbose = true 29 | 30 | build.doLast { 31 | // Copy kotlin.js and kotlin-meta.js from jar into web directory 32 | configurations.compile.each { File file -> 33 | copy { 34 | includeEmptyDirs = false 35 | 36 | from zipTree(file.absolutePath) 37 | into "${projectDir}/web/js/lib" 38 | include { fileTreeElement -> 39 | def path = fileTreeElement.path 40 | path.endsWith(".js") && (path.startsWith("META-INF/resources/") || !path.startsWith("META-INF/")) 41 | } 42 | } 43 | } 44 | 45 | copy { 46 | includeEmptyDirs = false 47 | from "${buildDir}/resources/main" 48 | into "${projectDir}/web" 49 | } 50 | } 51 | 52 | clean.doFirst { 53 | delete "${projectDir}/web" 54 | 55 | } 56 | -------------------------------------------------------------------------------- /kotlinfrontend/src/main/kotlin/main.kt: -------------------------------------------------------------------------------- 1 | import org.w3c.dom.Element 2 | import org.w3c.dom.HTMLInputElement 3 | import org.w3c.dom.HTMLTextAreaElement 4 | import org.w3c.dom.events.Event 5 | import org.w3c.dom.get 6 | import org.w3c.xhr.XMLHttpRequest 7 | import kotlin.browser.document 8 | import kotlin.browser.window 9 | import kotlin.js.Json 10 | 11 | fun main(args: Array) { 12 | window.onload = { 13 | fetch("1") 14 | //Example of how to add stylesheets dynamically 15 | //add stylesheet if we have any 16 | val head = document.getElementsByTagName("head") 17 | head[0]?.appendChild(createStylesheetLink("css/style.css")) 18 | //bind elements 19 | val input = document.getElementById("count_id") as HTMLInputElement 20 | val button = document.getElementById("button_id") 21 | //bind click listener on button 22 | button?.addEventListener("click", fun(event: Event) { 23 | fetch(input.value) 24 | }) 25 | } 26 | } 27 | 28 | fun fetch(count: String): Unit { 29 | val url = "http://localhost:8080/api/ping/$count" 30 | val req = XMLHttpRequest() 31 | req.onloadend = fun(event: Event){ 32 | if (req.status.toInt() != 200) { 33 | return; 34 | } 35 | val text = req.responseText 36 | println(text) 37 | val objArray = JSON.parse>(text) 38 | val textarea = document.getElementById("textarea_id") as HTMLTextAreaElement 39 | textarea.value = "" 40 | objArray.forEach { 41 | val message = it["message"] 42 | textarea.value += "$message\n" 43 | } 44 | } 45 | req.onerror = fun (_) { 46 | 47 | } 48 | req.open("GET", url, true) 49 | req.send() 50 | } 51 | 52 | fun createStylesheetLink(filePath: String): Element { 53 | val style = document.createElement("link") 54 | style.setAttribute("rel", "stylesheet") 55 | style.setAttribute("href", filePath) 56 | return style 57 | } 58 | 59 | external fun alert(message: Any?): Unit 60 | -------------------------------------------------------------------------------- /kotlinfrontend/src/main/resources/css/style.css: -------------------------------------------------------------------------------- 1 | body { 2 | background-color: #f4f4f4; 3 | font-family: arial; 4 | text-size: 3em 5 | } 6 | div, button { 7 | margin-bottom: 10px 8 | } 9 | 10 | button { 11 | width: 100px; 12 | height: 30px 13 | } 14 | -------------------------------------------------------------------------------- /kotlinfrontend/src/main/resources/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | Console Output 6 | 7 | 8 |
9 | 10 | 11 |
12 | 13 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /settings.gradle: -------------------------------------------------------------------------------- 1 | rootProject.name = 'kotlinfullstack' 2 | include 'kotlinbackend' 3 | include 'kotlinfrontend' 4 | include 'kotlinfrontend' 5 | include 'kotlinfrontend' 6 | 7 | --------------------------------------------------------------------------------