【2023】Kotlin教程第三篇 Kotlin进阶第24章轻量级SQL框架——Exposed 24.3 使用Exposed框架 24.3.2 面向DSL API

清疚 2024-03-23 15:08 20阅读 0赞

### 【2023】Kotlin教程 ###

#### 文章目录 ####

*   *  【2023】Kotlin教程
     *   *  第三篇 Kotlin进阶
         *  第24章 轻量级SQL框架——Exposed
         *   *  24.3 使用Exposed框架
             *   *  24.3.2 面向DSL API

![在这里插入图片描述][888018cd708c41c2986cb6578118a580.png_pic_center]

#### 第三篇 Kotlin进阶 ####

#### 第24章 轻量级SQL框架——Exposed ####

数据必须以某种方式来存储才可以有用，数据库实际上是一组相关数据的集合。

数据库编程相关的技术很多，涉及具体的数据库安装、配置和管理，还要掌握SQL语句，最后才能编写程序访问数据库。

##### 24.3 使用Exposed框架 #####

Exposed是Kotlin DSL轻量级的SQL框架，

官方仓库：[https://github.com/JetBrains/Exposed][https_github.com_JetBrains_Exposed]

![在这里插入图片描述][cae3d0e0166145a6a4d7a406a0d0c8ab.png_pic_center]

Exposed是基于JDBC（Java Database Connectivity）技术实现的，使用JDBC比较麻烦，要先建立数据连接、编写SQL语句、操作数据库，最后要关闭数据库。而使用Exposed开发人员不需要关心数据库连接和关闭等与业务无关的问题，只需要关注数据操作上。

###### 24.3.2 面向DSL API ######

Exposed框架提供了两种形式的API，一种是面向DSL的API；另一种是 面向对象的API。本节介绍面向DSL的API，这里的DSL类似于标准SQL。

下面通过示例介绍一下如何使用Exposed DSL API，示例中有一个公司部门表（Departments），它有两个字段id和name，如下表所示。

<table> 
 <thead> 
  <tr> 
   <th align="center">字段名</th> 
   <th align="center">类型</th> 
   <th align="center">是否可以为NULL</th> 
   <th align="center">主键</th> 
   <th align="center">是否自增长</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">id</td> 
   <td align="center">integer</td> 
   <td align="center">否</td> 
   <td align="center">是</td> 
   <td align="center">是</td> 
  </tr> 
  <tr> 
   <td align="center">name</td> 
   <td align="center">varchar(30)</td> 
   <td align="center">是</td> 
   <td align="center">否</td> 
   <td align="center">否</td> 
  </tr> 
 </tbody> 
</table>

注意先创建出来`mydb` 数据库。

![在这里插入图片描述][c6e5296563fd467ab1fe60f2cacaafc5.png_pic_center]

示例代码：

package com.dingjiaxiong
    
    import org.jetbrains.exposed.sql.*
    import org.jetbrains.exposed.sql.SchemaUtils.create;
    import org.jetbrains.exposed.sql.transactions.transaction
    
    /**
     * @Projectname: ExposedTest
     * @Classname: HelloWorld
     * @Author: Ding Jiaxiong
     * @Data:2023/4/6 16:58
     */
    
    // 声明部门表
    object Departments : Table() {
        
    
        // 声明表中字段
        val id = integer("id").autoIncrement()
        val name = varchar("name", length = 30)
        override val primaryKey = PrimaryKey(id, name = "PK_DEP_ID")
    }
    
    const val URL = "jdbc:mysql://localhost:3306/mydb?serverTimezone=UTC&useUnicode=true&CharacterEncoding=utf-8"
    const val DRIVER_CLASS = "com.mysql.cj.jdbc.Driver"
    
    fun main() {
        
    
        // 连接数据库
        Database.connect(URL, user = "root", password = "123456", driver = DRIVER_CLASS)
    
        // 操作数据库
        transaction {
        
            // 创建部门表Departments
            create(Departments)
            // 部门表插入数据
            Departments.insert {
        
                it[name] = "销售部"
            }
            Departments.insert {
        
                it[name] = "技术部"
            }
            showDatas()
    
            // 更新数据
            Departments.update({
         Departments.name eq "销售部" }) {
        
                it[name] = "市场部"
            }
            showDatas()
    
            // 删除数据
            Departments.deleteWhere {
         Departments.id lessEq 1 }
            showDatas()
        }
    }
    
    // 操作所有数据, 并打印
    fun showDatas() {
        
        println("=======================")
        Departments.selectAll().forEach {
        
            println("${
          it[Departments.id]} : ${
          it[Departments.name]}")
        }
    }

上述代码实现了创建Departments表，以及对Departments进行了数据CRUD操作。

integer和varchar函数对应SQL中的字段类型整数和可变字符串类型，类似的函数有：

*  数值类型：integer、long、decimal
 *  字符类型：char、text、varchar
 *  日期、时间类型：date、datetime
 *  布尔类型：bool
 *  大二进对象类型：blob

这些函数都与SQL字段类型对应，从函数名可知字段类型

另外，代码autoIncrement函数设置字段是自增长的 ，primaryKey函数设置字段是主键。

`useUnicode=true&CharacterEncoding=utf-8` 设置字符集为UTF-8。

`Database.connect` 连接数据库。

`transaction {}` 开启了一个事务，花括号内的SQL 操作都是一个事务。

【提示】数据库事务通常包含了多个对数据库读/写操作的，这些操作是有序的。当事务被提交给了数据库管理系统，则数据库管理系统需要确保该事务中的所有操作都成功完成，结果被永久保存在数据库中。如果事务中有的操作没有成功完成，则事务中的所有操作都需要被回滚，回到事务执行前的状态。同时，该事务对数据库或者其他事务的执行无影响，所有的事务都好像在独立的运行。

`create(Departments)` → 创建数据表。

自定义函数`showDatas()` → 查询所有数据并打印，`selectAll()`查询所有数据。

update函数是更新表，`Departments.name eq "销售部"`表达式是是更新条件，相当于SQL的name = ‘销售部’，eq是Exposed框架提供的中缀运算符，即等于。Exposed框架中缀运算符与SQL运算符对照如下表所示：

<table> 
 <thead> 
  <tr> 
   <th align="center">中缀运算符</th> 
   <th align="center">SQL运算符</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">eq</td> 
   <td align="center">=</td> 
  </tr> 
  <tr> 
   <td align="center">neq</td> 
   <td align="center">!=</td> 
  </tr> 
  <tr> 
   <td align="center">less</td> 
   <td align="center">&lt;</td> 
  </tr> 
  <tr> 
   <td align="center">lessEq</td> 
   <td align="center">&lt;=</td> 
  </tr> 
  <tr> 
   <td align="center">greater</td> 
   <td align="center">&gt;</td> 
  </tr> 
  <tr> 
   <td align="center">greaterEq</td> 
   <td align="center">&gt;=</td> 
  </tr> 
  <tr> 
   <td align="center">like</td> 
   <td align="center">like</td> 
  </tr> 
  <tr> 
   <td align="center">inList</td> 
   <td align="center">in</td> 
  </tr> 
  <tr> 
   <td align="center">between</td> 
   <td align="center">between</td> 
  </tr> 
  <tr> 
   <td align="center">plus</td> 
   <td align="center">+</td> 
  </tr> 
  <tr> 
   <td align="center">minus</td> 
   <td align="center">-</td> 
  </tr> 
  <tr> 
   <td align="center">times</td> 
   <td align="center">*</td> 
  </tr> 
  <tr> 
   <td align="center">div</td> 
   <td align="center">/</td> 
  </tr> 
 </tbody> 
</table>

运行结果：

![在这里插入图片描述][65e7b37d347c4243a22a7732dca6ad63.png_pic_center]

[888018cd708c41c2986cb6578118a580.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/8f23fd7a8d8748a88188787efc1d284d.png
[https_github.com_JetBrains_Exposed]: https://github.com/JetBrains/Exposed
[cae3d0e0166145a6a4d7a406a0d0c8ab.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/f650b5a72e6542ea98dfc6bf6481fa1b.png
[c6e5296563fd467ab1fe60f2cacaafc5.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/039ace56e256448eb17491e08be1e1ea.png
[65e7b37d347c4243a22a7732dca6ad63.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/b786b8b363374d438e2370e0ee369d5d.png