ORM 查询

ORM 查询有多种形式。有关查询的详细信息，请转到 docs / query

“纯”ORM 查询

以下是纯 ORM 查询的示例。我们没有明确指定任何 SQL 函数，并且所有 SQL 都已生成。

在典型的近期应用程序中，大约 85% 的查询是“纯”ORM 查询。 

Customer rob =
  new QCustomer()
    .name.equalTo("Rob")
    .findOne();

List<Customer> customers =
  new QCustomer()
    .status.equalTo(Status.NEW)
    .billingAddress.city.equalTo("Auckland")
    .findList();

val rob =
  QCustomer()
    .name.equalTo("Rob")
    .findOne()

val customers =
  QCustomer()
    .status.equalTo(Status.NEW)
    .billingAddress.city.equalTo("Auckland")
    .findList()

在 Select 中使用 SQL 的 ORM 查询

我们可以在 select 子句中使用 SQL。此类查询的一些示例是 

// using sql functions in the select clause

List<String> names =
  new QContact()
    .select("concat(lastName,', ',firstName)")
    .lastName.startsWith("A")
    .findSingleAttributeList();

BigDecimal routeDistance =
  new QTrip()
    .select("ST_Distance(ST_StartPoint(route), ST_EndPoint(route))::BigDecimal")
    .id.equalTo(tripId)
    .findSingleAttribute();

  

// using sql functions in the select clause

var names: List<String> =
  QContact()
    .select("concat(lastName,' ',firstName)")
    .lastName.startsWith("A")
    .findSingleAttributeList()

val routeDistance: BigDecimal =
  QTrip()
    .select("ST_Distance(ST_StartPoint(route), ST_EndPoint(route))::BigDecimal")
    .id.equalTo(tripId)
    .findSingleAttribute()

在 Where 中使用 SQL 的 ORM 查询

我们还可以在 where 子句中使用 SQL。通常这是为了指定 sql 子查询。 

// sql functions used in predicates
List<Order> orders =
  new QOrder()
  .raw("add_days(orderDate, 10) < ?", someDate)
  .findList();

// SQL sub-query - often easiest to specify the subquery in sql form
String subQuery
    = "t0.customer_id in " +
      "(select customer_id from customer_group where group_id = any(?::uuid[]))";

List<Order> orders =
  new QOrder()
   .status.equalTo(Status.NEW)
   .raw(subQuery, groupIds)   // use raw SQL in where clause
   .findList();

  

// sql functions used in predicates
var orders =
  QOrder()
  .raw("add_days(orderDate, 10) < ?", someDate)
  .findList()

// SQL sub-query - often easiest to specify the subquery in sql form
val subQuery =
    "t0.customer_id in " +
    "(select customer_id from customer_group where group_id = any(?::uuid[]))"

var orders =
  QOrder()
   .status.equalTo(Status.NEW)
   .raw(subQuery, groupIds)   // use raw SQL in where clause
   .findList()

在典型的近期应用程序中，大约 5% 的查询是带有某些 SQL（主要是子查询）的 ORM 查询。

ORM 到 DTO 查询

我们可以定义一个 ORM 查询，然后使用 asDto 将其转换为 DTO 查询。我们正在使用 ORM 生成 SQL，但随后希望将其直接映射到 DTO bean。 

// ContactDto is a plain bean with email and fullName properties

List<ContactDto> contacts =
  new QContact()
    .select("email, concat(lastName, ', ', firstName) as fullName")
    .lastName.startsWith("A")
    .orderBy()
      .lastName.asc()
    .setMaxRows(10)
    .asDto(ContactDto.class)
    .findList();

  

// ContactDto is a plain bean with email and fullName properties

val contacts =
  new QContact()
    .select("email, concat(lastName, ', ', firstName) as fullName")
    .lastName.startsWith("A")
    .orderBy()
      .lastName.asc()
    .setMaxRows(10)
    .asDto(ContactDto::class.java)
    .findList()

SQL - 又名查找本机

我们还可以用 SQL 指定查询，并将其自动映射到实体 bean（如下所示）或 DTO bean。 

String sql = "select id, name from customer where name like ?";

Customer customer = DB.findNative(Customer.class, sql)
    .setParameter(1, "Jo%")
    .findOne();

  

String sql = "select id, name from customer where name like ?";

val customer = DB.findNative(Customer::class.java, sql)
    .setParameter(1, "Jo%")
    .findOne()