Em geral você está correto.
Repository é um padrão de projeto similar ao DAO (Data Access Object) no sentido de que seu objetivo é abstrair o acesso a dados de forma genérica a partir do seu modelo. A diferença é que o Repository procura representar os dados como uma coleção de elementos, lembrando mesmo uma Collection
.
O projeto Spring Data Jpa facilita a implementação do padrão Repository através de AOP (Aspect Oriented Programming - programação orientada a aspectos).
Utilizando-se apenas de uma interface, o Spring irá "gerar" dinamicamente a implementação dos métodos de acesso a dados. Estender a interface JpaRepository
é opcional, mas a vantagem é ela já vem com vários de métodos genéricos de CRUD e você não precisa redefinir todos eles.
A princípio pode ser um pouco estranho usar este projeto do Spring. Quem não conhece AOP e como o Spring Data funciona vai perder um tempo procurando a implementação das interfaces.
Criar novos métodos simplesmente através das assinaturas é muito fácil. Veja este exemplo:
@Repository
public interface ClienteRepository extends JpaRepository<Cliente, Long> {
Cliente findByNome(String nome);
Page<Cliente> findByCidadeAndEstado(Cidade cidade, Estado, estado, Pageable pageable);
}
A princípio podemos perguntar: o que o Spring faz com isso?
Primeiro o prefixo findBy
nos nomes dos métodos significa que será um método de consulta.
O que vem se seguida é como uma expressão que define quais atributos serão usados como filtros. No primeiro exemplo, findByNome
, significa, pesquise pelo atributo nome
usando o valor passado no primeiro parâmetro. No segundo exemplo, a query gerada utilizará uma expressão com o operador AND
considerando os atributos cidade
e estado
.
Além disso, o parâmetro especial do tipo Pageable
diz que o resultado será paginado. Note que o retorno do método é uma "página de clientes".
Veja a documentação sobre criação de queries para maiores detalhes.
Alternativamente, você pode especificar uma query JPA ou nativa qualquer através da anotação @Query. Veja a documentação.
Exemplo de query JPA:
public interface UserRepository extends JpaRepository<User, Long> {
@Query("select u from User u where u.firstname like %?1")
List<User> findByFirstnameEndsWith(String firstname);
}
Exemplo de query nativa:
public interface UserRepository extends JpaRepository<User, Long> {
@Query(value = "SELECT * FROM USERS WHERE EMAIL_ADDRESS = ?0", nativeQuery = true)
User findByEmailAddress(String emailAddress);
}
Customizando o Spring Data Jpa
Existem basicamente duas formas de customizar ainda mais o Spring Data JPA:
Criando uma implementação específica
Se para apenas um caso você precisar mesmo fazer uma implementação de métodos, é possível. Para isso, se você tiver uma interface ClienteRepository
:
- Crie uma interface
ClienteRepositoryCustom
com os métodos que deseja implementar.
- Crie no mesmo pacote uma classe
ClienteRepositoryImpl
implementando esta interface.
- Faça a interface
ClienteRepository
estender a interface ClienteRepositoryCustom
Veja a documentação.
Criando uma interface "genérica"
Caso você tenha métodos que deseja ter em todos os repositórios, mas que não estão presentes na interface JpaRepository
, você pode criar um interface genérica com esses métodos e fazer seus repositórios estenderem essa interface.
Substituindo a implementação do JpaRepository
Bem, toda a mágica tem um truque por trás dos bastidores. Existe, sim, uma implementação disso tudo e você pode estendê-la conforma seus objetivos.
Eu mesmo fiz isso em um projeto recente para permitir uma busca dinâmica usando um mapa, onde cada entrada do mapa é adicionada automaticamente à cláusulas de pesquisa.
Creio que descrever todo o processo está fora do escopo da resposta, além de alongar muito o conteúdo. Então vou deixar o link de um dos artigos que usei para fazer a implementação é Customizing Spring Data JPA Repository.
Por um lado, criar sua versão estendida do JpaRepository
não é muito complicado, mas sugiro que tente resolver questões específicas usando as abordagens mais específicas já mencionadas. Pense duas vezes antes de criar ou sobrescrever métodos que afetam todas as suas classes.