Spring太復(fù)雜了鲫懒,配置這個東西簡直就是浪費(fèi)生命嫩实。尤其在沒有什么并發(fā)壓力,隨便搞一個RESTful服務(wù)讓整個業(yè)務(wù)跑起來先的情況下窥岩,更是么有必要糾結(jié)在一堆的XML配置上甲献。顯然這么想的人是很多的,于是就有了Spring Boot颂翼。又由于Java 8太墨跡于是有了Kotlin竟纳。
數(shù)據(jù)源使用MySql, ORM使用MyBatis
。通過Spring Boot這個基本不怎么配置的不怎么微的微服務(wù)來開發(fā)一個Web App疚鲤。
處理依賴
這里使用Maven來處理依賴锥累。打開spring boot initializer來創(chuàng)建一個初始的項目。你可以選擇Maven集歇、Gradle桶略,編程語言為Kotlin(其他還可以選擇Java和Groovy)。最后選擇Spring boot的版本诲宇,這里選擇1.5.6.
選擇完成后际歼,點(diǎn)擊Generate Project就會生成一個項目蒲列。
打開項目雄妥,我用的是Intellij Idea撵割。為了可以使用MySql數(shù)據(jù)庫柳沙,和MyBatic我們需要在項目中添加相關(guān)的依賴:
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.3.1</version>
</dependency>
其中包括mysq connector和mybatis spring boot starter兩個庫。
使用命令:mvn clean install -DskipTests
來安裝相關(guān)的依賴晴埂。這會花一點(diǎn)時間辽狈。你可以去和妹子聊一會兒了置逻。宙暇。
例子的目錄是這樣的:
└── src
└── main
└── kotlin
└── com.example.demo
但是無論是用上面的哪種方式输枯,最后都需要在Maven文件中添加依賴項。添加完依賴項之后是這樣的:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>demo</name>
<description>Demo project for Spring Boot</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.6.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<kotlin.compiler.incremental>true</kotlin.compiler.incremental>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
<kotlin.version>1.1.4-3</kotlin.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-stdlib-jre8</artifactId>
<version>${kotlin.version}</version>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-reflect</artifactId>
<version>${kotlin.version}</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.3.1</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<sourceDirectory>${project.basedir}/src/main/kotlin</sourceDirectory>
<testSourceDirectory>${project.basedir}/src/test/kotlin</testSourceDirectory>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<plugin>
<artifactId>kotlin-maven-plugin</artifactId>
<groupId>org.jetbrains.kotlin</groupId>
<version>${kotlin.version}</version>
<configuration>
<compilerPlugins>
<plugin>spring</plugin>
</compilerPlugins>
<jvmTarget>1.8</jvmTarget>
</configuration>
<executions>
<execution>
<id>compile</id>
<phase>compile</phase>
<goals>
<goal>compile</goal>
</goals>
</execution>
<execution>
<id>test-compile</id>
<phase>test-compile</phase>
<goals>
<goal>test-compile</goal>
</goals>
</execution>
</executions>
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-maven-allopen</artifactId>
<version>${kotlin.version}</version>
</dependency>
</dependencies>
</plugin>
</plugins>
</build>
</project>
配置文件
在目錄src/main/resources/application.yml
下編輯配置文件占贫。默認(rèn)是沒有這個文件和相應(yīng)的目錄的桃熄,自行創(chuàng)建。
server:
context-path: /api
port: 9091
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/petshop
username: root
password: 123456
driverClassName: com.mysql.jdbc.Driver
無需java的配置類型奥,或者什么XML配置文件瞳收。
創(chuàng)建一個簡單地實(shí)體類
這里定義一個簡單地實(shí)體類碉京,并聲明為JPA實(shí)體。這個類的文件存放在目錄src\main\java\hello\Entities\
下螟深。
package com.example.demo
data class UserInfo(val userId: Long, var username: String?, var password: String?
, var deleted: Int = 0)
這里使用了Kotlin里的data class谐宙。data class最大的優(yōu)點(diǎn)就是省去了定義getter和setter,以及toString()
的時間血崭。這些都已經(jīng)默認(rèn)實(shí)現(xiàn)。所以厘灼,在使用data class的對象的時候直接可以使用username
夹纫、password
當(dāng)然還有userId
這樣的屬性直接訪問。
創(chuàng)建簡單地查詢设凹,或者說Dao類
這個就更加的簡單了舰讹。
根據(jù)UserInfo
類,我們來實(shí)現(xiàn)一個UserMapper
(Dao):
package com.example.demo
import org.apache.ibatis.annotations.Insert
import org.apache.ibatis.annotations.Mapper
import org.apache.ibatis.annotations.Select
import com.example.demo.UserInfo
@Mapper
interface UserMapper {
@Select("""<script>
select USER_ID, USER_NAME, PASSWORD, DELETED from user where 1=1
<if test='username != null'>AND USER_NAME like #{username}%</if>
<if test='userId != null'> AND USER_ID = #{userId}</if>
<if test='deleted != null'> AND DELETED = #{deleted}</if>
</script>""")
fun queryUserList(userInfo: UserInfo): List<UserInfo>
@Insert("""
insert into user (USER_NAME, PASSWORD, DELETED)
values (#{username}, #{password}, #{deleted})
""")
fun insertUser(userInfo: UserInfo): Int
}
泛型的類型參數(shù)分別是user和user的id的類型:User
, Long
闪朱。我們可以定義增刪改查之外的Query月匣。比如在上面的代碼里我們定義了一個queryUserList()
方法。
我們這里是用了簡單的注解方式在代碼中加入SQL語句奋姿。你也可以使用mybatis的mapper資源文件來實(shí)現(xiàn)一樣的功能锄开。對于比較復(fù)雜的數(shù)據(jù)庫操作,xml的mapper資源文件更加適合称诗。
創(chuàng)建Service和對應(yīng)的實(shí)現(xiàn)
我們盡量保證我們的代碼貼近實(shí)際萍悴。在生產(chǎn)環(huán)境下寫代碼,為了保證代碼有足夠的可以應(yīng)對需求的擴(kuò)展的能力寓免,那么一定會有一個接口和對應(yīng)的實(shí)現(xiàn)癣诱。
Service接口
package com.example.demo
interface IUserService{
fun queryUserList(userInfo: UserInfo): List<UserInfo>
fun insertUser(userInfo: UserInfo): Int
}
Service接口以“I"字母開頭:IUserService
。里面包含兩個方法袜香,一個用來查詢一個用來插入用戶數(shù)據(jù)撕予。
Service接口的實(shí)現(xiàn)
package com.example.demo
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.stereotype.Service
@Service
class UserServiceImpl : IUserService {
@Autowired
lateinit var userMapper: UserMapper
override fun queryUserList(userInfo: UserInfo): List<UserInfo> {
return userMapper.queryUserList(userInfo);
}
override fun insertUser(userInfo: UserInfo): Int {
return userMapper.insertUser(userInfo);
}
}
在Service的實(shí)現(xiàn)UserServiceImpl
里,我們使用Spring boot的依賴注入注解@Autowired
來注入mapper方法蜈首。然后使用mapper的方法來實(shí)際操作數(shù)據(jù)庫实抡。
這里尤其需要注意的是,在類的上面加入的@Service
注解欢策。如果沒有這個注解的話controller里是找不到這個bean的澜术。
對應(yīng)于Kotlin語言的特性中類和方法默認(rèn)都是final的,如果要讓Kotlin寫的SpringBoot正常工作猬腰,就不得不在每一個相關(guān)的類上加入open
關(guān)鍵字鸟废。這樣太麻煩了不是嗎?于是就有了各種對應(yīng)的插件姑荷。也就是上面貼出來的pom.xml文件里顯示的盒延。
用Controller測試一下
數(shù)據(jù)庫缩擂,Rest服務(wù)和書庫的連接都已經(jīng)搞定。那么添寺,我們就來測試一下胯盯。
我們在目錄src\main\kotlin\com\example\demo\Controllers
創(chuàng)建一個UserController
類來測試和數(shù)據(jù)庫的數(shù)據(jù)存取。
package com.example.demo
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.PathVariable
import org.springframework.web.bind.annotation.RestController
@RestController
class UserController {
@Autowired
lateinit var userService: IUserService
@GetMapping("/user/{userId}/id")
fun queryUserById(@PathVariable userId: String): List<UserInfo> {
var userInfo = UserInfo(userId = userId.toLong(), username = null,
password = null)
var userList = userService.queryUserList(userInfo)
return userList
}
}
測試URL可以是這樣的:
http://localhost:9091/api/user/1/id计露,這時會返回一個用userId
得到的用戶列表博脑,當(dāng)然這里列表里就有一個UserInfo
對象。
代碼在這里
參考文章:
http://blog.netgloo.com/2014/10/27/using-mysql-in-spring-boot-via-spring-data-jpa-and-hibernate/
https://spring.io/guides/gs/accessing-data-jpa/