📚 Kotlin language features
Kotlin is an object oriented language with functional features. This chapter covers important and relevant features of the language slit into basic and intermediate. Another chapter covers advanced features.
Basic features
Basic constructs (variables, control flow)
- Kotlin is statically typed and supports implicit typing.
- Static typing: types cannot change on runtime (it is the opposite of dynamic typing).
- Implicit typing: the compiler can infer the type whenever possible.
varcreates mutable variables.valcreates immutable variables or constants.- Semi-colons are optional.
- Kotlin supports top level declaration of variables and functions (They can be declared outside of classes).
- String interpolation is available with this syntax
${expression}. if, andwhenstatements are expressions (they can return a value).whenis equivalent to theswitchstatement of other languages- The ternary operator is not available but the
ifstatement replaces-it.
- for-each is the only type of for loop available.
- Object oriented programming is supported as in Java with some additional features such as extensions.
- The compiler supports Null Safety. It allows to write code free from null pointer errors with a compile time guarantee.
- Functional programming is supported (Higher-order functions and functions as 1st class items, etc.).
Use val by default
Replace by var only if needed.
Functions
In the this section, the terms 'argument' and 'parameter' are used interchangeably.
Functions in Kotlin have the following features:
- Declaration:
fun functionName(arg1: type1 = defaultvalue1, ...) : retunrType. - Call a function by passing the value in the declaration order.
- Use argument labels for more clarity, however, it also allows for arbitrary ordering of arguments.
- Optional arguments have a default value and can be omitted during the call.
- Functions are first class items or citizen: they can be assigned to a variable, passed as a function parameter, or returned from a function.
- 💡 A function that takes a function as an argument or returns one is a higher order function.
- A function type can be expressed as follows:
(typeOfParam1, typeOfParam2, etc) -> returnType(The empty return type isUnit). - Anonymous functions use the following syntax
{ argName1, argName2, etc. -> // code }- Also called or lambda functions or literal functions
- The last function argument can be put after the closing after the closing parenthesis
compute(9, 5) { x, y -> x * y }
The next section talk about null safety.
Null safety
In a nutshell, null safety is a compiler feature that eliminates the infamous Null pointer exception or npe. The Kotlin compiler reports errors and warnings when we manipulate nullable (also called optional) values. Here is a list of null safety features provided by Kotlin:
- All types are non-nullable by default; we cannot assign
nullto a variable or an argument.- For example, this code fails
var s: String = null.
- For example, this code fails
- A type can be made nullable by suffixing it with a ?. For example:
var s: String? = null. - Kotlin forbids calling a method or a property of a non-nullable type, unless we do one of these possibilities:
- Use optional chaining with the ? suffix.
- Provide a default value with the elvis ?: operator.
- Smart-cast the nullable into a non-nullable.
- Use the !! operator that eliminates compiler checks. This should never be used.
Never unwrap with !!
Use other safe techniques instead.
Intermediate features
Object oriented programming
Kotlin allows to write concise OOP code and has the following features:
- Available common features: classes, inheritance, interfaces, and abstract classes.
- Native support of properties: do not define getters and setters unless needed.
- Just add
get()andset(value)functions next to the property declaration.
- Just add
- Constructor arguments are defined next to the class name
class ClassName(arg1, atg2, ) - Prefixing a constructor arguments with
valorvarmakes it a property (valmakes it read-only). - The constructor name is
initand does not require parameters. - The compiler checks that all non-nullable properties are initialized by the end of the constructor.
- ⚠️ The compiler does not check the initialization of
lateinitproperties. Thus, accessing them before while uninitialized causes an exception.
- ⚠️ The compiler does not check the initialization of
- Prefix classes with
opento allow inheritance. - Kotlin enables the
publicaccess level by default. - The equality operator
==callsequals()(as opposed to Java which uses reference equality). - A companion object contains static methods and properties.
- Extensions add function and properties to existing classes.
- 💡 They replace inheritance in many situations.
- For example, we can add functions to the String class instead of creating a new
StringUtilsclass.
- Sealed classes and interfaces cannot be extended or implemented by third parties.
Do not define accessors unless needed
As opposed to Java, Kotlin supports properties and allows to add accessors later without refactoring the code that calls these properties. Thus, by default, just define the name of properties without accessors and use them directly.
equals()andhashCode()toString()of the form"class(field=value, ...)"componentN()that correspond to the properties in their order of declaration.copy()
@Test
+fun givenReadOnlyList_whenCastToMutableList_checkNewElementsAdded(){
+ val list: List<String> = listOf("This", "Is", "Totally", "Immutable")
+ (list as MutableList<String>)[2] = "Not"
+ assertEquals(listOf("This", "Is", "Not", "Immutable"), list)
+}
+📅 Workshops
(2023) Android makers : Kotlin Beyond Android
Link
',4),g={href:"https://awl.li/am23-kt",target:"_blank",rel:"noopener noreferrer"},_=e("figure",null,[e("img",{src:s,alt:"qr code",width:"350",tabindex:"0",loading:"lazy"}),e("figcaption",null,"qr code")],-1),b=e("h3",{id:"agenda",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#agenda"},[e("span",null,"Agenda")])],-1),v={href:"https://worldline.github.io/learning-kotlin-multiplatform/",target:"_blank",rel:"noopener noreferrer"},A=e("h2",{id:"_2023-jnation-let-s-discover-the-possibilities-of-kotlin",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#_2023-jnation-let-s-discover-the-possibilities-of-kotlin"},[e("span",null,"(2023) JNation : Let's discover the possibilities of Kotlin")])],-1),K=e("h3",{id:"link-1",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#link-1"},[e("span",null,"Link")])],-1),w={href:"https://awl.li/jnation23-kt",target:"_blank",rel:"noopener noreferrer"},x=e("figure",null,[e("img",{src:"data:image/gif;base64,R0lGODdhkgCSAIAAAAAAAP///ywAAAAAkgCSAAAC/4yPqcvtD6OctNqLs968+w+G4kiW5omm6sq27gvH8kwD9o3jho3ogb8D9G4O3o94MAZzyKAzyUQqj9Ecpcp8LoVUrrZb5AKPw+rwixV7u+nrWmFsg8n07bkOhauz+Ls535cwBTEouBdlRzc1FvcW2MhX+PQ36XgnASllOVdmBbi4qdcpaajXWLl1OpGpaupIqbhGKgo1xlDoo8qq5pbKi8eo2Xl7SJuZSMyHHJsburCLWisrLE28HN08y9bEyUyNedgaaP2ZZm7bfS1Nquupbew+De53Xu96/+wJ7/tF6KwNzRCuTQPhKcvXjha5eQ0AhnvFrR+gS+UO4hMnkaK/c//YfiWM1TEkyJEfS9pbddKkSJUkPbpc+dKbHBED0dGrFxHYL1/B0DhzUTPnTZwQ6Y3SNzJjiGPbFOqMtgznMG9h2oEa2muOxaflfILiWI1qQ2o9K/4cSzHbN4TyzLoq+xWRWaYeroaN9I+bXXSwxM2UWawD0z9wd05Muk5vW59pi4rFMFhuYYl7IR60y/hwwccVKvNEmiiyxpZHJydWW/ldqa7btjYLvZh13MuG5dBWtxELbNSK2T3Ei/tuYKOkL4Dl/XmqQd2cLw6XHTNrR4w6I4NVjviv38DAO7cVvXr3b7nYt/etzT2eBdt5CT+n/D02Zq5Kd1GvKrl9fnWbodL//z/fUK+h5NRCWuU0H3XaoXeeU1sxNJqDmvTHVVC3VUfeI9PYtAGHAy5XoGZCCRfcZ54tNeKHq/FF0Ib6VeJQg+N4x5JvdHVjIYMZmsccjBm6UWOLN5Z1lFc76ijjX+BsZmOLIUolYmNShiXgWck41qSB8F0HoHxeMglaBFxaF9uV55lmYnzE+ajaW0eKF6FAPTbFWpprZveQBlYpFpWTOPLJlo/4+XeclfmwGV+AblE544Acwmake5C912WJf073JoYXjvYogelU+ml5MS0YKVIUWjooZ3HZiWdmU7oK6qYZOAqoeN2dCN+roCIaJ5CGbeliGFoWxyqh5nAaZqqn//7p0LAfFYsnqXK2eeiKmfKDGKK3jgjpp8tS6+x4jdG6nKShkuitY7169ySlPMLSZ6loRruWnuoueieX8WpqKnqlKoXfnq5ZNh6F2+maoJDMgUunfQgSDG1mCSNc5mnqoaTiVGol16qGpQG6arpFGnexc2SSW6eISQYrcmKTYhVetZb6FqfD9RWsJskwrxvysLBWeR9g864HMss9Mwr0Wrx5eCx0nV6Zr9IP09ya1A43uTK2ky4I74xu6jtXvfy6x7CZR3ZNLVEpiuuxxXiVbfE+jDZbNYvOzSw1PvYObCTPOH9LFrcHIgu3qMbue3fV/iXe6caqGrrvwZcGKnR0lP/faLJLigpLp8ZFM72nm8pSeqfW7HYuXGprhz7ti81ZK7rOdf+oIdmBFxqj5gp3TXSafLeOXOVvu46524ITHczmGPY9ecLPWjt88Mj3VjHzIc97/a9h24y6r+9OuDDbN584PNRzV4+x1fGwx/H4OZdPOeJei4m+zw2jP5vlMA9JfV31y9y6n6kscOSg1dGe9gAW2Y1fcose+CLnItoYMFkJnNrD/gW7+8EPe3Pa1oMqqJqASAxL4JPVxKKEtMr5yh+mw9WipAWrE/JHfPQrV5iu5q8KEexC+UMgrzyVNDCZ63C1y1QPjxe23sUMU8ZyXgRJhy4foi5onEOWoOg1rif/4o11uXHh9EaoKOWNTl5FG5lpCoeuK+bqMEuynLTyB0GAjQVthqIb04gYQy9hR4BdvGEd8xKc58lwVy2TY+xq5i4tCo+G3zujHw3JlmWpcYACW1+/yEi+R87PQEHxXPbAoyQ5TTJxpoOkhPR2oE+mJ2KifJ3nRrYus30seYn6GxSh1UgLQqmNR6Tl/prWuA4iyY9q29vnFFZKfHUsjxTjnv8Kk6XuKVNyzEShrZDIyzylUHX8g8ksc8YxEW5yjiVk2ZTg582xlTFugIllAOM3ziHOz3HFe+XgljgrChKJnCrKXbeCyTpJkqyXFYPmDrXHwycO7X6mbCUuIaZMbOUo/2pZeycVT2e4VkrQklUk5AkDis0KorKTU8wP3apZTZDCjWri5CI7k/lGhVLPoEps4CVfdyZd3pSgH9tZPj1JwoSC8oHkHCUAdfWy1AV1p0Ql0xjPhUh3mo+WghwmS90oTDL2lI3p6xPKmqjPUcnUhTndJwu5OlWxwrKoHtUjWlHIMDFqVK0uA2EOUfqfU46Tcavrq/uKmbKYflOql4PiBzNmPMEaj6LXGsECZ0jSx851i/rLK4oMZsHMheifgvuqNdPHvlSa9IJiqSQHc6qtkPrudjiDqe4wldDBRnFOZy3gKoFH198B9LUidajsbNutrZpkgbs1arvQ+MMjwgRw7JuZ6Du/KSOGdCecYmVu+Jy71tXK6qzb2ipxQpjI4BZ2owLl7sWUm0HwzlC8maPqvbLS3d4mbbWoWiRZ/wjf855FiJa0nXkV29C4AnKaudUmYxGbWjDWCogA7GZxxAlWBKtQh2alX6H+qh/iLhjAs7Ph9EKLtQyTdp8cDiWEaYDiFKt4xSxusYtfDOMYy3jGNK6xjW+M4xzreAMFAAA7",alt:"qr code",width:"350",tabindex:"0",loading:"lazy"}),e("figcaption",null,"qr code")],-1),y=e("h3",{id:"agenda-1",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#agenda-1"},[e("span",null,"Agenda")])],-1),q={href:"https://worldline.github.io/learning-kotlin-multiplatform/",target:"_blank",rel:"noopener noreferrer"},W=e("h2",{id:"_2023-mobile-devops-summit",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#_2023-mobile-devops-summit"},[e("span",null,"(2023) Mobile DevOps summit")])],-1),S=e("li",null,[l("Title: "),e("strong",null,"From Android to Multiplatform: leveraging the full potential of Kotlin")],-1),j={href:"https://awl.li/mds23-kt",target:"_blank",rel:"noopener noreferrer"},P=e("figure",null,[e("img",{src:d,alt:"qr code",width:"200",tabindex:"0",loading:"lazy"}),e("figcaption",null,"qr code")],-1),C=e("h3",{id:"agenda-2",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#agenda-2"},[e("span",null,"Agenda")])],-1),L=r('(2024) MiXit
- Titre : Développement front et back en Kotlin. Une visite guidée de KMP
Agenda
',4),M=e("strong",null,"Développement backend",-1),F={href:"https://speakerdeck.com/yostane/kotlin-pour-le-developpement-backend",target:"_blank",rel:"noopener noreferrer"},J=e("strong",null,"Développement frontend",-1),Z=e("strong",null,"Développement fullstack",-1),H=e("strong",null,"Autres fonctionnalités",-1);function O(D,N){const i=a("ExternalLinkIcon"),t=a("RouteLink");return m(),h("div",null,[k,e("p",null,[l("Workshop link: "),e("a",g,[l("awl.li/am23-kt"),n(i)])]),_,b,e("ul",null,[e("li",null,[n(t,{to:"/en/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with Ktor")]),_:1})]),e("li",null,[l("Optional: "),n(t,{to:"/en/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with nodeJS and Kotlin/JS")]),_:1})]),e("li",null,[n(t,{to:"/en/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Front-end development: Kotlin/WASM and Kotlin/JS webapp")]),_:1})]),e("li",null,[n(t,{to:"/en/front-development/#compose"},{default:o(()=>[l("Front-end development: cross-platform Hello world App with Compose multiplatform")]),_:1})]),e("li",null,[e("a",v,[l("Front-end development: Cross-platform Quiz App with Compose multiplatform"),n(i)])]),e("li",null,[n(t,{to:"/en/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Full-stack development: Quiz App with Compose multiplatform and Ktor server")]),_:1})])]),A,K,e("p",null,[l("Workshop link: "),e("a",w,[l("awl.li/jnation23-kt"),n(i)])]),x,y,e("ul",null,[e("li",null,[n(t,{to:"/en/presentation/#prerequisites"},{default:o(()=>[l("Prerequisutes")]),_:1})]),e("li",null,[l("Selection of Kotlin's languages features: "),n(t,{to:"/en/kotlin-features/#null-safety"},{default:o(()=>[l("null safety")]),_:1}),l(" and "),n(t,{to:"/en/kotlin-features/#functions"},{default:o(()=>[l("functions")]),_:1})]),e("li",null,[n(t,{to:"/en/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with Ktor")]),_:1})]),e("li",null,[l("Optional: "),n(t,{to:"/en/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with nodeJS and Kotlin/JS")]),_:1})]),e("li",null,[n(t,{to:"/en/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Front-end development: Kotlin/WASM and Kotlin/JS webapp")]),_:1})]),e("li",null,[n(t,{to:"/en/front-development/#compose"},{default:o(()=>[l("Front-end development: cross-platform Hello world App with Compose multiplatform")]),_:1})]),e("li",null,[e("a",q,[l("Front-end development: Cross-platform Quiz App with Compose multiplatform"),n(i)])]),e("li",null,[n(t,{to:"/en/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Full-stack development: Quiz App with Compose multiplatform and Ktor server")]),_:1})])]),W,e("ul",null,[S,e("li",null,[l("Link: "),e("a",j,[l("awl.li/mds23-kt"),n(i)])])]),P,C,e("ul",null,[e("li",null,[n(t,{to:"/en/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Initiate a cross-platform app")]),_:1})]),e("li",null,[l("Live examples of other Kotlin possibilities: "),e("ul",null,[e("li",null,[n(t,{to:"/en/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with Ktor")]),_:1})]),e("li",null,[n(t,{to:"/en/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with nodeJS and Kotlin/JS")]),_:1})]),e("li",null,[n(t,{to:"/en/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Front-end development: Kotlin/WASM and Kotlin/JS webapp")]),_:1})])])])]),L,e("ul",null,[e("li",null,[n(t,{to:"/en/presentation/#prerequisites"},{default:o(()=>[l("Prérequis")]),_:1})]),e("li",null,[l("Fonctionnalités notables: "),n(t,{to:"/en/kotlin-features/#null-safety"},{default:o(()=>[l("null safety")]),_:1}),l(" et "),n(t,{to:"/en/kotlin-features/#functions"},{default:o(()=>[l("les fonctions")]),_:1})]),e("li",null,[M,e("ul",null,[e("li",null,[e("a",F,[l("Présentation d'introduction à Kotlin pour le développement backend"),n(i)])]),e("li",null,[n(t,{to:"/en/backend-development/#spring-framework"},{default:o(()=>[l("API Rest avec Spring boot")]),_:1})]),e("li",null,[n(t,{to:"/en/backend-development/#ktor"},{default:o(()=>[l("API Rest avec Ktor")]),_:1})])])]),e("li",null,[J,e("ul",null,[e("li",null,[n(t,{to:"/en/front-development/#compose"},{default:o(()=>[l('Application "Hello World" avec Compose Multiplatform')]),_:1})])])]),e("li",null,[Z,e("ul",null,[e("li",null,[n(t,{to:"/en/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Application de quiz avec Ktor + Compose Multiplatform")]),_:1})])])]),e("li",null,[H,e("ul",null,[e("li",null,[n(t,{to:"/en/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Kotlin/WASM")]),_:1})]),e("li",null,[n(t,{to:"/en/backend-development/#nodejs"},{default:o(()=>[l("Développement NodeJS en Kotlin")]),_:1})]),e("li",null,[n(t,{to:"/en/kotlin-features-advanced/#concurrency-and-coroutines"},{default:o(()=>[l("Coroutines")]),_:1})])])])])])}const Y=c(f,[["render",O],["__file","index.html.vue"]]),I=JSON.parse(`{"path":"/en/workshops/","title":"📅 Workshops","lang":"en-US","frontmatter":{},"headers":[{"level":2,"title":"(2023) Android makers : Kotlin Beyond Android","slug":"_2023-android-makers-kotlin-beyond-android","link":"#_2023-android-makers-kotlin-beyond-android","children":[{"level":3,"title":"Link","slug":"link","link":"#link","children":[]},{"level":3,"title":"Agenda","slug":"agenda","link":"#agenda","children":[]}]},{"level":2,"title":"(2023) JNation : Let's discover the possibilities of Kotlin","slug":"_2023-jnation-let-s-discover-the-possibilities-of-kotlin","link":"#_2023-jnation-let-s-discover-the-possibilities-of-kotlin","children":[{"level":3,"title":"Link","slug":"link-1","link":"#link-1","children":[]},{"level":3,"title":"Agenda","slug":"agenda-1","link":"#agenda-1","children":[]}]},{"level":2,"title":"(2023) Mobile DevOps summit","slug":"_2023-mobile-devops-summit","link":"#_2023-mobile-devops-summit","children":[{"level":3,"title":"Agenda","slug":"agenda-2","link":"#agenda-2","children":[]}]},{"level":2,"title":"(2024) MiXit","slug":"_2024-mixit","link":"#_2024-mixit","children":[{"level":3,"title":"Agenda","slug":"agenda-3","link":"#agenda-3","children":[]}]}],"git":{"updatedTime":1713801068000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":10},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":2},{"name":"yostane","email":"1958676+yostane@users.noreply.github.com","commits":1}]},"filePathRelative":"en/workshops/README.md"}`);export{Y as comp,I as data}; diff --git a/assets/index.html-B8Y7MGp7.js b/assets/index.html-B8Y7MGp7.js new file mode 100644 index 00000000..207ffd0b --- /dev/null +++ b/assets/index.html-B8Y7MGp7.js @@ -0,0 +1 @@ +import{_ as a,r as l,o as r,c as o,a as e,b as t,d as i,e as s}from"./app-jR2rC7Ae.js";const c={},d={class:"custom-container tip"},m=e("p",{class:"custom-container-title"},"TIP",-1),u={href:"/",target:"_blank",rel:"noopener noreferrer"},h={href:"/",target:"_blank",rel:"noopener noreferrer"},p=s('Prerequisites
- Connaissance de base en language de programmation orienté object comme Java
- Préparez votre environnement de développement et installez des éléments avant la session (voir la section Outillage)
Liens utiles
',3),_={href:"https://kotlinlang.org/docs/home.html",target:"_blank",rel:"noopener noreferrer"},g={href:"https://github.com/worldline/learning-kotlin",target:"_blank",rel:"noopener noreferrer"};function f(b,v){const n=l("ExternalLinkIcon");return r(),o("div",null,[e("div",d,[m,e("p",null,[t("This training is also available in "),e("a",u,[t("English"),i(n)]),t(" / Cette formation est aussi disponible en "),e("a",h,[t("Anglais"),i(n)])])]),p,e("ul",null,[e("li",null,[e("a",_,[t("Documentation officielle Kotlin"),i(n)])]),e("li",null,[e("a",g,[t("Dépôt Github de la formation"),i(n)])])])])}const x=a(c,[["render",f],["__file","index.html.vue"]]),q=JSON.parse(`{"path":"/fr/","title":"","lang":"fr-FR","frontmatter":{"home":true,"heroImage":"./kotlin_logo.png","tagline":"A beginner's guide to a modern programming language","actions":[{"text":"Débuter →","link":"/fr/presentation/","type":"primary"}],"features":[{"title":"Bien commencer avec Kotlin","details":"lorem"},{"title":"Syntaxe de base","details":"lorem"},{"title":"Exemples","details":"lorem"}],"footer":"Worldline, 2021"},"headers":[{"level":2,"title":"Prerequisites","slug":"prerequisites","link":"#prerequisites","children":[]},{"level":2,"title":"Liens utiles","slug":"liens-utiles","link":"#liens-utiles","children":[]}],"git":{"updatedTime":1660920327000,"contributors":[{"name":"W112314","email":"quentin.carpentier@worldline.com","commits":1},{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":1}]},"filePathRelative":"fr/index.md"}`);export{x as comp,q as data}; diff --git a/assets/index.html-BBhIJwI8.js b/assets/index.html-BBhIJwI8.js new file mode 100644 index 00000000..552d844d --- /dev/null +++ b/assets/index.html-BBhIJwI8.js @@ -0,0 +1,13 @@ +import{_ as c,r as l,o as i,c as o,a as e,b as n,d as t,e as a}from"./app-jR2rC7Ae.js";const u={},r=e("h1",{id:"📚-fonctionnalites-avancees-de-kotlin",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#📚-fonctionnalites-avancees-de-kotlin"},[e("span",null,"📚 Fonctionnalités avancées de Kotlin")])],-1),p=e("h2",{id:"proprietes-deleguees",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#proprietes-deleguees"},[e("span",null,"Propriétés déléguées")])],-1),d=e("p",null,[n("Kotlin permet de déléguer le getter et le setter d'une propriété à un autre objet, appelé délégué. C'est une classe qui définit les méthodes "),e("code",null,"getValue"),n(" et "),e("code",null,"setValue"),n(".")],-1),g=e("p",null,"Kotlin fournit des délégués standard tels que des propriétés paresseuses et des propriétés observables.",-1),I={href:"https://play.kotlinlang.org/#eyJ2ZXJzaW9uIjoiMS43LjEwIiwicGxhdGZvcm0iOiJqYXZhIiwiYXJncyI6IiIsIm5vbmVNYXJrZXJzIjp0cnVlLCJ0aGVtZSI6ImlkZWEiLCJjb2RlIjoiaW1wb3J0IGtvdGxpbi5yYW5kb20uUmFuZG9tXG5pbXBvcnQga290bGluLnByb3BlcnRpZXMuRGVsZWdhdGVzXG5pbXBvcnQga290bGluLnJlZmxlY3QuS1Byb3BlcnR5XG5cbmNsYXNzIFN1cGVySGVybyB7XG4gICAgdmFsIHJhbmRvbVN0cmVuZ3RoOiBJbnQgYnkgbGF6eSB7XG4gICAgICAgIHByaW50bG4oXCJjb21wdXRlZFwiKVxuICAgICAgICBSYW5kb20ubmV4dEludCg1MCwgMTAwKVxuICAgIH1cbiAgICBcbiAgICB2YXIgcG93ZXJOYW1lOiBTdHJpbmcgYnkgRGVsZWdhdGVzLm9ic2VydmFibGUoXCJMYXNlclwiKSB7IF8sIG9sZCwgbmV3IC0+XG4gICAgICAgIHByaW50bG4oXCJDaGFuZ2VkIHBvd2VyIGZyb20gJG9sZCB0byAkbmV3XCIpXG4gICAgfVxuICAgIFxuICAgIHZhciBjb2RlTmFtZTogU3RyaW5nIGJ5IENhcGl0YWxpemVEZWxlZ2F0ZSgpXG59XG5cbmNsYXNzIENhcGl0YWxpemVEZWxlZ2F0ZXtcbiAgICB2YXIgdXBwZXJjYXNlZCA9IFwiXCJcbiAgICBvcGVyYXRvciBmdW4gZ2V0VmFsdWUodGhpc1JlZjogQW55PywgcHJvcGVydHk6IEtQcm9wZXJ0eTwqPik6IFN0cmluZyB7XG4gICAgICAgIHByaW50bG4oXCIkdGhpc1JlZiwgdGhhbmsgeW91IGZvciBkZWxlZ2F0aW5nICcke3Byb3BlcnR5Lm5hbWV9JyB0byBtZSFcIilcbiAgICAgICAgcmV0dXJuIHVwcGVyY2FzZWRcbiAgICB9XG5cbiAgICBvcGVyYXRvciBmdW4gc2V0VmFsdWUodGhpc1JlZjogQW55PywgcHJvcGVydHk6IEtQcm9wZXJ0eTwqPiwgdmFsdWU6IFN0cmluZykge1xuICAgICAgICBwcmludGxuKFwiJyR2YWx1ZScgaGFzIGJlZW4gYXNzaWduZWQgdG8gJyR7cHJvcGVydHkubmFtZX0nIGluICR0aGlzUmVmLlwiKVxuICAgICAgICB1cHBlcmNhc2VkID0gdmFsdWUudXBwZXJjYXNlKClcbiAgICB9XG59XG5cbmZ1biBtYWluKCkge1xuICAgdmFsIHN1cGVyTGFuZGVyID0gU3VwZXJIZXJvKClcbiAgIHByaW50bG4oc3VwZXJMYW5kZXIucmFuZG9tU3RyZW5ndGgpXG4gICBwcmludGxuKHN1cGVyTGFuZGVyLnJhbmRvbVN0cmVuZ3RoKVxuICAgXG4gICBzdXBlckxhbmRlci5wb3dlck5hbWUgPSBcInNwZWVkXCJcbiAgICBcbiAgICBzdXBlckxhbmRlci5jb2RlTmFtZSA9IFwic3VwZXJsYW5kZXJcIlxuICAgIHByaW50bG4oc3VwZXJMYW5kZXIuY29kZU5hbWUpXG59In0=",target:"_blank",rel:"noopener noreferrer"},b=a('Concurrence et coroutines
Kotlin fournit un modèle de concurrence de haut niveau appelé Coroutines. Le développeur peut déléguer la gestion des threads au compilateur et à l'exécution et utiliser des constructions de niveau supérieur aux threads pour exprimer des opérations asynchrones.
Les coroutines de Kotlin tournent autour de ces concepts :
- Une coroutine est une instance de calcul suspendable.
- Kotlin a de nombreuses méthodes pour créer une coroutine telle que
launch.
- Kotlin a de nombreuses méthodes pour créer une coroutine telle que
- Une coroutine doit exister dans une portée de coroutine.
- Par exemple,
runBlockingcrée une portée de coroutine dans laquelle les coroutines peuvent être lancées.
- Par exemple,
- Une coroutine peut exécuter des fonctions de suspension qui peuvent suspendre la coroutine mais ne bloquent pas le thread.
- Par exemple : le
delaysuspend la coroutine mais ne bloque pas le thread sur lequel elle s'exécute. - Les fonctions de suspension sont des opérations qui peuvent prendre du temps telles que les requêtes http et les appels au système de fichiers.
- Par exemple : le
- Le qualificateur
suspenddéfinit une fonction de suspension. Il s'exécute dans une coroutine et peut appeler d'autres fonctions de suspension. Flowpermet de générer une liste de valeurs asynchrones.DeferredetChanneltransfèrent respectivement une valeur unique et un flux de valeurs entre coroutines.
Littéral de fonction avec récepteur et constructeurs de type sécurisé
Comme vu précédemment, les extensions de fonctions ajoute du comportement à des classes existantes sans utiliser l'héritage. À l'intérieur de la définition de l'extension de fonction, nous pouvons référencer implicitement le récepteur d'extension (this).
fun String.countCharacters() = length // or this.length
+println("hello".countCharacters()) // prints 5
+Nous pouvons définir cette extension avec une fonction littérale (ou lambda) au lieu d'une fonction classique (déclarée avec fun).
var extFn: String.() -> Int
+extFn = { length } // extFn is a function literal
+println("hello".extFn()) // prints 5
+println(extFn("hello")) // prints 5
+extFn est une fonction littérale (lambda) qui a accès au récepteur (this). C'est pourquoi on l'appelle une fonction littérale avec récepteur.
extFn("hello") ou extFn("hello") appelle l'extension comme prévu par les fonctions d'extension.
Le type d'une fonction littérale avec récepteur est funName: ReceiverType.(arg1Type, arg2Type, etc.) -> ReturnType et est appelé avec funName(receiverValue, arg1Value, etc.) ou receiverValue.funName(arg1Value, etc.) .). Cependant, ce n'est pas l'aspect le plus intéressant.
La partie importante est extFn = { length } qui peut être placée comme argument de fonction dans une fonction d'ordre supérieur. Le développeur qui appelle la fonction d'ordre supérieur doit définir extFn, qui à son tour a accès au récepteur. Cela permet un style de programmation assez intéressant.
// StirngBuilder uses the builder pattern
+val text = StringBuilder("Temp")
+ .append(1)
+ .append(true)
+ .append("friend")
+ .toString()
+Exercises
Exercise 1
- open the java-integration-exercise projects in the materials folder.
- Have a look at the Java class we provided you in the
src/main/java/com/worldline/learning/kotlin/java2kotlinpackage. (yes, that's the Pokemon class) - Convert that Java class in Kotlin using IntelliJ's awesome copy-pasta tool! (just copy paste the java code in a kotlin file, one is provided at
src/main/kotlin/com/worldline/learning/kotlin/java2kotlin) - Have a look at the generated Kotlin code, and note the major differences you spot!
Dans la suite de ce chapitre, nous explorerons les différentes possibilités individuellement et on fera un projet KMP dans le chapitre suivant.
Kotlin/JS et Kotlin/WASM
- Kotlin/JS peut également cibler le web et même utiliser des frameworks web (tels que react) dans Kolitn.
- Kotlin WASM est une autre possibilité de cibler le web, mais il génère WASM au lieu de code JS pur.
- Il peut être utilisé par exemple pour développer des bibliothèques à forte intensité de calcul.
- Nous pourrons peut-être faire encore plus à l'avenir grâce à l'évolution de toutes ces technologies (Kotlin, WASM et Kotlin/WASM). - Par exemple, [WASI] (https://wasi.dev/) permet à WASM de communiquer avec le système d'exploitation. - Cela signifie que je pourrais voir des projets Kotlin/WASM à l'avenir qui peuvent cibler à la fois le navigateur et le système d'exploitation.
- Continuons à observer 😄.
🧪 Application web Kotlin/WASM
',4),L=t("- L'IDE génère un fichier Kotlin qui sera compilé par la suite en WASM et/ou JS. Kotlin/JS ne génère que du JS tandis que Kotin/WASM génère à la fois du JS et du WASM.
- Dans les deux cas, le point d'entrée du code généré est un fichier JS appelé nom_du_module.js.
- L'IDE génère également dans le dossier des ressources un fichier index.html dont le but est de charger le JS généré (le fichier nom_du_module.js).
- La tâche
wasmBrowserDevelopmentRunoujsWasmBrowserDevelopmentRunlancera un serveur local qui hébergera à la fois les fichiers index.html et les fichiers JS et WASM générés.
- Vérifiez qu'on est sur la dernière version de Kotlin dans build.gradle.kts (l'assistant peut le configurer à une version antérieure).
- Ouvrez src/wasmMain/kotlin/sample.kt et cliquez sur le bouton lancer qui apparaît à côté de la fonction
main. - Si la compilation échoue parce que l'IDE a utilisé la mauvaise tâche gradle, veuillez la changer en
wasmBrowserDevelopmentRunet essayez de l'exécuter à nouveau.
Compose Web vs Compose for Web Canvas
- La surface de l'API de Compose Web est différente des autres cibles de Compose car elle travaille directement avec le DOM.
- Compose for Web Canvas a la même surface d'API que celle du Desktop, Android et iOS car il dessine sur un Canvas et ne manipule pas le DOM.
Cela signifie que le premier a un meilleur support web et que le second a plus de code réutilisable.
🧪 Compose Web
- Créez un nouveau projet IntelliJ -> Compose Multiplaform.
- Choisissez "Single platform" -> "Web" et remplissez les autres champs.
- Choisissez Finish
- IntelliJ peut prendre un certain temps pour préparer le projet et peut demander d'installer des plugins supplémentaires.
- Lancez le serveur de développement de l'application web à l'aide de la commande
./gradlew jsBrowserRun --continuous. - Modifiez
Main.ktcomme suit et lancez l'application. - Ouvrez cette adresse :
localhost:8080.
fun main() {
+ renderComposable(rootElementId = "root") {
+ Div({ style { padding(25.px) } }) {
+ var expanded by remember { mutableStateOf(false) }
+ Button(
+ attrs = {
+ onClick { expanded = !expanded }
+ }
+ ) { Text("Cliquez sur moi") }
+ Div({ style { display(if (expanded) DisplayStyle.Block else DisplayStyle.None) } }) {
+ Text("Cliquez sur moi !")
+ }
+ }
+ }
+}
+🧪 Compose desktop + Android app
- Créez un nouveau projet sur IntelliJ -> Compose Multiplatform.
- Choisissez "multiple platforms" et remplissez les autres champs. Choisissez ensuite Finish.
- IntelliJ commence à préparer le projet et peut demander l'installation de plugins.
- Une fois le projet prêt, lancez l'application Android en utilisant le bouton vert run.
- Lancez l'application desktop en exécutant la fonction principale du projet desktop (qui devrait se trouver dans
Main.kt). - Modifiez
App.ktdans le projet principal comme suit et lancez l'application.
@Composable
+fun App() {
+ val platformName = getPlatformName()
+ Card {
+ var expanded by remember { mutableStateOf(false) }
+ Column(Modifier.clickable { expanded = !expanded }) {
+ Texte(
+ text="Cliquez sur moi !",
+ style = MaterialTheme.typography.h2
+ )
+ AnimatedVisibility(expanded){
+ Texte(
+ text = "Bonjour, \${platformName} 🎊",
+ style = MaterialTheme.typography.h1
+ )
+ }
+ }
+ }
+}
+Pour aller plus loin
',10),ae={href:"https://seb.deleuze.fr/the-huge-potential-of-kotlin-wasm/",target:"_blank",rel:"noopener noreferrer"};function te(oe,le){const s=i("ExternalLinkIcon");return p(),r("div",null,[f,h,e("ul",null,[e("li",null,[n("Côté bureau "),e("ul",null,[e("li",null,[n("Grâce au support de la JVM, Kotlin supporte "),e("a",v,[n("JavaFX"),a(s)]),n(". 💡 Il existe même un équivalent en Kotlin appelé "),e("a",g,[n("tornadofx"),a(s)]),n(".")]),e("li",null,[e("a",_,[n("Compose Multiplatform"),a(s)]),n(" apporte l'API Jetpack Compose sur le bureau, le web et le mobile.")])])]),e("li",null,[n("Sur le web "),e("ul",null,[e("li",null,[e("a",w,[n("Ktor"),a(s)]),n(" peut utiliser des moteurs de modèles "),e("a",x,[n("tels que FreeMarker"),a(s)]),n(" pour créer des pages de serveur.")]),C,S,e("li",null,[e("a",M,[n("Compose Multiplatform"),a(s)]),n(" apporte deux options sur le web: Compose web et Compose for Web Canvas.")])])]),e("li",null,[n("Sur les mobiles "),e("ul",null,[e("li",null,[n("Les développeurs Android utilisent "),e("a",K,[n("Jetpack Compose"),a(s)]),n(" ou l'ancienne méthode de "),q,n(".")]),e("li",null,[e("a",A,[n("Compose Multiplatform"),a(s)]),n(" supporte Android de façon stable et iOS de façon expérimentale.")])])])]),y,z,e("ul",null,[j,e("li",null,[e("a",W,[n("KMP"),a(s)]),n(" s'appuie sur Kotlin native et d'autres fonctionnalités de Kotlin pour aider les développeurs à créer des projets destinés à plusieurs plates-formes en utilisant une base de code Kotlin commune.")])]),J,e("ul",null,[e("li",null,[n("De nombreuses combinaisons de cibles et de cas d'utilisation sont possibles : "),e("ul",null,[e("li",null,[e("a",I,[n("Full-Stack web apps"),a(s)]),n(" : Un projet qui contient un backend et une application web tout en partageant une logique commune.")]),e("li",null,[e("a",D,[n("Bibliothèques multiplateformes"),a(s)])])])]),P]),B,e("ul",null,[L,e("li",null,[n("Créons une application Kotlin/WASM. Tout d'abord, activez l'assistant Kotlin/WASM en activant "),N,n(` dans le registre d'IntelliJ (ouvrez le registre en appuyant deux fois sur shift et en tapant "registry" dans la boîte de recherche). Alternativement, clonez `),e("a",T,[n("ce projet"),a(s)]),n(".")])]),E,e("ul",null,[e("li",null,[n("Le serveur de développement devrait démarrer et vous pouvez ouvrir votre application web sur "),e("a",O,[n("http://localhost:8080/"),a(s)])]),R]),V,e("ul",null,[F,e("li",null,[n("WASM étant un format binaire, nous devons d'abord le convertir au format texte. "),e("ul",null,[G,e("li",null,[n("ou utiliser un convertisseur en ligne "),e("a",X,[n("comme celui-ci"),a(s)])]),H])])]),U,Y,$,e("p",null,[e("a",Q,[n("Compose multiplatform"),a(s)]),n(" est une famille de frameworks d'interface utilisateur déclaratifs pour Android (Jetpack Compose), le bureau (Compose Desktop) et le web (Compose Web). Il dispose d'un support expérimental pour iOS et Web Canvas.")]),e("div",Z,[ee,e("p",null,[n("Bien que très similaire, Compose multiplatform est différent de Jetpack Compose car ce dernier n'est compatible qu'avec Android. Google fournit un "),e("a",ne,[n("JetPack compose tutorial"),a(s)]),n(" pour le développement Android.")])]),se,e("ul",null,[e("li",null,[e("a",ae,[n("L'énorme potentiel de Kotlin/Wasm"),a(s)])])])])}const re=l(b,[["render",te],["__file","index.html.vue"]]),ue=JSON.parse('{"path":"/fr/front-development/","title":"📚 Développement frontend","lang":"fr-FR","frontmatter":{},"headers":[{"level":2,"title":"KMP","slug":"kmp","link":"#kmp","children":[]},{"level":2,"title":"Kotlin/JS et Kotlin/WASM","slug":"kotlin-js-et-kotlin-wasm","link":"#kotlin-js-et-kotlin-wasm","children":[{"level":3,"title":"🧪 Application web Kotlin/WASM","slug":"🧪-application-web-kotlin-wasm","link":"#🧪-application-web-kotlin-wasm","children":[]},{"level":3,"title":"🧪 Application web KotlinJS","slug":"🧪-application-web-kotlinjs","link":"#🧪-application-web-kotlinjs","children":[]}]},{"level":2,"title":"Compose","slug":"compose","link":"#compose","children":[{"level":3,"title":"🧪 Compose Web","slug":"🧪-compose-web","link":"#🧪-compose-web","children":[]},{"level":3,"title":"🧪 Compose desktop + Android app","slug":"🧪-compose-desktop-android-app","link":"#🧪-compose-desktop-android-app","children":[]}]},{"level":2,"title":"Pour aller plus loin","slug":"pour-aller-plus-loin","link":"#pour-aller-plus-loin","children":[]}],"git":{"updatedTime":1696263241000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":5},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":2},{"name":"Ibrahim Gharbi","email":"brah.gharbi@gmail.com","commits":1}]},"filePathRelative":"fr/front-development/README.md"}');export{re as comp,ue as data}; diff --git a/assets/index.html-BOBxFfL8.js b/assets/index.html-BOBxFfL8.js new file mode 100644 index 00000000..2fc8f3dc --- /dev/null +++ b/assets/index.html-BOBxFfL8.js @@ -0,0 +1 @@ +import{_ as l}from"./kotlin-used-for-Bdlavnqs.js";import{_ as r,r as s,o as a,c as h,a as e,b as t,d as o,e as i}from"./app-jR2rC7Ae.js";const d="/learning-kotlin/assets/kotlin-decision-tree-4i7nEr1Z.svg",u={},c=e("h1",{id:"🚀-presentation-of-kotlin",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#🚀-presentation-of-kotlin"},[e("span",null,"🚀 Presentation of Kotlin")])],-1),p=e("p",null,"Kotlin is a modern programming language developed by JetBrains.",-1),m=e("h2",{id:"some-features",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#some-features"},[e("span",null,"Some features")])],-1),f=e("li",null,"Many server frameworks officially support Kotlin such as Spring and Quarkus.",-1),g=e("li",null,"It is the first-class language for writing Android.",-1),_={href:"https://www.graalvm.org/",target:"_blank",rel:"noopener noreferrer"},b=e("li",null,"KMP allows to share code between different platforms.",-1),k=e("li",null,[t("Kotlin can be considered as both "),e("em",null,"fullstack"),t(" and "),e("em",null,"corss-platform"),t(" language.")],-1),w=e("li",null,"Inter-operable with Java.",-1),y=e("li",null,"Provides modern features such as compile-time null safety and data classes.",-1),v=e("li",null,"Supports Object oriented programming and functional programming.",-1),K={href:"https://github.com/Kotlin/KEEP",target:"_blank",rel:"noopener noreferrer"},S=e("h2",{id:"history",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#history"},[e("span",null,"History")])],-1),x=e("ul",null,[e("li",null,"February 15, 2016: Kotlin 1.0 was released."),e("li",null,"January 04, 2017: Spring introduced Kotlin support in Spring 5."),e("li",null,"At Google I/O 2017, Google announced first-class support for Kotlin on Android."),e("li",null,"On 7 May 2019, Google announced that Kotlin the preferred language for Android app developers."),e("li",null,"June 2022: Kotlin 1.7 was released with the version of the new K2 compiler.")],-1),J=e("h2",{id:"some-numbers-and-facts",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#some-numbers-and-facts"},[e("span",null,"Some numbers and facts")])],-1),A={href:"https://medium.com/predict/8-stats-and-fact-you-should-know-about-kotlin-in-2021-b41133a1834",target:"_blank",rel:"noopener noreferrer"},P=e("ul",null,[e("li",null,"As of 2022, Kotlin is used by 7.8% of the industry experts."),e("li",null,"According to StackOverflow, Kotlin was the 4th most beloved language in 2020 with 62.9% votes."),e("li",null,"Kotlin is now listed among the top 20 programming languages by Redmonk."),e("li",null,"Kotlin is among the top 3 languages that most businesses are planning to migrate their apps to in 2022."),e("li",null,"Kotlin is used by global companies like Google, NetFlix, Amazon, Trello, and more."),e("li",null,"Pinterest and Uber are among the companies that migrated their apps to Kotlin from Java.")],-1),E=e("figure",null,[e("img",{src:l,alt:"kotlin used for what?",tabindex:"0",loading:"lazy"}),e("figcaption",null,"kotlin used for what?")],-1),I=e("p",null,"Please find more statics here:",-1),j={href:"https://www.jetbrains.com/lp/kotlin-census-2020/",target:"_blank",rel:"noopener noreferrer"},O={href:"https://www.jetbrains.com/lp/devecosystem-2021/kotlin/",target:"_blank",rel:"noopener noreferrer"},B=i('Why switch from Java to Kotlin
Here are some arguments that motivate switching from Java (version 17 LTS at the time of writing) to Kotlin.
- Kotlin supports more targets than Java.
- Kotlin has compile time null-safety (Java Optionals are runtime wrappers for nullable values and null annotations have less features).
- Kotlin strings support interpolation.
- Casting in Kotlin is smart.
- Kotlin functional programming features are better. It even allows to define Type-Safe builders and DSLs.
- Kotlin can be mixed with Java code, thus helping the migration process.
You can read more arguments in these articles:
',4),V={href:"https://codersera.com/blog/java-vs-kotlin/",target:"_blank",rel:"noopener noreferrer"},M={href:"https://www.geeksforgeeks.org/8-reasons-why-you-should-switch-to-kotlin-from-java",target:"_blank",rel:"noopener noreferrer"},T=i('A decision tree to help you decide if you should use Kotlin
Prerequisites
',3),W=e("li",null,[e("em",null,"Recommended"),t(": IntelliJ IDEA (Both community or ultimate are OK),")],-1),q=e("em",null,"or",-1),D={href:"https://gitpod.io/#https://github.com/worldline/learning-kotlin",target:"_blank",rel:"noopener noreferrer"},F=e("em",null,"material",-1),G=e("li",null,[e("em",null,"or"),t(" VSCode (with Kotlin and Java plugins) + JDK 17 (install via scoop.sh on windows or SDK man on Unix) + gradle")],-1),N=e("h2",{id:"📖-further-reading",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#📖-further-reading"},[e("span",null,"📖 Further reading")])],-1),L={href:"https://en.wikipedia.org/wiki/Kotlin_(programming_language)",target:"_blank",rel:"noopener noreferrer"},R={href:"https://spring.io/blog/2017/01/04/introducing-kotlin-support-in-spring-framework-5-0",target:"_blank",rel:"noopener noreferrer"},C={href:"https://medium.com/predict/8-stats-and-fact-you-should-know-about-kotlin-in-2021-b41133a1834",target:"_blank",rel:"noopener noreferrer"},z={href:"https://dev.to/aashiya123/why-should-you-learn-kotlin-in-2021-57e2",target:"_blank",rel:"noopener noreferrer"},H={href:"https://kotlin.link/",target:"_blank",rel:"noopener noreferrer"},U={href:"https://kotlin.libhunt.com/",target:"_blank",rel:"noopener noreferrer"};function Y(Q,Z){const n=s("ExternalLinkIcon");return a(),h("div",null,[c,p,m,e("ul",null,[e("li",null,[t("Kotlin compiles to many targets: the JVM, JS, WASM, Android, iOS, Desktop, native code, etc. "),e("ul",null,[f,g,e("li",null,[t("Kotlin can compile to native with Kotlin native or with "),e("a",_,[t("GraalVM"),o(n)]),t(".")]),b])]),k,w,y,v,e("li",null,[e("a",K,[t("Kotlin KEEP"),o(n)]),t(" is its open source evolution process.")])]),S,x,J,e("p",null,[e("a",A,[t("Source: Amyra Sheldon"),o(n)])]),P,E,I,e("ul",null,[e("li",null,[e("a",j,[t("Kotlin Census 2020"),o(n)])]),e("li",null,[e("a",O,[t("JetBrains' Kotlin state in 2021"),o(n)])])]),B,e("ul",null,[e("li",null,[e("a",V,[t("Java Vs Kotlin: Which One Is Better To Learn In 2022?"),o(n)])]),e("li",null,[e("a",M,[t("8 Reasons Why You Should Switch To Kotlin From Java"),o(n)])])]),T,e("ul",null,[W,e("li",null,[q,t(" GitPod by opening "),e("a",D,[t("https://gitpod.io/#https://github.com/worldline/learning-kotlin"),o(n)]),t(" to create a workspace and then browser to the "),F,t(" folder,")]),G]),N,e("ul",null,[e("li",null,[e("a",L,[t("Kotlin on Wikipedia"),o(n)])]),e("li",null,[e("a",R,[t("Introducing Kotlin support in Spring Framework 5.0"),o(n)])]),e("li",null,[e("a",C,[t("8 stats and facts you should know about Kotlin in 2022"),o(n)])]),e("li",null,[e("a",z,[t("Why should you learn Kotlin in 2022?"),o(n)])]),e("li",null,[e("a",H,[t("Kotlin is awesome"),o(n)])]),e("li",null,[e("a",U,[t("Awesome Kotlin"),o(n)])])])])}const ee=r(u,[["render",Y],["__file","index.html.vue"]]),te=JSON.parse('{"path":"/en/presentation/","title":"🚀 Presentation of Kotlin","lang":"en-US","frontmatter":{},"headers":[{"level":2,"title":"Some features","slug":"some-features","link":"#some-features","children":[]},{"level":2,"title":"History","slug":"history","link":"#history","children":[]},{"level":2,"title":"Some numbers and facts","slug":"some-numbers-and-facts","link":"#some-numbers-and-facts","children":[]},{"level":2,"title":"Why switch from Java to Kotlin","slug":"why-switch-from-java-to-kotlin","link":"#why-switch-from-java-to-kotlin","children":[]},{"level":2,"title":"A decision tree to help you decide if you should use Kotlin","slug":"a-decision-tree-to-help-you-decide-if-you-should-use-kotlin","link":"#a-decision-tree-to-help-you-decide-if-you-should-use-kotlin","children":[]},{"level":2,"title":"Prerequisites","slug":"prerequisites","link":"#prerequisites","children":[]},{"level":2,"title":"📖 Further reading","slug":"📖-further-reading","link":"#📖-further-reading","children":[]}],"git":{"updatedTime":1704373434000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":10},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":3}]},"filePathRelative":"en/presentation/README.md"}');export{ee as comp,te as data}; diff --git a/assets/index.html-CDMPFPby.js b/assets/index.html-CDMPFPby.js new file mode 100644 index 00000000..c86407ad --- /dev/null +++ b/assets/index.html-CDMPFPby.js @@ -0,0 +1 @@ +import{_ as r}from"./logo_worldline-dinT9MYm.js";import{_ as o,r as s,o as l,c,a as e,b as t,d as a,e as i}from"./app-jR2rC7Ae.js";const d={},h=i('Welcome
Who we are
We design payments technology that powers the growth of millions of businesses around the world. Engineering the next frontiers in payments technology
- Leader in payment and secured transactions
- Over 50 billion transactions/year
- 7000+ engineers in over 40 countries
- A huge & diverse tech-stack
Prerequisites
- Basic knowledge of object-oriented language like Java
- Prepare your development environment and install stuff before the session (see Tooling section)
Useful links
',3),_={href:"https://kotlinlang.org/docs/home.html",target:"_blank",rel:"noopener noreferrer"},b={href:"https://github.com/worldline/learning-kotlin",target:"_blank",rel:"noopener noreferrer"};function k(v,w){const n=s("ExternalLinkIcon");return l(),c("div",null,[h,e("div",p,[u,e("p",null,[t("This training is also available in "),e("a",m,[t("French"),a(n)]),t(" / Cette formation est aussi disponible en "),e("a",f,[t("Français"),a(n)])])]),g,e("ul",null,[e("li",null,[e("a",_,[t("Official Kotlin documentation"),a(n)])]),e("li",null,[e("a",b,[t("GitHub repository for this training"),a(n)])])])])}const W=o(d,[["render",k],["__file","index.html.vue"]]),P=JSON.parse(`{"path":"/en/","title":"Welcome","lang":"en-US","frontmatter":{"home":true,"heroImage":"./kotlin_logo.png","tagline":"A beginner's guide to a modern programming language","actions":[{"text":"Get started →","link":"/en/presentation/","type":"primary"}],"features":[{"title":"Language features","details":"null safety, extensions, lambdas, Java interoperability and more"},{"title":"Backend development","details":"With Ktor, spring and NodeJS"},{"title":"Frontend development","details":"Compose multiplatform, Kotlin/JS, Kotlin/WASM and JVM frameworks"},{"title":"Cross-platform development","details":"With KMP and Compose multiplatform"},{"title":"Advanced Kotlin","details":"Coroutines, delegates, Function literal with receiver, DSLs and more"},{"title":"Practical exercises and solutions","details":"All chapters have a set of exercises"}],"footer":"Worldline, 2023"},"headers":[{"level":2,"title":"Who we are","slug":"who-we-are","link":"#who-we-are","children":[]},{"level":2,"title":"Prerequisites","slug":"prerequisites","link":"#prerequisites","children":[]},{"level":2,"title":"Useful links","slug":"useful-links","link":"#useful-links","children":[]}],"git":{"updatedTime":1693839440000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":6}]},"filePathRelative":"en/index.md"}`);export{W as comp,P as data}; diff --git a/assets/index.html-C_I161o0.js b/assets/index.html-C_I161o0.js new file mode 100644 index 00000000..67ffd5fa --- /dev/null +++ b/assets/index.html-C_I161o0.js @@ -0,0 +1 @@ +import{_ as r}from"./logo_worldline-dinT9MYm.js";import{_ as o,r as s,o as l,c,a as e,b as t,d as i,e as a}from"./app-jR2rC7Ae.js";const d={},h=a('Welcome
Who we are
We design payments technology that powers the growth of millions of businesses around the world. Engineering the next frontiers in payments technology
- Leader in payment and secured transactions
- Over 50 billion transactions/year
- 7000+ engineers in over 40 countries
- A huge & diverse tech-stack
Prerequisites
- Basic knowledge of object-oriented language like Java
- Prepare your development environment and install stuff before the session (see Tooling section)
Useful links
',3),_={href:"https://kotlinlang.org/docs/home.html",target:"_blank",rel:"noopener noreferrer"},b={href:"https://github.com/worldline/learning-kotlin",target:"_blank",rel:"noopener noreferrer"};function k(v,w){const n=s("ExternalLinkIcon");return l(),c("div",null,[h,e("div",m,[p,e("p",null,[t("This training is also available in "),e("a",u,[t("French"),i(n)]),t(" / Cette formation est aussi disponible en "),e("a",f,[t("Français"),i(n)])])]),g,e("ul",null,[e("li",null,[e("a",_,[t("Official Kotlin documentation"),i(n)])]),e("li",null,[e("a",b,[t("Github repository for this training"),i(n)])])])])}const W=o(d,[["render",k],["__file","index.html.vue"]]),q=JSON.parse(`{"path":"/","title":"Welcome","lang":"en-US","frontmatter":{"home":true,"heroImage":"./kotlin_logo.png","tagline":"A beginner's guide to a modern programming language","actions":[{"text":"Get started →","link":"/en/presentation/","type":"primary"}],"features":[{"title":"Language features","details":"null safety, extensions, lambdas, Java interoperability and more"},{"title":"Backend development","details":"With Ktor, spring and NodeJS"},{"title":"Frontend development","details":"Compose multiplatform, Kotlin/JS, Kotlin/WASM and JVM frameworks"},{"title":"Cross-platform development","details":"With KMP and Compose multiplatform"},{"title":"Advanced Kotlin","details":"Coroutines, delegates, Function literal with receiver, DSLs and more"},{"title":"Practical exercises and solutions","details":"All chapters have a set of exercises"}],"footer":"Worldline, 2023"},"headers":[{"level":2,"title":"Who we are","slug":"who-we-are","link":"#who-we-are","children":[]},{"level":2,"title":"Prerequisites","slug":"prerequisites","link":"#prerequisites","children":[]},{"level":2,"title":"Useful links","slug":"useful-links","link":"#useful-links","children":[]}],"git":{"updatedTime":1693583972000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":4},{"name":"W112314","email":"quentin.carpentier@worldline.com","commits":2}]},"filePathRelative":"index.md"}`);export{W as comp,q as data}; diff --git a/assets/index.html-Cd7wtrxg.js b/assets/index.html-Cd7wtrxg.js new file mode 100644 index 00000000..3bcbf4de --- /dev/null +++ b/assets/index.html-Cd7wtrxg.js @@ -0,0 +1 @@ +import{_ as o}from"./kotlin-used-for-Bdlavnqs.js";import{_ as r,r as s,o as a,c as u,a as e,b as n,d as l,e as i}from"./app-jR2rC7Ae.js";const c={},d=e("h1",{id:"🚀-presentation-de-kotlin",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#🚀-presentation-de-kotlin"},[e("span",null,"🚀 Présentation de Kotlin")])],-1),p=e("p",null,"Kotlin est un langage de programmation moderne développé par JetBrains.",-1),h=e("h2",{id:"certaines-fonctionnalites",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#certaines-fonctionnalites"},[e("span",null,"Certaines fonctionnalités")])],-1),f=i("- Pris en charge officiellement par de grands frameworks back-end, tels que Spring et Quarkus,
- Langage préféré pour le développement Android,
- Kotlin Native compile en code natif,
- Kotlin peut être considéré comme un langage fullstack
Pourquoi passer de Java à Kotlin
Voici quelques arguments qui motivent le passage de Java (version 17 LTS au moment de la rédaction) à Kotlin.
- Kotlin prend en charge plus de cibles que Java.
- Kotlin protège des références null à la compilation (les
OptionalJava sont ne sont pas de protections à la compilation). - Les chaînes de caractères Kotlin prennent en charge l'interpolation.
- Les fonctionnalités de programmation fonctionnelle de Kotlin sont meilleures. Il permet même de définir des constructeurs et des DSL (Domain Specific Language) dont le typage est sécurisé (type-safe).
- Kotlin peut être mélangé avec du code Java, facilitant ainsi le processus de migration.
Vous pouvez lire plus d'arguments dans ces articles :
',4),E={href:"https://codersera.com/blog/java-vs-kotlin/",target:"_blank",rel:"noopener noreferrer"},A=e("li",null,"[8 raisons pour lesquelles vous devriez passer à Kotlin depuis Java] (https://www.geeksforgeeks.org/8-reasons-why-you-should-switch-to-kotlin-from-java)",-1),V=e("h2",{id:"sources-et-plus-de-lecture",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#sources-et-plus-de-lecture"},[e("span",null,"Sources et plus de lecture")])],-1),B={href:"https://en.wikipedia.org/wiki/Kotlin_(programming_language)",target:"_blank",rel:"noopener noreferrer"},N={href:"https://spring.io/blog/2017/01/04/introducing-kotlin-support-in-spring-framework-5-0",target:"_blank",rel:"noopener noreferrer"},z={href:"https://medium.com/predict/8-stats-and-fact-you-should-know-about-kotlin-in-2021-b41133a1834",target:"_blank",rel:"noopener noreferrer"},G={href:"https://dev.to/aashiya123/why-should-you-learn-kotlin-in-2021-57e2",target:"_blank",rel:"noopener noreferrer"};function O(R,I){const t=s("ExternalLinkIcon");return a(),u("div",null,[d,p,h,e("ul",null,[f,e("li",null,[n("Processus d'évolution open source: "),e("a",m,[n("Kotlin KEEP"),l(t)]),n(".")])]),g,_,v,e("p",null,[e("a",k,[n("Source : Amyra Sheldon"),l(t)])]),e("ul",null,[b,K,q,w,x,e("li",null,[n("Plusieurs entreprises dont "),e("a",S,[n("Google"),l(t)]),n(", Pinterest et Uber ont migré leurs applications de Java vers Kotlin.")])]),y,J,e("ul",null,[e("li",null,[e("a",P,[n("Recensement Kotlin 2020"),l(t)])]),e("li",null,[e("a",L,[n("État Kotlin de JetBrains en 2021"),l(t)])])]),j,e("ul",null,[e("li",null,[e("a",E,[n("Java Vs Kotlin : Lequel vaut-il mieux apprendre en 2022 ?"),l(t)])]),A]),V,e("ul",null,[e("li",null,[e("a",B,[n("Kotlin sur Wikipedia"),l(t)])]),e("li",null,[e("a",N,[n("Présentation de la prise en charge de Kotlin dans Spring Framework 5.0"),l(t)])]),e("li",null,[e("a",z,[n("8 statistiques et faits à connaître sur Kotlin en 2022"),l(t)])]),e("li",null,[e("a",G,[n("Pourquoi devriez-vous apprendre Kotlin en 2022 ?"),l(t)])])])])}const C=r(c,[["render",O],["__file","index.html.vue"]]),D=JSON.parse('{"path":"/fr/presentation/","title":"🚀 Présentation de Kotlin","lang":"fr-FR","frontmatter":{},"headers":[{"level":2,"title":"Certaines fonctionnalités","slug":"certaines-fonctionnalites","link":"#certaines-fonctionnalites","children":[]},{"level":2,"title":"Histoire","slug":"histoire","link":"#histoire","children":[]},{"level":2,"title":"Quelques chiffres et faits","slug":"quelques-chiffres-et-faits","link":"#quelques-chiffres-et-faits","children":[]},{"level":2,"title":"Pourquoi passer de Java à Kotlin","slug":"pourquoi-passer-de-java-a-kotlin","link":"#pourquoi-passer-de-java-a-kotlin","children":[]},{"level":2,"title":"Sources et plus de lecture","slug":"sources-et-plus-de-lecture","link":"#sources-et-plus-de-lecture","children":[]}],"git":{"updatedTime":1696262637000,"contributors":[{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":1},{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":1}]},"filePathRelative":"fr/presentation/README.md"}');export{C as comp,D as data}; diff --git a/assets/index.html-CrQuKRiG.js b/assets/index.html-CrQuKRiG.js new file mode 100644 index 00000000..d1f37a60 --- /dev/null +++ b/assets/index.html-CrQuKRiG.js @@ -0,0 +1 @@ +import{_ as n}from"./kmp_codelab-CiTPMWjt.js";import{_ as i,r,o as l,c as s,a as e,b as o,d as a}from"./app-jR2rC7Ae.js";const c={},m=e("h1",{id:"🛠-let-s-make-a-cross-plaform-app",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#🛠-let-s-make-a-cross-plaform-app"},[e("span",null,"🛠 Let's make a cross-plaform app !")])],-1),d=e("p",null,"By combining KMP and Compose, it is possible to fully develop cross-platform mobile, web and desktop apps using only Kotlin.",-1),h=e("h4",{id:"prerequisites",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#prerequisites"},[e("span",null,"Prerequisites")])],-1),p=e("li",null,"Basic knowledge of kotlin development (nullability,inline & lambda functions mainly)",-1),_={href:"https://developer.android.com/studio",target:"_blank",rel:"noopener noreferrer"},u=e("strong",null,"Giraffe",-1),b=e("li",null,"A good connectivity",-1),f={class:"custom-container tip"},g=e("p",{class:"custom-container-title"},"TIP",-1),k={href:"https://kotlinlang.org/docs/multiplatform-mobile-setup.html#next-step",target:"_blank",rel:"noopener noreferrer"},v={id:"🚀-start-the-practical-work-here-🚀",tabindex:"-1"},w={class:"header-anchor",href:"#🚀-start-the-practical-work-here-🚀"},x={href:"https://worldline.github.io/learning-kotlin-multiplatform/overview/",target:"_blank",rel:"noopener noreferrer"},y=e("figure",null,[e("a",{href:"%5Bhttps://worldline.github.io/learning-kotlin-multiplatform/%5D(https://worldline.github.io/learning-kotlin-multiplatform/overview/)"},[e("img",{src:n,alt:"kmp codelab",tabindex:"0",loading:"lazy"})]),e("figcaption",null,"kmp codelab")],-1);function B(E,I){const t=r("ExternalLinkIcon");return l(),s("div",null,[m,d,h,e("ul",null,[p,e("li",null,[e("a",_,[o("Android Studio IDE"),a(t)]),o(" with latest stable version "),u,o(" version or above")]),b]),e("div",f,[g,e("p",null,[o("For more information about your DEV environment and installs please have a look to jetbrain related "),e("a",k,[o("docs"),a(t)])])]),e("h1",v,[e("a",w,[e("span",null,[e("a",x,[o(" _____ 🚀 Start the practical work here 🚀_____"),a(t)])])])]),y])}const L=i(c,[["render",B],["__file","index.html.vue"]]),N=JSON.parse(`{"path":"/en/other-technologies/","title":"🛠 Let's make a cross-plaform app !","lang":"en-US","frontmatter":{},"headers":[],"git":{"updatedTime":1696345169000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":13},{"name":"Ibrahim Gharbi","email":"brah.gharbi@gmail.com","commits":4},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":1}]},"filePathRelative":"en/other-technologies/README.md"}`);export{L as comp,N as data}; diff --git a/assets/index.html-D9WLw91N.js b/assets/index.html-D9WLw91N.js new file mode 100644 index 00000000..e6f01c5d --- /dev/null +++ b/assets/index.html-D9WLw91N.js @@ -0,0 +1,13 @@ +import{_ as i,r as l,o as c,c as o,a as n,b as e,d as s,e as t}from"./app-jR2rC7Ae.js";const r={},p=n("h1",{id:"📚-advanced-and-other-kotlin-features",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#📚-advanced-and-other-kotlin-features"},[n("span",null,"📚 Advanced and other Kotlin features")])],-1),u=n("h2",{id:"delegated-properties",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#delegated-properties"},[n("span",null,"Delegated properties")])],-1),d=n("p",null,[e("Kotlin allows to delegate the getter and setter of a property to another object, which is called a delegate. It is a class that defines the "),n("code",null,"getValue"),e(" and "),n("code",null,"setValue"),e(" methods.")],-1),g=n("p",null,"Kotlin provides standard delegates such lazy properties and observable properties.",-1),I={href:"https://play.kotlinlang.org/#eyJ2ZXJzaW9uIjoiMS43LjEwIiwicGxhdGZvcm0iOiJqYXZhIiwiYXJncyI6IiIsIm5vbmVNYXJrZXJzIjp0cnVlLCJ0aGVtZSI6ImlkZWEiLCJjb2RlIjoiaW1wb3J0IGtvdGxpbi5yYW5kb20uUmFuZG9tXG5pbXBvcnQga290bGluLnByb3BlcnRpZXMuRGVsZWdhdGVzXG5pbXBvcnQga290bGluLnJlZmxlY3QuS1Byb3BlcnR5XG5cbmNsYXNzIFN1cGVySGVybyB7XG4gICAgdmFsIHJhbmRvbVN0cmVuZ3RoOiBJbnQgYnkgbGF6eSB7XG4gICAgICAgIHByaW50bG4oXCJjb21wdXRlZFwiKVxuICAgICAgICBSYW5kb20ubmV4dEludCg1MCwgMTAwKVxuICAgIH1cbiAgICBcbiAgICB2YXIgcG93ZXJOYW1lOiBTdHJpbmcgYnkgRGVsZWdhdGVzLm9ic2VydmFibGUoXCJMYXNlclwiKSB7IF8sIG9sZCwgbmV3IC0+XG4gICAgICAgIHByaW50bG4oXCJDaGFuZ2VkIHBvd2VyIGZyb20gJG9sZCB0byAkbmV3XCIpXG4gICAgfVxuICAgIFxuICAgIHZhciBjb2RlTmFtZTogU3RyaW5nIGJ5IENhcGl0YWxpemVEZWxlZ2F0ZSgpXG59XG5cbmNsYXNzIENhcGl0YWxpemVEZWxlZ2F0ZXtcbiAgICB2YXIgdXBwZXJjYXNlZCA9IFwiXCJcbiAgICBvcGVyYXRvciBmdW4gZ2V0VmFsdWUodGhpc1JlZjogQW55PywgcHJvcGVydHk6IEtQcm9wZXJ0eTwqPik6IFN0cmluZyB7XG4gICAgICAgIHByaW50bG4oXCIkdGhpc1JlZiwgdGhhbmsgeW91IGZvciBkZWxlZ2F0aW5nICcke3Byb3BlcnR5Lm5hbWV9JyB0byBtZSFcIilcbiAgICAgICAgcmV0dXJuIHVwcGVyY2FzZWRcbiAgICB9XG5cbiAgICBvcGVyYXRvciBmdW4gc2V0VmFsdWUodGhpc1JlZjogQW55PywgcHJvcGVydHk6IEtQcm9wZXJ0eTwqPiwgdmFsdWU6IFN0cmluZykge1xuICAgICAgICBwcmludGxuKFwiJyR2YWx1ZScgaGFzIGJlZW4gYXNzaWduZWQgdG8gJyR7cHJvcGVydHkubmFtZX0nIGluICR0aGlzUmVmLlwiKVxuICAgICAgICB1cHBlcmNhc2VkID0gdmFsdWUudXBwZXJjYXNlKClcbiAgICB9XG59XG5cbmZ1biBtYWluKCkge1xuICAgdmFsIHN1cGVyTGFuZGVyID0gU3VwZXJIZXJvKClcbiAgIHByaW50bG4oc3VwZXJMYW5kZXIucmFuZG9tU3RyZW5ndGgpXG4gICBwcmludGxuKHN1cGVyTGFuZGVyLnJhbmRvbVN0cmVuZ3RoKVxuICAgXG4gICBzdXBlckxhbmRlci5wb3dlck5hbWUgPSBcInNwZWVkXCJcbiAgICBcbiAgICBzdXBlckxhbmRlci5jb2RlTmFtZSA9IFwic3VwZXJsYW5kZXJcIlxuICAgIHByaW50bG4oc3VwZXJMYW5kZXIuY29kZU5hbWUpXG59In0=",target:"_blank",rel:"noopener noreferrer"},b=t('Concurrency and Coroutines
Kotlin provides a high level concurrency model called Coroutines. The developer can delegated the management of threads to the compiler and runtime and using higher level constructs than threads to express asynchronous operations.
Coroutines in Kotlin revolve around these concepts:
- A coroutine is an instance of suspendable computation.
- Kotlin has many methods for creating a coroutine such as
launch.
- Kotlin has many methods for creating a coroutine such as
- A coroutine must exist within a coroutine scope.
- For example
runBlockingcreates a coroutine scope whithin which coroutines can be launched.
- For example
- A coroutine can run suspend functions which can suspend the coroutine but do not block the thread.
- For example: the
delaysuspend the coroutine but does not block the thread on which it is running. - Suspend functions are operations that may take time such http requests and file system calls.
- For example: the
- The
suspendqualifier defines a suspend function. It runs within a coroutine and can call other suspend functions. Flowallows to generate a list of asynchronous values.DeferredandChanneltransfer a single value and a stream of values, respectively, between coroutines.
Function literal with receiver and Type-safe builders
As seen previously, function extension add behavior to existing classes. Inside the definition of the function extension, we can reference the extension receiver (or this) implicitly.
fun String.countCharacters() = length // or this.length
+println("hello".countCharacters()) // prints 5
+We can define this extension with a function literal (or lambda) in instead of a named function (declared with fun).
var extFn: String.() -> Int
+extFn = { length } // extFn is a function literal
+println("hello".extFn()) // prints 5
+println(extFn("hello")) // prints 5
+extFn is a function literal (lambda) that has access to the receiver (this). That's why it's called a function literal with receiver.
extFn("hello") or extFn("hello") call the extension as expected from extension functions.
The type of a function literal with receiver is funName: ReceiverType.(arg1Type, arg2Type, etc.) -> ReturnType and is called with funName(receiverValue, arg1Value, etc.) or receiverValue.funName(arg1Value, etc.). However, this is not the interesting aspect.
// StirngBuilder uses the builder pattern
+val text = StringBuilder("Temp")
+ .append(1)
+ .append(true)
+ .append("friend")
+ .toString()
+🧪 Exercises
Exercise 1
- open the java-integration-exercise projects in the materials folder.
- Have a look at the Java class we provided you in the
src/main/java/com/worldline/learning/kotlin/java2kotlinpackage. (yes, that's the Pokemon class) - Convert that Java class in Kotlin using IntelliJ's awesome copy-pasta tool! (just copy paste the java code in a kotlin file, one is provided at
src/main/kotlin/com/worldline/learning/kotlin/java2kotlin) - Have a look at the generated Kotlin code, and note the major differences you spot!
models package and add to it a Customer data class with these immutable properties id: String, firstName: String, lastName: String, email: String.@Serializable.routes and add to it a file CustomerRoutes.kt that will contain the code for the /customer endpoint.customerRouting() in the routing configuration file located in plugins/Routing.kt.val store = mutableListOf<Customer>().CustomerRoutes.kt
val store = mutableListOf<Customer>()
+
+fun Route.customerRouting() {
+ route("/customer") {
+ get {
+ call.respond(store)
+ }
+ get("{id?}") {
+ val id = call.parameters["id"] ?: return@get call.respondText(
+ "Missing id",
+ status = HttpStatusCode.BadRequest
+ )
+ val customer =
+ store.find { it.id == id } ?: return@get call.respondText(
+ "No customer with id $id",
+ status = HttpStatusCode.NotFound
+ )
+ call.respond(customer)
+ }
+ post {
+ val customer = call.receive<Customer>()
+ store.add(customer)
+ call.respondText("Customer stored correctly", status = HttpStatusCode.Created)
+ }
+ delete("{id?}") {
+
+ }
+ }
+}
+plugins/Routing.kt
fun Application.configureRouting() {
+ routing {
+ customerRouting()
+ }
+}
+return@label
You can specify which level you want to return with an explicit label using return@lambda.
lambdaA {
+ lambdaB {
+ lambdaC {
+ val randomInt = Random.nextInt(0, 100)
+ if (randomInt > 50) return@lambdaC else return@lambdaB
+ }
+ printf("In lambdaB")
+ }
+}
+CustomerTest.http
POST http://127.0.0.1:8080/customer
+Content-Type: application/json
+
+{
+ "id": "100",
+ "firstName": "Jane",
+ "lastName": "Smith",
+ "email": "jane.smith@company.com"
+}
+
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type: application/json
+
+{
+ "id": "200",
+ "firstName": "John",
+ "lastName": "Smith",
+ "email": "john.smith@company.com"
+}
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type: application/json
+
+{
+ "id": "300",
+ "firstName": "Mary",
+ "lastName": "Smith",
+ "email": "mary.smith@company.com"
+}
+
+
+###
+GET http://127.0.0.1:8080/customer
+Accept: application/json
+
+###
+GET http://127.0.0.1:8080/customer/200
+Accept: application/json
+
+###
+GET http://127.0.0.1:8080/customer/500
+Accept: application/json
+
+###
+DELETE http://127.0.0.1:8080/customer/100
+
+###
+DELETE http://127.0.0.1:8080/customer/500
+Customer data class in the model package without the @Serializable annotation.controller package that contains a CustomerController class which provides a CRUD using a global list. You can find a skeleton below. - 💡 In Spring, Rest controllers serve the purpose of Ktor routes, where a controller defines a REST resource.
.\\gradlew bootRun or from your IDE.CustomerController.kt
val store = mutableListOf<Customer>()
+
+@RestController
+@RequestMapping("/customer")
+class CustomerController {
+ @GetMapping
+ fun getAll() = store
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id: String) { /* TODO: implement */ }
+
+ @PostMapping
+ fun addOne(@RequestBody customer: Customer) { /* TODO: implement */ }
+
+ @DeleteMapping("{id}")
+ fun deleteOne(@PathVariable id: String) { /* TODO: implement */ }
+}
+Models or model package ? plural or not ?
Both are ok as long as you follow the same convention in the project.
🧪 Spring boot part 2 - adding a database
Let's go a little bit further by storing data in a database and writing some tests.
We'll use the H2 in-memory database for the sake of simplicity, since it does not require a server to run. Classes will mapped to database tables with JPA annotations. The database API we'll be using is called JPARepository. It is a lightweight API that provides common CRUD features by just defining an interface.
On the testing side, we'll see two different syntaxes. The default one that is more familiar with Java style and the DSL one which is more readable and more familiar with Kotlin developers.
`,6),N={href:"https://start.spring.io/",target:"_blank",rel:"noopener noreferrer"},V=e("model package @Entity class Product(@Id @GeneratedValue var id: Long? = null, var name: String, var price: Int). This single defines the class as well as the minimal JPA annotations (@Entity, @Id and @GeneratedValue) to generate the corresponding table.repository package, declare the ProductRepository interface as follows interface ProductRepository: JpaRepository<Product, Long>. This is enough for Spring to generate an implementation with common features as we'll see later.ProductService class which will contain the business logic. In terms of architecture, the controller calls a service which in turn rely on other services or repositories.ProductService.kt
@Service
+class ProductService(@Autowired val productRepository: ProductRepository) {
+ fun getAll() = productRepository.findAll()
+
+ // use findByIdOrNull instad of findById because the latter returns an optional<Product> instead of Product?
+ fun getById(id: Long) = productRepository.findByIdOrNull(id)
+}
+- In the controller package, create a
ProductControllerclass that is mapped to/productand injects the with@Autowired. Reply to@Getas follows.
ProductController.kt
@RestController
+@RequestMapping("/product")
+class ProductController(@Autowired val productService: ProductService) {
+ @GetMapping fun getAll() = productService.getAll()
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id: Long) =
+ productService.getById(id) ?: throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+Kotlin makes getById(@PathVariable id: Long) more concise
The Elvis operator ?: allows to simplify the code. Here is a longer version as reference.
@GetMapping("{id}")
+fun getById(@PathVariable id: Long): Product {
+ val product = productService.getById(id)
+ if (product != null){
+ return product
+ }
+ throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+- Let's run the project. Before running the project, we need to add a plugin that allows Kotlin classes to generate a default constructor
id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10". The plugins should look as follows:
plugins {
+ id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10"
+ id("org.springframework.boot") version "3.0.4"
+ id("io.spring.dependency-management") version "1.1.0"
+ kotlin("jvm") version "1.8.10"
+ kotlin("plugin.spring") version "1.8.10"
+}
+- As an exercise, implement these endpoints: POST a single product, DELETE by id (
/product/{id}) and GET by id (/product/{id}).- Hint:
ProductControlleralready provides the necessary methods.
- Hint:
- Call the different endpoints with a REST client.
🧪 Spring boot part 2 - adding tests
Spring frameworks helps perform different types of tests by providing different classes out of the box:
- Unit testing of services, repositories and the REST API. This is done through mock utilities such as
MockMVC. - Integration testing of the REST API using
TestRestTemplate. In this situation, a full server is run and tested.
Most, if not all classes provided by Spring provide an elegant syntax for Java developers. Some of them go further by taking advantage of Kotlin specific features. In the following, we're going to focus on parts that provide Kotlin DSLs, namely unit testing the REST API with MockMVC.
- Create a test class
ProductControllerUnitTestswith this initial content.MockMvcallows to unit test the REST API. The@AutoConfigureMockMvcannotation allows spring to configure it automatically
@SpringBootTest
+@AutoConfigureMockMvc
+class ProductControllerTests(
+ @Autowired val mockMvc: MockMvc,
+ @Autowired val productRepository: ProductRepository) {
+
+ @BeforeEach
+ fun reset(){
+ productRepository.deleteAll()
+ }
+}
+- Add these two tests. The first one uses a classic approach while the second take advantage of Kotlin DSL capabilities. In addition to that, we name using a more readable string literal
The request builder of JpaRepository
Spring repositories implement requests based on the name of their methods. For example, to get all products sorted by name, we can add this method to the interface.
interface ProductRepository: JpaRepository<Product, Long> {
+ fun findAllByOrderByNameAsc(): List<Product>;
+}
+There are two gradle plugins that allow to create nodeJs projects: the kotlin("js") one and the kotlin("multiplatform") one. The difference between the two plugins is that the former only supports JS or WASM while the latter supports more platforms but requires to configure source sets. Thus, the former may seem easier to setup but the latter is better in the long run because it allows us to get more familiar with Kotlin Multiplatform (KMP).
🧪 Getting started with Kotlin/JS and Express
At the time of writing, I didn't find an official wizard or starter project. So we'll create one from scratch using gradle init.
- Create a new Gradle project using IntelliJ or by running
gradle initin a empty folder (see below for the replies to thegradle initcommand).
gradle init
gradle init
+Starting a Gradle Daemon, 1 incompatible and 1 stopped Daemons could not be reused, use --status for details
+
+Select type of project to generate:
+ 1: basic
+ 2: application
+ 3: library
+ 4: Gradle plugin
+Enter selection (default: basic) [1..4] 1
+
+Select build script DSL:
+ 1: Kotlin
+ 2: Groovy
+Enter selection (default: Kotlin) [1..2] 1
+
+Project name (default: starter): rest-api-kotlin-nodejs
+
+Generate build using new APIs and behavior (some features may change in the next minor release)? (default: no) [yes, no] yes
+
+
+> Task :init
+To learn more about Gradle by exploring our Samples at https://docs.gradle.org/8.3/samples
+
+BUILD SUCCESSFUL in 24s
+2 actionable tasks: 2 executed
+- In build.gradle.kts, add and configure the
kotlin("multiplatform")plugin. Also add theexpressanddev.chriskrueger:kotlin-expressdependencies.
build.gradle.kts
plugins {
+ kotlin("multiplatform") version "1.9.20-Beta"
+}
+
+repositories {
+ mavenCentral()
+}
+
+group = "tech.worldline.demo"
+version = "1.0-SNAPSHOT"
+
+kotlin {
+ js {
+ nodejs {
+ }
+ binaries.executable()
+ useCommonJs()
+ }
+
+ sourceSets {
+ val jsMain by getting {
+ dependencies {
+ implementation(npm("express", "> 4.0.0 < 5.0.0"))
+ implementation("dev.chriskrueger:kotlin-express:1.2.0")
+ }
+ }
+ }
+}
+- create a main.kt file in src/jsMain/kotlin with the following content:
main.kt
data class Message(val id: Int, val message: String)
+
+val messages = mutableListOf(Message(0, "I love Kotlin/JS"))
+
+fun main() {
+ val app = express.Express()
+
+ // REST API that provides a **GET /hello** endpoint
+ app.get("/hello") { _, res ->
+ res.send(messages)
+ }
+
+ // Create a server that listens to port 3000
+ app.listen(3000) {
+ console.log("server start at port 3000")
+ }
+}
+Execution failed for task ':kotlinStoreYarnLock'
If you get this error:
Execution failed for task ':kotlinStoreYarnLock'.\n> yarn.lock was changed. Run the `kotlinUpgradeYarnLock` task to actualize yarn.lock file\nRun ./gradlew kotlinUpgradeYarnLock so that yarn.lock is updated
🧪 Adding a post endpoint and an external Kotlin/JS definition
',2),wn={href:"https://www.npmjs.com/package/body-parser",target:"_blank",rel:"noopener noreferrer"},_n=n("code",null,"app.use(bodyParser.json())",-1),qn=n("code",null,"req.body",-1),Sn=n("strong",null,"bodyParser",-1),xn=e(`- First, add the body-parser dependncy in the build file
implementation(npm("body-parser", "> 1.0.0 < 2.0.0")) - Next, we would write:
app.use(bodyparser.json())to activate the library. Let's guess what a minimal definition ofbodyparsercan be.
BodyParser.kt
// external means that this class is defined in JS
+external class BodyParser {
+ // we tell Kotlin that we want to use the json() function.
+ fun json(): Any
+ // It is not required to define all the functions of the module
+}
+
+// @JsModule is used to import the module from the NPM registry
+@JsModule("body-parser")
+external val bodyParser: BodyParser
+- Finally, we just need to add the BodyParser.kt file into the project and use it in our server.
main.kt
app.use(bodyParser.json())
+app.post("/hello") { req, res ->
+ // Kotlin does not keep the original field name when parsing JSON from JS (you can see it the in get response)
+ if (req.body as? Message == null) {
+ println("failed to get the body from Kotlin")
+ }
+ // Thus, we need to use js() to get the the field by its expected name
+ // js() calls JS from Kotlin
+ println("req.body from JS \${js("req.body.id")} - \${js("req.body.message")}")
+ val id = js("req.body.id") as? Int
+ val message = js("req.body.message") as? String
+ if (message != null && id != null) {
+ messages.add(Message(id, message))
+ res.status(201).end()
+ } else {
+ res.status(400).send(js("{cause : 'error'}") as Any)
+ }
+}
+🧪 Adding more endpoints
- Add PUT and DELETE endpoints
🎯 Solutions
`,7),In={href:"https://github.com/worldline/learning-kotlin/tree/master/material/ktor-api",target:"_blank",rel:"noopener noreferrer"},jn={href:"https://github.com/worldline/learning-kotlin/tree/master/material/spring-boot-kt-api",target:"_blank",rel:"noopener noreferrer"},Cn={href:"https://github.com/worldline/learning-kotlin/blob/main/material/rest-api-kotlin-nodejs",target:"_blank",rel:"noopener noreferrer"},Tn=n("h2",{id:"📖-further-readings",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#📖-further-readings"},[n("span",null,"📖 Further readings")])],-1),An=n("p",null,"These official tutorials go even further:",-1),Pn={href:"https://kotlinlang.org/docs/jvm-spring-boot-restful.html",target:"_blank",rel:"noopener noreferrer"},Rn={href:"https://spring.io/guides/tutorials/spring-boot-kotlin/",target:"_blank",rel:"noopener noreferrer"},Jn={href:"https://spring.io/guides/tutorials/rest/",target:"_blank",rel:"noopener noreferrer"},En={href:"https://quarkus.io/guides/kotlin",target:"_blank",rel:"noopener noreferrer"},Gn=n("p",null,[n("strong",null,"References")],-1),Bn={href:"https://dev.to/mpetuska/js-in-kotlinjs-c4g",target:"_blank",rel:"noopener noreferrer"},Kn={href:"https://www.baeldung.com/kotlin/mockmvc-kotlin-dsl",target:"_blank",rel:"noopener noreferrer"},Mn={href:"https://spring.io/guides/tutorials/spring-boot-kotlin/",target:"_blank",rel:"noopener noreferrer"},Ln={href:"https://www.baeldung.com/kotlin/jpa",target:"_blank",rel:"noopener noreferrer"},Dn={href:"https://stackoverflow.com/questions/47143127/spring-data-jpa-how-to-use-kotlin-nulls-instead-of-optional",target:"_blank",rel:"noopener noreferrer"};function On(Nn,Vn){const t=o("ExternalLinkIcon"),l=o("CodeGroupItem"),p=o("CodeGroup");return r(),u("div",null,[k,n("p",null,[s("Many frameworks officially support Kotlin: "),n("a",m,[s("Spring"),a(t)]),s(", "),n("a",v,[s("Quarkus"),a(t)]),s(", "),n("a",g,[s("Ktor"),a(t)]),s(", among others "),n("a",b,[s("listed here"),a(t)]),s(".")]),n("p",null,[s("In addition to that, Kotlin is theoretically compatible with any framework that targets the JVM or JS. For example, this tutorial shows "),n("a",h,[s("how to use nodejs with Kotlin"),a(t)]),s(". However, frameworks that do not officially support Kotlin may require some tweaking to use it.")]),f,y,w,n("ul",null,[n("li",null,[s("Create a project on "),n("a",_,[s("start.ktor.io"),a(t)]),s(" with the following plugins: Content Negotiation, kotlinx.serialization, and Routing.")]),q]),S,n("div",x,[I,n("p",null,[n("a",j,[s("This code runs another example"),a(t)]),s(".")])]),C,n("p",null,[n("a",T,[s("This page has detailed steps"),a(t)])]),A,P,R,n("ul",null,[n("li",null,[s("Create a project on "),n("a",J,[s("start.spring.io (also called Spring initializr)"),a(t)]),s(" with the following dependencies: Spring Web and Spring Boot DevTools.")]),E,G,n("li",null,[s('Click on "Generate". Download the archive, unzip it, and open the project with IntelliJ (preferably) or VSCode. '),n("ul",null,[n("li",null,[s("For VSCode, install a "),n("a",B,[s("Kotlin extension"),a(t)]),s(" and "),n("a",K,[s("Spring Boot Extension Pack"),a(t)]),s(" ( ⚠️ Spring extension do not seem to support kotlin).")])])]),M,n("li",null,[s("Please test the endpoints with a REST client. You can find http files here in "),n("a",L,[s("JetBrains format"),a(t)]),s(" or "),n("a",D,[s("VSCode's REST Client extension"),a(t)])])]),O,n("ul",null,[n("li",null,[s("Create a new Spring project using "),n("a",N,[s("Spring initializr"),a(t)]),s(" with Kotlin and the following dependencies: Spring Data JPA, H2 Database, Spring Boot DevTools, Spring Web")]),V]),H,n("div",W,[F,n("p",null,[s("In addition to that, Spring provides "),X,s(" to change the exception message. You can see an "),n("a",Y,[s("example here"),a(t)]),s(".")])]),U,a(p,null,{default:i(()=>[a(l,{title:"Without DSL (Test Get All)"},{default:i(()=>[Z]),_:1}),a(l,{title:"With DSL (Test Get Single)"},{default:i(()=>[z]),_:1})]),_:1}),$,n("div",Q,[nn,n("p",null,[n("a",sn,[s("The official documentation"),a(t)]),s(" provides more detailed explanations and examples.")])]),an,n("p",null,[s("Thanks to Kotlin/JS, we can write apps that target nodejs using Kotlin. We can even import npm libraries as long as you declare the JS API surface that you'll be using in Kotlin. This is called "),tn,s(" (You can think of it as an equivalent of TypeScript's type definitions) that declares the symbols that we want to access in Kotlin thanks to "),n("a",en,[s("@JsModule"),a(t)]),s(" and "),n("a",on,[s("@JsNonModule"),a(t)]),s(" annotations.")]),n("p",null,[s("Defining such external declarations can be a hassle and there seems to be no official automatic generator ("),n("a",ln,[s("dukat"),a(t)]),s(" has been removed in kotlin 1.8.20). In that case, we have two options, either we write the external declaration ourselves or import it as a dependency if available. Fortunately for express developers, "),n("a",pn,[s("chrisnkrueger/kotlin-express"),a(t)]),s(" provides declarations for the express library.")]),cn,n("div",rn,[un,n("ul",null,[dn,n("li",null,[kn,s(),n("a",mn,[s("is required"),a(t)]),s(" to be able to use "),n("a",vn,[s("chrisnkrueger/kotlin-express"),a(t)]),s(" in our code.")])])]),gn,n("ul",null,[bn,n("li",null,[s("Open the "),hn,s(" endpoint on "),n("a",fn,[s("http://localhost:3000/hello"),a(t)])])]),yn,n("p",null,[s("Let's add a post endpoint which reads the body as a json. In order to read the body as json, we must add this possibility to express by importing the npm library "),n("a",wn,[s("body-parser"),a(t)]),s(" and by calling "),_n,s(". Once this setup is complete, "),qn,s(" will contain the content of the body. However, there is no available external definition for "),Sn,s(" as of the time of writing. Thus, we must create or own external definition.")]),xn,n("ul",null,[n("li",null,[n("a",In,[s("ktor Rest API"),a(t)])]),n("li",null,[n("a",jn,[s("Spring boot Rest API"),a(t)])]),n("li",null,[s("The starter and final nodejs projects are available "),n("a",Cn,[s("here"),a(t)])])]),Tn,An,n("ul",null,[n("li",null,[n("a",Pn,[s("This tutorial from kotlinlang"),a(t)]),s(" shows how to create a RESTful web service with a database using Spring Boot.")]),n("li",null,[n("a",Rn,[s("This one from spring.io"),a(t)]),s(" show how to build a web application with Spring Boot and Kotlin.")]),n("li",null,[n("a",Jn,[s("Rest ÄPIs with Spring"),a(t)])]),n("li",null,[n("a",En,[s("Quarkus and kotlin"),a(t)])])]),Gn,n("ul",null,[n("li",null,[n("a",Bn,[s("JS in Kotlin/JS"),a(t)])]),n("li",null,[n("a",Kn,[s("mockmvc kotlin dsl"),a(t)])]),n("li",null,[n("a",Mn,[s("spring-boot-kotlin tutorial"),a(t)])]),n("li",null,[n("a",Ln,[s("Working with Kotlin and JPA"),a(t)])]),n("li",null,[n("a",Dn,[s("Spring Data JPA How to use Kotlin nulls instead of Optional"),a(t)])])])])}const Wn=c(d,[["render",On],["__file","index.html.vue"]]),Fn=JSON.parse('{"path":"/en/backend-development/","title":"📚 Backend development","lang":"en-US","frontmatter":{},"headers":[{"level":2,"title":"Ktor","slug":"ktor","link":"#ktor","children":[{"level":3,"title":"🧪 develop an API with Ktor","slug":"🧪-develop-an-api-with-ktor","link":"#🧪-develop-an-api-with-ktor","children":[]}]},{"level":2,"title":"Spring framework","slug":"spring-framework","link":"#spring-framework","children":[{"level":3,"title":"🧪 Spring boot part 1 - develop the same API with Spring Boot","slug":"🧪-spring-boot-part-1-develop-the-same-api-with-spring-boot","link":"#🧪-spring-boot-part-1-develop-the-same-api-with-spring-boot","children":[]},{"level":3,"title":"🧪 Spring boot part 2 - adding a database","slug":"🧪-spring-boot-part-2-adding-a-database","link":"#🧪-spring-boot-part-2-adding-a-database","children":[]},{"level":3,"title":"🧪 Spring boot part 2 - adding tests","slug":"🧪-spring-boot-part-2-adding-tests","link":"#🧪-spring-boot-part-2-adding-tests","children":[]}]},{"level":2,"title":"NodeJS","slug":"nodejs","link":"#nodejs","children":[{"level":3,"title":"🧪 Getting started with Kotlin/JS and Express","slug":"🧪-getting-started-with-kotlin-js-and-express","link":"#🧪-getting-started-with-kotlin-js-and-express","children":[]},{"level":3,"title":"🧪 Adding a post endpoint and an external Kotlin/JS definition","slug":"🧪-adding-a-post-endpoint-and-an-external-kotlin-js-definition","link":"#🧪-adding-a-post-endpoint-and-an-external-kotlin-js-definition","children":[]},{"level":3,"title":"🧪 Adding more endpoints","slug":"🧪-adding-more-endpoints","link":"#🧪-adding-more-endpoints","children":[]}]},{"level":2,"title":"🎯 Solutions","slug":"🎯-solutions","link":"#🎯-solutions","children":[]},{"level":2,"title":"📖 Further readings","slug":"📖-further-readings","link":"#📖-further-readings","children":[]}],"git":{"updatedTime":1702392867000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":22},{"name":"Ibrahim Gharbi","email":"brah.gharbi@gmail.com","commits":3},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":2},{"name":"Tobias Preuss","email":"tobias.preuss@googlemail.com","commits":2},{"name":"Yassine Benabbas @ Worldline","email":"86733850+wlybe@users.noreply.github.com","commits":2}]},"filePathRelative":"en/backend-development/README.md"}');export{Wn as comp,Fn as data}; diff --git a/assets/index.html-DuVz8Jxd.js b/assets/index.html-DuVz8Jxd.js new file mode 100644 index 00000000..add5802d --- /dev/null +++ b/assets/index.html-DuVz8Jxd.js @@ -0,0 +1,24 @@ +import{_ as l}from"./kotlin-wasm-webapp-R4_9ho9v.js";import{_ as s,r as i,o as r,c as p,a as e,b as t,d as o,e as a}from"./app-jR2rC7Ae.js";const c="/learning-kotlin/assets/launch-android-app-BS4WBFFP.png",d="/learning-kotlin/assets/kmp-compose-desktop-CzocCLNL.png",m="/learning-kotlin/assets/hello-compose-demo-B4DIIuDy.gif",u={},h=e("h1",{id:"📚-frontend-development",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#📚-frontend-development"},[e("span",null,"📚 Frontend development")])],-1),f=e("p",null,"Kotlin supports a wide selection of frontend frameworks across all platforms: mobile, desktop and web.",-1),g=e("p",null,"Please find below a glimpse of the possibilities that you can do right from IntelliJ:",-1),k=e("strong",null,"Desktop",-1),b={href:"https://openjfx.io/",target:"_blank",rel:"noopener noreferrer"},_=e("em",null,"was",-1),w={href:"https://tornadofx.io/",target:"_blank",rel:"noopener noreferrer"},v={href:"https://www.jetbrains.com/lp/compose-mpp/",target:"_blank",rel:"noopener noreferrer"},S=e("strong",null,"Web",-1),A={href:"https://ktor.io/docs/creating-interactive-website.html",target:"_blank",rel:"noopener noreferrer"},y={href:"https://freemarker.apache.org/",target:"_blank",rel:"noopener noreferrer"},x=e("li",null,[t("With "),e("strong",null,"KotlinJS"),t(", developers can create React, nodsjs, or vanilla JS Apps using Kotlin.")],-1),K=e("li",null,[t("Kotlin "),e("strong",null,"WASM"),t(" compiles into "),e("em",null,"Web Assembly"),t(". It can complement KotlinJS for computation intensive tasks.")],-1),M=e("strong",null,"Mobiles",-1),W={href:"https://developer.android.com/jetpack/compose",target:"_blank",rel:"noopener noreferrer"},I=e("strong",null,"xml layouts",-1),J=e("p",null,[t("Kotlin supports cross platform frontend development thanks to "),e("strong",null,"Kotlin MultiPlatform (KMP)")],-1),j=e("h2",{id:"kotlin-multiplatform-kmp",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#kotlin-multiplatform-kmp"},[e("span",null,"Kotlin Multiplatform (KMP)")])],-1),C={href:"https://kotlinlang.org/docs/multiplatform.html",target:"_blank",rel:"noopener noreferrer"},P={href:"https://blog.jetbrains.com/kotlin/2021/08/compose-multiplatform-goes-alpha/",target:"_blank",rel:"noopener noreferrer"},B=e("figure",null,[e("img",{src:"https://kotlinlang.org/docs/images/kotlin-multiplatform.svg",alt:"KMP",tabindex:"0",loading:"lazy"}),e("figcaption",null,"KMP")],-1),T=e("p",null,"Many combinations of targets and use cases are possible:",-1),O={href:"https://kotlinlang.org/docs/multiplatform-full-stack-app.html",target:"_blank",rel:"noopener noreferrer"},L={href:"https://kotlinlang.org/docs/multiplatform-library.html",target:"_blank",rel:"noopener noreferrer"},q=e("h2",{id:"kotlin-js-and-kotlin-wasm",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#kotlin-js-and-kotlin-wasm"},[e("span",null,"Kotlin/JS and Kotlin/WASM")])],-1),z=e("li",null,"Kotlin/JS can also target the web and even use web frameworks (such as react) in Kolitn.",-1),D=e("li",null,[t("Kotlin WASM is another possibility to target the web but this will generate WASM instead of pure JS code. "),e("ul",null,[e("li",null,"It can be used for example to develop computation intensive libraries.")])],-1),F={href:"https://wasi.dev/",target:"_blank",rel:"noopener noreferrer"},R=e("li",null,"Let's keep watching 😄.",-1),N=e("h3",{id:"🧪-kotlin-wasm-web-app",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#🧪-kotlin-wasm-web-app"},[e("span",null,"🧪 Kotlin/WASM web app")])],-1),U=e("code",null,"git clone git@github.com:Kotlin/kotlin-wasm-examples.git",-1),V=e("strong",null,"browser-example",-1),E={href:"https://kotlinlang.org/docs/wasm-get-started.html",target:"_blank",rel:"noopener noreferrer"},H=e("li",null,[t("Open the project and run the "),e("code",null,"wasmJsBrowserRun"),t(" task.")],-1),G={href:"http://localhost:8080/",target:"_blank",rel:"noopener noreferrer"},Y=e("ul",null,[e("li",null,"⚠️ You may need to activate some flags on your browser for the app to work. If you see a blank page, please read the browser logs to check for the instructions.")],-1),$=e("figure",null,[e("img",{src:l,alt:"Alt text",tabindex:"0",loading:"lazy"}),e("figcaption",null,"Alt text")],-1),Q=e("li",null,[t("Please check the contents of "),e("strong",null,"src/wasmJsMain/kotlin/Simple.kt"),t(" to understand how the page is coded.")],-1),X=e("strong",null,"build/js/packages/project_name/kotlin",-1),Z=e("li",null,"WASM being a binary format, we need to convert it first to text format.",-1),ee={href:"https://github.com/WebAssembly/wabt",target:"_blank",rel:"noopener noreferrer"},te=e("em",null,"wasm2wattool",-1),ne=e("code",null,"wasm2wat --enable-all -v .\\kotlin-wasm-demo-wasm.wasm -o wasm.wat",-1),oe={href:"https://webassembly.github.io/wabt/demo/wasm2wat/",target:"_blank",rel:"noopener noreferrer"},ae=e("li",null,"❗ However, I couldn't get it to work (yet).",-1),le=a(`Kotlin/JS and Kotlin/WASM common points
Both Kotlin/WASM and Kotlin/JS IntelliJ work somewhat similarly.
- Both rely on the KMP plugin
- Kotlin/WASM is enabled by adding a
wasmjssection in thebuild.gradle.ktsfile, while Kotlin/JS is enabled by adding ajssection. - The Kotlin code will compile to WASM and / or JS. Kotlin/JS generates only JS while Kotin/WASM generates both JS and WASM.
- In both cases, the entry point of the generated code is a JS file called module_name.js.
- The index.html in the resources folder loads the generated JS explained above (the one named module_name.js).
- The task
wasmBrowserDevelopmentRunorjsWasmBrowserDevelopmentRunrun a local server that hosts both the index.html files and the generated JS and WASM files.
Compose multiplatform
"Compose Multiplatform simplifies and accelerates UI development for Desktop and Web applications, and allows extensive UI code sharing between Android, iOS, Desktop and Web. It's a modern toolkit for building native UI. Quickly bring your app to life with less code, powerful tools, and intuitive Kotlin APIs."
Button(
+ onClick = {
+ logger.info("Pressed!")
+ }
+) {
+ Text("Hello $platform")
+}
+- a shared module (or subproject) that contains common code as well as
- and another module for earch targeted platform: androidApp, iOSApp and desktopApp (When web will be included in the template, we should also see a webApp project). These contain the source code of the apps itself (such as the main activity in Android, the
@main Appin iOS and the main function in desktopJVM) and well as platform specific resources that cannot be placed in the shared module. Some examples of such files are the AndroidManifest.xml for android and the info.plist in iOS.
./gradlew desktopApp:run.🧪 Playing with the Compose multiplatform API
Compose multiplatform is a component based declarative UI framework. Each component is called a Composable and is defined as a function annotated with @Composable.
In compose multiplatform, the main component (the component at the root of the App) is usually found in shared/src/commonMain/Kotlin/App.kt.
- Take a look at shared/src/commonMain/Kotlin/App.kt, run the app and try to understand how compose works.
- Let's create a new composable called
RandomNumberList.
@Composable
+fun RandomNumberList(){
+ // Generate a list of random numbers
+ val myRandomValues = List(5) { Random.nextInt(0, 30) }
+ // LazyColumn is a vertically scrolling list that renders items on demand
+ LazyColumn {
+ items(myRandomValues.size){
+ Text(text = "$it")
+ }
+ }
+}
+- Place this composable below
AnimatedVisibilityandButtonand run the app.
/*
+Button(onClick ...
+AnimatedVisibility(showImage) { ...
+*/
+RandomNumberList()
+- Exercise: Make the "Hello, .." button switch between showing the list and and the image.
🎯 Solutions
',11),ye={href:"https://github.com/worldline/learning-kotlin/tree/main/material/webapp-kotlin-wasm",target:"_blank",rel:"noopener noreferrer"},xe={href:"https://github.com/worldline/learning-kotlin/tree/main/material/app-compose-multiplatform",target:"_blank",rel:"noopener noreferrer"},Ke=e("h2",{id:"📖-further-reading",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#📖-further-reading"},[e("span",null,"📖 Further reading")])],-1),Me={href:"https://seb.deleuze.fr/the-huge-potential-of-kotlin-wasm/",target:"_blank",rel:"noopener noreferrer"},We={href:"https://kmp.jetbrains.com/",target:"_blank",rel:"noopener noreferrer"};function Ie(Je,je){const n=i("ExternalLinkIcon");return r(),p("div",null,[h,f,g,e("ul",null,[e("li",null,[t("On the "),k,t(" side "),e("ul",null,[e("li",null,[t("Thanks to JVM support, Kotlin supports "),e("a",b,[t("JavaFX"),o(n)]),t(" (There "),_,t(" a Kotlin counterpart called "),e("a",w,[t("tornadofx"),o(n)]),t(" which is not maintained anymore).")]),e("li",null,[e("a",v,[t("Compose Multiplatform"),o(n)]),t(" brings Jetpack Compose to the desktop, the web and mobile.")])])]),e("li",null,[t("On the "),S,e("ul",null,[e("li",null,[e("a",A,[t("Ktor"),o(n)]),t(" can use templates engines "),e("a",y,[t("such as FreeMarker"),o(n)]),t(" to create server pages.")]),x,K])]),e("li",null,[t("On "),M,e("ul",null,[e("li",null,[t("Android developers use the "),e("a",W,[t("Jetpack Compose"),o(n)]),t(" UI Framework or the legacy "),I,t(". It is experimental on iOS.")])])])]),J,j,e("blockquote",null,[e("p",null,[t('"The Kotlin Multiplatform technology is designed to simplify the development of cross-platform projects. It reduces time spent writing and maintaining the same code for different platforms while retaining the flexibility and benefits of native programming." '),e("a",C,[t("₁"),o(n)])])]),e("p",null,[e("a",P,[t("KMP"),o(n)]),t(" relies on Kotlin native and other Kotlin features to help developers create projects that target multiple platforms using a common Kotlin code-base.")]),B,T,e("ul",null,[e("li",null,[e("a",O,[t("Full-Stack web apps"),o(n)]),t(": A project that contains a backend and a web app while sharing common logic.")]),e("li",null,[e("a",L,[t("Multiplatform libraries"),o(n)])])]),q,e("ul",null,[z,D,e("li",null,[t("Maybe we can do even more in the future with as all these technologies (Kotlin, WASM and Kotlin/WASM) evolve. - For example, "),e("a",F,[t("WASI"),o(n)]),t(" allows WASM to communicate with the operating system. - This means that me may see Kotlin/WASM project projects in the future that can target both the browser and the OS.")]),R]),N,e("ul",null,[e("li",null,[t("Let's create a Kotlin/WASM app. By cloning "),U,t(" and opening the "),V,t(" folder in your IDE. "),e("ul",null,[e("li",null,[t("To get up to date information on how to start a Kotlin/WASM project, please refer to the "),e("a",E,[t("official documentation for kotlin/wasm"),o(n)]),t(".")])])]),H,e("li",null,[t("The development server should start and you can open your WASM powered webapp on "),e("a",G,[t("http://localhost:8080/"),o(n)]),Y])]),$,e("ul",null,[Q,e("li",null,[t("Next, let's check the generated wasm file which is available in "),X,e("ul",null,[Z,e("li",null,[t("We can either install "),e("a",ee,[t("WABT (The WebAssembly Binary Toolkit or wabbit)"),o(n)]),t(" and use the "),te,t(),ne,t(",")]),e("li",null,[t("or use an online converter "),e("a",oe,[t("such as this one"),o(n)])]),ae])])]),le,e("p",null,[t("It is based on "),e("a",se,[t("Android Jetpack Compose"),o(n)]),t(" declarative UI approach ( which is similar also to "),e("a",ie,[t("iOS SwiftUI"),o(n)]),t(" ) "),e("a",re,[t("1"),o(n)])]),e("div",pe,[ce,e("p",null,[t("While very similar, Compose multiplatform is different from Jetpack Compose as the latter is only compatible with Android. Google provides a "),e("a",de,[t("JetPack compose tutorial"),o(n)]),t(" for Android development.")])]),me,ue,e("p",null,[t("We'll create a multiplatform app using the "),e("a",he,[t("official template"),o(n)]),t(". At the time of writing, this template does not include a compose web target.")]),e("ul",null,[e("li",null,[t("Please check that your environment is correctly setup "),e("a",fe,[t("as explained here"),o(n)]),t(". "),ge]),e("li",null,[t("Open the "),e("a",ke,[t("official template"),o(n)]),t(' and either download a zip or use the "'),be,t('" options on GitHub.')]),_e,e("li",null,[t("In order to run the Android App, the simplest way is to launch it from IntelliJ "),we,t(". It is also possible "),e("a",ve,[t("define a gradle task"),o(n)]),t(" that installs the app on the device and issues a command to the device to launch it.")]),e("li",null,[t("In order to run the iOS App, the simplest way is to run it on the simulator using IntelliJ. In order to run it on a real device, the TramID needs to be defined as "),e("a",Se,[t("explained here"),o(n)])])]),Ae,e("ul",null,[e("li",null,[e("a",ye,[t("Kotlin/JS and Kotlin/WASM PW"),o(n)])]),e("li",null,[e("a",xe,[t("Compose multiplatform PW2"),o(n)])])]),Ke,e("ul",null,[e("li",null,[e("a",Me,[t("The huge potential of Kotlin/WASM"),o(n)])]),e("li",null,[e("a",We,[t("Official KMP wizard"),o(n)])])])])}const Be=s(u,[["render",Ie],["__file","index.html.vue"]]),Te=JSON.parse('{"path":"/en/front-development/","title":"📚 Frontend development","lang":"en-US","frontmatter":{},"headers":[{"level":2,"title":"Kotlin Multiplatform (KMP)","slug":"kotlin-multiplatform-kmp","link":"#kotlin-multiplatform-kmp","children":[]},{"level":2,"title":"Kotlin/JS and Kotlin/WASM","slug":"kotlin-js-and-kotlin-wasm","link":"#kotlin-js-and-kotlin-wasm","children":[{"level":3,"title":"🧪 Kotlin/WASM web app","slug":"🧪-kotlin-wasm-web-app","link":"#🧪-kotlin-wasm-web-app","children":[]},{"level":3,"title":"Kotlin/JS and Kotlin/WASM common points","slug":"kotlin-js-and-kotlin-wasm-common-points","link":"#kotlin-js-and-kotlin-wasm-common-points","children":[]}]},{"level":2,"title":"Compose multiplatform","slug":"compose-multiplatform","link":"#compose-multiplatform","children":[{"level":3,"title":"🧪 Create a Compose multiplatform app","slug":"🧪-create-a-compose-multiplatform-app","link":"#🧪-create-a-compose-multiplatform-app","children":[]},{"level":3,"title":"🧪 Playing with the Compose multiplatform API","slug":"🧪-playing-with-the-compose-multiplatform-api","link":"#🧪-playing-with-the-compose-multiplatform-api","children":[]}]},{"level":2,"title":"🎯 Solutions","slug":"🎯-solutions","link":"#🎯-solutions","children":[]},{"level":2,"title":"📖 Further reading","slug":"📖-further-reading","link":"#📖-further-reading","children":[]}],"git":{"updatedTime":1702464292000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":25},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":3},{"name":"Ibrahim Gharbi","email":"brah.gharbi@gmail.com","commits":1}]},"filePathRelative":"en/front-development/README.md"}');export{Be as comp,Te as data}; diff --git a/assets/index.html-hW5i8q7d.js b/assets/index.html-hW5i8q7d.js new file mode 100644 index 00000000..6fac4106 --- /dev/null +++ b/assets/index.html-hW5i8q7d.js @@ -0,0 +1,195 @@ +import{_ as c,r as o,o as r,c as u,a as n,b as s,d as e,w as i,e as t}from"./app-jR2rC7Ae.js";const d={},k=n("h1",{id:"📚-developpement-du-backend",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#📚-developpement-du-backend"},[n("span",null,"📚 Développement du backend")])],-1),m={href:"https://spring.io/blog/2017/01/04/introducing-kotlin-support-in-spring-framework-5-0",target:"_blank",rel:"noopener noreferrer"},v={href:"https://quarkus.io/guides/kotlin",target:"_blank",rel:"noopener noreferrer"},g={href:"https://github.com/ktorio/ktor",target:"_blank",rel:"noopener noreferrer"},b={href:"https://kotlinlang.org/docs/server-overview.html#deploying-kotlin-server-side-applications",target:"_blank",rel:"noopener noreferrer"},h=n("p",null,"En outre, Kotlin est théoriquement compatible avec tout framework qui cible la JVM ou JS. Cependant, les frameworks qui ne supportent pas officiellement Kotlin peuvent nécessiter quelques ajustements pour l'utiliser.",-1),f=n("h2",{id:"ktor",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#ktor"},[n("span",null,"Ktor")])],-1),_=n("p",null,"Ktor est une bibliothèque Kotlin multiplateforme permettant de développer des clients et des serveurs HTTP. Cela fait de Ktor une bibliothèque utile à la fois aux développeurs frontend, pour la partie client HTTP, ainsi qu'aux développeurs backend, pour la partie serveur HTTP. Dans ce qui suit, nous allons créer une API REST avec le serveur Ktor.",-1),q=n("h3",{id:"tp-developper-une-api-avec-ktor",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#tp-developper-une-api-avec-ktor"},[n("span",null,"TP : développer une API avec Ktor")])],-1),y={href:"https://start.ktor.io/",target:"_blank",rel:"noopener noreferrer"},x=t("models et ajoutez-y une classe de données Customer avec ces propriétés immuables id : String, firstName : String, lastName : Chaîne, email : Chaîne.@Serializable.routes et ajoutez-y un fichier CustomerRoutes.kt qui contiendra le code pour l'endpoint /customer.customerRouting() dans le fichier de configuration du routage situé dans plugins/Routing.kt.val store = mutableListOf<Customer>().CustomerRoutes.kt
val store = mutableListOf<Customer>()
+
+fun Route.customerRouting() {
+ route("/customer") {
+ get {
+ call.respond(store)
+ }
+ get("{id?}") {
+ val id = call.parameters["id"] ? : return@get call.respondText(
+ "Missing id",
+ status = HttpStatusCode.BadRequest
+ )
+ val customer =
+ store.find { it.id == id } ? : return@get call.respondText(
+ "Pas de client avec l'id $id",
+ status = HttpStatusCode.NotFound
+ )
+ call.respond(customer)
+ }
+ post {
+ val customer = call.receive<Customer>()
+ store.add(customer)
+ call.respondText("Customer stored correctly", status = HttpStatusCode.Created)
+ }
+ delete("{id?}") {
+ // TODO
+ }
+ }
+}
+
+plugins/Routing.kt
fun Application.configureRouting() {
+ routing {
+ customerRouting()
+ }
+}
+return@label
Vous pouvez spécifier le niveau que vous voulez retourner avec un label explicite en utilisant return@lambda.
lambdaA {
+ lambdaB {
+ lambdaC {
+ val randomInt = Random.nextInt(0, 100)
+ if (randomInt > 50) return@lambdaC else return@lambdaB
+ }
+ printf("In lambdaB")
+ }
+}
+CustomerTest.http
POST http://127.0.0.1:8080/customer
+Content-Type : application/json
+
+{
+ "id" : "100",
+ "firstName" : "Jane",
+ "lastName" : "Smith",
+ "email" : "jane.smith@company.com"
+}
+
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type : application/json
+
+{
+ "id" : "200",
+ "firstName" : "John",
+ "lastName" : "Smith",
+ "email" : "john.smith@company.com"
+}
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type : application/json
+
+{
+ "id" : "300",
+ "firstName" : "Mary",
+ "lastName" : "Smith",
+ "email" : "mary.smith@company.com"
+}
+
+
+###
+GET http://127.0.0.1:8080/customer
+Accept : application/json
+
+###
+GET http://127.0.0.1:8080/customer/200
+Accepte : application/json
+
+###
+GET http://127.0.0.1:8080/customer/500
+Accepte : application/json
+
+###
+DELETE http://127.0.0.1:8080/customer/100
+
+###
+DELETE http://127.0.0.1:8080/customer/500
+implementation(npm("express", "> 4.0.0 < 5.0.0"));
+implementation("dev.chriskrueger:kotlin-express:1.2.0");
+- Modifiez main.kt comme suit. Cela crée un serveur API REST qui écoute le port 3000 et fournit une route GET /hello.
data class Message(val id : Int, val message : String)
+
+fun main() {
+ val messages = listOf(Message(0, "I love Kotlin/JS"))
+ val app = express.Express()
+ app.get("/hello") { req, res ->
+ res.send(messages)
+ }
+
+ app.listen(3000) {
+ console.log("server start at port 3000")
+ }
+}
+plugins {
+ id("org.springframework.boot") version "3.0.4"
+ id("io.spring.dependency-management") version "1.1.0"
+ kotlin("jvm") version "1.8.10"
+ kotlin("plugin.spring") version "1.8.10"
+}
+data class Customer dans le package model (sans l'annotation @Serializable).controller qui contient une classe CustomerController qui fournit un CRUD en utilisant une liste globale. - Vous pouvez trouver un squelette ci-dessous.
- 💡 Dans Spring, les contrôleurs Rest servent de routes Ktor, où un contrôleur définit une ressource REST.
- Sur Powershell :
.\\gradlew.bat bootRun - Tout shell Unix :
.\\gradlew bootRun - Ou bien, vérifiez si votre IDE fournit déjà des configurations d'exécution pour les projets Spring Boot.
CustomerController.kt
val store = mutableListOf<Customer>()
+
+@RestController
+@RequestMapping("/customer")
+class CustomerController {
+ @GetMapping
+ fun getAll() = store
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id : String) { /* TODO : implement */ }
+
+ @PostMapping
+ fun addOne(@RequestBody customer : Customer) { /* TODO : implement */ }
+
+ @DeleteMapping("{id}")
+ fun deleteOne(@PathVariable id : String) { /* TODO : implement */ }
+}
+TP : Spring boot partie 2 - ajouter une base de données
Allons un peu plus loin en stockant des données dans une base de données et en écrivant quelques tests.
Nous utiliserons la base de données en mémoire H2 pour des raisons de simplicité, puisqu'elle ne nécessite pas de serveur pour fonctionner. Les classes seront mappées aux tables de la base de données avec des annotations JPA. L'API de base de données que nous utiliserons s'appelle JPARepository. C'est une API légère qui fournit des fonctionnalités CRUD communes à partir d'une simple une interface.
model @Entity class Product(@Id @GeneratedValue var id : Long ? = null, var name : String, var price : Int). Ceci définit la classe ainsi que les annotations JPA minimales (@Entity, @Id et @GeneratedValue) pour générer la table correspondante.repository, déclarez l'interface ProductRepository comme suit interface ProductRepository : JpaRepository<Produit, Long>. C'est suffisant pour que Spring génère une implémentation avec des caractéristiques communes comme nous le verrons plus tard.ProductService qui contiendra la logique métier. En termes d'architecture, le contrôleur appelle un service qui, à son tour, s'appuie sur d'autres services ou référentiels.ProductService.kt
@Service
+class ProductService(@Autowired val productRepository: ProductRepository) {
+ fun getAll() = productRepository.findAll()
+
+ // use findByIdOrNull instad of findById because the latter returns an optional<Product> instead of Product?
+ fun getById(id: Long) = productRepository.findByIdOrNull(id)
+}
+- Dans le package controller, créez une classe
ProductControllerqui est mappée à/productet injectée avec@Autowired. Répondez à@Getcomme suit.
ProductController.kt
@RestController
+@RequestMapping("/product")
+class ProductController(@Autowired val productService : ProductService) {
+ @GetMapping fun getAll() = productService.getAll()
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id : Long) =
+ productService.getById(id) ? : throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+Kotlin rend getById(@PathVariable id : Long) plus concis
L'opérateur Elvis ?: permet de simplifier le code. Voici une version plus longue en guise de référence.
@GetMapping("{id}")
+fun getById(@PathVariable id : Long) : Produit {
+ val product = productService.getById(id)
+ if (product != null){
+ return product
+ }
+ throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+En outre, Spring fournit @ControllerAdvice pour modifier le message d'exception. Vous pouvez voir un [exemple ici] (https://spring.io/guides/tutorials/rest/).
- Exécutons le projet. Avant de lancer le projet, nous devons ajouter un plugin qui permet aux classes Kotlin de générer un constructeur par défaut
id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10". Les plugins devraient ressembler à ce qui suit :
plugins {
+ id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10"
+ id("org.springframework.boot") version "3.0.4"
+ id("io.spring.dependency-management") version "1.1.0"
+ kotlin("jvm") version "1.8.10"
+ kotlin("plugin.spring") version "1.8.10"
+}
+
+- En guise d'exercice, implémentez ces routes : POST d'un seul produit, DELETE par id (
/produit/{id}) et GET par id (/produit/{id}).- Indice :
ProductControllerfournit déjà les méthodes nécessaires.
- Indice :
- Appelez les différents points de terminaison avec un client REST.
- Tester votre API Rest avec un client HTTP
TP : Spring boot partie 3 - ajouter des tests
Les frameworks Spring permettent d'effectuer différents types de tests en fournissant différentes classes dès le départ :
- Tests unitaires/de composants des services et de l'API REST. Cela se fait par le biais d'utilitaires de bouchonnage tels que
MockMVC. - Tests d'intégration de l'API REST en utilisant
TestRestTemplate. Dans ce cas, un serveur complet est exécuté et testé.
La plupart des classes fournies par Spring, si ce n'est toutes, offrent une syntaxe élégante pour les développeurs Java. Certaines d'entre elles vont plus loin en tirant parti des caractéristiques spécifiques de Kotlin. Dans ce qui suit, nous allons nous concentrer sur les parties qui fournissent des DSLs Kotlin, à savoir le test unitaire de l'API REST avec MockMVC.
- Créer une classe de test
ProductControllerUnitTestsavec le contenu initial ci-dessous.MockMvcpermet de tester unitairement l'API REST. L'annotation@AutoConfigureMockMvcpermet à Spring de la configurer automatiquement.
@SpringBootTest
+@AutoConfigureMockMvc
+classe ProductControllerTests(
+ @Autowired val mockMvc : MockMvc,
+ @Autowired val productRepository : ProductRepository) {
+
+ @BeforeEach
+ fun reset(){
+ productRepository.deleteAll()
+ }
+}
+- Ajoutez les deux tests ci-dessous. Le premier utilise une approche classique tandis que le second tire parti des capacités du DSL de Kotlin. De plus, nous utilisons une chaîne littérale plus lisible.
- En guise d'exercice, écrire des tests pour les autres points d'accès.
Le constructeur de requêtes de JpaRepository
Les repository Spring implémentent des requêtes basées sur le nom de leurs méthodes. Par exemple, pour obtenir tous les produits triés par nom, nous pouvons ajouter cette méthode à l'interface.
interface ProductRepository : JpaRepository<Produit, Long> {
+ fun findAllByOrderByNameAsc() : List<Produit> ;
+}
+La [documentation officielle] (https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#repositories.query-methods.query-creation) fournit des explications et des exemples plus détaillés.
Projets terminés
`,3),Tn={href:"https://github.com/worldline/learning-kotlin/tree/master/material/ktor-api",target:"_blank",rel:"noopener noreferrer"},An={href:"https://github.com/worldline/learning-kotlin/tree/master/material/kotlin-nodejs-demo",target:"_blank",rel:"noopener noreferrer"},Rn={href:"https://github.com/worldline/learning-kotlin/tree/master/material/spring-boot-kt-api",target:"_blank",rel:"noopener noreferrer"},En=n("h2",{id:"aller-plus-loin",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#aller-plus-loin"},[n("span",null,"Aller plus loin")])],-1),zn=n("p",null,"Ces tutoriels officiels vont encore plus loin :",-1),Gn={href:"https://kotlinlang.org/docs/jvm-spring-boot-restful.html",target:"_blank",rel:"noopener noreferrer"},Kn={href:"https://spring.io/guides/tutorials/spring-boot-kotlin/",target:"_blank",rel:"noopener noreferrer"},Bn={href:"https://spring.io/guides/tutorials/rest/",target:"_blank",rel:"noopener noreferrer"},Dn={href:"https://quarkus.io/guides/kotlin",target:"_blank",rel:"noopener noreferrer"},Jn=n("h2",{id:"lien-et-references",tabindex:"-1"},[n("a",{class:"header-anchor",href:"#lien-et-references"},[n("span",null,"Lien et références")])],-1),Ln={href:"https://dev.to/mpetuska/js-in-kotlinjs-c4g",target:"_blank",rel:"noopener noreferrer"},On={href:"https://www.baeldung.com/kotlin/mockmvc-kotlin-dsl",target:"_blank",rel:"noopener noreferrer"},Mn={href:"https://spring.io/guides/tutorials/spring-boot-kotlin/",target:"_blank",rel:"noopener noreferrer"},Vn={href:"https://www.baeldung.com/kotlin/jpa",target:"_blank",rel:"noopener noreferrer"},Nn={href:"https://stackoverflow.com/questions/47143127/spring-data-jpa-how-to-use-kotlin-nulls-instead-of-optional",target:"_blank",rel:"noopener noreferrer"};function Hn(Xn,Wn){const a=o("ExternalLinkIcon"),l=o("CodeGroupItem"),p=o("CodeGroup");return r(),u("div",null,[k,n("p",null,[s("De nombreux frameworks supportent officiellement Kotlin comme "),n("a",m,[s("Spring"),e(a)]),s(", "),n("a",v,[s("Quarkus"),e(a)]),s(" et "),n("a",g,[s("Ktor"),e(a)]),s(", parmi d'autres "),n("a",b,[s("listés ici"),e(a)]),s(".")]),h,f,_,q,n("ul",null,[n("li",null,[s("Créez un projet sur "),n("a",y,[s("start.ktor.io"),e(a)]),s(" avec les plugins suivants : Content Negotiation, kotlinx.serialization, et Routing.")]),x]),S,n("div",w,[j,n("p",null,[n("a",C,[s("Ce code exécute un autre exemple"),e(a)]),s(".")])]),P,n("p",null,[n("a",I,[s("Cette page contient des étapes détaillées"),e(a)])]),T,A,n("p",null,[s("On peut même importer des librairies npm à condition de déclarer les API JS que l'on va utiliser en Kotlin. C'est ce qu'on appelle une "),R,s(" (vous pouvez la considérer comme un équivalent des définitions de type de TypeScript) qui déclare les symboles auxquels nous voulons accéder en Kotlin grâce aux annotations "),n("a",E,[s("@JsModule"),e(a)]),s(" et "),n("a",z,[s("@JsNonModule"),e(a)]),s(". Définir de telles déclarations externes peut s'avérer fastidieux et il ne semble pas y avoir de générateur automatique officiel et stable ("),n("a",G,[s("dukat"),e(a)]),s(" a été supprimé dans kotlin 1.8.20). Dans ce cas, nous avons deux options, soit écrire la déclaration externe nous-même, soit l'importer en tant que dépendance si elle est disponible.")]),K,B,n("ul",null,[D,n("li",null,[s("Une fois le projet chargé, éditer "),J,s(" comme suit : "),n("ul",null,[L,n("li",null,[s("Ajoutez ces deux dépendances: "),n("ul",null,[n("li",null,[s("La première est la bibliothèque "),n("a",O,[M,e(a)]),s(",")]),n("li",null,[s("et la seconde est la définition externe fournie par "),n("a",V,[s("chrisnkrueger/kotlin-express"),e(a)]),s(".")])])]),n("li",null,[s("ajouter une ligne "),N,s(" à l'intérieur du bloc "),H,s(". Ceci "),n("a",X,[s("est nécessaire"),e(a)]),s(" pour pouvoir utiliser "),n("a",W,[s("chrisnkrueger/ kotlin-express"),e(a)]),s(" dans notre code.")])])])]),Y,n("ul",null,[Z,U,n("li",null,[s("En ce qui concerne le corps du POST, Express positionne "),F,s(" à "),Q,s(" à moins que nous ne spécifions un "),$,s(". "),n("ul",null,[nn,n("li",null,[n("a",sn,[en,e(a)]),s(" est une bibliothèque npm et malheureusement, "),n("a",an,[s("chrisnkrueger/kotlin-express"),e(a)]),s(" ne fournit pas de définition externe pour "),tn,s(" au moment de l'écriture de ces lignes (chrisnkrueger/kotlin-express en version 1.2.0).")]),n("li",null,[s("Pouvez-vous essayer de la définir vous-même en lisant le "),n("a",on,[s("code de la bibliothèque"),e(a)]),s(" ?")]),n("li",null,[s("Vous pouvez trouver une solution "),n("a",ln,[s("ici"),e(a)])])])])]),pn,cn,rn,n("ul",null,[n("li",null,[s("Créez un projet sur "),n("a",un,[s("start.spring.io (aussi appelé Spring initializr)"),e(a)]),s(" avec les dépendances suivantes : Spring Web et Spring Boot DevTools.")]),dn,kn,n("li",null,[s("Cliquez sur "),mn,s(". Téléchargez l'archive, décompressez-la et ouvrez le projet avec IntelliJ (de préférence) ou VSCode. "),n("ul",null,[n("li",null,[s("Pour VSCode, installez une "),n("a",vn,[s("extension Kotlin"),e(a)]),s(" et "),n("a",gn,[s("Spring Boot Extension Pack"),e(a)]),s(" ( ⚠️ l'extension Spring ne semble pas supporter kotlin).")])])]),bn]),hn,n("ul",null,[fn,n("li",null,[s("Veuillez tester les routes avec un client REST. Vous pouvez trouver des fichiers "),_n,s(" ici au "),n("a",qn,[s("format JetBrains"),e(a)]),s(" ou "),n("a",yn,[s(" au format de l'extension REST Client de VSCode"),e(a)])])]),xn,n("ul",null,[n("li",null,[s("Créez un nouveau projet Spring en utilisant "),n("a",Sn,[s("Spring initializr"),e(a)]),s(" avec Kotlin et les dépendances suivantes : Spring Data JPA, H2 Database, Spring Boot DevTools, Spring Web.")]),wn]),jn,e(p,null,{default:i(()=>[e(l,{title:"Sans DSL (Test Get All)"},{default:i(()=>[Cn]),_:1}),e(l,{title:"Avec DSL (Test Get Single)"},{default:i(()=>[Pn]),_:1})]),_:1}),In,n("ul",null,[n("li",null,[n("a",Tn,[s("Projet Ktor"),e(a)])]),n("li",null,[n("a",An,[s("Projet nodejs"),e(a)])]),n("li",null,[n("a",Rn,[s("Projet Spring boot"),e(a)])])]),En,zn,n("ul",null,[n("li",null,[n("a",Gn,[s("Ce tutoriel de kotlinlang"),e(a)]),s(" montre comment créer un service web RESTful avec une base de données en utilisant Spring Boot.")]),n("li",null,[n("a",Kn,[s("Ce tutoriel de spring.io"),e(a)]),s(" montre comment construire une application web avec Spring Boot et Kotlin.")]),n("li",null,[n("a",Bn,[s("Rest APIs with Spring"),e(a)])]),n("li",null,[n("a",Dn,[s("Quarkus et Kotlin"),e(a)])])]),Jn,n("ul",null,[n("li",null,[n("a",Ln,[s("JS et Kotlin/JS"),e(a)])]),n("li",null,[n("a",On,[s("mockmvc kotlin dsl"),e(a)])]),n("li",null,[n("a",Mn,[s("spring-boot-kotlin tutorial"),e(a)])]),n("li",null,[n("a",Vn,[s("Kotlin et JPA"),e(a)])]),n("li",null,[n("a",Nn,[s("Spring Data JPA Comment utiliser les nulls Kotlin au lieu de Optional"),e(a)])])])])}const Zn=c(d,[["render",Hn],["__file","index.html.vue"]]),Un=JSON.parse('{"path":"/fr/backend-development/","title":"📚 Développement du backend","lang":"fr-FR","frontmatter":{},"headers":[{"level":2,"title":"Ktor","slug":"ktor","link":"#ktor","children":[{"level":3,"title":"TP : développer une API avec Ktor","slug":"tp-developper-une-api-avec-ktor","link":"#tp-developper-une-api-avec-ktor","children":[]}]},{"level":2,"title":"nodejs","slug":"nodejs","link":"#nodejs","children":[{"level":3,"title":"TP : API Rest avec Kotlin/JS et Express","slug":"tp-api-rest-avec-kotlin-js-et-express","link":"#tp-api-rest-avec-kotlin-js-et-express","children":[]}]},{"level":2,"title":"Spring framework","slug":"spring-framework","link":"#spring-framework","children":[{"level":3,"title":"TP : Spring boot part 1 - développer la même API avec Spring Boot","slug":"tp-spring-boot-part-1-developper-la-meme-api-avec-spring-boot","link":"#tp-spring-boot-part-1-developper-la-meme-api-avec-spring-boot","children":[]},{"level":3,"title":"TP : Spring boot partie 2 - ajouter une base de données","slug":"tp-spring-boot-partie-2-ajouter-une-base-de-donnees","link":"#tp-spring-boot-partie-2-ajouter-une-base-de-donnees","children":[]},{"level":3,"title":"TP : Spring boot partie 3 - ajouter des tests","slug":"tp-spring-boot-partie-3-ajouter-des-tests","link":"#tp-spring-boot-partie-3-ajouter-des-tests","children":[]},{"level":3,"title":"Projets terminés","slug":"projets-termines","link":"#projets-termines","children":[]}]},{"level":2,"title":"Aller plus loin","slug":"aller-plus-loin","link":"#aller-plus-loin","children":[]},{"level":2,"title":"Lien et références","slug":"lien-et-references","link":"#lien-et-references","children":[]}],"git":{"updatedTime":1696262637000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":4},{"name":"Ibrahim Gharbi","email":"brah.gharbi@gmail.com","commits":2},{"name":"Tobias Preuss","email":"tobias.preuss@googlemail.com","commits":2},{"name":"Yassine Benabbas @ Worldline","email":"86733850+wlybe@users.noreply.github.com","commits":2},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":1}]},"filePathRelative":"fr/backend-development/README.md"}');export{Zn as comp,Un as data}; diff --git a/assets/index.html-mnsf-FXr.js b/assets/index.html-mnsf-FXr.js new file mode 100644 index 00000000..543a0ad1 --- /dev/null +++ b/assets/index.html-mnsf-FXr.js @@ -0,0 +1 @@ +import{_ as s,a as d,b as u,c}from"./qrcode-mixtit24-D6tnJWnS.js";import{_ as p,r as i,o as m,c as f,a as e,b as l,d as n,w as o,e as r}from"./app-jR2rC7Ae.js";const h="/learning-kotlin/assets/qrcode-devoxxma23-Beeff8NO.gif",_={},k=r('📅 Workshops
Android makers 2023: Kotlin Beyond Android
Liens
',4),g={href:"https://awl.li/am23-kt",target:"_blank",rel:"noopener noreferrer"},v=e("figure",null,[e("img",{src:s,alt:"qr code",tabindex:"0",loading:"lazy"}),e("figcaption",null,"qr code")],-1),b=e("h3",{id:"agenda",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#agenda"},[e("span",null,"Agenda")])],-1),x={href:"https://worldline.github.io/learning-kotlin-multiplatform/",target:"_blank",rel:"noopener noreferrer"},w=e("h2",{id:"mobile-devops-summit-2023",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#mobile-devops-summit-2023"},[e("span",null,"Mobile DevOps summit 2023")])],-1),A=e("li",null,[l("Titre: "),e("strong",null,"From Android to Multiplatform: leveraging the full potential of Kotlin")],-1),K={href:"https://awl.li/mds23-kt",target:"_blank",rel:"noopener noreferrer"},y=e("figure",null,[e("img",{src:d,alt:"qr code",width:"200",tabindex:"0",loading:"lazy"}),e("figcaption",null,"qr code")],-1),S=e("h3",{id:"agenda-1",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#agenda-1"},[e("span",null,"Agenda")])],-1),M=e("h2",{id:"devoxx-morocco-2023",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#devoxx-morocco-2023"},[e("span",null,"Devoxx Morocco 2023")])],-1),q=e("li",null,[l("Titre: "),e("strong",null,"Let's discover the amazing possibilities of Kotlin")],-1),D={href:"https://awl.li/devoxxma23-kt",target:"_blank",rel:"noopener noreferrer"},C=e("figure",null,[e("img",{src:h,alt:"qr code",width:"200",tabindex:"0",loading:"lazy"}),e("figcaption",null,"qr code")],-1),P=e("h3",{id:"agenda-2",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#agenda-2"},[e("span",null,"Agenda")])],-1),R=r('(2024) MiXit
- Titre : Développement front et back en Kotlin. Une visite guidée de KMP
Agenda
',4),z=e("strong",null,"Développement backend",-1),I={href:"https://speakerdeck.com/yostane/kotlin-pour-le-developpement-backend",target:"_blank",rel:"noopener noreferrer"},J=e("strong",null,"Développement frontend",-1),L=e("strong",null,"Développement fullstack",-1),B=e("strong",null,"Autres fonctionnalités",-1);function W(N,F){const a=i("ExternalLinkIcon"),t=i("RouteLink");return m(),f("div",null,[k,e("p",null,[l("Lien du workshop: "),e("a",g,[l("awl.li/am23-kt"),n(a)])]),v,b,e("ul",null,[e("li",null,[n(t,{to:"/fr/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with Ktor")]),_:1})]),e("li",null,[l("Optional: "),n(t,{to:"/fr/backend-development/#ktor"},{default:o(()=>[l("Backend development: Rest API with nodeJS and Kotlin/JS")]),_:1})]),e("li",null,[n(t,{to:"/fr/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Front-end development: Kotlin/WASM and Kotlin/JS webapp")]),_:1})]),e("li",null,[n(t,{to:"/fr/front-development/#compose"},{default:o(()=>[l("Front-end development: cross-platform Hello world App with Compose multiplatform")]),_:1})]),e("li",null,[e("a",x,[l("Front-end development: Cross-platform Quiz App with Compose multiplatform"),n(a)])]),e("li",null,[n(t,{to:"/fr/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Full-stack development: Quiz App with Compose multiplatform and Ktor server")]),_:1})])]),w,e("ul",null,[A,e("li",null,[l("Lien: "),e("a",K,[l("awl.li/mds23-kt"),n(a)])])]),y,S,e("ul",null,[e("li",null,[n(t,{to:"/fr/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Développement d'une application multi-plateformes")]),_:1})]),e("li",null,[l("Démonstration des autres possibilités: "),e("ul",null,[e("li",null,[n(t,{to:"/fr/backend-development/#ktor"},{default:o(()=>[l("API Rest avec Ktor")]),_:1})]),e("li",null,[n(t,{to:"/fr/backend-development/#ktor"},{default:o(()=>[l("API Rest avec nodeJS et Kotlin/JS")]),_:1})]),e("li",null,[n(t,{to:"/fr/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Webapp Kotlin/WASM et Kotlin/JS ")]),_:1})])])])]),M,e("ul",null,[q,e("li",null,[l("Lien: "),e("a",D,[l("awl.li/mds23-kt"),n(a)])])]),C,P,e("ul",null,[e("li",null,[n(t,{to:"/fr/presentation/#prerequisites"},{default:o(()=>[l("Prérequis")]),_:1})]),e("li",null,[l("Caractéristiques notables de Kotlin: "),n(t,{to:"/fr/kotlin-features/#null-safety"},{default:o(()=>[l("le null safety")]),_:1}),l(" et "),n(t,{to:"/fr/kotlin-features/#functions"},{default:o(()=>[l("les fonctions")]),_:1})]),e("li",null,[n(t,{to:"/fr/backend-development/#spring-framework"},{default:o(()=>[l("API Rest avec Spring boot")]),_:1})]),e("li",null,[n(t,{to:"/fr/backend-development/#ktor"},{default:o(()=>[l("API Rest avec Ktor")]),_:1})]),e("li",null,[n(t,{to:"/fr/front-development/#compose"},{default:o(()=>[l(`Développement d'une application multi-plateformes type "Hello World" avec Compose Multiplatform`)]),_:1})]),e("li",null,[n(t,{to:"/fr/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Dévelopment sullstack d'une application de Quiz avec with Compose multiplatform en front et Ktor server en backend")]),_:1})]),e("li",null,[l("Autres fonctionnalités et possibilités: "),e("ul",null,[e("li",null,[n(t,{to:"/fr/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Kotlin/WASM")]),_:1})]),e("li",null,[n(t,{to:"/fr/backend-development/#nodejs"},{default:o(()=>[l("Serveur NodeJS avec Kotlin/JS")]),_:1})]),e("li",null,[n(t,{to:"/fr/kotlin-features-advanced/#concurrency-and-coroutines"},{default:o(()=>[l("Coroutines")]),_:1})])])])]),R,e("ul",null,[e("li",null,[n(t,{to:"/fr/presentation/#prerequisites"},{default:o(()=>[l("Prérequis")]),_:1})]),e("li",null,[l("Fonctionnalités notables: "),n(t,{to:"/fr/kotlin-features/#null-safety"},{default:o(()=>[l("null safety")]),_:1}),l(" et "),n(t,{to:"/fr/kotlin-features/#functions"},{default:o(()=>[l("les fonctions")]),_:1})]),e("li",null,[z,e("ul",null,[e("li",null,[e("a",I,[l("Présentation d'introduction à Kotlin pour le développement backend"),n(a)])]),e("li",null,[n(t,{to:"/fr/backend-development/#spring-framework"},{default:o(()=>[l("API Rest avec Spring boot")]),_:1})]),e("li",null,[n(t,{to:"/fr/backend-development/#ktor"},{default:o(()=>[l("API Rest avec Ktor")]),_:1})])])]),e("li",null,[J,e("ul",null,[e("li",null,[n(t,{to:"/fr/front-development/#compose"},{default:o(()=>[l('Application "Hello World" avec Compose Multiplatform')]),_:1})])])]),e("li",null,[L,e("ul",null,[e("li",null,[n(t,{to:"/fr/other-technologies/#pw-add-a-ktor-server-app"},{default:o(()=>[l("Application de quiz avec Ktor + Compose Multiplatform")]),_:1})])])]),e("li",null,[B,e("ul",null,[e("li",null,[n(t,{to:"/fr/front-development/#kotlin-js-and-kotlin-wasm"},{default:o(()=>[l("Kotlin/WASM")]),_:1})]),e("li",null,[n(t,{to:"/fr/backend-development/#nodejs"},{default:o(()=>[l("Développement NodeJS en Kotlin")]),_:1})]),e("li",null,[n(t,{to:"/fr/kotlin-features-advanced/#concurrency-and-coroutines"},{default:o(()=>[l("Coroutines")]),_:1})])])])])])}const O=p(_,[["render",W],["__file","index.html.vue"]]),T=JSON.parse('{"path":"/fr/workshops/","title":"📅 Workshops","lang":"fr-FR","frontmatter":{},"headers":[{"level":2,"title":"Android makers 2023: Kotlin Beyond Android","slug":"android-makers-2023-kotlin-beyond-android","link":"#android-makers-2023-kotlin-beyond-android","children":[{"level":3,"title":"Liens","slug":"liens","link":"#liens","children":[]},{"level":3,"title":"Agenda","slug":"agenda","link":"#agenda","children":[]}]},{"level":2,"title":"Mobile DevOps summit 2023","slug":"mobile-devops-summit-2023","link":"#mobile-devops-summit-2023","children":[{"level":3,"title":"Agenda","slug":"agenda-1","link":"#agenda-1","children":[]}]},{"level":2,"title":"Devoxx Morocco 2023","slug":"devoxx-morocco-2023","link":"#devoxx-morocco-2023","children":[{"level":3,"title":"Agenda","slug":"agenda-2","link":"#agenda-2","children":[]}]},{"level":2,"title":"(2024) MiXit","slug":"_2024-mixit","link":"#_2024-mixit","children":[{"level":3,"title":"Agenda","slug":"agenda-3","link":"#agenda-3","children":[]}]}],"git":{"updatedTime":1713801068000,"contributors":[{"name":"Yassine Benabbas","email":"yassine.benabbas@worldline.com","commits":5},{"name":"A187839","email":"ibrahim.gharbi@worldline.com","commits":1},{"name":"yostane","email":"1958676+yostane@users.noreply.github.com","commits":1}]},"filePathRelative":"fr/workshops/README.md"}');export{O as comp,T as data}; diff --git a/assets/index.html-pJuZpkgy.js b/assets/index.html-pJuZpkgy.js new file mode 100644 index 00000000..1645a515 --- /dev/null +++ b/assets/index.html-pJuZpkgy.js @@ -0,0 +1,7 @@ +import{_ as i,r as g,o as a,c as s,a as l,b as e,d as n,e as c}from"./app-jR2rC7Ae.js";const b={},t=c('📚 Fonctionnalités du langage Kotlin
Kotlin est un langage qui support les paradigmes orienté objet et fonctionnel. Ce chapitre couvre les caractéristiques basiques et intermédiaires. Le chapitre suivant couvrira les fonctionnalités avancées.
Caractéristiques de base
Constructions de base (variables, flux de contrôle)
- Kotlin est typé statiquement et prend en charge le typage implicite.
- Typage statique : les types ne peuvent pas changer à l'exécution (c'est l'inverse du typage dynamique).
- Typage implicite : le compilateur peut inférer le type tant que c'est possible.
varcrée des variables ré-assignables.valcrée des variables qu'on ne peut plus ré-assigner.- Les points-virgules sont facultatifs.
- Kotlin prend en charge la déclaration de haut niveau des variables et des fonctions (elles peuvent être déclarées en dehors des classes).
- L'interpolation de chaîne de caractères est disponible avec cette syntaxe
${expression}. ifetwhensont des expressions (elles peuvent renvoyer une valeur).whenest équivalent à l'instructionswitchdes autres langages- L'opérateur ternaire n'est pas disponible. L'expression
ifle remplace.
- for-each est le seul type de boucle for disponible.
- La programmation orientée objet est prise en charge comme en Java avec quelques fonctionnalités supplémentaires telles que les extensions.
- Le compilateur prend en charge la Null Safety. Il permet d'écrire du code sans erreur de pointeur nulle vérifié à la compilation.
- La programmation fonctionnelle est prise en charge (fonctions d'ordre supérieur et fonctions en tant qu'éléments de 1ère classe, etc.).
Utiliser val par défaut
Utiliser var uniquement si vous réassignez une variable ou argument.
Les fonctions
Dans cette section, les termes 'argument' et 'paramètre' sont utilisés de manière interchangeable.
Les fonctions de Kotlin ont les caractéristiques suivantes :
- Déclaration :
fun functionName(arg1 : type1 = defaultvalue1, ...) : retunrType. - Appeler une fonction en passant la valeur dans l'ordre de déclaration.
- Utilisez des étiquettes d'argument pour plus de clarté, cependant, cela permet également un classement arbitraire des arguments.
- Les arguments optionnels ont une valeur par défaut et peuvent être omis lors de l'appel.
- Les fonctions sont des éléments de première classe ou citoyens : elles peuvent être affectées à une variable, passées en tant que paramètre de fonction ou renvoyées par une fonction.
- 💡 Une fonction qui prend une fonction comme argument ou en renvoie une est une fonction d'ordre supérieur.
- Un type de fonction peut être exprimé comme suit :
(typeOfParam1, typeOfParam2, etc) -> returnType(Le type de retour vide estUnit). - Les fonctions anonymes utilisent la syntaxe suivante
{ argName1, argName2, etc. -> // code }- Aussi appelées fonctions lambda ou fonctions littérales
- Le dernier argument de la fonction peut être mis après la fermeture après la parenthèse fermante
compute(9, 5) { x, y -> x * y }
La prochaine section abordera le null safety.
Null safety
null safety est une fonctionnalité du compilateur qui élimine la fameuse Null pointer exception ou npe. En effet, le compilateur signale des erreurs et des avertissements lorsque nous manipulons des types nullables (également appelées types optionnels) dès qu'il y a un risque de npe à l'exécution. Ainsi, afin de mettre Voici une liste des fonctionnalités de sécurité null fournies par Kotlin :
- Tous les types ne sont pas nullables par défaut ; nous ne pouvons pas affecter
nullà une variable ou à un argument.- Par exemple, ce code échoue
var s: String = null.
- Par exemple, ce code échoue
- Un type peut être rendu nullable en le suffixant avec un ?. Par exemple :
var s : chaîne ? = nul. - Kotlin interdit d'appeler une méthode ou une propriété de type non nullable, sauf si l'on fait l'une de ces possibilités :
- Utilisez le chaînage optionnel avec le suffixe ?.
- Fournissez une valeur par défaut avec l'opérateur elvis ?:.
- Smart-cast le nullable dans un non-nullable.
- Utilisez l'opérateur !! qui élimine les vérifications du compilateur. Cela ne devrait jamais être utilisé.
Ne jamais déballer avec !!
Car cela équivaut à désactiver la null safety. Utilisez les autres possibilités à la place.
Fonctionnalités intermédiaires
Programmation orientée objet
Kotlin permet d'écrire du code Orienté Object concis grâce aux caractéristiques suivantes :
- Concepts disponibles : classes, héritage, interfaces et classes abstraites.
- Prise en charge possée des propriétés : les getters et les setters sont automatiquement implémentés.
- On peut les personnaliser les accesseurs en définissant les fonctions
get()etset(value)à côté de la déclaration de la propriété.
- On peut les personnaliser les accesseurs en définissant les fonctions
- Les arguments du constructeur sont définis à côté du nom de la classe
class ClassName(arg1, atg2, ) - Préfixer les arguments d'un constructeur avec
valouvaren fait une propriété (valla rend non ré-assignable). - Le nom du constructeur est
initet ne nécessite pas de paramètres. - Le compilateur vérifie que toutes les propriétés non nullables sont initialisées à la fin du constructeur.
- ⚠️ Le compilateur ne vérifie pas l'initialisation des propriétés
lateinit. Ainsi, y accéder avant alors qu'elles ne sont pas initialisés provoque une exception.
- ⚠️ Le compilateur ne vérifie pas l'initialisation des propriétés
- Une classe doit être préfixée avec
openpour permettre l'héritage. - Kotlin utilise le niveau d'accès
publicpar défaut. - L'opérateur d'égalité
==appelle implicitement la méthodeequals()(contrairement à Java qui utilise l'égalité de référence). - Un objet compagnon contient des méthodes et des propriétés statiques.
- Les extensions ajoutent des fonctions et des propriétés aux classes existantes.
- 💡 Ils remplacent l'héritage dans de nombreuses situations.
- Par exemple, nous pouvons ajouter des fonctions à la classe String au lieu de créer une nouvelle classe
StringUtils.
- Les classes et interfaces scellées ne peuvent pas être étendues ou implémentées par des tiers.
Ne définir les accesseurs que si vous avez un comportement personnalisé
Kotlin prend en charge les propriétés de façon plus poussée que Java et permet d'ajouter des accesseurs ultérieurement sans refactoriser le code qui appelle ces propriétés. Ainsi, par défaut, il suffit de définir le nom des propriétés sans accesseurs et on peut les utiliser directement.
@Test
+fun givenReadOnlyList_whenCastToMutableList_checkNewElementsAdded(){
+ val list: List<String> = listOf("This", "Is", "Totally", "Immutable")
+ (list as MutableList<String>)[2] = "Not"
+ assertEquals(listOf("This", "Is", "Not", "Immutable"), list)
+}
+
📚 Backend development
Many frameworks officially support Kotlin: Spring, Quarkus, Ktor, among others listed here.
In addition to that, Kotlin is theoretically compatible with any framework that targets the JVM or JS. For example, this tutorial shows how to use nodejs with Kotlin. However, frameworks that do not officially support Kotlin may require some tweaking to use it.
Ktor
Ktor is a cross-platform Kotlin library for building both HTTP clients and servers. This makes Ktor a useful library to learn for both front-end developers for its HTTP client capabilities and backend-development for its HTTP server capabilities. In the following, we'll create a REST API with Ktor server.
🧪 develop an API with Ktor
- Create a project on start.ktor.io with the following plugins: Content Negotiation, kotlinx.serialization, and Routing.
- Click on "Generate project".
- Download the archive, unzip it, and open the project with IntelliJ.
- Create a
modelspackage and add to it aCustomerdata class with these immutable propertiesid: String, firstName: String, lastName: String, email: String. - Annotate the class with
@Serializable. - Create a new package named
routesand add to it a fileCustomerRoutes.ktthat will contain the code for the/customerendpoint. - The code below provides the implementation of some endpoints. Please implement the remaining ones.
- To enable the route call
customerRouting()in the routing configuration file located inplugins/Routing.kt. - For simplicity, use a global in-memory list of customers
val store = mutableListOf<Customer>(). - Run the server by running the main method.
- Test the api on the IDE by using an http file or using any other client.
CustomerRoutes.kt
val store = mutableListOf<Customer>()
+
+fun Route.customerRouting() {
+ route("/customer") {
+ get {
+ call.respond(store)
+ }
+ get("{id?}") {
+ val id = call.parameters["id"] ?: return@get call.respondText(
+ "Missing id",
+ status = HttpStatusCode.BadRequest
+ )
+ val customer =
+ store.find { it.id == id } ?: return@get call.respondText(
+ "No customer with id $id",
+ status = HttpStatusCode.NotFound
+ )
+ call.respond(customer)
+ }
+ post {
+ val customer = call.receive<Customer>()
+ store.add(customer)
+ call.respondText("Customer stored correctly", status = HttpStatusCode.Created)
+ }
+ delete("{id?}") {
+
+ }
+ }
+}
+plugins/Routing.kt
fun Application.configureRouting() {
+ routing {
+ customerRouting()
+ }
+}
+return@label
You can specify which level you want to return with an explicit label using return@lambda.
lambdaA {
+ lambdaB {
+ lambdaC {
+ val randomInt = Random.nextInt(0, 100)
+ if (randomInt > 50) return@lambdaC else return@lambdaB
+ }
+ printf("In lambdaB")
+ }
+}
+CustomerTest.http
POST http://127.0.0.1:8080/customer
+Content-Type: application/json
+
+{
+ "id": "100",
+ "firstName": "Jane",
+ "lastName": "Smith",
+ "email": "jane.smith@company.com"
+}
+
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type: application/json
+
+{
+ "id": "200",
+ "firstName": "John",
+ "lastName": "Smith",
+ "email": "john.smith@company.com"
+}
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type: application/json
+
+{
+ "id": "300",
+ "firstName": "Mary",
+ "lastName": "Smith",
+ "email": "mary.smith@company.com"
+}
+
+
+###
+GET http://127.0.0.1:8080/customer
+Accept: application/json
+
+###
+GET http://127.0.0.1:8080/customer/200
+Accept: application/json
+
+###
+GET http://127.0.0.1:8080/customer/500
+Accept: application/json
+
+###
+DELETE http://127.0.0.1:8080/customer/100
+
+###
+DELETE http://127.0.0.1:8080/customer/500
+Spring framework
Spring is a famous framework for developing server-side applications: APIs, server generated web pages, microservices, etc. It relies on the the Java ecosystem to build and run, thus making it compatible with Kotlin. Even better, Spring officially supports Kotlin. It even allows in start a new project with Kotlin and Gradle-Kotlin. In the next section, we'll use this starter to recreate our above REST API with Spring.
🧪 Spring boot part 1 - develop the same API with Spring Boot
- Create a project on start.spring.io (also called Spring initializr) with the following dependencies: Spring Web and Spring Boot DevTools.
- Choose Kotlin as the language and Kotlin-Grade as the project manager.
- Add these dependencies: Spring Web, Spring Boot DevTools, h2 database and Spring Data JPA.
- Click on "Generate". Download the archive, unzip it, and open the project with IntelliJ (preferably) or VSCode.
- For VSCode, install a Kotlin extension and Spring Boot Extension Pack ( ⚠️ Spring extension do not seem to support kotlin).
- Create
Customerdata class in themodelpackage without the@Serializableannotation. - Create a
controllerpackage that contains aCustomerControllerclass which provides a CRUD using a global list. You can find a skeleton below.- 💡 In Spring, Rest controllers serve the purpose of Ktor routes, where a controller defines a REST resource.
- Define the same endpoints as in the previous PW.
- Start the REST API server by running
.\gradlew bootRunor from your IDE. - Please test the endpoints with a REST client. You can find http files here in JetBrains format or VSCode's REST Client extension
CustomerController.kt
val store = mutableListOf<Customer>()
+
+@RestController
+@RequestMapping("/customer")
+class CustomerController {
+ @GetMapping
+ fun getAll() = store
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id: String) { /* TODO: implement */ }
+
+ @PostMapping
+ fun addOne(@RequestBody customer: Customer) { /* TODO: implement */ }
+
+ @DeleteMapping("{id}")
+ fun deleteOne(@PathVariable id: String) { /* TODO: implement */ }
+}
+Models or model package ? plural or not ?
Both are ok as long as you follow the same convention in the project.
🧪 Spring boot part 2 - adding a database
Let's go a little bit further by storing data in a database and writing some tests.
We'll use the H2 in-memory database for the sake of simplicity, since it does not require a server to run. Classes will mapped to database tables with JPA annotations. The database API we'll be using is called JPARepository. It is a lightweight API that provides common CRUD features by just defining an interface.
On the testing side, we'll see two different syntaxes. The default one that is more familiar with Java style and the DSL one which is more readable and more familiar with Kotlin developers.
- Create a new Spring project using Spring initializr with Kotlin and the following dependencies: Spring Data JPA, H2 Database, Spring Boot DevTools, Spring Web
- Open the project and add this class in the
modelpackage@Entity class Product(@Id @GeneratedValue var id: Long? = null, var name: String, var price: Int). This single defines the class as well as the minimal JPA annotations (@Entity,@Idand@GeneratedValue) to generate the corresponding table. - In the
repositorypackage, declare theProductRepositoryinterface as followsinterface ProductRepository: JpaRepository<Product, Long>. This is enough for Spring to generate an implementation with common features as we'll see later. - Next, create a
ProductServiceclass which will contain the business logic. In terms of architecture, the controller calls a service which in turn rely on other services or repositories.
ProductService.kt
@Service
+class ProductService(@Autowired val productRepository: ProductRepository) {
+ fun getAll() = productRepository.findAll()
+
+ // use findByIdOrNull instad of findById because the latter returns an optional<Product> instead of Product?
+ fun getById(id: Long) = productRepository.findByIdOrNull(id)
+}
+- In the controller package, create a
ProductControllerclass that is mapped to/productand injects the with@Autowired. Reply to@Getas follows.
ProductController.kt
@RestController
+@RequestMapping("/product")
+class ProductController(@Autowired val productService: ProductService) {
+ @GetMapping fun getAll() = productService.getAll()
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id: Long) =
+ productService.getById(id) ?: throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+Kotlin makes getById(@PathVariable id: Long) more concise
The Elvis operator ?: allows to simplify the code. Here is a longer version as reference.
@GetMapping("{id}")
+fun getById(@PathVariable id: Long): Product {
+ val product = productService.getById(id)
+ if (product != null){
+ return product
+ }
+ throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+In addition to that, Spring provides @ControllerAdvice to change the exception message. You can see an example here.
- Let's run the project. Before running the project, we need to add a plugin that allows Kotlin classes to generate a default constructor
id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10". The plugins should look as follows:
plugins {
+ id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10"
+ id("org.springframework.boot") version "3.0.4"
+ id("io.spring.dependency-management") version "1.1.0"
+ kotlin("jvm") version "1.8.10"
+ kotlin("plugin.spring") version "1.8.10"
+}
+- As an exercise, implement these endpoints: POST a single product, DELETE by id (
/product/{id}) and GET by id (/product/{id}).- Hint:
ProductControlleralready provides the necessary methods.
- Hint:
- Call the different endpoints with a REST client.
🧪 Spring boot part 2 - adding tests
Spring frameworks helps perform different types of tests by providing different classes out of the box:
- Unit testing of services, repositories and the REST API. This is done through mock utilities such as
MockMVC. - Integration testing of the REST API using
TestRestTemplate. In this situation, a full server is run and tested.
Most, if not all classes provided by Spring provide an elegant syntax for Java developers. Some of them go further by taking advantage of Kotlin specific features. In the following, we're going to focus on parts that provide Kotlin DSLs, namely unit testing the REST API with MockMVC.
- Create a test class
ProductControllerUnitTestswith this initial content.MockMvcallows to unit test the REST API. The@AutoConfigureMockMvcannotation allows spring to configure it automatically
@SpringBootTest
+@AutoConfigureMockMvc
+class ProductControllerTests(
+ @Autowired val mockMvc: MockMvc,
+ @Autowired val productRepository: ProductRepository) {
+
+ @BeforeEach
+ fun reset(){
+ productRepository.deleteAll()
+ }
+}
+- Add these two tests. The first one uses a classic approach while the second take advantage of Kotlin DSL capabilities. In addition to that, we name using a more readable string literal
@Test
+fun testWithClassicApproach(){
+ mockMvc.perform(get("/product"))
+ .andExpect(status().isOk)
+ .andExpect(content().string(containsString("[]")))
+}
+@Test
+fun `test GET a single product`() {
+ mockMvc.get("/product/1").andExpect {
+ status { isOk() }
+ jsonPath("$.name") { value("A") }
+ jsonPath("$.price") { value(1) }
+ content { contentType(MediaType.APPLICATION_JSON) }
+ }
+}
+- As an exercise, unit tests for the other endpoints.
The request builder of JpaRepository
Spring repositories implement requests based on the name of their methods. For example, to get all products sorted by name, we can add this method to the interface.
interface ProductRepository: JpaRepository<Product, Long> {
+ fun findAllByOrderByNameAsc(): List<Product>;
+}
+The official documentation provides more detailed explanations and examples.
NodeJS
Thanks to Kotlin/JS, we can write apps that target nodejs using Kotlin. We can even import npm libraries as long as you declare the JS API surface that you'll be using in Kotlin. This is called external declaration (You can think of it as an equivalent of TypeScript's type definitions) that declares the symbols that we want to access in Kotlin thanks to @JsModule and @JsNonModule annotations.
Defining such external declarations can be a hassle and there seems to be no official automatic generator (dukat has been removed in kotlin 1.8.20). In that case, we have two options, either we write the external declaration ourselves or import it as a dependency if available. Fortunately for express developers, chrisnkrueger/kotlin-express provides declarations for the express library.
There are two gradle plugins that allow to create nodeJs projects: the kotlin("js") one and the kotlin("multiplatform") one. The difference between the two plugins is that the former only supports JS or WASM while the latter supports more platforms but requires to configure source sets. Thus, the former may seem easier to setup but the latter is better in the long run because it allows us to get more familiar with Kotlin Multiplatform (KMP).
🧪 Getting started with Kotlin/JS and Express
At the time of writing, I didn't find an official wizard or starter project. So we'll create one from scratch using gradle init.
- Create a new Gradle project using IntelliJ or by running
gradle initin a empty folder (see below for the replies to thegradle initcommand).
gradle init
gradle init
+Starting a Gradle Daemon, 1 incompatible and 1 stopped Daemons could not be reused, use --status for details
+
+Select type of project to generate:
+ 1: basic
+ 2: application
+ 3: library
+ 4: Gradle plugin
+Enter selection (default: basic) [1..4] 1
+
+Select build script DSL:
+ 1: Kotlin
+ 2: Groovy
+Enter selection (default: Kotlin) [1..2] 1
+
+Project name (default: starter): rest-api-kotlin-nodejs
+
+Generate build using new APIs and behavior (some features may change in the next minor release)? (default: no) [yes, no] yes
+
+
+> Task :init
+To learn more about Gradle by exploring our Samples at https://docs.gradle.org/8.3/samples
+
+BUILD SUCCESSFUL in 24s
+2 actionable tasks: 2 executed
+- In build.gradle.kts, add and configure the
kotlin("multiplatform")plugin. Also add theexpressanddev.chriskrueger:kotlin-expressdependencies.
build.gradle.kts
plugins {
+ kotlin("multiplatform") version "1.9.20-Beta"
+}
+
+repositories {
+ mavenCentral()
+}
+
+group = "tech.worldline.demo"
+version = "1.0-SNAPSHOT"
+
+kotlin {
+ js {
+ nodejs {
+ }
+ binaries.executable()
+ useCommonJs()
+ }
+
+ sourceSets {
+ val jsMain by getting {
+ dependencies {
+ implementation(npm("express", "> 4.0.0 < 5.0.0"))
+ implementation("dev.chriskrueger:kotlin-express:1.2.0")
+ }
+ }
+ }
+}
+Some notes on the build file
- express dependency is retrieved from npm
useCommonJs()is required to be able to use chrisnkrueger/kotlin-express in our code.
- create a main.kt file in src/jsMain/kotlin with the following content:
main.kt
data class Message(val id: Int, val message: String)
+
+val messages = mutableListOf(Message(0, "I love Kotlin/JS"))
+
+fun main() {
+ val app = express.Express()
+
+ // REST API that provides a **GET /hello** endpoint
+ app.get("/hello") { _, res ->
+ res.send(messages)
+ }
+
+ // Create a server that listens to port 3000
+ app.listen(3000) {
+ console.log("server start at port 3000")
+ }
+}
+- Run the task
jsRunfrom IntelliJ of from the command line./gradlew --console=plain jsRun. The server should start running. - Open the hello endpoint on http://localhost:3000/hello
Execution failed for task ':kotlinStoreYarnLock'
If you get this error:
Execution failed for task ':kotlinStoreYarnLock'.
+> yarn.lock was changed. Run the `kotlinUpgradeYarnLock` task to actualize yarn.lock file
+Run ./gradlew kotlinUpgradeYarnLock so that yarn.lock is updated
🧪 Adding a post endpoint and an external Kotlin/JS definition
Let's add a post endpoint which reads the body as a json. In order to read the body as json, we must add this possibility to express by importing the npm library body-parser and by calling app.use(bodyParser.json()). Once this setup is complete, req.body will contain the content of the body. However, there is no available external definition for bodyParser as of the time of writing. Thus, we must create or own external definition.
- First, add the body-parser dependncy in the build file
implementation(npm("body-parser", "> 1.0.0 < 2.0.0")) - Next, we would write:
app.use(bodyparser.json())to activate the library. Let's guess what a minimal definition ofbodyparsercan be.
BodyParser.kt
// external means that this class is defined in JS
+external class BodyParser {
+ // we tell Kotlin that we want to use the json() function.
+ fun json(): Any
+ // It is not required to define all the functions of the module
+}
+
+// @JsModule is used to import the module from the NPM registry
+@JsModule("body-parser")
+external val bodyParser: BodyParser
+- Finally, we just need to add the BodyParser.kt file into the project and use it in our server.
main.kt
app.use(bodyParser.json())
+app.post("/hello") { req, res ->
+ // Kotlin does not keep the original field name when parsing JSON from JS (you can see it the in get response)
+ if (req.body as? Message == null) {
+ println("failed to get the body from Kotlin")
+ }
+ // Thus, we need to use js() to get the the field by its expected name
+ // js() calls JS from Kotlin
+ println("req.body from JS ${js("req.body.id")} - ${js("req.body.message")}")
+ val id = js("req.body.id") as? Int
+ val message = js("req.body.message") as? String
+ if (message != null && id != null) {
+ messages.add(Message(id, message))
+ res.status(201).end()
+ } else {
+ res.status(400).send(js("{cause : 'error'}") as Any)
+ }
+}
+🧪 Adding more endpoints
- Add PUT and DELETE endpoints
🎯 Solutions
- ktor Rest API
- Spring boot Rest API
- The starter and final nodejs projects are available here
📖 Further readings
These official tutorials go even further:
- This tutorial from kotlinlang shows how to create a RESTful web service with a database using Spring Boot.
- This one from spring.io show how to build a web application with Spring Boot and Kotlin.
- Rest ÄPIs with Spring
- Quarkus and kotlin
References
📚 Frontend development
Kotlin supports a wide selection of frontend frameworks across all platforms: mobile, desktop and web.
Please find below a glimpse of the possibilities that you can do right from IntelliJ:
- On the Desktop side
- Thanks to JVM support, Kotlin supports JavaFX (There was a Kotlin counterpart called tornadofx which is not maintained anymore).
- Compose Multiplatform brings Jetpack Compose to the desktop, the web and mobile.
- On the Web
- Ktor can use templates engines such as FreeMarker to create server pages.
- With KotlinJS, developers can create React, nodsjs, or vanilla JS Apps using Kotlin.
- Kotlin WASM compiles into Web Assembly. It can complement KotlinJS for computation intensive tasks.
- On Mobiles
- Android developers use the Jetpack Compose UI Framework or the legacy xml layouts. It is experimental on iOS.
Kotlin supports cross platform frontend development thanks to Kotlin MultiPlatform (KMP)
Kotlin Multiplatform (KMP)
"The Kotlin Multiplatform technology is designed to simplify the development of cross-platform projects. It reduces time spent writing and maintaining the same code for different platforms while retaining the flexibility and benefits of native programming." ₁
KMP relies on Kotlin native and other Kotlin features to help developers create projects that target multiple platforms using a common Kotlin code-base.
Many combinations of targets and use cases are possible:
- Full-Stack web apps: A project that contains a backend and a web app while sharing common logic.
- Multiplatform libraries
Kotlin/JS and Kotlin/WASM
- Kotlin/JS can also target the web and even use web frameworks (such as react) in Kolitn.
- Kotlin WASM is another possibility to target the web but this will generate WASM instead of pure JS code.
- It can be used for example to develop computation intensive libraries.
- Maybe we can do even more in the future with as all these technologies (Kotlin, WASM and Kotlin/WASM) evolve. - For example, WASI allows WASM to communicate with the operating system. - This means that me may see Kotlin/WASM project projects in the future that can target both the browser and the OS.
- Let's keep watching 😄.
🧪 Kotlin/WASM web app
- Let's create a Kotlin/WASM app. By cloning
git clone git@github.com:Kotlin/kotlin-wasm-examples.gitand opening the browser-example folder in your IDE.- To get up to date information on how to start a Kotlin/WASM project, please refer to the official documentation for kotlin/wasm.
- Open the project and run the
wasmJsBrowserRuntask. - The development server should start and you can open your WASM powered webapp on http://localhost:8080/
- ⚠️ You may need to activate some flags on your browser for the app to work. If you see a blank page, please read the browser logs to check for the instructions.
- Please check the contents of src/wasmJsMain/kotlin/Simple.kt to understand how the page is coded.
- Next, let's check the generated wasm file which is available in build/js/packages/project_name/kotlin
- WASM being a binary format, we need to convert it first to text format.
- We can either install WABT (The WebAssembly Binary Toolkit or wabbit) and use the wasm2wattool
wasm2wat --enable-all -v .\kotlin-wasm-demo-wasm.wasm -o wasm.wat, - or use an online converter such as this one
- ❗ However, I couldn't get it to work (yet).
Kotlin/JS and Kotlin/WASM common points
Both Kotlin/WASM and Kotlin/JS IntelliJ work somewhat similarly.
- Both rely on the KMP plugin
- Kotlin/WASM is enabled by adding a
wasmjssection in thebuild.gradle.ktsfile, while Kotlin/JS is enabled by adding ajssection. - The Kotlin code will compile to WASM and / or JS. Kotlin/JS generates only JS while Kotin/WASM generates both JS and WASM.
- In both cases, the entry point of the generated code is a JS file called module_name.js.
- The index.html in the resources folder loads the generated JS explained above (the one named module_name.js).
- The task
wasmBrowserDevelopmentRunorjsWasmBrowserDevelopmentRunrun a local server that hosts both the index.html files and the generated JS and WASM files.
Compose multiplatform
"Compose Multiplatform simplifies and accelerates UI development for Desktop and Web applications, and allows extensive UI code sharing between Android, iOS, Desktop and Web. It's a modern toolkit for building native UI. Quickly bring your app to life with less code, powerful tools, and intuitive Kotlin APIs."
Button(
+ onClick = {
+ logger.info("Pressed!")
+ }
+) {
+ Text("Hello $platform")
+}
+It is based on Android Jetpack Compose declarative UI approach ( which is similar also to iOS SwiftUI ) 1
Compose multiplatform vs Jetpack Compose
While very similar, Compose multiplatform is different from Jetpack Compose as the latter is only compatible with Android. Google provides a JetPack compose tutorial for Android development.
Compose HTML is not cross-platform
Compose HTML is UI a library targeting Kotlin/JS which is not compatible with Compose Multiplatform (it is a different API). For cross-platform UI development with Compose Multiplatform, compose Web is the choice.
🧪 Create a Compose multiplatform app
We'll create a multiplatform app using the official template. At the time of writing, this template does not include a compose web target.
- Please check that your environment is correctly setup as explained here.
- On Windows and Linux, we don't need to install iOS/macOS related tools but and we won't be able to run iOS/macOS targets.
- If we don't want to install Android Studio, we need at least to install the Android SDK either through the official installer or from the "Languages and Framework -> Android SDK" menu in the settings.
- Open the official template and either download a zip or use the "use this template" options on GitHub.
- Open the downloaded projet. You'll note that it contains these modules:
- a shared module (or subproject) that contains common code as well as
- and another module for earch targeted platform: androidApp, iOSApp and desktopApp (When web will be included in the template, we should also see a webApp project). These contain the source code of the apps itself (such as the main activity in Android, the
@main Appin iOS and the main function in desktopJVM) and well as platform specific resources that cannot be placed in the shared module. Some examples of such files are the AndroidManifest.xml for android and the info.plist in iOS.
- In order to run the desktopApp, open a terminal on the project root folder and launch this command:
./gradlew desktopApp:run. - In order to run the Android App, the simplest way is to launch it from IntelliJ
. It is also possible define a gradle task that installs the app on the device and issues a command to the device to launch it. - In order to run the iOS App, the simplest way is to run it on the simulator using IntelliJ. In order to run it on a real device, the TramID needs to be defined as explained here
🧪 Playing with the Compose multiplatform API
Compose multiplatform is a component based declarative UI framework. Each component is called a Composable and is defined as a function annotated with @Composable.
In compose multiplatform, the main component (the component at the root of the App) is usually found in shared/src/commonMain/Kotlin/App.kt.
- Take a look at shared/src/commonMain/Kotlin/App.kt, run the app and try to understand how compose works.
- Let's create a new composable called
RandomNumberList.
@Composable
+fun RandomNumberList(){
+ // Generate a list of random numbers
+ val myRandomValues = List(5) { Random.nextInt(0, 30) }
+ // LazyColumn is a vertically scrolling list that renders items on demand
+ LazyColumn {
+ items(myRandomValues.size){
+ Text(text = "$it")
+ }
+ }
+}
+- Place this composable below
AnimatedVisibilityandButtonand run the app.
/*
+Button(onClick ...
+AnimatedVisibility(showImage) { ...
+*/
+RandomNumberList()
+- Exercise: Make the "Hello, .." button switch between showing the list and and the image.
🎯 Solutions
📖 Further reading
Learning Kotlin
A beginner's guide to a modern programming language
Language features
null safety, extensions, lambdas, Java interoperability and more
Backend development
With Ktor, spring and NodeJS
Frontend development
Compose multiplatform, Kotlin/JS, Kotlin/WASM and JVM frameworks
Cross-platform development
With KMP and Compose multiplatform
Advanced Kotlin
Coroutines, delegates, Function literal with receiver, DSLs and more
Practical exercises and solutions
All chapters have a set of exercises
Welcome
Who we are
We design payments technology that powers the growth of millions of businesses around the world. Engineering the next frontiers in payments technology
- Leader in payment and secured transactions
- Over 50 billion transactions/year
- 7000+ engineers in over 40 countries
- A huge & diverse tech-stack
Prerequisites
- Basic knowledge of object-oriented language like Java
- Prepare your development environment and install stuff before the session (see Tooling section)
Useful links
📚 Advanced and other Kotlin features
Delegated properties
Kotlin allows to delegate the getter and setter of a property to another object, which is called a delegate. It is a class that defines the getValue and setValue methods.
Kotlin provides standard delegates such lazy properties and observable properties.
▶️ this code illustrates delegate properties.
Concurrency and Coroutines
Kotlin provides a high level concurrency model called Coroutines. The developer can delegated the management of threads to the compiler and runtime and using higher level constructs than threads to express asynchronous operations.
Coroutines in Kotlin revolve around these concepts:
- A coroutine is an instance of suspendable computation.
- Kotlin has many methods for creating a coroutine such as
launch.
- Kotlin has many methods for creating a coroutine such as
- A coroutine must exist within a coroutine scope.
- For example
runBlockingcreates a coroutine scope whithin which coroutines can be launched.
- For example
- A coroutine can run suspend functions which can suspend the coroutine but do not block the thread.
- For example: the
delaysuspend the coroutine but does not block the thread on which it is running. - Suspend functions are operations that may take time such http requests and file system calls.
- For example: the
- The
suspendqualifier defines a suspend function. It runs within a coroutine and can call other suspend functions. Flowallows to generate a list of asynchronous values.DeferredandChanneltransfer a single value and a stream of values, respectively, between coroutines.
▶️ this code show how to create a coroutine and suspend function and how to use them.
▶️ this code illustrated flows.
▶️ this code illustrates channels and deferred.
Function literal with receiver and Type-safe builders
As seen previously, function extension add behavior to existing classes. Inside the definition of the function extension, we can reference the extension receiver (or this) implicitly.
fun String.countCharacters() = length // or this.length
+println("hello".countCharacters()) // prints 5
+We can define this extension with a function literal (or lambda) in instead of a named function (declared with fun).
var extFn: String.() -> Int
+extFn = { length } // extFn is a function literal
+println("hello".extFn()) // prints 5
+println(extFn("hello")) // prints 5
+extFn is a function literal (lambda) that has access to the receiver (this). That's why it's called a function literal with receiver.
extFn("hello") or extFn("hello") call the extension as expected from extension functions.
The type of a function literal with receiver is funName: ReceiverType.(arg1Type, arg2Type, etc.) -> ReturnType and is called with funName(receiverValue, arg1Value, etc.) or receiverValue.funName(arg1Value, etc.). However, this is not the interesting aspect.
The important part is extFn = { length } which can be put as a function argument in a higher order function. The developer that calls the higher order function must define extFn, which in turn has access to the receiver. This allows for a nice style of programming. ▶️ this code shows an example.
Type-safe builders combine well-named builder functions and functions literals with receiver to create type-safe, statically typed builders in Kotlin.
Builder pattern
The builder pattern is a way to construct complex objects.
// StirngBuilder uses the builder pattern
+val text = StringBuilder("Temp")
+ .append(1)
+ .append(true)
+ .append("friend")
+ .toString()
+This code shows a basic type-safe builder.
Kotlin docs provides an example of an advanced type-safe builder that builds an HTML page.
🧪 Exercises
Exercise 1
- open the java-integration-exercise projects in the materials folder.
- Have a look at the Java class we provided you in the
src/main/java/com/worldline/learning/kotlin/java2kotlinpackage. (yes, that's the Pokemon class) - Convert that Java class in Kotlin using IntelliJ's awesome copy-pasta tool! (just copy paste the java code in a kotlin file, one is provided at
src/main/kotlin/com/worldline/learning/kotlin/java2kotlin) - Have a look at the generated Kotlin code, and note the major differences you spot!
📚 Kotlin language features
Kotlin is an object oriented language with functional features. This chapter covers important and relevant features of the language slit into basic and intermediate. Another chapter covers advanced features.
Basic features
Basic constructs (variables, control flow)
- Kotlin is statically typed and supports implicit typing.
- Static typing: types cannot change on runtime (it is the opposite of dynamic typing).
- Implicit typing: the compiler can infer the type whenever possible.
varcreates mutable variables.valcreates immutable variables or constants.- Semi-colons are optional.
- Kotlin supports top level declaration of variables and functions (They can be declared outside of classes).
- String interpolation is available with this syntax
${expression}. if, andwhenstatements are expressions (they can return a value).whenis equivalent to theswitchstatement of other languages- The ternary operator is not available but the
ifstatement replaces-it.
- for-each is the only type of for loop available.
- Object oriented programming is supported as in Java with some additional features such as extensions.
- The compiler supports Null Safety. It allows to write code free from null pointer errors with a compile time guarantee.
- Functional programming is supported (Higher-order functions and functions as 1st class items, etc.).
Use val by default
Replace by var only if needed.
▶️ this code highlights the above features.
Functions
In the this section, the terms 'argument' and 'parameter' are used interchangeably.
Functions in Kotlin have the following features:
- Declaration:
fun functionName(arg1: type1 = defaultvalue1, ...) : retunrType. - Call a function by passing the value in the declaration order.
- Use argument labels for more clarity, however, it also allows for arbitrary ordering of arguments.
- Optional arguments have a default value and can be omitted during the call.
- Functions are first class items or citizen: they can be assigned to a variable, passed as a function parameter, or returned from a function.
- 💡 A function that takes a function as an argument or returns one is a higher order function.
- A function type can be expressed as follows:
(typeOfParam1, typeOfParam2, etc) -> returnType(The empty return type isUnit). - Anonymous functions use the following syntax
{ argName1, argName2, etc. -> // code }- Also called or lambda functions or literal functions
- The last function argument can be put after the closing after the closing parenthesis
compute(9, 5) { x, y -> x * y }
▶️ this code highlights the above features.
The next section talk about null safety.
Null safety
In a nutshell, null safety is a compiler feature that eliminates the infamous Null pointer exception or npe. The Kotlin compiler reports errors and warnings when we manipulate nullable (also called optional) values. Here is a list of null safety features provided by Kotlin:
- All types are non-nullable by default; we cannot assign
nullto a variable or an argument.- For example, this code fails
var s: String = null.
- For example, this code fails
- A type can be made nullable by suffixing it with a ?. For example:
var s: String? = null. - Kotlin forbids calling a method or a property of a non-nullable type, unless we do one of these possibilities:
- Use optional chaining with the ? suffix.
- Provide a default value with the elvis ?: operator.
- Smart-cast the nullable into a non-nullable.
- Use the !! operator that eliminates compiler checks. This should never be used.
Never unwrap with !!
Use other safe techniques instead.
▶️ this code illustrates null safety and how to use optional types.
Java `Optional` does not provide compile time null checks
Optional wrap null values on runtime. The Java compiler (as of version 17) does not provide unwrapping features such as smart casting. It is still possible to have a npe like this: Optional<String> s = null; s.isPresent();
Enumerations
Enumerations allow to work with a group of values in a type-safe fashion. Unlike Java enums, Kotlin enums are classes. Kotlin enum classes provide these features:
whenstatements support enumerations.- Enum constants can declare their own anonymous classes with their corresponding methods, as well as with overriding base methods.
- An enum class can implement an interface but it cannot derive from a class
- There are methods for listing the defined enum constants and getting an enum constant by its name.
- Every enum constant has properties for obtaining its name and position (starting with 0).
▶️ this code illustrated the features above. For further reading please consult the official documentation.
🧪 Exercises
Exercise 1
Please click on this link to view the exercise
Please open to see the solution(s)
Exercise 2
Please click on this link to view the exercise
Please open to see the solution(s)
Intermediate features
Object oriented programming
Kotlin allows to write concise OOP code and has the following features:
- Available common features: classes, inheritance, interfaces, and abstract classes.
- Native support of properties: do not define getters and setters unless needed.
- Just add
get()andset(value)functions next to the property declaration.
- Just add
- Constructor arguments are defined next to the class name
class ClassName(arg1, atg2, ) - Prefixing a constructor arguments with
valorvarmakes it a property (valmakes it read-only). - The constructor name is
initand does not require parameters. - The compiler checks that all non-nullable properties are initialized by the end of the constructor.
- ⚠️ The compiler does not check the initialization of
lateinitproperties. Thus, accessing them before while uninitialized causes an exception.
- ⚠️ The compiler does not check the initialization of
- Prefix classes with
opento allow inheritance. - Kotlin enables the
publicaccess level by default. - The equality operator
==callsequals()(as opposed to Java which uses reference equality). - A companion object contains static methods and properties.
- Extensions add function and properties to existing classes.
- 💡 They replace inheritance in many situations.
- For example, we can add functions to the String class instead of creating a new
StringUtilsclass.
- Sealed classes and interfaces cannot be extended or implemented by third parties.
Do not define accessors unless needed
As opposed to Java, Kotlin supports properties and allows to add accessors later without refactoring the code that calls these properties. Thus, by default, just define the name of properties without accessors and use them directly.
▶️ this code illustrates some features.
Data class
Data classes are final (cannot be inherited from) classes that provide standard functionality:
equals()andhashCode()toString()of the form"class(field=value, ...)"componentN()that correspond to the properties in their order of declaration.copy()
However, they have the following constraints:
- The primary constructor needs to have at least one parameter.
- All primary constructor parameters need to be marked as val or var.
- They cannot be abstract, open, sealed, or inner (💡 but extensions are possible).
▶️ this code illustrates some features.
Functional programming
General concepts
Functional programming revolves around these concepts: pure functions, recursion, referential transparency, immutable variables, functions as first-class citizens, and higher-order functions.
Let's briefly explain these concepts:
- Immutable variables means that we cannot change the value of a variable or its properties once it has been created. If we want to do so, we must create a new instance with the new value.
- Pure functions are functions that do not have side effects and will thus return always the same output given the same input.
- Functions are first class citizens: they can be assigned to a variable or used in higher-order functions (passed as a function parameter to another function or returned from a function).
- Referential transparency: means that an expression can be replaced by its result without changing the behavior of the program. Transparency refers to the fact that the implementation of the expression is irrelevant.
💡 Pure functional languages provide these features natively and enforces them (at build time).
Kotlin and functional programming
Kotlin is not a pure functional languages but it supports some features. For example, Kotlin does not have compile time verification of pure functions, but it provides immutable collections through the kotlinx.collections.immutable library.
listOf generates read-only lists, which are not immutable
A read-only list cannot add or remove elements, but it can change the underlying data.
@Test
+fun givenReadOnlyList_whenCastToMutableList_checkNewElementsAdded(){
+ val list: List<String> = listOf("This", "Is", "Totally", "Immutable")
+ (list as MutableList<String>)[2] = "Not"
+ assertEquals(listOf("This", "Is", "Not", "Immutable"), list)
+}
+The Arrow-kt library add more functional programming features.
Declarative programming
Declarative programming is a famous style within functional programming. It consists of writing code as a chaining of function calls in this style val result = f(x).g(y). .... Higher order functions replace many situation where we would use loops. This favors readable code which is easy to debug an maintain.
▶️ this code show an example of list manipulation using declarative programming.
Kotlin and Java interoperability
- Kotlin is designed with Java interoperability in mind.
- Kotlin code may require some annotations to be called from Java.
- It is possible to mix Java and Kotlin in the same project.
- JetBrain's IntelliJ and Android Studio can convert to Kotlin when pasting java code.
- Kotlin generates Java records by annotating a data class with
@JvmRecordand targeting JVM 16, among other requirement listed here. - It is much more easier and natural to call Java from Kotlin.
- For example: Java accessors are converted to Kotlin properties.
▶️ this code shows how to convert a Kotlin List to a Java ArrayList.
The official documentation provides exhaustive documentation on Kotlin and JVM integration
🧪 Exercises
Exercise 3
Please click on this link to view the exercise
Please open to see the solution(s)
Exercise 4
Please click on this link to view the exercise
Please open to see the solution(s)
Exercise 5
Please click on this link to view the exercise
Please open to see the solution(s)
Exercise 6
Please click on this link to view the exercise
Please open to see the solution(s)
Exercise 7
Please click on this link to view the exercise
Please open to see the solution(s)
📖 Further reading
🛠 Let's make a cross-plaform app !
By combining KMP and Compose, it is possible to fully develop cross-platform mobile, web and desktop apps using only Kotlin.
Prerequisites
- Basic knowledge of kotlin development (nullability,inline & lambda functions mainly)
- Android Studio IDE with latest stable version Giraffe version or above
- A good connectivity
TIP
For more information about your DEV environment and installs please have a look to jetbrain related docs
_____ 🚀 Start the practical work here 🚀_____
🚀 Presentation of Kotlin
Kotlin is a modern programming language developed by JetBrains.
Some features
- Kotlin compiles to many targets: the JVM, JS, WASM, Android, iOS, Desktop, native code, etc.
- Many server frameworks officially support Kotlin such as Spring and Quarkus.
- It is the first-class language for writing Android.
- Kotlin can compile to native with Kotlin native or with GraalVM.
- KMP allows to share code between different platforms.
- Kotlin can be considered as both fullstack and corss-platform language.
- Inter-operable with Java.
- Provides modern features such as compile-time null safety and data classes.
- Supports Object oriented programming and functional programming.
- Kotlin KEEP is its open source evolution process.
History
- February 15, 2016: Kotlin 1.0 was released.
- January 04, 2017: Spring introduced Kotlin support in Spring 5.
- At Google I/O 2017, Google announced first-class support for Kotlin on Android.
- On 7 May 2019, Google announced that Kotlin the preferred language for Android app developers.
- June 2022: Kotlin 1.7 was released with the version of the new K2 compiler.
Some numbers and facts
- As of 2022, Kotlin is used by 7.8% of the industry experts.
- According to StackOverflow, Kotlin was the 4th most beloved language in 2020 with 62.9% votes.
- Kotlin is now listed among the top 20 programming languages by Redmonk.
- Kotlin is among the top 3 languages that most businesses are planning to migrate their apps to in 2022.
- Kotlin is used by global companies like Google, NetFlix, Amazon, Trello, and more.
- Pinterest and Uber are among the companies that migrated their apps to Kotlin from Java.
Please find more statics here:
Why switch from Java to Kotlin
Here are some arguments that motivate switching from Java (version 17 LTS at the time of writing) to Kotlin.
- Kotlin supports more targets than Java.
- Kotlin has compile time null-safety (Java Optionals are runtime wrappers for nullable values and null annotations have less features).
- Kotlin strings support interpolation.
- Casting in Kotlin is smart.
- Kotlin functional programming features are better. It even allows to define Type-Safe builders and DSLs.
- Kotlin can be mixed with Java code, thus helping the migration process.
You can read more arguments in these articles:
- Java Vs Kotlin: Which One Is Better To Learn In 2022?
- 8 Reasons Why You Should Switch To Kotlin From Java
A decision tree to help you decide if you should use Kotlin
Prerequisites
- Recommended: IntelliJ IDEA (Both community or ultimate are OK),
- or GitPod by opening https://gitpod.io/#https://github.com/worldline/learning-kotlin to create a workspace and then browser to the material folder,
- or VSCode (with Kotlin and Java plugins) + JDK 17 (install via scoop.sh on windows or SDK man on Unix) + gradle
📖 Further reading
📅 Workshops
(2023) Android makers : Kotlin Beyond Android
Link
Workshop link: awl.li/am23-kt
Agenda
- Backend development: Rest API with Ktor
- Optional: Backend development: Rest API with nodeJS and Kotlin/JS
- Front-end development: Kotlin/WASM and Kotlin/JS webapp
- Front-end development: cross-platform Hello world App with Compose multiplatform
- Front-end development: Cross-platform Quiz App with Compose multiplatform
- Full-stack development: Quiz App with Compose multiplatform and Ktor server
(2023) JNation : Let's discover the possibilities of Kotlin
Link
Workshop link: awl.li/jnation23-kt
Agenda
- Prerequisutes
- Selection of Kotlin's languages features: null safety and functions
- Backend development: Rest API with Ktor
- Optional: Backend development: Rest API with nodeJS and Kotlin/JS
- Front-end development: Kotlin/WASM and Kotlin/JS webapp
- Front-end development: cross-platform Hello world App with Compose multiplatform
- Front-end development: Cross-platform Quiz App with Compose multiplatform
- Full-stack development: Quiz App with Compose multiplatform and Ktor server
(2023) Mobile DevOps summit
- Title: From Android to Multiplatform: leveraging the full potential of Kotlin
- Link: awl.li/mds23-kt
Agenda
- Initiate a cross-platform app
- Live examples of other Kotlin possibilities:
(2024) MiXit
- Titre : Développement front et back en Kotlin. Une visite guidée de KMP
Agenda
- Prérequis
- Fonctionnalités notables: null safety et les fonctions
- Développement backend
- Développement frontend
- Développement fullstack
- Autres fonctionnalités
📚 Développement du backend
De nombreux frameworks supportent officiellement Kotlin comme Spring, Quarkus et Ktor, parmi d'autres listés ici.
En outre, Kotlin est théoriquement compatible avec tout framework qui cible la JVM ou JS. Cependant, les frameworks qui ne supportent pas officiellement Kotlin peuvent nécessiter quelques ajustements pour l'utiliser.
Ktor
Ktor est une bibliothèque Kotlin multiplateforme permettant de développer des clients et des serveurs HTTP. Cela fait de Ktor une bibliothèque utile à la fois aux développeurs frontend, pour la partie client HTTP, ainsi qu'aux développeurs backend, pour la partie serveur HTTP. Dans ce qui suit, nous allons créer une API REST avec le serveur Ktor.
TP : développer une API avec Ktor
- Créez un projet sur start.ktor.io avec les plugins suivants : Content Negotiation, kotlinx.serialization, et Routing.
- Cliquez sur "Generate project".
- Téléchargez l'archive, décompressez-la et ouvrez le projet avec votre IDE préféré.
- Créez un package
modelset ajoutez-y une classe de donnéesCustomeravec ces propriétés immuablesid : String, firstName : String, lastName : Chaîne, email : Chaîne. - Annotez la classe avec
@Serializable. - Créez un nouveau package nommé
routeset ajoutez-y un fichierCustomerRoutes.ktqui contiendra le code pour l'endpoint/customer. - Le code ci-dessous fournit l'implémentation de certains endpoints. Veuillez implémenter les autres.
- Pour activer la route, appelez
customerRouting()dans le fichier de configuration du routage situé dansplugins/Routing.kt. - Pour plus de simplicité, utilisez une liste globale de clients en mémoire
val store = mutableListOf<Customer>(). - Lancer le serveur en exécutant la méthode main.
- Tester l'API sur l'IDE en utilisant un fichier http ou en utilisant n'importe quel autre client.
CustomerRoutes.kt
val store = mutableListOf<Customer>()
+
+fun Route.customerRouting() {
+ route("/customer") {
+ get {
+ call.respond(store)
+ }
+ get("{id?}") {
+ val id = call.parameters["id"] ? : return@get call.respondText(
+ "Missing id",
+ status = HttpStatusCode.BadRequest
+ )
+ val customer =
+ store.find { it.id == id } ? : return@get call.respondText(
+ "Pas de client avec l'id $id",
+ status = HttpStatusCode.NotFound
+ )
+ call.respond(customer)
+ }
+ post {
+ val customer = call.receive<Customer>()
+ store.add(customer)
+ call.respondText("Customer stored correctly", status = HttpStatusCode.Created)
+ }
+ delete("{id?}") {
+ // TODO
+ }
+ }
+}
+
+plugins/Routing.kt
fun Application.configureRouting() {
+ routing {
+ customerRouting()
+ }
+}
+return@label
Vous pouvez spécifier le niveau que vous voulez retourner avec un label explicite en utilisant return@lambda.
lambdaA {
+ lambdaB {
+ lambdaC {
+ val randomInt = Random.nextInt(0, 100)
+ if (randomInt > 50) return@lambdaC else return@lambdaB
+ }
+ printf("In lambdaB")
+ }
+}
+CustomerTest.http
POST http://127.0.0.1:8080/customer
+Content-Type : application/json
+
+{
+ "id" : "100",
+ "firstName" : "Jane",
+ "lastName" : "Smith",
+ "email" : "jane.smith@company.com"
+}
+
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type : application/json
+
+{
+ "id" : "200",
+ "firstName" : "John",
+ "lastName" : "Smith",
+ "email" : "john.smith@company.com"
+}
+
+###
+POST http://127.0.0.1:8080/customer
+Content-Type : application/json
+
+{
+ "id" : "300",
+ "firstName" : "Mary",
+ "lastName" : "Smith",
+ "email" : "mary.smith@company.com"
+}
+
+
+###
+GET http://127.0.0.1:8080/customer
+Accept : application/json
+
+###
+GET http://127.0.0.1:8080/customer/200
+Accepte : application/json
+
+###
+GET http://127.0.0.1:8080/customer/500
+Accepte : application/json
+
+###
+DELETE http://127.0.0.1:8080/customer/100
+
+###
+DELETE http://127.0.0.1:8080/customer/500
+Cette page contient des étapes détaillées
nodejs
Grâce à Kotlin/JS, nous pouvons écrire des applications qui ciblent nodejs en utilisant Kotlin.
On peut même importer des librairies npm à condition de déclarer les API JS que l'on va utiliser en Kotlin. C'est ce qu'on appelle une déclaration externe (vous pouvez la considérer comme un équivalent des définitions de type de TypeScript) qui déclare les symboles auxquels nous voulons accéder en Kotlin grâce aux annotations @JsModule et @JsNonModule. Définir de telles déclarations externes peut s'avérer fastidieux et il ne semble pas y avoir de générateur automatique officiel et stable (dukat a été supprimé dans kotlin 1.8.20). Dans ce cas, nous avons deux options, soit écrire la déclaration externe nous-même, soit l'importer en tant que dépendance si elle est disponible.
Heureusement pour nous, le prochain TP utilise la librairie Express pour laquelle nous pouvons trouver une déclaration de type externe.
TP : API Rest avec Kotlin/JS et Express
- Dans IntelliJ, créer un nouveau projet nodejs
- Une fois le projet chargé, éditer build.gradle.ts comme suit :
- Mettre la dernière version de Kotlin dans la ligne contenant
kotlin("js"). - Ajoutez ces deux dépendances:
- La première est la bibliothèque Express,
- et la seconde est la définition externe fournie par chrisnkrueger/kotlin-express.
- ajouter une ligne
useCommonJs()à l'intérieur du blocjs. Ceci est nécessaire pour pouvoir utiliser chrisnkrueger/ kotlin-express dans notre code.
- Mettre la dernière version de Kotlin dans la ligne contenant
implementation(npm("express", "> 4.0.0 < 5.0.0"));
+implementation("dev.chriskrueger:kotlin-express:1.2.0");
+- Modifiez main.kt comme suit. Cela crée un serveur API REST qui écoute le port 3000 et fournit une route GET /hello.
data class Message(val id : Int, val message : String)
+
+fun main() {
+ val messages = listOf(Message(0, "I love Kotlin/JS"))
+ val app = express.Express()
+ app.get("/hello") { req, res ->
+ res.send(messages)
+ }
+
+ app.listen(3000) {
+ console.log("server start at port 3000")
+ }
+}
+- Exécutez la tâche
nodeRundepuis votre IDE ou depuis la ligne de commande (si vous avez installé Gradle).- Si vous rencontrez une erreur avec Yarn lock, exécutez la tâche
kotlinUpgradeYarnLockpuis réessayez.
- Si vous rencontrez une erreur avec Yarn lock, exécutez la tâche
- Ajouter des routes en POST, PUT et DELETE
- En ce qui concerne le corps du POST, Express positionne
req.bodyàundefinedà moins que nous ne spécifions un body parser.- Pour un corps en JSON, nous devons appeler
app.use(bodyParser.json()). - bodyParser est une bibliothèque npm et malheureusement, chrisnkrueger/kotlin-express ne fournit pas de définition externe pour bodyParser au moment de l'écriture de ces lignes (chrisnkrueger/kotlin-express en version 1.2.0).
- Pouvez-vous essayer de la définir vous-même en lisant le code de la bibliothèque ?
- Vous pouvez trouver une solution ici
- Pour un corps en JSON, nous devons appeler
Spring framework
Spring est un framework célèbre pour le développement d'applications côté serveur : API REST, pages web générées par le serveur, microservices, etc. Il s'appuie sur l'écosystème Java pour la compilation et l'exécution, ce qui le rend compatible avec Kotlin. Mieux encore, Spring supporte officiellement Kotlin. On peut même démarrer un nouveau projet avec Kotlin et Gradle-Kotlin. Dans la prochaine section, nous utiliserons ce projet pour recréer notre API REST plus haut avec Spring.
TP : Spring boot part 1 - développer la même API avec Spring Boot
- Créez un projet sur start.spring.io (aussi appelé Spring initializr) avec les dépendances suivantes : Spring Web et Spring Boot DevTools.
- Choisissez Kotlin comme langage et Kotlin-Grade comme gestionnaire de projet.
- Ajoutez les dépendances suivantes : Spring Web et Spring Boot DevTools.
- Cliquez sur Generate. Téléchargez l'archive, décompressez-la et ouvrez le projet avec IntelliJ (de préférence) ou VSCode.
- Pour VSCode, installez une extension Kotlin et Spring Boot Extension Pack ( ⚠️ l'extension Spring ne semble pas supporter kotlin).
- Vérifiez que la partie plugins
build.gradle.ktsutilise la dernière version de Kotlin. Voici à quoi cela devrait ressembler avec Kotlin 1.8.10 :
plugins {
+ id("org.springframework.boot") version "3.0.4"
+ id("io.spring.dependency-management") version "1.1.0"
+ kotlin("jvm") version "1.8.10"
+ kotlin("plugin.spring") version "1.8.10"
+}
+- Créez la
data class Customerdans le packagemodel(sans l'annotation@Serializable). - Créez un paquetage
controllerqui contient une classeCustomerControllerqui fournit un CRUD en utilisant une liste globale.- Vous pouvez trouver un squelette ci-dessous.
- 💡 Dans Spring, les contrôleurs Rest servent de routes Ktor, où un contrôleur définit une ressource REST.
- Définissez les mêmes routes que dans le TP précédent.
- Démarrez le serveur de l'API REST en exécutant :
- Sur Powershell :
.\gradlew.bat bootRun - Tout shell Unix :
.\gradlew bootRun - Ou bien, vérifiez si votre IDE fournit déjà des configurations d'exécution pour les projets Spring Boot.
- Sur Powershell :
- Veuillez tester les routes avec un client REST. Vous pouvez trouver des fichiers http ici au format JetBrains ou au format de l'extension REST Client de VSCode
CustomerController.kt
val store = mutableListOf<Customer>()
+
+@RestController
+@RequestMapping("/customer")
+class CustomerController {
+ @GetMapping
+ fun getAll() = store
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id : String) { /* TODO : implement */ }
+
+ @PostMapping
+ fun addOne(@RequestBody customer : Customer) { /* TODO : implement */ }
+
+ @DeleteMapping("{id}")
+ fun deleteOne(@PathVariable id : String) { /* TODO : implement */ }
+}
+TP : Spring boot partie 2 - ajouter une base de données
Allons un peu plus loin en stockant des données dans une base de données et en écrivant quelques tests.
Nous utiliserons la base de données en mémoire H2 pour des raisons de simplicité, puisqu'elle ne nécessite pas de serveur pour fonctionner. Les classes seront mappées aux tables de la base de données avec des annotations JPA. L'API de base de données que nous utiliserons s'appelle JPARepository. C'est une API légère qui fournit des fonctionnalités CRUD communes à partir d'une simple une interface.
- Créez un nouveau projet Spring en utilisant Spring initializr avec Kotlin et les dépendances suivantes : Spring Data JPA, H2 Database, Spring Boot DevTools, Spring Web.
- Ouvrez le projet et ajoutez cette classe dans le package
model@Entity class Product(@Id @GeneratedValue var id : Long ? = null, var name : String, var price : Int). Ceci définit la classe ainsi que les annotations JPA minimales (@Entity,@Idet@GeneratedValue) pour générer la table correspondante. - Dans le package
repository, déclarez l'interfaceProductRepositorycomme suitinterface ProductRepository : JpaRepository<Produit, Long>. C'est suffisant pour que Spring génère une implémentation avec des caractéristiques communes comme nous le verrons plus tard. - Ensuite, créez une classe
ProductServicequi contiendra la logique métier. En termes d'architecture, le contrôleur appelle un service qui, à son tour, s'appuie sur d'autres services ou référentiels.
ProductService.kt
@Service
+class ProductService(@Autowired val productRepository: ProductRepository) {
+ fun getAll() = productRepository.findAll()
+
+ // use findByIdOrNull instad of findById because the latter returns an optional<Product> instead of Product?
+ fun getById(id: Long) = productRepository.findByIdOrNull(id)
+}
+- Dans le package controller, créez une classe
ProductControllerqui est mappée à/productet injectée avec@Autowired. Répondez à@Getcomme suit.
ProductController.kt
@RestController
+@RequestMapping("/product")
+class ProductController(@Autowired val productService : ProductService) {
+ @GetMapping fun getAll() = productService.getAll()
+
+ @GetMapping("{id}")
+ fun getById(@PathVariable id : Long) =
+ productService.getById(id) ? : throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+Kotlin rend getById(@PathVariable id : Long) plus concis
L'opérateur Elvis ?: permet de simplifier le code. Voici une version plus longue en guise de référence.
@GetMapping("{id}")
+fun getById(@PathVariable id : Long) : Produit {
+ val product = productService.getById(id)
+ if (product != null){
+ return product
+ }
+ throw ResponseStatusException(HttpStatus.NOT_FOUND)
+}
+En outre, Spring fournit @ControllerAdvice pour modifier le message d'exception. Vous pouvez voir un [exemple ici] (https://spring.io/guides/tutorials/rest/).
- Exécutons le projet. Avant de lancer le projet, nous devons ajouter un plugin qui permet aux classes Kotlin de générer un constructeur par défaut
id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10". Les plugins devraient ressembler à ce qui suit :
plugins {
+ id("org.jetbrains.kotlin.plugin.jpa") version "1.8.10"
+ id("org.springframework.boot") version "3.0.4"
+ id("io.spring.dependency-management") version "1.1.0"
+ kotlin("jvm") version "1.8.10"
+ kotlin("plugin.spring") version "1.8.10"
+}
+
+- En guise d'exercice, implémentez ces routes : POST d'un seul produit, DELETE par id (
/produit/{id}) et GET par id (/produit/{id}).- Indice :
ProductControllerfournit déjà les méthodes nécessaires.
- Indice :
- Appelez les différents points de terminaison avec un client REST.
- Tester votre API Rest avec un client HTTP
TP : Spring boot partie 3 - ajouter des tests
Les frameworks Spring permettent d'effectuer différents types de tests en fournissant différentes classes dès le départ :
- Tests unitaires/de composants des services et de l'API REST. Cela se fait par le biais d'utilitaires de bouchonnage tels que
MockMVC. - Tests d'intégration de l'API REST en utilisant
TestRestTemplate. Dans ce cas, un serveur complet est exécuté et testé.
La plupart des classes fournies par Spring, si ce n'est toutes, offrent une syntaxe élégante pour les développeurs Java. Certaines d'entre elles vont plus loin en tirant parti des caractéristiques spécifiques de Kotlin. Dans ce qui suit, nous allons nous concentrer sur les parties qui fournissent des DSLs Kotlin, à savoir le test unitaire de l'API REST avec MockMVC.
- Créer une classe de test
ProductControllerUnitTestsavec le contenu initial ci-dessous.MockMvcpermet de tester unitairement l'API REST. L'annotation@AutoConfigureMockMvcpermet à Spring de la configurer automatiquement.
@SpringBootTest
+@AutoConfigureMockMvc
+classe ProductControllerTests(
+ @Autowired val mockMvc : MockMvc,
+ @Autowired val productRepository : ProductRepository) {
+
+ @BeforeEach
+ fun reset(){
+ productRepository.deleteAll()
+ }
+}
+- Ajoutez les deux tests ci-dessous. Le premier utilise une approche classique tandis que le second tire parti des capacités du DSL de Kotlin. De plus, nous utilisons une chaîne littérale plus lisible.
@Test
+fun testWithClassicApproach(){
+ mockMvc.perform(get("/product"))
+ .andExpect(status().isOk)
+ .andExpect(content().string(containsString("[]")))
+}
+@Test
+fun `test GET a single product`() {
+ mockMvc.get("/product/1").andExpect {
+ status { isOk() }
+ jsonPath("$.name") { value("A") }
+ jsonPath("$.price") { value(1) }
+ content { contentType(MediaType.APPLICATION_JSON) }
+ }
+}
+- En guise d'exercice, écrire des tests pour les autres points d'accès.
Le constructeur de requêtes de JpaRepository
Les repository Spring implémentent des requêtes basées sur le nom de leurs méthodes. Par exemple, pour obtenir tous les produits triés par nom, nous pouvons ajouter cette méthode à l'interface.
interface ProductRepository : JpaRepository<Produit, Long> {
+ fun findAllByOrderByNameAsc() : List<Produit> ;
+}
+La [documentation officielle] (https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#repositories.query-methods.query-creation) fournit des explications et des exemples plus détaillés.
Projets terminés
Aller plus loin
Ces tutoriels officiels vont encore plus loin :
- Ce tutoriel de kotlinlang montre comment créer un service web RESTful avec une base de données en utilisant Spring Boot.
- Ce tutoriel de spring.io montre comment construire une application web avec Spring Boot et Kotlin.
- Rest APIs with Spring
- Quarkus et Kotlin
Lien et références
📚 Développement frontend
Kotlin supporte une large sélection de frameworks frontaux sur toutes les plateformes : mobile, desktop et web. Vous trouverez ci-dessous un aperçu des possibilités que vous pouvez faire directement à partir d'IntelliJ :
- Côté bureau
- Grâce au support de la JVM, Kotlin supporte JavaFX. 💡 Il existe même un équivalent en Kotlin appelé tornadofx.
- Compose Multiplatform apporte l'API Jetpack Compose sur le bureau, le web et le mobile.
- Sur le web
- Ktor peut utiliser des moteurs de modèles tels que FreeMarker pour créer des pages de serveur.
- Avec KotlinJS, les développeurs peuvent créer des applications React, nodsjs ou vanilla JS en utilisant Kotlin.
- Kotlin WASM se compile en Web Assembly. Il peut compléter KotlinJS pour les tâches à forte intensité de calcul.
- Compose Multiplatform apporte deux options sur le web: Compose web et Compose for Web Canvas.
- Sur les mobiles
- Les développeurs Android utilisent Jetpack Compose ou l'ancienne méthode de layout XML.
- Compose Multiplatform supporte Android de façon stable et iOS de façon expérimentale.
Comme nous pouvons le voir, Kotlin propose plusieurs options. L'option la plus séduisante en terme de partage de code est Compose Multiplatform. Ceci est possible notamment grâce à KMP
KMP
- KMP (Kotlin Multiplatform) permet de partager une base de code unique sur plusieurs cibles.
- KMP s'appuie sur Kotlin native et d'autres fonctionnalités de Kotlin pour aider les développeurs à créer des projets destinés à plusieurs plates-formes en utilisant une base de code Kotlin commune.
- De nombreuses combinaisons de cibles et de cas d'utilisation sont possibles :
- Full-Stack web apps : Un projet qui contient un backend et une application web tout en partageant une logique commune.
- Bibliothèques multiplateformes
- KMM est une ancienne dénomination qui est dépréciée.
Dans la suite de ce chapitre, nous explorerons les différentes possibilités individuellement et on fera un projet KMP dans le chapitre suivant.
Kotlin/JS et Kotlin/WASM
- Kotlin/JS peut également cibler le web et même utiliser des frameworks web (tels que react) dans Kolitn.
- Kotlin WASM est une autre possibilité de cibler le web, mais il génère WASM au lieu de code JS pur.
- Il peut être utilisé par exemple pour développer des bibliothèques à forte intensité de calcul.
- Nous pourrons peut-être faire encore plus à l'avenir grâce à l'évolution de toutes ces technologies (Kotlin, WASM et Kotlin/WASM). - Par exemple, [WASI] (https://wasi.dev/) permet à WASM de communiquer avec le système d'exploitation. - Cela signifie que je pourrais voir des projets Kotlin/WASM à l'avenir qui peuvent cibler à la fois le navigateur et le système d'exploitation.
- Continuons à observer 😄.
🧪 Application web Kotlin/WASM
- Les assistants de création de projet Kotlin/WASM et Kotlin/JS sur IntelliJ fonctionnent de manière similaire:
- L'IDE génère un fichier Kotlin qui sera compilé par la suite en WASM et/ou JS. Kotlin/JS ne génère que du JS tandis que Kotin/WASM génère à la fois du JS et du WASM.
- Dans les deux cas, le point d'entrée du code généré est un fichier JS appelé nom_du_module.js.
- L'IDE génère également dans le dossier des ressources un fichier index.html dont le but est de charger le JS généré (le fichier nom_du_module.js).
- La tâche
wasmBrowserDevelopmentRunoujsWasmBrowserDevelopmentRunlancera un serveur local qui hébergera à la fois les fichiers index.html et les fichiers JS et WASM générés.
- Créons une application Kotlin/WASM. Tout d'abord, activez l'assistant Kotlin/WASM en activant kotlin.wasm.wizard dans le registre d'IntelliJ (ouvrez le registre en appuyant deux fois sur shift et en tapant "registry" dans la boîte de recherche). Alternativement, clonez ce projet.
- Vérifiez qu'on est sur la dernière version de Kotlin dans build.gradle.kts (l'assistant peut le configurer à une version antérieure).
- Ouvrez src/wasmMain/kotlin/sample.kt et cliquez sur le bouton lancer qui apparaît à côté de la fonction
main. - Si la compilation échoue parce que l'IDE a utilisé la mauvaise tâche gradle, veuillez la changer en
wasmBrowserDevelopmentRunet essayez de l'exécuter à nouveau.
- Le serveur de développement devrait démarrer et vous pouvez ouvrir votre application web sur http://localhost:8080/
- ⚠️ Il se peut que vous deviez activer certains drapeaux sur votre navigateur pour que l'application fonctionne. Si vous voyez une page blanche, veuillez lire les journaux du navigateur pour vérifier les instructions.
- Le fichier wasm généré est disponible dans build/js/packages/nom_du_projet/kotlin
- WASM étant un format binaire, nous devons d'abord le convertir au format texte.
- Nous pouvons soit installer [WABT (The WebAssembly Binary Toolkit ou wabbit)] (https://github.com/WebAssembly/wabt) et utiliser l'outil wasm2wattool
wasm2wat --enable-all -v .\kotlin-wasm-demo-wasm.wasm -o wasm.wat, - ou utiliser un convertisseur en ligne comme celui-ci
- ❗ Cependant, je n'ai pas réussi à le faire fonctionner
- Nous pouvons soit installer [WABT (The WebAssembly Binary Toolkit ou wabbit)] (https://github.com/WebAssembly/wabt) et utiliser l'outil wasm2wattool
🧪 Application web KotlinJS
L'assistant Kotlin/JS crée une application très similaire à celle de Kotlin/WASM. Dans un prochain PW, nous créerons une application complète avec Ktor et Kotlin/JS.
Compose
Compose multiplatform est une famille de frameworks d'interface utilisateur déclaratifs pour Android (Jetpack Compose), le bureau (Compose Desktop) et le web (Compose Web). Il dispose d'un support expérimental pour iOS et Web Canvas.
Compose multiplatform vs Jetpack Compose
Bien que très similaire, Compose multiplatform est différent de Jetpack Compose car ce dernier n'est compatible qu'avec Android. Google fournit un JetPack compose tutorial pour le développement Android.
Compose Web vs Compose for Web Canvas
- La surface de l'API de Compose Web est différente des autres cibles de Compose car elle travaille directement avec le DOM.
- Compose for Web Canvas a la même surface d'API que celle du Desktop, Android et iOS car il dessine sur un Canvas et ne manipule pas le DOM.
Cela signifie que le premier a un meilleur support web et que le second a plus de code réutilisable.
🧪 Compose Web
- Créez un nouveau projet IntelliJ -> Compose Multiplaform.
- Choisissez "Single platform" -> "Web" et remplissez les autres champs.
- Choisissez Finish
- IntelliJ peut prendre un certain temps pour préparer le projet et peut demander d'installer des plugins supplémentaires.
- Lancez le serveur de développement de l'application web à l'aide de la commande
./gradlew jsBrowserRun --continuous. - Modifiez
Main.ktcomme suit et lancez l'application. - Ouvrez cette adresse :
localhost:8080.
fun main() {
+ renderComposable(rootElementId = "root") {
+ Div({ style { padding(25.px) } }) {
+ var expanded by remember { mutableStateOf(false) }
+ Button(
+ attrs = {
+ onClick { expanded = !expanded }
+ }
+ ) { Text("Cliquez sur moi") }
+ Div({ style { display(if (expanded) DisplayStyle.Block else DisplayStyle.None) } }) {
+ Text("Cliquez sur moi !")
+ }
+ }
+ }
+}
+
🧪 Compose desktop + Android app
- Créez un nouveau projet sur IntelliJ -> Compose Multiplatform.
- Choisissez "multiple platforms" et remplissez les autres champs. Choisissez ensuite Finish.
- IntelliJ commence à préparer le projet et peut demander l'installation de plugins.
- Une fois le projet prêt, lancez l'application Android en utilisant le bouton vert run.
- Lancez l'application desktop en exécutant la fonction principale du projet desktop (qui devrait se trouver dans
Main.kt). - Modifiez
App.ktdans le projet principal comme suit et lancez l'application.
@Composable
+fun App() {
+ val platformName = getPlatformName()
+ Card {
+ var expanded by remember { mutableStateOf(false) }
+ Column(Modifier.clickable { expanded = !expanded }) {
+ Texte(
+ text="Cliquez sur moi !",
+ style = MaterialTheme.typography.h2
+ )
+ AnimatedVisibility(expanded){
+ Texte(
+ text = "Bonjour, ${platformName} 🎊",
+ style = MaterialTheme.typography.h1
+ )
+ }
+ }
+ }
+}
+
Pour aller plus loin
Apprendre Kotlin
A beginner's guide to a modern programming language
Bien commencer avec Kotlin
lorem
Syntaxe de base
lorem
Exemples
lorem
Prerequisites
- Connaissance de base en language de programmation orienté object comme Java
- Préparez votre environnement de développement et installez des éléments avant la session (voir la section Outillage)
Liens utiles
📚 Fonctionnalités avancées de Kotlin
Propriétés déléguées
Kotlin permet de déléguer le getter et le setter d'une propriété à un autre objet, appelé délégué. C'est une classe qui définit les méthodes getValue et setValue.
Kotlin fournit des délégués standard tels que des propriétés paresseuses et des propriétés observables.
▶️ this code illustrates delegate properties.
Concurrence et coroutines
Kotlin fournit un modèle de concurrence de haut niveau appelé Coroutines. Le développeur peut déléguer la gestion des threads au compilateur et à l'exécution et utiliser des constructions de niveau supérieur aux threads pour exprimer des opérations asynchrones.
Les coroutines de Kotlin tournent autour de ces concepts :
- Une coroutine est une instance de calcul suspendable.
- Kotlin a de nombreuses méthodes pour créer une coroutine telle que
launch.
- Kotlin a de nombreuses méthodes pour créer une coroutine telle que
- Une coroutine doit exister dans une portée de coroutine.
- Par exemple,
runBlockingcrée une portée de coroutine dans laquelle les coroutines peuvent être lancées.
- Par exemple,
- Une coroutine peut exécuter des fonctions de suspension qui peuvent suspendre la coroutine mais ne bloquent pas le thread.
- Par exemple : le
delaysuspend la coroutine mais ne bloque pas le thread sur lequel elle s'exécute. - Les fonctions de suspension sont des opérations qui peuvent prendre du temps telles que les requêtes http et les appels au système de fichiers.
- Par exemple : le
- Le qualificateur
suspenddéfinit une fonction de suspension. Il s'exécute dans une coroutine et peut appeler d'autres fonctions de suspension. Flowpermet de générer une liste de valeurs asynchrones.DeferredetChanneltransfèrent respectivement une valeur unique et un flux de valeurs entre coroutines.
▶️ this code show how to create a coroutine and suspend function and how to use them.
▶️ this code illustrated flows.
▶️ this code illustrates channels and deferred.
Littéral de fonction avec récepteur et constructeurs de type sécurisé
Comme vu précédemment, les extensions de fonctions ajoute du comportement à des classes existantes sans utiliser l'héritage. À l'intérieur de la définition de l'extension de fonction, nous pouvons référencer implicitement le récepteur d'extension (this).
fun String.countCharacters() = length // or this.length
+println("hello".countCharacters()) // prints 5
+Nous pouvons définir cette extension avec une fonction littérale (ou lambda) au lieu d'une fonction classique (déclarée avec fun).
var extFn: String.() -> Int
+extFn = { length } // extFn is a function literal
+println("hello".extFn()) // prints 5
+println(extFn("hello")) // prints 5
+extFn est une fonction littérale (lambda) qui a accès au récepteur (this). C'est pourquoi on l'appelle une fonction littérale avec récepteur.
extFn("hello") ou extFn("hello") appelle l'extension comme prévu par les fonctions d'extension.
Le type d'une fonction littérale avec récepteur est funName: ReceiverType.(arg1Type, arg2Type, etc.) -> ReturnType et est appelé avec funName(receiverValue, arg1Value, etc.) ou receiverValue.funName(arg1Value, etc.) .). Cependant, ce n'est pas l'aspect le plus intéressant.
La partie importante est extFn = { length } qui peut être placée comme argument de fonction dans une fonction d'ordre supérieur. Le développeur qui appelle la fonction d'ordre supérieur doit définir extFn, qui à son tour a accès au récepteur. Cela permet un style de programmation assez intéressant.
▶️ ce code montre un example.
Les Type-safe builders combinent les monteurs bien nommées et les fonctions littérales avec récepteur pour créer des monteur avec un typage statique et sécurisé. La syntaxe particulière possible avec technique permet de définir une sorte de sous-langage aussi appelé DSL (domain specific language).
Le pattern monteur (Builder)
Est une technique permettant de construire des objects avec une syntaxe élégante.
// StirngBuilder uses the builder pattern
+val text = StringBuilder("Temp")
+ .append(1)
+ .append(true)
+ .append("friend")
+ .toString()
+Ce code montre un type-safe builder basique.
Kotlin docs fournit un exemple plus avancé d'un monteur de documents HTML.
Exercises
Exercise 1
- open the java-integration-exercise projects in the materials folder.
- Have a look at the Java class we provided you in the
src/main/java/com/worldline/learning/kotlin/java2kotlinpackage. (yes, that's the Pokemon class) - Convert that Java class in Kotlin using IntelliJ's awesome copy-pasta tool! (just copy paste the java code in a kotlin file, one is provided at
src/main/kotlin/com/worldline/learning/kotlin/java2kotlin) - Have a look at the generated Kotlin code, and note the major differences you spot!
📚 Fonctionnalités du langage Kotlin
Kotlin est un langage qui support les paradigmes orienté objet et fonctionnel. Ce chapitre couvre les caractéristiques basiques et intermédiaires. Le chapitre suivant couvrira les fonctionnalités avancées.
Caractéristiques de base
Constructions de base (variables, flux de contrôle)
- Kotlin est typé statiquement et prend en charge le typage implicite.
- Typage statique : les types ne peuvent pas changer à l'exécution (c'est l'inverse du typage dynamique).
- Typage implicite : le compilateur peut inférer le type tant que c'est possible.
varcrée des variables ré-assignables.valcrée des variables qu'on ne peut plus ré-assigner.- Les points-virgules sont facultatifs.
- Kotlin prend en charge la déclaration de haut niveau des variables et des fonctions (elles peuvent être déclarées en dehors des classes).
- L'interpolation de chaîne de caractères est disponible avec cette syntaxe
${expression}. ifetwhensont des expressions (elles peuvent renvoyer une valeur).whenest équivalent à l'instructionswitchdes autres langages- L'opérateur ternaire n'est pas disponible. L'expression
ifle remplace.
- for-each est le seul type de boucle for disponible.
- La programmation orientée objet est prise en charge comme en Java avec quelques fonctionnalités supplémentaires telles que les extensions.
- Le compilateur prend en charge la Null Safety. Il permet d'écrire du code sans erreur de pointeur nulle vérifié à la compilation.
- La programmation fonctionnelle est prise en charge (fonctions d'ordre supérieur et fonctions en tant qu'éléments de 1ère classe, etc.).
Utiliser val par défaut
Utiliser var uniquement si vous réassignez une variable ou argument.
▶️ this code highlights the above features.
Les fonctions
Dans cette section, les termes 'argument' et 'paramètre' sont utilisés de manière interchangeable.
Les fonctions de Kotlin ont les caractéristiques suivantes :
- Déclaration :
fun functionName(arg1 : type1 = defaultvalue1, ...) : retunrType. - Appeler une fonction en passant la valeur dans l'ordre de déclaration.
- Utilisez des étiquettes d'argument pour plus de clarté, cependant, cela permet également un classement arbitraire des arguments.
- Les arguments optionnels ont une valeur par défaut et peuvent être omis lors de l'appel.
- Les fonctions sont des éléments de première classe ou citoyens : elles peuvent être affectées à une variable, passées en tant que paramètre de fonction ou renvoyées par une fonction.
- 💡 Une fonction qui prend une fonction comme argument ou en renvoie une est une fonction d'ordre supérieur.
- Un type de fonction peut être exprimé comme suit :
(typeOfParam1, typeOfParam2, etc) -> returnType(Le type de retour vide estUnit). - Les fonctions anonymes utilisent la syntaxe suivante
{ argName1, argName2, etc. -> // code }- Aussi appelées fonctions lambda ou fonctions littérales
- Le dernier argument de la fonction peut être mis après la fermeture après la parenthèse fermante
compute(9, 5) { x, y -> x * y }
▶️ Ce code illustre les fonctions en Kotlin.
La prochaine section abordera le null safety.
Null safety
null safety est une fonctionnalité du compilateur qui élimine la fameuse Null pointer exception ou npe. En effet, le compilateur signale des erreurs et des avertissements lorsque nous manipulons des types nullables (également appelées types optionnels) dès qu'il y a un risque de npe à l'exécution. Ainsi, afin de mettre Voici une liste des fonctionnalités de sécurité null fournies par Kotlin :
- Tous les types ne sont pas nullables par défaut ; nous ne pouvons pas affecter
nullà une variable ou à un argument.- Par exemple, ce code échoue
var s: String = null.
- Par exemple, ce code échoue
- Un type peut être rendu nullable en le suffixant avec un ?. Par exemple :
var s : chaîne ? = nul. - Kotlin interdit d'appeler une méthode ou une propriété de type non nullable, sauf si l'on fait l'une de ces possibilités :
- Utilisez le chaînage optionnel avec le suffixe ?.
- Fournissez une valeur par défaut avec l'opérateur elvis ?:.
- Smart-cast le nullable dans un non-nullable.
- Utilisez l'opérateur !! qui élimine les vérifications du compilateur. Cela ne devrait jamais être utilisé.
Ne jamais déballer avec !!
Car cela équivaut à désactiver la null safety. Utilisez les autres possibilités à la place.
▶️ ce code illustrate la null safety et les types optionnels.
La classe `Optional` de Java ne fournit aucun protection à la compilation
Ce code lance une npe en Java: Optional<String> s = null; s.isPresent();. Le compilateur Java (au moins à la version version 17) ne propose pas d'équivalent à ce que propose Kotlin comme le smart casting.
Énumérations
Les énumérations permettent de travailler avec un groupe de valeurs de façon cadrée. Contrairement aux énumérations Java, les énumérations Kotlin sont des classes. Les enum class de Kotlin fournissent ces fonctionnalités :
- Les expressions when prennent en charge les énumérations.
- Une
enum classpeut définir des méthodes et implémenter des interfaces mais elle ne peut pas dériver d'une classe. - Il existe des méthodes pour lister les constantes d'une
enum class. - Chaque constante d'une énumération a des propriétés pour obtenir son nom et sa position (en commençant par 0).
▶️ ce code illustres les enum en Kotlin de façon succincte. Veuillez consulter la documentation officielle pour aller plus loin.
Exercices
Exercice 1
Veuillez cliquer sur le lien pour consulter l'énoncé
Déplier pour consulter la solution
Exercise 2
Veuillez cliquer sur le lien pour consulter l'énoncé
Déplier pour consulter la solution
Fonctionnalités intermédiaires
Programmation orientée objet
Kotlin permet d'écrire du code Orienté Object concis grâce aux caractéristiques suivantes :
- Concepts disponibles : classes, héritage, interfaces et classes abstraites.
- Prise en charge possée des propriétés : les getters et les setters sont automatiquement implémentés.
- On peut les personnaliser les accesseurs en définissant les fonctions
get()etset(value)à côté de la déclaration de la propriété.
- On peut les personnaliser les accesseurs en définissant les fonctions
- Les arguments du constructeur sont définis à côté du nom de la classe
class ClassName(arg1, atg2, ) - Préfixer les arguments d'un constructeur avec
valouvaren fait une propriété (valla rend non ré-assignable). - Le nom du constructeur est
initet ne nécessite pas de paramètres. - Le compilateur vérifie que toutes les propriétés non nullables sont initialisées à la fin du constructeur.
- ⚠️ Le compilateur ne vérifie pas l'initialisation des propriétés
lateinit. Ainsi, y accéder avant alors qu'elles ne sont pas initialisés provoque une exception.
- ⚠️ Le compilateur ne vérifie pas l'initialisation des propriétés
- Une classe doit être préfixée avec
openpour permettre l'héritage. - Kotlin utilise le niveau d'accès
publicpar défaut. - L'opérateur d'égalité
==appelle implicitement la méthodeequals()(contrairement à Java qui utilise l'égalité de référence). - Un objet compagnon contient des méthodes et des propriétés statiques.
- Les extensions ajoutent des fonctions et des propriétés aux classes existantes.
- 💡 Ils remplacent l'héritage dans de nombreuses situations.
- Par exemple, nous pouvons ajouter des fonctions à la classe String au lieu de créer une nouvelle classe
StringUtils.
- Les classes et interfaces scellées ne peuvent pas être étendues ou implémentées par des tiers.
Ne définir les accesseurs que si vous avez un comportement personnalisé
Kotlin prend en charge les propriétés de façon plus poussée que Java et permet d'ajouter des accesseurs ultérieurement sans refactoriser le code qui appelle ces propriétés. Ainsi, par défaut, il suffit de définir le nom des propriétés sans accesseurs et on peut les utiliser directement.
▶️ ce code illustre la POO en Kotlin.
Data class
Ce sont des classes qui implémentent des méthodes communes:
equals(),hashCode(),copy()ettoString()componentN()qui est une syntaxe alternative pour récupérer les propriétés.
Cependant, les data class ont des restrictions:
- Le constructeur principal doit avoir au moins un paramètre.
- Tous les paramètres du constructeur principal doivent être marqués comme
valouvar. - Une Data class ne peut pas être abstraite, ouverte à l'héritage, scellée ou interne (💡 mais des extensions sont possibles).
▶️ ce code illustrate les data class.
Programmation fonctionnelle
Concepts généraux
La programmation fonctionnelle s'articule autour de ces concepts : fonctions pures, récursivité, transparence référentielle, variables immuables, fonctions en tant que citoyens de première classe et fonctions d'ordre supérieur.
Expliquons brièvement ces concepts :
- Les variables immuables signifient qu'on ne peut pas changer la valeur d'une variable ou ses propriétés une fois qu'elle a été créée. Si nous voulons le faire, nous devons créer une nouvelle instance avec la nouvelle valeur.
- Les fonctions pures sont des fonctions qui n'ont pas d'effets secondaires et renverront donc toujours la même sortie étant donné la même entrée.
- Les fonctions sont des citoyennes de première classe : elles peuvent être affectées à une variable ou utilisées dans des fonctions d'ordre supérieur (passées en tant qu'un argument de fonction ou retournées dans un fonction).
- Transparence référentielle : signifie qu'une expression peut être remplacée par son résultat sans modifier le comportement du programme.
💡 Les langages fonctionnels purs fournissent ces fonctionnalités de manière native et les appliquent (au moment de la construction).
Kotlin et programmation fonctionnelle
Kotlin n'est pas un langage fonctionnel pur mais il prend en charge certaines fonctionnalités. En effet, Kotlin ne sait pas dire si une fonction est pures ou non, mais il fournit des collections immuables via la bibliothèque kotlinx.collections.immutable pour nous aider à manipuler des données immuables.
`listOf` génère des listes en lecture seule, mais qui sont mutables
Une liste en lecture seule ne peut pas ajouter ou supprimer des éléments, mais elle peut modifier les données sous-jacentes.
@Test
+fun givenReadOnlyList_whenCastToMutableList_checkNewElementsAdded(){
+ val list: List<String> = listOf("This", "Is", "Totally", "Immutable")
+ (list as MutableList<String>)[2] = "Not"
+ assertEquals(listOf("This", "Is", "Not", "Immutable"), list)
+}
+La librairie Arrow-kt permet d'aller encore plus loin en développement fonctionnel.
Programmation déclarative
La programmation déclarative est un style célèbre dans la programmation fonctionnelle. Il consiste à écrire du code sous la forme d'un enchaînement d'appels de fonction dans ce style val result = f(x).g(y). .... Les fonctions d'ordre supérieur remplacent de nombreuses situations où nous utiliserions des boucles. Cela favorise le code lisible qui est facile à déboguer et à maintenir.
▶️ ce code montre comment manipuler une liste avec la programmation déclarative.
Kotlin and Java interoperability
- Kotlin is designed with Java interoperability in mind.
- Kotlin code may require some annotations to be called from Java.
- It is possible to mix Java and Kotlin in the same project.
- JetBrain's IntelliJ and Android Studio can convert to Kotlin when pasting java code.
- Kotlin generates Java records by annotating a data class with
@JvmRecordand targeting JVM 16, among other requirement listed here. - It is much more easier and natural to call Java from Kotlin.
- For example: Java accessors are converted to Kotlin properties.
▶️ this code shows how to convert a Kotlin List to a Java ArrayList.
The official documentation provides exhaustive documentation on Kotlin and JVM integration
Exercices
Exercice 3
Solution(s)
Exercice 4
Solutions(s)
Exercice 5
Solution(s)
Exercice 6
solution(s)
Exercice 7
Solution(s)
Plus d'exercices et de lecture
🛠 Construisons une app multiplateforme !
En combinant KMP, KMM et Compose, il est possible de développer des applications mobiles et de bureau multiplateformes en utilisant uniquement Kotlin.
Prérequis
- Connaissance de base du développement en Kotlin (notamment la nullabilité, les fonctions en ligne et les fonctions lambda)
- IDE Android Studio avec la version stable la plus récente, version Giraffe ou supérieure
- Une bonne connectivité
TIP
Pour plus d'informations sur votre environnement de développement (DEV) et les installations, veuillez consulter la documentation liée à JetBrains ici.
____ 🚀 Demarrer la session pratique ici 🚀___
🚀 Présentation de Kotlin
Kotlin est un langage de programmation moderne développé par JetBrains.
Certaines fonctionnalités
- Kotlin est capable de compiler vers différentes cibles : la JVM, JS, Android, iOS, Les OS de bureau, etc.
- Pris en charge officiellement par de grands frameworks back-end, tels que Spring et Quarkus,
- Langage préféré pour le développement Android,
- Kotlin Native compile en code natif,
- Kotlin peut être considéré comme un langage fullstack
- Interopérable avec Java.
- Fournit des fonctionnalités modernes telles que la null safety à la compilation.
- Prend en charge la programmation orientée objet et la programmation fonctionnelle.
- Processus d'évolution open source: Kotlin KEEP.
Histoire
- 15 février 2016 : sortie de Kotlin 1.0.
- 4 janvier 2017 : Spring a introduit le support de Kotlin dans Spring 5.
- Lors de Google I/O 2017, Google a annoncé une prise en charge officielle de Kotlin sur Android.
- Le 7 mai 2019, Google a annoncé que Kotlin était le langage préféré des développeurs d'applications Android.
- Juin 2022 : Kotlin 1.7 est sorti avec la version du nouveau compilateur K2.
Quelques chiffres et faits
- En 2022, Kotlin est utilisé par 7,8 % des experts de l'industrie.
- Selon StackOverflow, Kotlin était le 4ème langage le plus apprécié en 2020 avec 62,9 % des votes.
- Kotlin est désormais répertorié parmi les 20 meilleurs langages de programmation par Redmonk.
- Kotlin fait partie des 3 principaux langages vers lesquels la plupart des entreprises prévoient de migrer leurs applications en 2022.
- Kotlin est utilisé par des entreprises mondiales telles que Google, Netflix, Amazon, Trello, etc.
- Plusieurs entreprises dont Google, Pinterest et Uber ont migré leurs applications de Java vers Kotlin.
Veuillez trouver plus de statiques ici :
Pourquoi passer de Java à Kotlin
Voici quelques arguments qui motivent le passage de Java (version 17 LTS au moment de la rédaction) à Kotlin.
- Kotlin prend en charge plus de cibles que Java.
- Kotlin protège des références null à la compilation (les
OptionalJava sont ne sont pas de protections à la compilation). - Les chaînes de caractères Kotlin prennent en charge l'interpolation.
- Les fonctionnalités de programmation fonctionnelle de Kotlin sont meilleures. Il permet même de définir des constructeurs et des DSL (Domain Specific Language) dont le typage est sécurisé (type-safe).
- Kotlin peut être mélangé avec du code Java, facilitant ainsi le processus de migration.
Vous pouvez lire plus d'arguments dans ces articles :
- Java Vs Kotlin : Lequel vaut-il mieux apprendre en 2022 ?
- [8 raisons pour lesquelles vous devriez passer à Kotlin depuis Java] (https://www.geeksforgeeks.org/8-reasons-why-you-should-switch-to-kotlin-from-java)
Sources et plus de lecture
📅 Workshops
Android makers 2023: Kotlin Beyond Android
Liens
Lien du workshop: awl.li/am23-kt
Agenda
- Backend development: Rest API with Ktor
- Optional: Backend development: Rest API with nodeJS and Kotlin/JS
- Front-end development: Kotlin/WASM and Kotlin/JS webapp
- Front-end development: cross-platform Hello world App with Compose multiplatform
- Front-end development: Cross-platform Quiz App with Compose multiplatform
- Full-stack development: Quiz App with Compose multiplatform and Ktor server
Mobile DevOps summit 2023
- Titre: From Android to Multiplatform: leveraging the full potential of Kotlin
- Lien: awl.li/mds23-kt
Agenda
- Développement d'une application multi-plateformes
- Démonstration des autres possibilités:
Devoxx Morocco 2023
- Titre: Let's discover the amazing possibilities of Kotlin
- Lien: awl.li/mds23-kt
Agenda
- Prérequis
- Caractéristiques notables de Kotlin: le null safety et les fonctions
- API Rest avec Spring boot
- API Rest avec Ktor
- Développement d'une application multi-plateformes type "Hello World" avec Compose Multiplatform
- Dévelopment sullstack d'une application de Quiz avec with Compose multiplatform en front et Ktor server en backend
- Autres fonctionnalités et possibilités:
(2024) MiXit
- Titre : Développement front et back en Kotlin. Une visite guidée de KMP
Agenda
- Prérequis
- Fonctionnalités notables: null safety et les fonctions
- Développement backend
- Développement frontend
- Développement fullstack
- Autres fonctionnalités
Hello
A beginner's guide to a modern programming language
Language features
null safety, extensions, lambdas, Java interoperability and more
Backend development
With Ktor, spring and NodeJS
Frontend development
Compose multiplatform, Kotlin/JS, Kotlin/WASM and JVM frameworks
Cross-platform development
With KMP and Compose multiplatform
Advanced Kotlin
Coroutines, delegates, Function literal with receiver, DSLs and more
Practical exercises and solutions
All chapters have a set of exercises
Welcome
Who we are
We design payments technology that powers the growth of millions of businesses around the world. Engineering the next frontiers in payments technology
- Leader in payment and secured transactions
- Over 50 billion transactions/year
- 7000+ engineers in over 40 countries
- A huge & diverse tech-stack
Prerequisites
- Basic knowledge of object-oriented language like Java
- Prepare your development environment and install stuff before the session (see Tooling section)