序言
從簡入深的使用SpringBoot搭建一個Web項目,，同時也包括一些小的問題,。第一篇博文是以較為簡單的方式完成一個可以連接數(shù)據(jù)庫的Springboot web程序。之前自己學(xué)習(xí)的時候看網(wǎng)上的教程總是感覺有點太大,，我只是想最簡單的搭建一個可以運行的項目,，之后再去深究細節(jié)。每個教程的配置還都不一樣,，讓我不知所措,，所以我就寫了這篇博文來記錄自我感覺的較簡單的步驟較少的方法去搭建一個springboot web項目，不常寫文可能思路有點混亂,。
Code
創(chuàng)建項目
這里使用的IDE是IDEA,，選擇軟件左上角File -> New -> Project來創(chuàng)建一個新的項目
選擇Spring Initializr來初始化我們的SpringBoot項目，選擇JDK8之后點擊Next,，接下來的點擊Next操作就不做說明了
在如下界面我們設(shè)置包名,，項目類型選擇Maven項目,，語言選擇Java，打包方式選擇Jar,，Java版本選擇8
依賴這部分,，我們分別選擇Web下的Spring Web，Template Engines下的Thymeleaf(為以后挖坑),，SQL下的MyBatis Framework,，當(dāng)然這里也可以創(chuàng)建項目之后手動在POM文件中寫入，不過這樣更方便一些,。
接下來選擇項目的存放路徑，即可完成項目的創(chuàng)建,，創(chuàng)建完成項目打開項目之后IDEA右下角會彈出Maven projects need to be imported彈窗,，選擇Enable Auto-Import即可，這樣Maven就可以自己下載依賴,。
目錄結(jié)構(gòu)
我們打開新建的項目之后大致如下圖所示,。.idea文件夾下存放的是IDEA項目的配置文件，比如compiler.xml 配置了JDK版本,，encodings.xml 配置了編碼類型,，該文件夾我們不需要過多了解。.mvn文件夾下存放的是Maven的配置和相關(guān)Jar包,。src文件夾是我們主要編碼的地方,，src.main.java路徑下是我們編寫java代碼的地方，src.main.resources是我們存放靜態(tài)資源,，頁面以及配置文件的地方,。test文件夾是我們編寫測試代碼的地方。.gitignore文件配置了我們使用git時忽略上傳的文件,。HELP.md是一個幫助文檔,。mvnw是一個linux腳本文件，可以使我們運行指定版本的Maven,，mvnw.cmd則是相同功能的windows版本腳本文件,，pom.xml是Maven項目的依賴配置文件。t1.iml是 intellij idea的工程配置文件,，里面是當(dāng)前t1 project的一些配置信息,。
我們主要關(guān)注的還是src文件夾下的文件，其余不重要的文件可以隱藏,，選中t1 項目,，然后點擊這個文件夾右下角帶三個小藍色方塊的圖標
選擇要隱藏的文件右鍵選擇Excluded 然后這些文件夾就會變成橙黃色
點擊Apply回到原來的頁面點擊圖片中右上角的小齒輪，點擊取消Show Excluded Files,，這樣想要隱藏的文件就消失了
測試啟動
首先我們先來測試一下SpringBoot框架是否能夠啟動,，創(chuàng)建TestController文件,，目錄結(jié)構(gòu)如下
該類的代碼如下
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController // 標注該類為Controller，SpringBoot會自動掃描該類
public class TestController {
@RequestMapping("/test") // 處理請求路徑為/test的請求
public String test(){
return "測試成功";
}
}
注：自己敲代碼的時候會自動導(dǎo)包,，如果是復(fù)制上去的話可能不會自動導(dǎo),，需要手動處理。
接下來點擊下圖左側(cè)主啟動類的小箭頭或者右上角的箭頭都可以啟動項目
然后觀察控制臺的輸出,，很自然的沒有運行成功,，出錯了，我們看一下錯誤提示
APPLICATION FAILED TO START
Description:
Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.
Reason: Failed to determine a suitable driver class
大體意思就是沒有配置數(shù)據(jù)庫驅(qū)動,，我們也沒用到數(shù)據(jù)庫?。繛樯兑渲脭?shù)據(jù)庫驅(qū)動呢,？還記得我們之前選擇依賴的時候選擇了mybatis嗎,，原因就出在這里，找到pom.xml文件注釋掉mybatis依賴,，重啟項目,。
<!-- <dependency>-->
<!-- <groupId>org.mybatis.spring.boot</groupId>-->
<!-- <artifactId>mybatis-spring-boot-starter</artifactId>-->
<!-- <version>2.1.3</version>-->
<!-- </dependency>-->
項目成功啟動控制臺輸出如下
我們可以看到程序啟動在8080端口，在瀏覽器中輸入請求地址即可看到我們想要得到的測試成功字符串
我們百度可以了解到mybatis是一個Java持久層框架,，JDBC才是連接數(shù)據(jù)庫用到的驅(qū)動,，那為什么我們引入mybatis需要配置數(shù)據(jù)庫驅(qū)動呢？
我們從上面這張圖片可以看到mybatis-spring-boot-starter依賴包含了jdbc依賴,，所以引入了mybatis就相當(dāng)于引入了jdbc,，再加上SpringBoot的自動配置是根據(jù)是否引入類來進行自動配置的，自然的,，引入了jdbc依賴就需要配置數(shù)據(jù)庫驅(qū)動程序(選擇數(shù)據(jù)庫驅(qū)動自然是沒法自動配置的),，從如下的報錯也可以得出同樣結(jié)論。
Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'dataSource' defined in class path resource [org/springframework/boot/autoconfigure/jdbc/DataSourceConfiguration$Hikari.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [com.zaxxer.hikari.HikariDataSource]: Factory method 'dataSource' threw exception; nested exception is org.springframework.boot.autoconfigure.jdbc.DataSourceProperties$DataSourceBeanCreationException: Failed to determine a suitable driver class
連接數(shù)據(jù)庫
我們使用mysql數(shù)據(jù)庫,，首先創(chuàng)建一個數(shù)據(jù)庫,，我起的名字叫t1并創(chuàng)建了一張表Bear
表內(nèi)字段如下
然后隨便添加點數(shù)據(jù)，這樣我們數(shù)據(jù)庫就準備好了,。
再次回到代碼這邊,，首先我們是要配置數(shù)據(jù)庫的連接信息，在application.properties里做如下配置
# 數(shù)據(jù)庫設(shè)置
## 數(shù)據(jù)庫驅(qū)動
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
# 數(shù)據(jù)庫連接地址
spring.datasource.url=jdbc:mysql://localhost:3306/t1
# 數(shù)據(jù)庫用戶名
spring.datasource.username=root
# 數(shù)據(jù)庫密碼
spring.datasource.password=root
其次是導(dǎo)入JDBC驅(qū)動,，在pom.xml中添加如下代碼
<!-- mysql jdbc 驅(qū)動 https:///artifact/mysql/mysql-connector-java -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
因為我安裝的是5.7版本的mysql所以這里我選擇的是5版本的jdbc,，如果是8版本的mysql可能就需要選擇8版本的驅(qū)動了，驅(qū)動程序可以在maven倉庫找到,，同時我們要解開之前對mybatis依賴的注釋,。
接下來我們要創(chuàng)建一個實體Bear，用來承接Bear表查詢出來的數(shù)據(jù),，在t1目錄下創(chuàng)建controller的同級目錄entity,，再在entity內(nèi)創(chuàng)建java文件Bear.java,內(nèi)容如下
package com.ljsh.t1.entity;
public class Bear {
private String name;
private String type;
private String weight;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getType() {
return type;
}
public void setType(String type) {
this.type = type;
}
public String getWeight() {
return weight;
}
public void setWeight(String weight) {
this.weight = weight;
}
public Bear(String name, String type, String weight) {
this.name = name;
this.type = type;
this.weight = weight;
}
}
一個典型的pojo,，下面的getter和setter方法可以在idea編碼頁面右鍵選擇 Generate -> Getter and Setter 自動生成。
再之后是對mybaitis的配置與操作,，創(chuàng)建controller目錄同級目錄mapper,，在mapper目錄中創(chuàng)建接口文件TestMapper.java,代碼內(nèi)容如下
package com.ljsh.t1.mapper;
import com.ljsh.t1.entity.Bear;
import java.util.List;
public interface TestMapper {
List<Bear> getAllBears(); //查詢Bear表所有數(shù)據(jù)，作為List查出來
}
同樣的在resources目錄下也創(chuàng)建一個mapper文件夾,，mapper文件夾里創(chuàng)建TestMapper.xml文件,，內(nèi)容如下
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-////DTD Mapper 3.0//EN" "http:///dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ljsh.t1.mapper.TestMapper">
<select id="getAllBears" resultType="com.ljsh.t1.entity.Bear">
select
*
from Bear
</select>
</mapper>
在T1Applicatin文件也就是主啟動類中添加一個注解如下
package com.ljsh.t1;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
@MapperScan("com.ljsh.t1.mapper") //掃描mapper接口類
public class T1Application {
public static void main(String[] args) {
SpringApplication.run(T1Application.class, args);
}
}
最后在application.properties中增加一行
# 指向映射xml文件目錄
mybatis.mapperLocations=classpath:mapper/*.xml
現(xiàn)在的目錄結(jié)構(gòu)如下
通過在主啟動類上配置@MapperScan注解，讓springboot掃描需要實現(xiàn)的Mapper接口文件,。通過配置文件里xml地址的配置,，讓Mapper接口和Mapper的xml實現(xiàn)可以對應(yīng)起來。
最后我們在TestController里修改代碼
package com.ljsh.t1.controller;
import com.ljsh.t1.entity.Bear;
import com.ljsh.t1.mapper.TestMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
@RestController // 標注該類為Controller,，SpringBoot會自動掃描該類
public class TestController {
@Autowired
TestMapper testMapper; //自動注入
@RequestMapping("/test") // 處理請求路徑為/test的請求
public Object test(){
List<Bear> bears = testMapper.getAllBears();
return bears;
}
}
重新啟動項目訪問http://localhost:8080/test我們會收到從數(shù)據(jù)庫查詢出來的數(shù)據(jù)
這時候查看控制臺可能會發(fā)現(xiàn)一些警告
Thu Jan 14 22:45:15 CST 2021 WARN: Establishing SSL connection without server's identity verification is not recommended. According to MySQL 5.5.45+, 5.6.26+ and 5.7.6+ requirements SSL connection must be established by default if explicit option isn't set. For compliance with existing applications not using SSL the verifyServerCertificate property is set to 'false'. You need either to explicitly disable SSL by setting useSSL=false, or set useSSL=true and provide truststore for server certificate verification.
修改application.properties中的數(shù)據(jù)庫連接為如下即可消除警告
spring.datasource.url=jdbc:mysql://localhost:3306/t1?useSSL=false
結(jié)束語
本來的出發(fā)點是以最簡單的方式搭建一個能跑起來的web項目,，但是寫完了感覺還是有點復(fù)雜，但有基礎(chǔ)的話還是很好理解的,。之后應(yīng)該還會根據(jù)這個demo更新 mvc / 配置 /mybatis 具體的一些細節(jié)，也是自己的一次復(fù)習(xí),，如果有時間的話,。
|
