资讯专栏INFORMATION COLUMN

使用kotlin开发最新版的spring boot应用 | SpringBoot实践

mj / 3162人阅读

摘要:官方定义项目介绍长期目标是使用开发一个完整的应用,目前搭建了最小量的脚手架。测试程序和都提供了强大的测试套件,能够很好的和集成,进行集成测试和单元测试。编写一些基本的集成测试,检查接口是否正常。

kotlin是由IntelliJ IDEA的开发商Jetbrain推出的一种基于JVM的开发语言,目标是简化Java中很多繁琐的设计,可以和Java无缝的集成,之前一直在单元测试的时候试着使用,最近正好由契机,试着用来写一下Spring Boot脚手架。

官方定义: Statically typed programming language for the JVM, Android and the browser

项目介绍

长期目标是使用kotlin开发一个完整的spring boot应用,目前搭建了最小量的脚手架。

在本次实践中增加了gradle docker插件的使用,使用gradle一站式的完成从开发、测试、打包到发布docker镜像的整个过程。

项目结构

SpringBootKotlon
│
├─── build.gradle
└─── src
     ├───main
     │   ├─── docker
     │   ├─── java
     │   ├─── kotlin
     │   └─── resources
     │        └─── config/application.properties
     └───test
          ├─── java
          ├─── kotlin
          └─── resources

在main目录的java、kotlin、resources下面,包名是一样的。也就是说在kotlin/com/app和java/com/app下的类,在classpath引用的时候是同一个包。

创建Spring Boot项目

Spring Boot项目的创建,可以参考《用Gradle和SpringBoot实现简单的RESTful框架应用》。

为了支持kotlin本项目的build.gradle中需要增加kotlin的支持,并且配置docker插件。

buildscript {
    ext.kotlin_version = "1.1.0"
    ext.spting_boot_version = "1.5.2.RELEASE"

    ... ...

    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath("org.springframework.boot:spring-boot-gradle-plugin:$spting_boot_version")
    }
}

... ...
apply plugin: "kotlin"
apply plugin: "org.springframework.boot"

dependencies {
    ... ...

    compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
    compile "org.jetbrains.kotlin:kotlin-reflect:$kotlin_version"

    testCompile "org.jetbrains.kotlin:kotlin-test:$kotlin_version"
    testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"
}

sourceSets{
    main{
        ... ...
        kotlin {srcDir "src/main/kotlin"}
    }
    test{
        ... ...
        kotlin {srcDir "src/test/kotlin"}
    }
}

配置完之后,运行gradle idea,下载相应的gradle依赖包。在repositories中使用国内镜像和自建的本地nexus,可以加快依赖包的下载速度maven{ url "http://maven.aliyun.com/nexus/content/groups/public/"}

配置sourceSets增加kotlin的包之后,可以自己创建一个gradle task,自动创建sourceSets对应的目录;gradle createJavaProject会根据sourceSets中配置的路径,创建指定set对应的目录。

task createJavaProject << {
    sourceSets*.java.srcDirs*.each { it.mkdirs() }
    sourceSets*.kotlin.srcDirs*.each { it.mkdirs() }
    sourceSets*.resources.srcDirs*.each { it.mkdirs()}
}
运行spring boot程序

项目的application入口类,使用kotlin语言实现,在kotlin中是没有静态方法的,所以如果要实现main函数,有两种方法,一种是将main函数写在class的外面;或者使用companion object {},将需要静态调用的方法写在{}中。

@SpringBootApplication
open class SpringBootKotlinApplication

fun main(args: Array){
    SpringApplication.run(SpringBootKotlinApplication::class.java,*args)
}

相比spring mvc,spring boot给人最大的感触就是,用简单的注解和application.properties配置的方式,避免了spring mvc中繁琐而且容易出错的xml配置文件,极大的简化了spring boot的配置。值得一提的是,application配置文件,也可以使用yaml文件。

application配置文件说明
端口

通过在配置文件中设置server.port属性,可以指定spring boot运行时绑定的端口。

freemarker

spring.freemarker.* 是spring boot提供的freemarker相关配置,可以配置的属性,和注解或者xml文件是一样的,要使用spring.freemarker配置,需要在gradle中,引入org.springframework.boot:spring-boot-starter-freemarker这个包。

此外,spring boot的application配置文件,还可以配置包括数据库在内的各种常见第三方工具或者库,应该是将提供了一系列starter包,将注解和配置过程包装起来了。

配置完成之后,就可以在Application类的子目录中编写Spring MVC的控制器代码。

编写restful controller

一个最基本的RestController代码如下:

@RestController
@RequestMapping(value = "/api/data")
class DataController {

    @RequestMapping(value = "",method = arrayOf(RequestMethod.GET,RequestMethod.PUT))
    fun index():Map{
        val resultMap = HashMap()

        resultMap["status"] = true
        resultMap["msg"] = "success"
        return resultMap
    }

