我非常喜爱Spring Data JPA。它帮助我简化代码库，把我从大量的JPAQL和SQL语句中解救出来。使用Spring Data编写的复杂查询也令我印象深刻。我最喜爱的功能便是从表格中返回第一条或顶部的记录。

假设我有一个表格跟踪文档：

与其关联的JPA对象：

@Entity
@Table(name = "DOCUMENT_TABLE")
public class Document implements Serializable {
   private static final long serialVersionUID = 1L;
   @Id
   @Column(name = "DOCUMENT_ID")
   private Long documentId;
   @Basic(optional = false)
   @NotNull
   private String name;
   @Basic(optional = false)
   @NotNull
   private Long version;
}

我的SQL会是这样：

SELECT *
FROM
  (SELECT *
  FROM document_table dt
  WHERE dt.name = 'mydoc.doc'
  ORDER BY dt.VERSION DESC
  )
WHERE rownum = 1;

或者在JPA中：

select d
   from Document d
   where d.name = :name
   and d.version = (select max(d.version) from Document d where d.name = :name)

但是我希望保持我的代码库始终不变，所以我要做的第一件事是:

public interface DocumentRepository extends CrudRepository {
    List findByNameOrderByVersionDesc(String name);
}

我可以得到第一条记录:

List documentList =
   documentRepository.findByNameOrderByVersionDesc("mydoc.doc");
Document document = documentList.get(0);

另一种选择是在存储库中直接进行SQL查询，但是最好的选择还是使用 spring data中的TOP功能：

public interface DocumentRepository extends CrudRepository {
    Document findFirstByNameOrderByVersionDesc(String name);
    Document findTopByNameOrderByVersionDesc(String name);
}

上述方法都是等效的

我们甚至可以使用TOP特性返回顶部的第n条记录：

Document findTop2ByNameOrderByVersionDesc(String name);

有趣但意料之中的是，基础的 SQL通过 Spring Data选择中我在原始SQL语句中使用的rownum构造生成。

本文译自：Dzone 英文原文：My Favourite Spring Data JPA Feature