O objetivo principal do projeto Spring Data é facilitar a construção de aplicativos baseados em Spring que usam novas tecnologias de acesso a dados, como bancos de dados não relacionais, estruturas de redução de mapas e serviços de dados baseados em nuvem.
Este módulo fornece integração com a loja Redis. Ele também é testado para funcionar com Valkey na base do melhor esforço, desde que Valkey permaneça amplamente compatível com Redis.
Pacote de conexão como abstração de baixo nível em vários drivers Redis (Lettuce e Jedis).
Tradução de exceções para a hierarquia de exceções de acesso a dados portátil do Spring para exceções de driver Redis
RedisTemplate
que fornece uma abstração de alto nível para executar várias operações Redis, tradução de exceções e suporte de serialização.
Suporte Pubsub (como MessageListenerContainer para POJOs acionados por mensagens).
Suporte ao Redis Sentinel e Redis Cluster.
API reativa usando o driver Lettuce.
Serializadores de mapeamento JDK, String, JSON e Spring Object/XML.
Implementações da coleção JDK em cima do Redis.
Aulas de suporte de contador atômico.
Funcionalidade de classificação e pipeline.
Suporte dedicado para SORT, padrão SORT/GET e valores em massa retornados.
Implementação do Redis para abstração de cache Spring 3.1.
Implementação automática de interfaces Repository
, incluindo suporte para métodos de localização personalizados usando @EnableRedisRepositories
.
Suporte CDI para repositórios.
Este projeto é regido pelo Código de Conduta Spring. Ao participar, espera-se que você cumpra este código de conduta. Por favor, relate comportamento inaceitável para [email protected].
Aqui está um teaser rápido de um aplicativo usando Spring Data Redis em Java:
public class Example {
// inject the actual template
@ Autowired
private RedisTemplate < String , String > redisTemplate ;
// inject the template as ListOperations
// can also inject as Value, Set, ZSet, and HashOperations
@ Resource ( name = "redisTemplate" )
private ListOperations < String , String > listOps ;
public void addLink ( String userId , URL url ) {
listOps . leftPush ( userId , url . toExternalForm ());
// or use template directly
redisTemplate . boundListOps ( userId ). leftPush ( url . toExternalForm ());
}
}
@ Configuration
class ApplicationConfig {
@ Bean
public RedisConnectionFactory redisConnectionFactory () {
return new LettuceConnectionFactory ();
}
}
Adicione a dependência do Maven:
< dependency >
< groupId >org.springframework.data</ groupId >
< artifactId >spring-data-redis</ artifactId >
< version >${version}</ version >
</ dependency >
Se você preferir os snapshots mais recentes da próxima versão principal, use nosso repositório de snapshots Maven e declare a versão de dependência apropriada.
< dependency >
< groupId >org.springframework.data</ groupId >
< artifactId >spring-data-redis</ artifactId >
< version >${version}-SNAPSHOT</ version >
</ dependency >
< repository >
< id >spring-snapshot</ id >
< name >Spring Snapshot Repository</ name >
< url >https://repo.spring.io/snapshot</ url >
</ repository >
Está com problemas com Spring Data? Adoraríamos ajudar!
Verifique a documentação de referência e Javadocs.
Aprenda os fundamentos do Spring – Spring Data é baseado no Spring Framework, verifique o site spring.io para obter uma grande variedade de documentação de referência. Se você está apenas começando com o Spring, experimente um dos guias.
Se você estiver atualizando, verifique as notas de versão para recursos “novos e dignos de nota”.
Faça uma pergunta - monitoramos stackoverflow.com em busca de perguntas marcadas com spring-data-redis
. Você também pode conversar com a comunidade no Gitter.
Relate bugs com Spring Data Redis em github.com/spring-projects/spring-data-redis.
Spring Data usa Github como sistema de rastreamento de problemas para registrar bugs e solicitações de recursos. Se você quiser levantar um problema, siga as recomendações abaixo:
Antes de registrar um bug, pesquise no rastreador de problemas para ver se alguém já relatou o problema.
Se o problema ainda não existir, crie um novo problema.
Forneça o máximo de informações possível com o relatório de problemas, gostamos de saber a versão do Spring Data que você está usando, a versão da JVM, Stacktrace, etc.
Se você precisar colar código ou incluir um rastreamento de pilha, use limites de código Markdown ```.
Se possível, tente criar um caso de teste ou projeto que replique o problema. Anexe um link ao seu código ou um arquivo compactado contendo seu código.
Você não precisa compilar a partir do código-fonte para usar o Spring Data (binários em repo.spring.io), mas se quiser experimentar o que há de melhor e mais recente, o Spring Data pode ser facilmente compilado com o wrapper maven. Você também precisa do JDK 17 ou superior e make
. O ambiente de construção local é gerenciado em um Makefile
para baixar, construir e ativar o Redis em várias configurações (autônomo, sentinela, cluster, etc.)
$ make test
O comando anterior executa uma compilação completa. Você pode usar comandos make start
, make stop
e make clean
para controlar o ambiente por conta própria. Isso é útil se você quiser evitar reinicializações constantes do servidor. Depois que todas as instâncias do Redis forem iniciadas, você poderá executar testes em seu IDE ou na versão completa do Maven:
$ ./mvnw clean install
Se quiser construir com o comando mvn
normal, você precisará do Maven v3.8.0 ou superior.
Consulte também CONTRIBUTING.adoc se desejar enviar solicitações pull e, em particular, assine o Contrato do Colaborador antes de sua primeira alteração não trivial.
Construir a documentação também constrói o projeto sem executar testes.
$ ./mvnw clean install -Pantora
A documentação gerada está disponível em target/antora/site/index.html
.
O site spring.io contém vários guias que mostram como usar o Spring Data passo a passo:
Mensagens com Redis: Aprenda como usar o Redis como um corretor de mensagens.
Acessando dados de forma reativa com Redis: Aprenda como fazer interface reativa com Redis e Spring Data.
Exemplos de dados do Spring contêm projetos de exemplo que explicam recursos específicos com mais detalhes.
Spring Data Redis é um software de código aberto lançado sob a licença Apache 2.0.