    @RequestMapping(value = "show",method = arrayOf(RequestMethod.PUT),consumes = arrayOf(MediaType.APPLICATION_JSON_UTF8_VALUE))
    fun test(@RequestBody reqMap:Map):Map{
        return reqMap
    }
}

代码解读:

kotlin中使用arrayof来初始化数组;

对于不指定类型或者Obejct型的变量,kotlin使用Any类型

method方法中可以指定对种请求头,很灵活

在consumes中,可以指定接受的contentType为JSON格式

如果请求是json格式,用ResponseBody就可以接收JSON对象

完成所有代码之后,运行gradle bootRun就可以启动服务。

curl "http://localhost:8080/api/data/show"  
    -X "PUT"  
    -H "content-type: application/json"  
    -H "accept: application/json"  
    --data-binary "{"data":"hello","who":"echo"}" --compressed
测试spring boot程序

spring boot和kotlin都提供了强大的测试套件,能够很好的和JUnit集成,进行集成测试和单元测试。编写一些基本的集成测试,检查接口是否正常。

spring boot starter test集成了JUnit 、Mockito、AssertJ 、Hamcrest 、Spring Test & Spring Boot Test可以方便的开始测试

@RunWith(SpringJUnit4ClassRunner::class)
@WebMvcTest(HomeController::class)
class HomeControllerStandaloneTest {

    @Autowired
    private var mvc: MockMvc? = null

    @Test
    @Throws(Exception::class)
    fun indexTest() {
        mvc!!.perform(MockMvcRequestBuilders.get("/").accept(MediaType.TEXT_HTML))
                .andExpect(status().isOk)
                .andExpect(model().attributeExists("data"))
                .andExpect { content().string(containsString("Spring Boot Kotlin")) }
    }
}

MockMvc可以依赖注入绑定通过WebMvcTest注解的HomeController控制器,然后针对指定的controller模拟请求。andExpect方法,检查response的header,body是否符合测试的期望。

源代码:https://github.com/liuwill-projects/SpringBootKotlin

文/liuwill(简书作者)
原文链接:使用kotlin开发最新版的spring boot应用 | SpringBoot实践
著作权归作者所有,转载请联系作者获得授权,并标注“简书作者”。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/66836.html

相关文章

  • 初探Kotlin+SpringBoot联合编程

    摘要:是一门最近比较流行的静态类型编程语言,而且和一样同属系。这个生成的构造函数是合成的,因此不能从或中直接调用,但可以使用反射调用。 showImg(https://segmentfault.com/img/remote/1460000012958496); Kotlin是一门最近比较流行的静态类型编程语言,而且和Groovy、Scala一样同属Java系。Kotlin具有的很多静态语言...

    xiaokai 评论0 收藏0
  • Kotlin + Spring Boot : 下一代 Java 服务端开发

    摘要:下一代服务端开发下一代服务端开发第部门快速开始第章快速开始环境准备,,快速上手实现一个第章企业级服务开发从到语言的缺点发展历程的缺点为什么是产生的背景解决了哪些问题为什么是的发展历程容器的配置地狱是什么从到下一代企业级服务开发在移动开发领域 《 Kotlin + Spring Boot : 下一代 Java 服务端开发 》 Kotlin + Spring Boot : 下一代 Java...

    springDevBird 评论0 收藏0
  • SpringBoot热部署加持

    摘要:概述进行的开发过程中,我们很多时候经常需要重启服务器才能保证修改的源代码文件或者一些诸如的配置文件以及一些静态文件生效,这样耗时又低效。 showImg(https://segmentfault.com/img/remote/1460000015363888); 概述 进行SpringBoot的Web开发过程中,我们很多时候经常需要重启Web服务器才能保证修改的 源代码文件、或者一些...

    ixlei 评论0 收藏0
  • SpringBoot应用Docker化

    摘要:微服务的基本思想在于考虑围绕着业务领域组件来创建应用,这些应用可独立地进行开发管理和加速。在分散的组件中使用微服务云架构和平台,使部署管理和服务功能交付变得更加简单。 showImg(https://segmentfault.com/img/remote/1460000014332184); 概述 当下web服务端开发中最火的名词中绝对有微服务的一席之地,其也成为当下互联网后端服务架...

    U2FsdGVkX1x 评论0 收藏0
  • Spring Boot Admin 2.0开箱体验

    摘要:概述在我之前的应用监控实战一文中,讲述了如何利用版本来可视化地监控应用。接下来我们就来创建一个待监控的示例。 showImg(https://segmentfault.com/img/remote/1460000015671446); 概述 在我之前的 《Spring Boot应用监控实战》 一文中,讲述了如何利用 Spring Boot Admin 1.5.X 版本来可视化地监控 ...

    CastlePeaK 评论0 收藏0

发表评论

0条评论

mj

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<