Spring太复杂了,配置这个东西简直就是浪费生命。尤其在没有什么并发压力,随便搞一个RESTful服务让整个业务跑起来先的情况下,更是么有必要纠结在一堆的XML配置上。显然这么想的人是很多的,于是就有了Spring Boot。又由于Java 8太墨迹于是有了Kotlin。
数据源使用MySql, ORM使用MyBatis
。通过Spring Boot这个基本不怎么配置的不怎么微的微服务来开发一个Web App。
处理依赖
这里使用Maven来处理依赖。打开来创建一个初始的项目。你可以选择Maven、Gradle,编程语言为Kotlin(其他还可以选择Java和Groovy)。最后选择Spring boot的版本,这里选择1.5.6.
选择完成后,点击Generate Project就会生成一个项目。打开项目,我用的是Intellij Idea。为了可以使用MySql数据库,和MyBatic我们需要在项目中添加相关的依赖:
mysql mysql-connector-java runtime org.mybatis.spring.boot mybatis-spring-boot-starter 1.3.1
其中包括mysq connector和mybatis spring boot starter两个库。
使用命令:mvn clean install -DskipTests
来安装相关的依赖。这会花一点时间。你可以去和妹子聊一会儿了。。 例子的目录是这样的:
└── src └── main └── kotlin └── com.example.demo
但是无论是用上面的哪种方式,最后都需要在Maven文件中添加依赖项。添加完依赖项之后是这样的:
4.0.0 com.example demo 0.0.1-SNAPSHOT jar demo Demo project for Spring Boot org.springframework.boot spring-boot-starter-parent 1.5.6.RELEASE true UTF-8 UTF-8 1.8 1.1.4-3 org.springframework.boot spring-boot-starter org.springframework.boot spring-boot-starter-web org.jetbrains.kotlin kotlin-stdlib-jre8 ${kotlin.version} org.jetbrains.kotlin kotlin-reflect ${kotlin.version} mysql mysql-connector-java runtime org.mybatis.spring.boot mybatis-spring-boot-starter 1.3.1 org.springframework.boot spring-boot-starter-test test ${project.basedir}/src/main/kotlin ${project.basedir}/src/test/kotlin org.springframework.boot spring-boot-maven-plugin kotlin-maven-plugin org.jetbrains.kotlin ${kotlin.version} spring 1.8 compile compile compile test-compile test-compile test-compile org.jetbrains.kotlin kotlin-maven-allopen ${kotlin.version}
配置文件
在目录src/main/resources/application.yml
下编辑配置文件。默认是没有这个文件和相应的目录的,自行创建。
server: context-path: /api port: 9091spring: datasource: url: jdbc:mysql://127.0.0.1:3306/petshop username: root password: 123456 driverClassName: com.mysql.jdbc.Driver
无需java的配置类,或者什么XML配置文件。
创建一个简单地实体类
这里定义一个简单地实体类,并声明为JPA实体。这个类的文件存放在目录src\main\java\hello\Entities\
下。
package com.example.demodata class UserInfo(val userId: Long, var username: String?, var password: String? , var deleted: Int = 0)
这里使用了Kotlin里的data class。data class最大的优点就是省去了定义getter和setter,以及toString()
的时间。这些都已经默认实现。所以,在使用data class的对象的时候直接可以使用username
、password
当然还有userId
这样的属性直接访问。
创建简单地查询,或者说Dao类
这个就更加的简单了。
根据UserInfo
类,我们来实现一个UserMapper
(Dao):
package com.example.demoimport org.apache.ibatis.annotations.Insertimport org.apache.ibatis.annotations.Mapperimport org.apache.ibatis.annotations.Selectimport com.example.demo.UserInfo@Mapperinterface UserMapper { @Select("""""") fun queryUserList(userInfo: UserInfo): List@Insert(""" insert into user (USER_NAME, PASSWORD, DELETED) values (#{username}, #{password}, #{deleted}) """) fun insertUser(userInfo: UserInfo): Int}
泛型的类型参数分别是user和user的id的类型:User
, Long
。我们可以定义增删改查之外的Query。比如在上面的代码里我们定义了一个queryUserList()
方法。
我们这里是用了简单的注解方式在代码中加入SQL语句。你也可以使用mybatis的mapper资源文件来实现一样的功能。对于比较复杂的数据库操作,xml的mapper资源文件更加适合。
创建Service和对应的实现
我们尽量保证我们的代码贴近实际。在生产环境下写代码,为了保证代码有足够的可以应对需求的扩展的能力,那么一定会有一个接口和对应的实现。
Service接口
package com.example.demointerface IUserService{ fun queryUserList(userInfo: UserInfo): Listfun insertUser(userInfo: UserInfo): Int}
Service接口以“I"字母开头:IUserService
。里面包含两个方法,一个用来查询一个用来插入用户数据。
Service接口的实现
package com.example.demoimport org.springframework.beans.factory.annotation.Autowiredimport org.springframework.stereotype.Service@Serviceclass UserServiceImpl : IUserService { @Autowired lateinit var userMapper: UserMapper override fun queryUserList(userInfo: UserInfo): List{ return userMapper.queryUserList(userInfo); } override fun insertUser(userInfo: UserInfo): Int { return userMapper.insertUser(userInfo); }}
在Service的实现UserServiceImpl
里,我们使用Spring boot的依赖注入注解@Autowired
来注入mapper方法。然后使用mapper的方法来实际操作数据库。
这里尤其需要注意的是,在类的上面加入的@Service
注解。如果没有这个注解的话controller里是找不到这个bean的。
对应于Kotlin语言的特性中类和方法默认都是final的,如果要让Kotlin写的SpringBoot正常工作,就不得不在每一个相关的类上加入open
关键字。这样太麻烦了不是吗?于是就有了各种对应的插件。也就是上面贴出来的pom.xml文件里显示的。
用Controller测试一下
数据库,Rest服务和书库的连接都已经搞定。那么,我们就来测试一下。
我们在目录src\main\kotlin\com\example\demo\Controllers
创建一个UserController
类来测试和数据库的数据存取。
package com.example.demoimport org.springframework.beans.factory.annotation.Autowiredimport org.springframework.web.bind.annotation.GetMappingimport org.springframework.web.bind.annotation.PathVariableimport org.springframework.web.bind.annotation.RestController@RestControllerclass UserController { @Autowired lateinit var userService: IUserService @GetMapping("/user/{userId}/id") fun queryUserById(@PathVariable userId: String): List{ var userInfo = UserInfo(userId = userId.toLong(), username = null, password = null) var userList = userService.queryUserList(userInfo) return userList }}
测试URL可以是这样的:
:9091/api/user/1/id,这时会返回一个用userId
得到的用户列表,当然这里列表里就有一个UserInfo
对象。 代码在
参考文章: