@RepeatableSE(NamedQueries.class)
@TargetSE(TYPESE)
@RetentionSE(RUNTIMESE)
public @interface NamedQuery

Jakarta Persistence クエリ言語で静的な名前付きクエリを指定します。クエリ名のスコープは永続性ユニットです。NamedQuery アノテーションは、エンティティまたはマップされたスーパークラスに適用できます。

以下は、Jakarta Persistence クエリ言語での名前付きクエリの定義の例です。

    @NamedQuery(
            name="findAllCustomersWithName",
            query="SELECT c FROM Customer c WHERE c.name LIKE :custName"
    )
 

以下は、名前付きクエリの使用例です。

    @PersistenceContext
    public EntityManager em;
    ...
    customers = em.createNamedQuery("findAllCustomersWithName")
            .setParameter("custName", "Smith")
            .getResultList();