在第2章節(jié)中创千,我們介紹了如何通過Spring Boot來實(shí)現(xiàn)HTTP接口蔑舞,以及圍繞HTTP接口相關(guān)的單元測(cè)試、文檔生成等實(shí)用技能殷费。但是印荔,這些內(nèi)容還不足以幫助我們構(gòu)建一個(gè)動(dòng)態(tài)應(yīng)用的服務(wù)端程序。不論我們是要做App详羡、小程序仍律、還是傳統(tǒng)的Web站點(diǎn),對(duì)于用戶的信息实柠、相關(guān)業(yè)務(wù)的內(nèi)容水泉,通常都需要對(duì)其進(jìn)行存儲(chǔ),而不是像第2章節(jié)中那樣窒盐,把用戶信息存儲(chǔ)在內(nèi)存中(重啟就丟了2菰颉)。
對(duì)于信息的存儲(chǔ)蟹漓,現(xiàn)在已經(jīng)有非常非常多的產(chǎn)品可以選擇炕横,其中不乏許多非常優(yōu)秀的開源免費(fèi)產(chǎn)品,比如:MySQL葡粒,Redis等份殿。接下來膜钓,在第3章節(jié),我們將繼續(xù)學(xué)習(xí)在使用Spring Boot開發(fā)服務(wù)端程序的時(shí)候卿嘲,如何實(shí)現(xiàn)對(duì)各流行數(shù)據(jù)存儲(chǔ)產(chǎn)品的增刪改查操作颂斜。
作為數(shù)據(jù)訪問章節(jié)的第一篇,我們將從最為常用的關(guān)系型數(shù)據(jù)庫(kù)開始拾枣。通過一個(gè)簡(jiǎn)單例子沃疮,學(xué)習(xí)在Spring Boot中最基本的數(shù)據(jù)訪問工具:JdbcTemplate。
數(shù)據(jù)源配置
在我們?cè)L問數(shù)據(jù)庫(kù)的時(shí)候梅肤,需要先配置一個(gè)數(shù)據(jù)源忿磅,下面分別介紹一下幾種不同的數(shù)據(jù)庫(kù)配置方式。
首先凭语,為了連接數(shù)據(jù)庫(kù)需要引入jdbc支持葱她,在pom.xml
中引入如下配置:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
嵌入式數(shù)據(jù)庫(kù)支持
嵌入式數(shù)據(jù)庫(kù)通常用于開發(fā)和測(cè)試環(huán)境,不推薦用于生產(chǎn)環(huán)境似扔。Spring Boot提供自動(dòng)配置的嵌入式數(shù)據(jù)庫(kù)有H2吨些、HSQL、Derby炒辉,你不需要提供任何連接配置就能使用豪墅。
比如,我們可以在pom.xml
中引入如下配置使用HSQL
<dependency>
<groupId>org.hsqldb</groupId>
<artifactId>hsqldb</artifactId>
<scope>runtime</scope>
</dependency>
連接生產(chǎn)數(shù)據(jù)源
以MySQL數(shù)據(jù)庫(kù)為例黔寇,先引入MySQL連接的依賴包偶器,在pom.xml
中加入:
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.46</version>
</dependency>
在src/main/resources/application.properties
中配置數(shù)據(jù)源信息
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=dbuser
spring.datasource.password=dbpass
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
連接JNDI數(shù)據(jù)源
當(dāng)你將應(yīng)用部署于應(yīng)用服務(wù)器上的時(shí)候想讓數(shù)據(jù)源由應(yīng)用服務(wù)器管理,那么可以使用如下配置方式引入JNDI數(shù)據(jù)源缝裤。
spring.datasource.jndi-name=java:jboss/datasources/customers
使用JdbcTemplate操作數(shù)據(jù)庫(kù)
Spring的JdbcTemplate是自動(dòng)配置的屏轰,你可以直接使用@Autowired
或構(gòu)造函數(shù)(推薦)來注入到你自己的bean中來使用。
下面就來一起完成一個(gè)增刪改查的例子:
準(zhǔn)備數(shù)據(jù)庫(kù)
先創(chuàng)建User
表憋飞,包含屬性name
霎苗、age
¢蛔觯可以通過執(zhí)行下面的建表語句::
CREATE TABLE `User` (
`name` varchar(100) COLLATE utf8mb4_general_ci NOT NULL,
`age` int NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci
編寫領(lǐng)域?qū)ο?/h4>
根據(jù)數(shù)據(jù)庫(kù)中創(chuàng)建的User
表唁盏,創(chuàng)建領(lǐng)域?qū)ο螅?/p>
@Data
@NoArgsConstructor
public class User {
private String name;
private Integer age;
}
這里使用了Lombok的@Data
和@NoArgsConstructor
注解來自動(dòng)生成各參數(shù)的Set、Get函數(shù)以及不帶參數(shù)的構(gòu)造函數(shù)检眯。如果您對(duì)Lombok還不了解厘擂,可以看看這篇文章:Java開發(fā)神器Lombok的使用與原理。
編寫數(shù)據(jù)訪問對(duì)象
- 定義包含有插入锰瘸、刪除刽严、查詢的抽象接口UserService
public interface UserService {
/**
* 新增一個(gè)用戶
*
* @param name
* @param age
*/
int create(String name, Integer age);
/**
* 根據(jù)name查詢用戶
*
* @param name
* @return
*/
List<User> getByName(String name);
/**
* 根據(jù)name刪除用戶
*
* @param name
*/
int deleteByName(String name);
/**
* 獲取用戶總量
*/
int getAllUsers();
/**
* 刪除所有用戶
*/
int deleteAllUsers();
}
- 通過
JdbcTemplate
實(shí)現(xiàn)UserService
中定義的數(shù)據(jù)訪問操作
@Service
public class UserServiceImpl implements UserService {
private JdbcTemplate jdbcTemplate;
UserServiceImpl(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
@Override
public int create(String name, Integer age) {
return jdbcTemplate.update("insert into USER(NAME, AGE) values(?, ?)", name, age);
}
@Override
public List<User> getByName(String name) {
List<User> users = jdbcTemplate.query("select NAME, AGE from USER where NAME = ?", (resultSet, i) -> {
User user = new User();
user.setName(resultSet.getString("NAME"));
user.setAge(resultSet.getInt("AGE"));
return user;
}, name);
return users;
}
@Override
public int deleteByName(String name) {
return jdbcTemplate.update("delete from USER where NAME = ?", name);
}
@Override
public int getAllUsers() {
return jdbcTemplate.queryForObject("select count(1) from USER", Integer.class);
}
@Override
public int deleteAllUsers() {
return jdbcTemplate.update("delete from USER");
}
}
編寫單元測(cè)試用例
- 創(chuàng)建對(duì)UserService的單元測(cè)試用例,通過創(chuàng)建获茬、刪除和查詢來驗(yàn)證數(shù)據(jù)庫(kù)操作的正確性港庄。
@RunWith(SpringRunner.class)
@SpringBootTest
public class Chapter31ApplicationTests {
@Autowired
private UserService userSerivce;
@Before
public void setUp() {
// 準(zhǔn)備,清空user表
userSerivce.deleteAllUsers();
}
@Test
public void test() throws Exception {
// 插入5個(gè)用戶
userSerivce.create("Tom", 10);
userSerivce.create("Mike", 11);
userSerivce.create("Didispace", 30);
userSerivce.create("Oscar", 21);
userSerivce.create("Linda", 17);
// 查詢名為Oscar的用戶恕曲,判斷年齡是否匹配
List<User> userList = userSerivce.getByName("Oscar");
Assert.assertEquals(21, userList.get(0).getAge().intValue());
// 查數(shù)據(jù)庫(kù)鹏氧,應(yīng)該有5個(gè)用戶
Assert.assertEquals(5, userSerivce.getAllUsers());
// 刪除兩個(gè)用戶
userSerivce.deleteByName("Tom");
userSerivce.deleteByName("Mike");
// 查數(shù)據(jù)庫(kù),應(yīng)該有5個(gè)用戶
Assert.assertEquals(3, userSerivce.getAllUsers());
}
}
上面介紹的JdbcTemplate
只是最基本的幾個(gè)操作佩谣,更多其他數(shù)據(jù)訪問操作的使用請(qǐng)參考:JdbcTemplate API
通過上面這個(gè)簡(jiǎn)單的例子把还,我們可以看到在Spring Boot下訪問數(shù)據(jù)庫(kù)的配置依然秉承了框架的初衷:簡(jiǎn)單。我們只需要在pom.xml中加入數(shù)據(jù)庫(kù)依賴茸俭,再到application.properties中配置連接信息吊履,不需要像Spring應(yīng)用中創(chuàng)建JdbcTemplate的Bean,就可以直接在自己的對(duì)象中注入使用调鬓。
代碼示例
本文的相關(guān)例子可以查看下面?zhèn)}庫(kù)中的chapter3-1
目錄:
- Github:https://github.com/dyc87112/SpringBoot-Learning/
- Gitee:https://gitee.com/didispace/SpringBoot-Learning/
如果您覺得本文不錯(cuò)艇炎,歡迎Star
支持,您的關(guān)注是我堅(jiān)持的動(dòng)力腾窝!
歡迎關(guān)注我的公眾號(hào):程序猿DD缀踪,獲得獨(dú)家整理的學(xué)習(xí)資源和日常干貨推送。
如果您對(duì)我的專題內(nèi)容感興趣虹脯,也可以關(guān)注我的博客:didispace.com