query-cn.md

查询

SELECT 语句相比其他语句更加复杂，因为 SELECT 语句拥有更多的子句。

基础

最简单的用例是查询表内的所有数据：

fun sample() {
    lateinit var selectStatement: SelectStatement<Person>
    database {
        PersonTable { table ->
             selectStatement = table SELECT X
        }
    }
    selectStatement.getResult().forEach { person ->
        println(person)
    }
}

X 表示没有任何子句，我们已经在 DELETE 语句中见过它了。

SELECT 语句与其他语句的另一个不同点在于它拥有查询结果。所以你需要声明一个类型为 SelectStatement<T> 的变量，泛型参数 T 是你希望反序列化的数据库实体的类型。你应该将你构建的 SELECT 语句赋值给此变量。

注意，所有的语句只会在 DatabaseScope 结束后执行，我们曾在《修改数据库与事务》中提到过这一点。 所以你必须在 database { ... } 外部调用 getResults 函数，SQLlin 将会帮助你将查询结果反序列化为你期待的对象。

单子句

在 SQL 中，我们常使用一些子句来进行条件查询。这些子句可以被单独使用 WHERE、ORDER BY、LIMIT 以及 GROUP BY 。示例代码如下所示：

fun sample() {
    database {
        PersonTable { table ->
            table SELECT WHERE(age LTE 5)
            table SELECT ORDER_BY(age to DESC)
            table SELECT ORDER_BY(age)
            table SELECT LIMIT(3)
            table SELECT GROUP_BY(name)
        }
    }
}

子句连接

有时我们会一次使用多个子句。在 SQL 中，有一些子句必须跟在另一些子句之后，比如 HAVING 跟在 GROUP BY 后面。SQLlin 确保你不会在子句的顺序上出错，子句的连接规则如下表所示：

Clause/Statement	Connectable
SELECT	WHERE, ORDER BY, LIMIT, GROUP BY
WHERE	LIMIT, ORDER BY, GROUP BY
GROUP BY	HAVING, ORDER BY
HAVING	ORDER BY, LIMIT
ORDER BY	LIMIT
LIMIT	OFFSET
OFFSET	/

一个带有多子句的 SELECT 如下所示：

fun sample() {
    lateinit var selectStatement: SelectStatement<Person>
    database {
        PersonTable { table ->
             selectStatement = table SELECT WHERE (age LTE 5) GROUP_BY age HAVING (upper(name) EQ "TOM") ORDER_BY (age to DESC) LIMIT 2 OFFSET 1
        }
    }
    selectStatement.getResult().forEach { person ->
        println(person)
    }
}

接下来

接下来我们将学习如何使用 SQL 函数以及高级查询：

• 并发安全
• SQL 函数
• 高级查询