{"id":736,"date":"2017-06-23T09:53:56","date_gmt":"2017-06-23T09:53:56","guid":{"rendered":"http:\/\/smartfoxserver.com\/blog\/?p=736"},"modified":"2017-06-23T09:56:49","modified_gmt":"2017-06-23T09:56:49","slug":"kotlin-and-smartfoxserver-2x-part-3","status":"publish","type":"post","link":"https:\/\/smartfoxserver.com\/blog\/kotlin-and-smartfoxserver-2x-part-3\/","title":{"rendered":"Kotlin and SmartFoxServer 2X, part 3"},"content":{"rendered":"

This is the third and final chapter of our explorations with Kotlin and SmartFoxServer 2X. After building the first Kotlin extension in part one<\/a> and creating a basic client app in part two<\/a> we’re now completing the picture with a client\/server example.<\/p>\n

<\/p>\n

Word of advice: if you haven’t followed the two previous chapters make sure to go back and review them before starting with\u00a0this last chapter.<\/p>\n

\u00bb\u00a0Putting it all together<\/h2>\n

In this final installment we’re going to translate in Kotlin our client and server quick start example<\/a>\u00a0from the documentation, applying what we have learned so far about Kotlin.<\/p>\n

Server side<\/h3>\n
\r\npackage sfs2x.kt\r\n\r\nimport com.smartfoxserver.v2.core.ISFSEvent\r\nimport com.smartfoxserver.v2.core.SFSEventType\r\nimport com.smartfoxserver.v2.entities.User\r\nimport com.smartfoxserver.v2.entities.data.ISFSObject\r\nimport com.smartfoxserver.v2.entities.data.SFSObject\r\nimport com.smartfoxserver.v2.extensions.BaseClientRequestHandler\r\nimport com.smartfoxserver.v2.extensions.SFSExtension\r\n\r\nval CMD_SUM = "sum"\r\n\r\nclass SumHandler : BaseClientRequestHandler()\r\n{\r\n    override fun handleClientRequest(user: User, params: ISFSObject)\r\n    {\r\n        if (params.containsKey("n1") && params.containsKey("n2"))\r\n        {\r\n            val n1 = params.getInt("n1")\r\n            val n2 = params.getInt("n2")\r\n\r\n            val resObj = SFSObject()\r\n            resObj.putInt("res", n1 + n2)\r\n\r\n            send(CMD_SUM, resObj, user)\r\n        }\r\n    }\r\n}\r\n\r\nclass KotlinTestExtension : SFSExtension()\r\n{\r\n    override  fun init()\r\n    {\r\n        trace("Kotlin Extension ready!")\r\n\r\n        addRequestHandler(CMD_SUM, SumHandler());\r\n    }\r\n\r\n    override fun destroy() {\r\n        super.destroy()\r\n\r\n        trace("Kotlin Extension shutting down.");\r\n    }\r\n}\r\n<\/pre>\n
We have already learned how to create an Extension class by inheriting from the parent SFSExtension<\/strong> class and overriding the init()<\/strong> method. This time we’re also implementing a request handler by creating a class that extends\u00a0BaseClientRequestHandler<\/strong>.<\/p>\n
Our SumHandler\u00a0<\/strong>implementation takes two integer parameters, sums them together and sends them back to the client, wrapped in an SFSObject.<\/p>\n
As a side note, it’s worth noticing how Kotlin is more flexible with class definitions as we’re not constrained to the one-class-per-file rule\u00a0of Java development.<\/p>\n
Client\u00a0side<\/h3>\n
\r\nimport com.smartfoxserver.v2.entities.data.SFSObject\r\nimport com.sun.xml.internal.rngom.parse.host.Base\r\nimport sfs2x.client.SmartFox\r\nimport sfs2x.client.core.BaseEvent\r\nimport sfs2x.client.core.IEventListener\r\nimport sfs2x.client.core.SFSEvent\r\nimport sfs2x.client.requests.ExtensionRequest\r\nimport sfs2x.client.requests.LoginRequest\r\nimport sfs2x.client.util.ConfigData\r\n\r\nclass SFSEventListener : IEventListener\r\n{\r\n    override fun dispatch(evt: BaseEvent?)\r\n    {\r\n\r\n        when (evt?.type)\r\n        {\r\n            SFSEvent.CONNECTION -> onConnection(evt)\r\n            SFSEvent.CONNECTION_LOST -> println("Connection lost")\r\n            SFSEvent.LOGIN -> onLogin(evt)\r\n            SFSEvent.LOGIN_ERROR ->onLoginError(evt)\r\n            SFSEvent.EXTENSION_RESPONSE ->onExtensionResp(evt)\r\n        }\r\n    }\r\n\r\n    fun onConnection(evt:BaseEvent)\r\n    {\r\n        val success = evt.arguments.get("success") as Boolean\r\n\r\n        if (success)\r\n        {\r\n            println("Connected to server...")\r\n            sfs.send(LoginRequest("", "", cfg.zone))\r\n        }\r\n\r\n        else println("Connection failed!")\r\n    }\r\n\r\n    fun onLogin(evt:BaseEvent)\r\n    {\r\n        println("Logged in as: " + sfs.mySelf.name)\r\n        \r\n        val sfso = SFSObject()\r\n        sfso.putInt("n1", 15)\r\n        sfso.putInt("n2", 50)\r\n\r\n        sfs.send( ExtensionRequest("sum", sfso) )\r\n    }\r\n\r\n    fun onLoginError(evt:BaseEvent)\r\n    {\r\n        val errorMsg = evt.arguments.get("errorMessage");\r\n        println("Login failed: ${errorMsg}")\r\n    }\r\n\r\n    fun onExtensionResp(evt:BaseEvent)\r\n    {\r\n        val params = evt.arguments.get("params") as SFSObject\r\n        println("Result = " + params.getInt("res"))\r\n    }\r\n}\r\n\r\nval sfs = SmartFox()\r\nval cfg = ConfigData()\r\nval listener = SFSEventListener()\r\n\r\nfun main(args: Array<String>)\r\n{\r\n    println("SFS2X API Version: ${sfs.version}")\r\n\r\n    cfg.host = "127.0.0.1"\r\n    cfg.port = 9933\r\n    cfg.zone = "BasicExamples"\r\n    cfg.isDebug = false\r\n\r\n    sfs.setClientDetails("Kotlin", "")\r\n    sfs.addEventListener(SFSEvent.CONNECTION, listener)\r\n    sfs.addEventListener(SFSEvent.CONNECTION_LOST, listener)\r\n    sfs.addEventListener(SFSEvent.LOGIN, listener)\r\n    sfs.addEventListener(SFSEvent.LOGIN_ERROR, listener)\r\n    sfs.addEventListener(SFSEvent.EXTENSION_RESPONSE, listener)\r\n\r\n    \/\/ Start connection\r\n    sfs.connect(cfg)\r\n}\r\n<\/pre>\n
As seen in our previous chapter in Kotlin we’re free to write functions outside of classes, so our main()<\/strong> method doesn’t require any class definitions around it. Here we define our connection parameters an register the events we’re going to listen to.<\/p>\n
Also notice the usage of the setClientDetails()<\/strong> method to identify the client’s technology. This is an optional step that can be useful to distinguish between different client technologies in our server logs and usage statistics, for example using the Analytics module<\/a>.<\/p>\n
Sending and receiving extension messages is no different from the Java counterpart. All we need to do is wrapping the request (or response) parameters in an SFSObject and send them to the other side. In this case we’re sending two integers (called “n1” and “n2) and we’re expecting an integer (called “res”) in the server response.<\/p>\n
\u00bb Conclusions<\/h2>\n
We have found Kotlin a solid alternative to Java development for both client and server sides. It’s relatively easy to get started with and it’s definitely less strict and verbose than Java. Paired with its functional style, modern approach to OOP and interoperability with Java, it is a great tool for developing with SmartFoxServer and building multiplayer apps and games.<\/p>\n","protected":false},"excerpt":{"rendered":"
This is the third and final chapter of our explorations with Kotlin and SmartFoxServer 2X. After building the first Kotlin extension in part one and creating a basic client app in part two we’re now completing the picture with a client\/server example.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"_links":{"self":[{"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/posts\/736"}],"collection":[{"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/comments?post=736"}],"version-history":[{"count":13,"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/posts\/736\/revisions"}],"predecessor-version":[{"id":753,"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/posts\/736\/revisions\/753"}],"wp:attachment":[{"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/media?parent=736"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/categories?post=736"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/smartfoxserver.com\/blog\/wp-json\/wp\/v2\/tags?post=736"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}