Cláusula JPQL IN: Java-Arrays (ou Listas, Conjuntos ...)?

Gostaria de carregar todos os objetos que têm uma tag textual definida para qualquer um de um número pequeno, mas arbitrário de valores de nosso banco de dados. A maneira lógica de fazer isso no SQL seria construir uma cláusula "IN". JPQL permite IN, mas parece exigir que eu especifique cada parâmetro para IN diretamente (como em, "in (: in1,: in2,: in3)").

Existe alguma maneira de especificar uma matriz ou lista (ou algum outro contêiner) que deve ser desenrolada para os valores de uma cláusula IN?

Não tenho certeza para JPA 1.0, mas você pode passar um Collectionem JPA 2.0:

String qlString = "select item from Item item where item.name IN :names"; 
Query q = em.createQuery(qlString, Item.class);

List<String> names = Arrays.asList("foo", "bar");

q.setParameter("names", names);
List<Item> actual = q.getResultList();

assertNotNull(actual);
assertEquals(2, actual.size());

Testado com EclipseLInk. Com o Hibernate 3.5.1, você precisará colocar o parâmetro entre parênteses:

String qlString = "select item from Item item where item.name IN (:names)";

Mas isso é um bug, a consulta JPQL na amostra anterior é JPQL válida. Consulte HHH-5126 .

O limite do oráculo é de 1000 parâmetros. O problema foi resolvido pelo hibernate na versão 4.1.7 embora dividindo a lista de parâmetros passada em conjuntos de 500 veja JIRA HHH-1123