Você pode usar a palavra chave NEW da JPQL na query, especificando uma classe. Para cada linha retornada, será criada uma instância desta classe. E então você pode passar o tipo desta sua estrutura de dados como parâmetro quando for solicitar a query ao EntityManager.
Esta estrutura de dados (ou "classe") precisa declarar um construtor que receba os valores dos campos na ordem em que eles são selecionados na query.
Então, considerando esta estrutura de dados:
package org.learning;
class ContaAtrasada {
final int idConta;
final double valor;
final int diasEmAtraso;
ContaAtrasada(int idConta, double valor, int diasEmAtraso) {
this.idConta = idConta;
this.valor = valor;
this.diasEmAtraso = diasEmAtraso;
}
}
O método que executa a query ficaria mais ou menos assim:
public List<ContaAtrasada> findContasAtrasadas() {
return em.createQuery("select NEW org.learning.ContaAtrasada(c.idConta, c.valor, " +
"today - c.dataVencimento as diasEmAtraso) " +
"from Conta c where c.dataVencimento < today", ContaAtrasada.class)
.getResultList();
}
Eu explicitei o namespace (package) da classe porque é muito importante informá-lo na sua query JPQL, já que a query pode ser executada em outro contexto onde a sua classe não estará diretamente acessível.