目錄

【SpringBoot2.0文章匯總目錄，java多線程教程文章匯總 長期更新系列
】
請多多支持

【SpringBoot2.0系列01】初識SpringBoot
【SpringBoot2.0系列02】SpringBoot之使用Thymeleaf視圖模板
【SpringBoot2.0系列03】SpringBoot之使用freemark視圖模板
【SpringBoot2.0系列04】SpringBoot之使用JPA完成簡單的rest api
【SpringBoot2.0系列05】SpringBoot之整合Mybatis
【SpringBoot2.0系列06】SpringBoot之多數(shù)據(jù)源動態(tài)切換數(shù)據(jù)源
【SpringBoot2.0系列07】SpringBoot之redis使用（Lettuce版本）

一宏多、 前言

在前面我們已經(jīng)知道在springboot中如何使用freemark與thymeleaf之類的視圖模板引擎去渲染我們的視圖頁面算吩，但是沒涉及跟數(shù)據(jù)庫交互的東西，所以今天在這里我們將介紹了一下如何在springboot中通過spring data jpa操作mysql數(shù)據(jù)庫，并且構(gòu)建一套簡單的rest api接口。

1.1、Spring Data Jpa 介紹

Spring Data JPA是Spring基于Hibernate開發(fā)的一個JPA框架绰寞。如果用過Hibernate或者M(jìn)yBatis的話，就會知道對象關(guān)系映射（ORM）框架有多么方便。但是Spring Data JPA框架功能更進(jìn)一步克握，為我們做了 一個數(shù)據(jù)持久層框架幾乎能做的任何事情蕾管。并且提供了基礎(chǔ)的增刪改查方法，具體api請看官網(wǎng)菩暗。

2.2

REST是所有Web應(yīng)用都應(yīng)該遵守的架構(gòu)設(shè)計指導(dǎo)原則掰曾。
Representational State Transfer，翻譯是”表現(xiàn)層狀態(tài)轉(zhuǎn)化”停团。
面向資源是REST最明顯的特征旷坦，對于同一個資源的一組不同的操作。資源是服務(wù)器上一個可命名的抽象概念佑稠，資源是以名詞為核心來組織的秒梅，首先關(guān)注的是名詞。REST要求舌胶，必須通過統(tǒng)一的接口來對資源執(zhí)行各種操作捆蜀。對于每個資源只能執(zhí)行一組有限的操作。（7個HTTP方法：GET/POST/PUT/DELETE/PATCH/HEAD/OPTIONS）
關(guān)于rest api如何涉及我也是從阮一峰老師那里學(xué)習(xí)的幔嫂。

二辆它、目標(biāo)

首先我們有一個user表，我們希望能通過構(gòu)建出對應(yīng)的rest api對表中的數(shù)據(jù)完成增刪改查操作履恩。
jpa的依賴如下

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
    </dependencies>

接下來那么第一步就是創(chuàng)表了
1锰茉、創(chuàng)表
由于我們使用的spring data jpa 而jpa的底層實現(xiàn)是hibernate，用過hibernate的同學(xué)知道 hibernate可以通過實體類逆向創(chuàng)建表切心，只需要配置一下ddl-auto 就可以
所以我們需要在application.yml配置一下

server:
  port: 8989
spring:
  datasource:
    username: root
    password: root
    url: jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf8
    driver-class-name: com.mysql.jdbc.Driver
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true

在上面的配置文件中 我們配置了一個數(shù)據(jù)源跟tomcat端口還有jpa的配置飒筑。其中 show-sql: true 代表會在日志中打印我們操作的sql、
而另外 ddl-auto有四個值可選绽昏，分別是

• create 啟動時刪數(shù)據(jù)庫中的表协屡，然后創(chuàng)建，退出時不刪除數(shù)據(jù)表
• create-drop 啟動時刪數(shù)據(jù)庫中的表全谤，然后創(chuàng)建肤晓，退出時刪除數(shù)據(jù)表 如果表不存在報錯
• update 最常用的屬性，第一次加載hibernate時根據(jù)model類會自動建立起表的結(jié)構(gòu)（前提是先建立好數(shù)據(jù)庫）啼县，以后加載hibernate時根據(jù) model類自動更新表結(jié)構(gòu)，即使表結(jié)構(gòu)改變了但表中的行仍然存在不會刪除以前的行沸久。要注意的是當(dāng)部署到服務(wù)器后季眷，表結(jié)構(gòu)是不會被馬上建立起來的，是要等 應(yīng)用第一次運(yùn)行起來后才會卷胯。
• validate 項目啟動表結(jié)構(gòu)進(jìn)行校驗 如果不一致則報錯

所以這里我們希望當(dāng)表創(chuàng)建成功后 下次啟動數(shù)據(jù)還在我們就選擇了update模式子刮，其次我們需要在本地的mysql數(shù)據(jù)庫新建一個test數(shù)據(jù)庫。
接下來我們需要編寫的我們實體類User.java了 hibernate將會通過實體類的結(jié)構(gòu)在test數(shù)據(jù)庫中創(chuàng)建一個對應(yīng)的user表
新建包entity 創(chuàng)建User.java代碼如下：

@JsonIgnoreProperties(value={"hibernateLazyInitializer","handler","fieldHandler"}) 
@Entity
public class User {

    @Id
    @GeneratedValue
    private Long id;

    /**
     * 用戶名
     */
    @Column(name = "username", nullable = true, length = 32)
    private String username;

    /**
     * 密碼
     */
    @Column(name = "password", nullable = true, length = 32)
    private String password;

