KTOR-8962 Update the Create a new Ktor project tutorial (#708)

* KTOR-8962 Update the Create a new Ktor project tutorial

* fix wrong library name

* update code snippets

* update the example explanation in maven-assembly-plugin.md

* KTOR-9002 update maven dependency and add a warning for YAML support

* update screenshots and fix casing

* fix final step in second additional task

Author: vnikolova

codeSnippets/settings.gradle.kts

@@ -120,7 +120,6 @@ module("snippets", "deployment-ktor-plugin")
 module("snippets", "tutorial-website-static")
 module("snippets", "server-websockets-sharedflow")
 module("snippets", "tutorial-client-get-started")
-module("snippets", "tutorial-server-get-started")
 module("snippets", "tutorial-server-web-application")
 module("snippets", "server-websockets-serialization")
 module("snippets", "client-websockets-serialization")

codeSnippets/snippets/tutorial-server-get-started-maven/pom.xml

@@ -8,14 +8,14 @@
     <name>tutorial-server-get-started-maven</name>
     <description>tutorial-server-get-started-maven</description>
     <properties>
-        <ktor_version>3.3.1</ktor_version>
         <kotlin.code.style>official</kotlin.code.style>
         <kotlin_version>2.2.20</kotlin_version>
-        <logback_version>1.5.18</logback_version>
-        <slf4j_version>2.0.12</slf4j_version>
+        <ktor_version>3.3.1</ktor_version>
+        <logback_version>1.4.14</logback_version>
+        <slf4j_version>2.0.9</slf4j_version>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <kotlin.compiler.incremental>true</kotlin.compiler.incremental>
-        <main.class>com.example.ApplicationKt</main.class>
+        <main.class>io.ktor.server.netty.EngineMain</main.class>
     </properties>
     <repositories>
     </repositories>
@@ -35,6 +35,11 @@
             <artifactId>logback-classic</artifactId>
             <version>${logback_version}</version>
         </dependency>
+        <dependency>
+            <groupId>io.ktor</groupId>
+            <artifactId>ktor-server-status-pages-jvm</artifactId>
+            <version>${ktor_version}</version>
+        </dependency>
         <dependency>
             <groupId>org.slf4j</groupId>
             <artifactId>slf4j-api</artifactId>
@@ -111,7 +116,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-assembly-plugin</artifactId>
-                <version>2.6</version>
+                <version>3.7.1</version>
                 <configuration>
                     <descriptorRefs>
                         <descriptorRef>jar-with-dependencies</descriptorRef>

codeSnippets/snippets/tutorial-server-get-started-maven/src/main/kotlin/Application.kt

@@ -0,0 +1,11 @@
+package com.example
+
+import io.ktor.server.application.*
+
+fun main(args: Array<String>) {
+    io.ktor.server.netty.EngineMain.main(args)
+}
+
+fun Application.module() {
+    configureRouting()
+}

codeSnippets/snippets/tutorial-server-get-started/src/main/kotlin/com/example/plugins/Routing.kt renamed to codeSnippets/snippets/tutorial-server-get-started-maven/src/main/kotlin/Routing.kt

@@ -1,12 +1,11 @@
-package com.example.plugins
+package com.example
 
-import io.ktor.http.*
+import io.ktor.http.ContentType
 import io.ktor.server.application.*
-import io.ktor.server.http.content.*
+import io.ktor.server.http.content.staticResources
+import io.ktor.server.plugins.statuspages.StatusPages
 import io.ktor.server.response.*
 import io.ktor.server.routing.*
-import io.ktor.server.routing.get
-import io.ktor.server.plugins.statuspages.*
 
 fun Application.configureRouting() {
     install(StatusPages) {
@@ -21,11 +20,14 @@ fun Application.configureRouting() {
             call.respondText("Hello World!")
         }
 
+        // ...
+
         get("/test1") {
             val text = "<h1>Hello From Ktor</h1>"
             val type = ContentType.parse("text/html")
             call.respondText(text, type)
         }
+
         get("/error-test") {
             throw IllegalStateException("Too Busy")
         }

codeSnippets/snippets/tutorial-server-get-started-maven/src/main/kotlin/com/example/Application.kt

@@ -4,7 +4,7 @@
             <pattern>%d{YYYY-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
         </encoder>
     </appender>
-    <root level="trace">
+    <root level="INFO">
         <appender-ref ref="STDOUT"/>
     </root>
     <logger name="org.eclipse.jetty" level="INFO"/>

codeSnippets/snippets/tutorial-server-get-started-maven/src/main/kotlin/com/example/plugins/Routing.kt

@@ -0,0 +1,37 @@
+package com.example
+
+import io.ktor.client.request.get
+import io.ktor.client.statement.bodyAsText
+import io.ktor.http.HttpStatusCode
+import io.ktor.http.contentType
+import io.ktor.server.testing.testApplication
+import kotlin.test.Test
+import kotlin.test.assertContains
+import kotlin.test.assertEquals
+
+class ApplicationTest {
+
+    @Test
+    fun testRoot() = testApplication {
+        application {
+            module()
+        }
+        val response = client.get("/")
+
+        assertEquals(HttpStatusCode.OK, response.status)
+        assertEquals("Hello World!", response.bodyAsText())
+    }
+
+    @Test
+    fun testNewEndpoint() = testApplication {
+        application {
+            module()
+        }
+
+        val response = client.get("/test1")
+
+        assertEquals(HttpStatusCode.OK, response.status)
+        assertEquals("html", response.contentType()?.contentSubtype)
+        assertContains(response.bodyAsText(), "Hello From Ktor")
+    }
+}