Escolher qual API utilizar não seria apenas uma escolha de mão no código, mas também deve-se pensar em arquitetura. Vou descrever o que penso sobre os dois:
Considerações sobre arquitetura
A vantagem de usar a API de Criteria nativa do JPA é que:
- Você terá mais flexibilidade para mudar de implementação, você poderá manter o código de JPA utilizado. Como apenas as interfaces do JPA será utilizada, tanto como Eclipse, OpenJPA, Hibernate, etc terão essas interfaces implementada.
- Qualquer nova feature que for adicionar em uma nova versão, você já terá acesso
- Você tem a opção de usar a criteria de modo tipado ou não, o modo tipado já mostra erro em tempo de compilação
- Permite que consultas complexas sejam realizadas, e caso haja erro na implementação (hibernate por exemplo), basta fazer uma portabilidade de provider (ir para EclipseLink por exemplo)
A desvantagem de se usar a API nativa do JPA é:
- Complexidade. Devido a grande quantidade de classes que existem na API nativa, conhecer todas e seus objetivos levará um bom tempo
- Verbosidade. É uma API muito verbosa, um comando simples como select leva a várias linhas de códigos
A vantagem de usar a API de Criteria do Hibernate é que:
- Código simples e fácil de utilizar
- Ter acesso a funcionalidades que não estarão presentes na API nativa
A desvantagem de usar a API de Criteria do Hibernate é que:
- Você vai estar preso a uma implementação. Caso algum problema aconteça com o Hibernate você terá problemas em migrar para outra implementação. Algum tempo atrás, por exemplo, foi lançado o Batoo que prometeu uma performance 15x mais rápida que o Hibernate. Imagine que seu projeto está tendo problemas de performance e você gostaria de testar essa nova implementação? Ao utilizar API do Hiberate esse teste demoraria muito tempo. Já com API nativa do JPA seria feita mais rapidamente.
- Tamanho do Artefato. Infelizmente o Hibernate tem muitas dependências, com isso, o tamanho do war/ear aumenta consideravelmente. Isso poderá ser problema quando o upload do artefato para o ambiente de produção não tem um link bom de internet.
Considerações Código
Veja como ficará um select * from pessoa (entity Person) ao utilizar a criteria do JPA:
CriteriaQuery<Person> criteriaQuery = criteriaBuilder.createQuery(Person.class);
Root<Person> root = criteriaQuery.from(Person.class);
criteriaQuery.select(root); // necessário caso uma condição where seja adicionada na consulta
TypedQuery<Person> query = entityManager.createQuery(criteriaQuery);
query.getResultList();
Diversas linhas de código para realizar uma consulta simples. Como dito, a complexidade e a verbosidade infelizmente são grandes. Veja como ficará a mesma consulta acima utilizando o Hibernate:
Criteria criteria = session.createCriteria(Person.class);
List persons = criteria.list();
Note que o código ficou bem menor e mais simples de ser executado, só que houve a adição do código do próprio Hibernate.
O que escolher?
Algumas perguntas poderiam ser feitas para decidir qual criteria utilizar:
- Qual o nível da equipe que dará manutenção no projeto?
- É possível que um pequeno treinamento em criteria seja dado a toda equipe?
- Meu projeto pode vir a ter consultas muito complexas utilizando criteria?
- O projeto pode vir a ter problemas de performance?
Existem soluções para usar API nativa?
Existem frameworks no mercado que trabalham com a API nativa do JPA e facilitam o uso da criteria. Um deles é o EasyCriteria (http://easycriteria.uaihebert.com/). As mesmas consultas realizadas acima poderia ser feito como abaixo:
EasyCriteria<Person> easyCriteria = EasyCriteriaFactory.createQueryCriteria(entityManager, Person.class);
easyCriteria.getResultList();
A vantagem de utilizar esse tipo de framework é que seria possível migrar de Hibernate para OpenJPA, por exemplo.
Outra solução seria o QueryDSL que também tem uma interface para facilitar a consulta e criação de criterias tipadas (não sei se criterias não tipadas funciona). Nesse caso você geraria um meta model e depois utilizar o QueryDSL para gerar as critérias.