    /**
     * 年齡
     */
    @Column(name = "age", nullable = true, length = 11)
    private Integer age;

    /**
     * 性別 1=男 2=女 其他=保密
     */
    @Column(name = "sex", nullable = true, length = 11)
    private Integer sex;


    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public Integer getSex() {
        return sex;
    }

    public void setSex(Integer sex) {
        this.sex = sex;
    }

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }
}

至此，我們的user表也算是創(chuàng)建好了挺峡，當(dāng)我們的程序第一個啟動的時候jpa會自動在test數(shù)據(jù)庫中創(chuàng)建與之對應(yīng)的表葵孤。

2、構(gòu)建rest api
這里我們需要構(gòu)建如下的rest api

那么這就是我們需要構(gòu)建的rest api橱赠，那么對應(yīng)的由mvc模式可知我們的rest api是controller層的尤仍，所以我們的service跟repository層(備注在使用 jpa的時候我們喜歡把dao層命名為repository)需要提供對應(yīng)的接口。
首先我們首先需要編寫UserRepository接口狭姨，并且讓它基礎(chǔ)JpaRepository接口

新建包repository 創(chuàng)建UserRepository.java代碼如下：

public interface UserRepository extends JpaRepository<User, Long> {

    /**
     * 根據(jù)用戶名查找用戶信息
     * @param username
     * @return
     */
    User findUserByUsername(String username);

}

解釋一下上面的代碼宰啦，為什么只有一個方法，而前面我們是五個接口饼拍，因為是在JpaRepository中提供較為基礎(chǔ)的增刪改查方法赡模，我們無需編寫就看使用。如果大家不信按住ctrl點(diǎn)擊JpaRepository看源碼就知道了师抄。

image.png

image.png

image.png

public interface UserService {

    /**
     * 添加用戶信息
     * @param user
     * @return
     */
    User saveUser(User user);

    /**
     * 更新用戶信息
     * @param user
     */
    User updateUser(User user);

    /**
     * 根據(jù)id獲取用戶
     * @param id
     * @return
     */
    User getById(Long id);

    /**
     * 根據(jù)名稱獲取用戶
     * @param username
     * @return
     */
    User getByUserName(String username);

    /**
     * 查詢所有用戶
     * @return
     */
    List<User> queryAll();

    /**
     * 根據(jù)id刪除用戶信息
     * @param id
     */
    void deleteById(Long id);
}

接下里就下service的實現(xiàn)類剿干，帶service包下新建impl包并且創(chuàng)建實現(xiàn)類UserServiceImpl.java 代碼如下

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserRepository userRepository;

    @Override
    public User saveUser(User user) {
        return userRepository.save(user);
    }

    @Override
    public User updateUser(User user) {
        return userRepository.save(user);
    }

    @Override
    public User getById(Long id) {
        return userRepository.getOne(id);
    }

    @Override
    public User getByUserName(String username) {
        return userRepository.findUserByUsername(username);
    }

    @Override
    public List<User> queryAll() {
        return userRepository.findAll();
    }

    @Override
    public void deleteById(Long id) {
        userRepository.deleteById(id);
    }
}

那么緊接著就是控制層的代碼了,新建controller包，并且創(chuàng)建UserController.java

@RestController
@RequestMapping(value = "/user")
public class UserController {

    @Autowired
    private UserService userService;

    @PostMapping
    public User save(@RequestBody User user) {
        return userService.saveUser(user);
    }

    @PutMapping
    public User update(@RequestBody User user) {
        return userService.saveUser(user);
    }

    @DeleteMapping(value = "/id/{id}")
    public String delete(@PathVariable  Long id) {
        userService.deleteById(id);
        return "刪除成功";
    }

    @GetMapping(value = "/id/{id}")
    public User findById (@PathVariable Long id) {
        return userService.getById(id);
    }

    @GetMapping(value = "/username/{username}")
    public User findByUsername (@PathVariable String username) {
        return userService.getByUserName(username);
    }

    @GetMapping(value = "/")
    public List<User> findAll () {
        return userService.queryAll();
    }
}

這樣我們就完成了一個簡單的rest api了啊穆刻。
接下來我們來測試一下把置尔。
3、測試
由于我們這里測試的是rest api普通的瀏覽器是沒法支持 post delet put方式的訪問的氢伟，所以這里我們就用postman來測試榜轿。
1、首先我們看到test數(shù)據(jù)庫中現(xiàn)在是一張表都沒有的

image.png

image.png

我們看到了日志打印了創(chuàng)建表的ddl那么我們再看看數(shù)據(jù)庫中有沒有表

image.png

image.png

選擇post模式，輸入訪問的url砸烦，然后選擇body中的raw弃鸦，因為我們使用的@RequestBody注解，所以我們選擇raw中的Json幢痘，如圖

image.png

因為我們的id是自增的唬格，所以我們不要輸入，直接點(diǎn)擊send訪問雪隧，如果返回的數(shù)據(jù)有id那么就是代表新增成功西轩。如下圖就是新增成功。

image.png

image.png

接下來我們就多添加幾條數(shù)據(jù)注服。
那么我們測試一下查詢所有數(shù)據(jù)的方法。操作如圖

image.png

image.png

image.png

三、總結(jié)

這里我們通過這次選擇對于jpa的使用有了一個初步的了解焰盗，并且對于rest api的規(guī)范也有了個了解璧尸。

最后配套教程的代碼全部在這里
github https://github.com/YuKongEr/SpringBoot-Study。麻煩點(diǎn)個star或者fork吧熬拒。
最后大家關(guān)注一下我的個人公眾號把爷光。

公眾號