| Is used to specify a named query in the Java Persistence query language,
which is a static query expressed in metadata.
Query names are scoped to the persistence unit.
The following is an example of the definition of a named query
in the Java Persistence query language:
@NamedQuery(
name="findAllCustomersWithName",
query="SELECT c FROM Customer c WHERE c.name LIKE :custName"
)
The following is an example of the use of a named query:
@PersistenceContext
public EntityManager em;
...
customers = em.createNamedQuery("findAllCustomersWithName")
.setParameter("custName", "Smith")
.getResultList();
since:
Java Persistence 1.0 |