Spring Data プロジェクトの主な目標は、非リレーショナル データベース、マップリデュース フレームワーク、クラウド ベースのデータ サービスなどの新しいデータ アクセス テクノロジを使用する Spring ベースのアプリケーションの構築を容易にすることです。
このモジュールは、Redis ストアとの統合を提供します。また、Valkey が Redis とほぼ互換性がある限り、ベストエフォート ベースで Valkey と連携することもテストされています。
複数の Redis ドライバー (Lettuce および Jedis) にわたる低レベルの抽象化としての接続パッケージ。
Redis ドライバー例外に対する Spring のポータブル データ アクセス例外階層への例外変換
さまざまな Redis 操作、例外変換、シリアル化サポートを実行するための高レベルの抽象化を提供するRedisTemplate
。
Pubsub サポート (メッセージ駆動型 POJO の MessageListenerContainer など)。
Redis Sentinel および Redis Cluster のサポート。
Lettuce ドライバーを使用したリアクティブ API。
JDK、String、JSON、Spring Object/XML マッピング シリアライザー。
Redis 上の JDK コレクションの実装。
アトミックカウンターサポートクラス。
ソートおよびパイプライン機能。
SORT、SORT/GET パターン、および返されるバルク値の専用サポート。
Spring 3.1 キャッシュ抽象化のための Redis 実装。
@EnableRedisRepositories
を使用したカスタム ファインダー メソッドのサポートを含む、 Repository
インターフェイスの自動実装。
リポジトリの CDI サポート。
このプロジェクトは Spring 行動規範に準拠しています。参加することにより、この行動規範を遵守することが期待されます。容認できない行為は [email protected] に報告してください。
Java で Spring Data Redis を使用するアプリケーションの簡単なティーザーを次に示します。
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 ();
}
}
Maven 依存関係を追加します。
< dependency >
< groupId >org.springframework.data</ groupId >
< artifactId >spring-data-redis</ artifactId >
< version >${version}</ version >
</ dependency >
今後のメジャー バージョンの最新のスナップショットが必要な場合は、Maven スナップショット リポジトリを使用して、適切な依存関係バージョンを宣言してください。
< 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 >
Spring Data でお困りですか?ぜひお手伝いさせていただきます!
リファレンス ドキュメントと Javadoc を確認してください。
Spring の基本を学びましょう – Spring Data は Spring Framework 上に構築されています。豊富なリファレンス ドキュメントについては spring.io Web サイトをチェックしてください。 Spring を使い始めたばかりの場合は、いずれかのガイドを試してください。
アップグレードする場合は、リリース ノートで「注目すべき新機能」を確認してください。
質問する - 私たちは、 spring-data-redis
でタグ付けされた質問について stackoverflow.com を監視します。 Gitter のコミュニティとチャットすることもできます。
Spring Data Redis のバグは、github.com/spring-projects/spring-data-redis で報告してください。
Spring Data は、問題追跡システムとして Github を使用し、バグや機能リクエストを記録します。問題を提起したい場合は、以下の推奨事項に従ってください。
バグを記録する前に、問題トラッカーを検索して、誰かがすでに問題を報告していないかどうかを確認してください。
問題がまだ存在しない場合は、新しい問題を作成します。
問題レポートにはできるだけ多くの情報を提供してください。使用している Spring Data のバージョン、JVM バージョン、Stacktrace などを知りたいと考えています。
コードを貼り付ける必要がある場合、またはスタック トレースを含める必要がある場合は、Markdown コード フェンス ``` を使用します。
可能であれば、問題を再現するテストケースまたはプロジェクトを作成してみてください。コードへのリンク、またはコードを含む圧縮ファイルを添付します。
Spring Data (repo.spring.io のバイナリ) を使用するためにソースからビルドする必要はありませんが、最新かつ最高のものを試したい場合は、Maven ラッパーを使用して Spring Data を簡単にビルドできます。 JDK 17 以降とmake
も必要です。ローカル ビルド環境はMakefile
内で管理され、さまざまな構成 (スタンドアロン、センチネル、クラスターなど) で Redis をダウンロード、ビルド、スピンアップします。
$ make test
前述のコマンドは完全なビルドを実行します。 make start
、 make stop
、およびmake clean
コマンドを使用して、環境を自分で制御できます。これは、サーバーの定期的な再起動を避けたい場合に便利です。すべての Redis インスタンスが開始されたら、IDE または完全な Maven ビルドでテストを実行できます。
$ ./mvnw clean install
通常のmvn
コマンドを使用してビルドする場合は、Maven v3.8.0 以降が必要です。
プル リクエストを送信する場合は、CONTRIBUTING.adoc も参照してください。特に、最初の重要な変更を行う前に、寄稿者同意書に署名してください。
ドキュメントをビルドすると、テストを実行せずにプロジェクトもビルドされます。
$ ./mvnw clean install -Pantora
生成されたドキュメントはtarget/antora/site/index.html
から入手できます。
spring.io サイトには、Spring Data の使用方法を段階的に示すいくつかのガイドが含まれています。
Redis を使用したメッセージング: Redis をメッセージ ブローカーとして使用する方法を学びます。
Redis を使用したリアクティブなデータ アクセス: Redis および Spring Data とリアクティブにインターフェイスする方法を学びます。
Spring Data Examples には、特定の機能をより詳細に説明するサンプル プロジェクトが含まれています。
Spring Data Redis は、Apache 2.0 ライセンスに基づいてリリースされたオープン ソース ソフトウェアです。