iT邦幫忙

第 12 屆 iThome 鐵人賽

DAY 16
0
Modern Web

30天從零撰寫 Kotlin 語言並應用於 Spring Boot 開發系列 第 16

[Day 16] 遠征 Kotlin × 使用 Spring Data JPA 操作資料庫 (1)

  • 分享至 

  • xImage
  •  

昨日我們已經學會資料庫設定與使用 JDBC 取得資料庫資料,而今天我們將 JDBC 這段程式改為使用 Spring Data JPA 進行資料庫資料操作,而 Spring Data JPA 是 Spring Boot 官方相當推薦使用的 ORM 框架,可以讓使用者利用極簡的程式碼實現資料操作處理,它內部已經提供了資料庫 CRUD(Create、Read、Update、Delete)等常用功能,可以讓我們大幅提高開發效率,我們直接進入實作體驗:

此文章有提供範例程式碼在 Github 供大家參考

  1. build.gradle.ktsdependencies 加入 Spring DataJPA 套件

    implementation("org.springframework.boot:spring-boot-starter-data-jpa")
    
  2. 設定 application.yml JPA 設定,這邊列出整個 application.yml 內容

    server:
      port: 8080  # 設定 Spring Boot 啟動 port 
    spring:
      h2: # 設定 H2 資料庫
        console:
          enabled: true
          path: /h2-console
      jpa: # 設定 JPA 相關設定
        hibernate:
          ddl-auto: update # 設定update值,表示只有第一次載入時需要自動建立資料表,其餘載入則是更新資料表結構
        database-platform: H2 # 設定 JPA database 為 H2 資料庫
        show-sql: true # 顯示 JPA 運行的SQL語法
        generate-ddl: false
      datasource:
        url: jdbc:h2:file:./src/main/resources/data/ironman;AUTO_SERVER=true
        username: sa
        password: Ironman0924!
    
  3. 新增 Student.kt 檔案,我們利用data class屬性建立 Student Entity,如果有使用 Java 開發過 Spring Boot 的朋友,會發現Kotlin是可以利用data class取代 Java 的 lombok 套件,檔案內容如下:

    @Entity
    @Table
    data class Student(
            @Id
            @GeneratedValue(strategy = GenerationType.SEQUENCE)
            val id: Int = 0,
    
            @Column
            val name: String = "",
    
            @Column
            val email: String = ""
    )
    
  4. 新增 StudentDao.kt 檔案,建立 DAO 操作物件

    interface StudentDao:  JpaRepository<Student, Long>, JpaSpecificationExecutor<Student>
    
  5. 新增 StudentController.kt 檔案,建立兩個 API-取得所有學生資料API新增學生資料API

    @RestController
    @RequestMapping("/api")
    class StudentController(@Autowired val studentDao: StudentDao) {
        /**
         * 取得 Student 所有資料
         */
        @GetMapping("/students")
        fun getStudentData(): MutableList<Student> {
            return studentDao.findAll()
        }
    
        /**
         * 新增 Student 資料
         */
        @PostMapping("/students")
        fun addStudentData(@RequestBody student: Student): Student {
            return studentDao.save(student)
        }
    }
    
  6. 新增 Student.http 檔案,利用 Http Client 工具進行 API 測試

    ### 取得所有學生資料 API
    GET http://localhost:8080/api/students
    
    ### 新增學生資料 API
    POST http://localhost:8080/api/students
    Content-Type: application/json
    
    {
      "name": "Devin",
      "email": "test@gmail.com"
    }
    

    在 API 測試這塊,可能有些朋友接觸過 Postman 測試工具,而這邊我們使用的工具是 Http Client ,這套工具也可以讓開發者模擬 Http Request 動作,利用建立 Http 檔案與撰寫測試案例進行 API測試與取得驗證結果,而目前在工作開發上也經常使用這套工具,此工具若相較於Postman,個人認為 Http Client 帶給我們更多的好處,像是可以利用版本控制維護測試檔案,也可以與團隊共享此份測試檔案,在靈活度上佔有很大優勢,Plugin 其餘介紹也可以從這邊查看 Document
    https://ithelp.ithome.com.tw/upload/images/20200925/201211795y2swNt5bW.png

  7. 我們實際測試 新增學生資料API取得所有學生資料API 來觀看實際運作:
    (1) 新增兩筆學生資料,實際操作結果如下
    https://ithelp.ithome.com.tw/upload/images/20200925/20121179w9oaTr6iWx.png

    (2) 取得所有學生資料,實際操作結果如下
    https://ithelp.ithome.com.tw/upload/images/20200925/20121179aw96vaDFgk.png

此文章有提供範例程式碼在 Github 供大家參考

今天我們直接帶入實作步驟來讓大家感受 Spring Data JPA 的效果,而後續我們再來細談 Spring Data JPA 的介紹與其餘使用方式的介紹,相信大家會對於 Spring Data JPA 更了解。


上一篇
[Day 15] 遠征 Kotlin × Spring Boot 設定資料庫與匯入初始資料
下一篇
[Day 17] 遠征 Kotlin × 使用 Spring Data JPA 操作資料庫 (2)
系列文
30天從零撰寫 Kotlin 語言並應用於 Spring Boot 開發30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言