前言

在 Java 開發中，與資料庫互動是必備技能。這篇文章介紹三種常用的查詢方式：JdbcTemplate、JPA 與 JPQL，幫助你選擇適合的工具來操作資料庫。

JdbcTemplate

Repository 負責與資料庫溝通，運用 SQL 語言來操作 CRUD。

@Repository
public class DemoDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public void addStaff (ExampleEntity exampleEntity) {

        String sql = "INSERT INTO members(id, name) VALUES (?,?);";

        jdbcTemplate.update(sql, exampleEntity.getId(), exampleEntity.getName());
    }
}

常用方法

  • execute：操作資料表相關的 SQL (create, drop…)
  • update / batchUpdate：資料的新增、修改、刪除
  • query / queryForXXX：查詢資料
  • call：Stored Procedure

JPA

Repository extends JpaRepository。

public interface DemoRepository extends JpaRepository<DemoEntity, String> {

    DemoEntity findByGuid(String guid);

    List<DemoEntity> findByGuid(String guid);
}

可以直接使用 JPA 的語法進行查詢，findByGuid = SELECT * FROM Demo WHERE Guid = 'guid';，也可以回傳該物件的 List。但若需要更精細的查詢，可以使用 JPQL。

多個主鍵

在 JPA 如果要處理有多個 PK 的話，可以寫一個包含所有主鍵的類。

@Data // lombok 用法等於 @Getter @Setter, 但還有其他東西
public class PrimaryKey implements Serializable {

    private Integer id;

    private Integer userId;
}

在 Entity 下加入。

@Data
@Entity
@Table (name = "Demo")
@IdClass(Primarykey.class)
@Equa lsAndHashCode (callSuper = true)
@DynamicUpdate
public class DemoEntity {

    @Id
    @Column(name = "id", nullable = false)
    private Integer id;

    @Id
    @Column(name = "user_id", nullable = false)
    private Integer userId;
}

特殊 ID

uniqueidentifier (Transact-SQL) 類型。

@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
@Entity
@Table(name = "FileCollection", schema = "dbo")
public class FileCollectionEntity {

    @Id
    @GenericGenerator(name = "generator", strategy = "uuid2")
    @GeneratedValue(generator = "generator")
    @Column(name = "FileGuid", columnDefinition="uniqueidentifier")
    private String fileGuid;
}

這樣就會自動產生特殊的 UUID 了。

JPQL

一樣 extends JpaRepository。

public interface DemoRepository extends JpaRepository<DemoEntity, String> {

    @Query("SELECT COUNT(e) FROM DemoEntity e")
    long countAll();
}

意思是 SELECT COUNT(*) FROM Demo;，然而 JPQL 並不支援 LIMIT 語法，可以用 Pageable 進行限制。

在 Repository 傳入 Pageable 物件。

public interface DemoRepository extends JpaRepository<DemoEntity, String> {

    @Query("SELECT d.urpn, COUNT(d.urpn) AS t FROM DemoEntity d GROUP BY d.urpn ORDER BY t DESC")
    List<String> countUsRef(Pageable pageable);
}

接著在呼叫的方法加入 PageRequest.of(page, size)。

DemoRepository.countUsRef(PageRequest.of(0,10));

意思是第 0 頁，每 10 筆一頁。

總結

Java 提供了多種資料庫查詢方式，JdbcTemplate 提供原生 SQL 操作，JPA 提供物件導向的查詢方式，JPQL 則結合兩者優點。選擇適合的工具可以讓開發更有效率。

參考資料