Das Hauptziel des Spring Data-Projekts besteht darin, die Erstellung von Spring-basierten Anwendungen zu erleichtern, die neue Datenzugriffstechnologien wie nicht-relationale Datenbanken, Map-Reduce-Frameworks und cloudbasierte Datendienste nutzen.
Dieses Modul ermöglicht die Integration mit dem Redis-Store. Es wurde auch getestet, ob es mit Valkey auf Best-Effort-Basis funktioniert, solange Valkey weitgehend mit Redis kompatibel bleibt.
Verbindungspaket als Low-Level-Abstraktion über mehrere Redis-Treiber (Lettuce und Jedis).
Ausnahmeübersetzung in die portable Data Access-Ausnahmehierarchie von Spring für Redis-Treiberausnahmen
RedisTemplate
, das eine Abstraktion auf hoher Ebene für die Durchführung verschiedener Redis-Vorgänge, Ausnahmeübersetzung und Serialisierungsunterstützung bietet.
Pubsub-Unterstützung (z. B. ein MessageListenerContainer für nachrichtengesteuerte POJOs).
Unterstützung für Redis Sentinel und Redis Cluster.
Reaktive API mit dem Lettuce-Treiber.
JDK-, String-, JSON- und Spring Object/XML-Mapping-Serialisierer.
JDK Collection-Implementierungen zusätzlich zu Redis.
Unterstützungsklassen für atomare Zähler.
Sortier- und Pipelining-Funktionalität.
Spezielle Unterstützung für SORT, SORT/GET-Muster und zurückgegebene Massenwerte.
Redis-Implementierung für die Spring 3.1-Cache-Abstraktion.
Automatische Implementierung von Repository
-Schnittstellen einschließlich Unterstützung für benutzerdefinierte Finder-Methoden mithilfe von @EnableRedisRepositories
.
CDI-Unterstützung für Repositorys.
Für dieses Projekt gilt der Spring Code of Conduct. Durch Ihre Teilnahme wird von Ihnen erwartet, dass Sie diesen Verhaltenskodex einhalten. Bitte melden Sie inakzeptables Verhalten an [email protected].
Hier ist ein kurzer Teaser einer Anwendung, die Spring Data Redis in Java verwendet:
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 ();
}
}
Fügen Sie die Maven-Abhängigkeit hinzu:
< dependency >
< groupId >org.springframework.data</ groupId >
< artifactId >spring-data-redis</ artifactId >
< version >${version}</ version >
</ dependency >
Wenn Sie lieber die neuesten Snapshots der kommenden Hauptversion möchten, verwenden Sie unser Maven-Snapshot-Repository und deklarieren Sie die entsprechende Abhängigkeitsversion.
< 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 >
Haben Sie Probleme mit Spring Data? Wir helfen gerne!
Überprüfen Sie die Referenzdokumentation und Javadocs.
Lernen Sie die Spring-Grundlagen kennen – Spring Data baut auf dem Spring Framework auf. Auf der spring.io-Website finden Sie eine Fülle von Referenzdokumentationen. Wenn Sie gerade erst mit dem Frühling beginnen, probieren Sie einen der Ratgeber aus.
Wenn Sie ein Upgrade durchführen, sehen Sie sich die Versionshinweise für „neue und bemerkenswerte“ Funktionen an.
Stellen Sie eine Frage – wir überwachen stackoverflow.com auf Fragen mit dem Tag spring-data-redis
. Sie können auch mit der Community auf Gitter chatten.
Melden Sie Fehler mit Spring Data Redis unter github.com/spring-projects/spring-data-redis.
Spring Data nutzt Github als Issue-Tracking-System, um Fehler und Funktionsanfragen zu erfassen. Wenn Sie ein Problem ansprechen möchten, befolgen Sie bitte die folgenden Empfehlungen:
Bevor Sie einen Fehler melden, durchsuchen Sie bitte den Issue-Tracker, um zu sehen, ob jemand das Problem bereits gemeldet hat.
Wenn das Problem noch nicht vorhanden ist, erstellen Sie ein neues Problem.
Bitte geben Sie mit dem Problembericht so viele Informationen wie möglich an. Wir möchten gerne wissen, welche Version von Spring Data Sie verwenden, die JVM-Version, Stacktrace usw.
Wenn Sie Code einfügen oder einen Stack-Trace einschließen müssen, verwenden Sie Markdown-Code-Zäune „“.
Versuchen Sie nach Möglichkeit, einen Testfall oder ein Projekt zu erstellen, das das Problem reproduziert. Hängen Sie einen Link zu Ihrem Code oder eine komprimierte Datei an, die Ihren Code enthält.
Sie müssen nicht aus dem Quellcode erstellen, um Spring Data (Binärdateien in repo.spring.io) zu verwenden. Wenn Sie jedoch die neuesten und besten Versionen ausprobieren möchten, können Sie Spring Data problemlos mit dem Maven-Wrapper erstellen. Sie benötigen außerdem JDK 17 oder höher und make
. Die lokale Build-Umgebung wird in einem Makefile
verwaltet, um Redis in verschiedenen Konfigurationen (Standalone, Sentinel, Cluster usw.) herunterzuladen, zu erstellen und hochzufahren.
$ make test
Der vorhergehende Befehl führt einen vollständigen Build aus. Sie können die Befehle make start
, make stop
und make clean
verwenden, um die Umgebung selbst zu steuern. Dies ist nützlich, wenn Sie ständige Serverneustarts vermeiden möchten. Sobald alle Redis-Instanzen gestartet wurden, können Sie entweder Tests in Ihrer IDE oder den vollständigen Maven-Build ausführen:
$ ./mvnw clean install
Wenn Sie mit dem regulären mvn
-Befehl erstellen möchten, benötigen Sie Maven v3.8.0 oder höher.
Sehen Sie sich auch CONTRIBUTING.adoc an, wenn Sie Pull-Anfragen einreichen möchten, und unterzeichnen Sie insbesondere die Mitwirkendenvereinbarung vor Ihrer ersten nicht trivialen Änderung.
Durch die Erstellung der Dokumentation wird auch das Projekt erstellt, ohne dass Tests ausgeführt werden müssen.
$ ./mvnw clean install -Pantora
Die generierte Dokumentation ist unter target/antora/site/index.html
verfügbar.
Die Website spring.io enthält mehrere Anleitungen, die Schritt für Schritt zeigen, wie Sie Spring Data verwenden:
Messaging mit Redis: Erfahren Sie, wie Sie Redis als Nachrichtenbroker verwenden.
Reaktiver Zugriff auf Daten mit Redis: Erfahren Sie, wie Sie reaktiv mit Redis und Spring Data interagieren.
Spring Data Examples enthält Beispielprojekte, die bestimmte Funktionen detaillierter erläutern.
Spring Data Redis ist eine Open-Source-Software, die unter der Apache 2.0-Lizenz veröffentlicht wird.