الهدف الأساسي لمشروع Spring Data هو تسهيل إنشاء التطبيقات التي تعمل بنظام Spring والتي تستخدم تقنيات جديدة للوصول إلى البيانات مثل قواعد البيانات غير العلائقية وأطر عمل تقليل الخرائط وخدمات البيانات المستندة إلى السحابة.
توفر هذه الوحدة التكامل مع متجر Redis. تم اختباره أيضًا للعمل مع Valkey على أساس أفضل جهد طالما ظل Valkey متوافقًا إلى حد كبير مع Redis.
حزمة الاتصال كتجريد منخفض المستوى عبر برامج تشغيل Redis المتعددة (Lettuce وJedis).
ترجمة الاستثناء إلى التسلسل الهرمي لاستثناءات الوصول إلى البيانات المحمولة في Spring لاستثناءات برنامج تشغيل Redis
RedisTemplate
الذي يوفر تجريدًا عالي المستوى لتنفيذ عمليات Redis المتنوعة وترجمة الاستثناءات ودعم التسلسل.
دعم Pubsub (مثل messageListenerContainer لـ POJOs المبنية على الرسائل).
دعم Redis Sentinel وRedis Cluster.
واجهة برمجة التطبيقات التفاعلية باستخدام برنامج تشغيل الخس.
JDK وString وJSON وSpring Object/XML لتسلسل الخرائط.
تطبيقات مجموعة JDK أعلى Redis.
فئات دعم العداد الذري.
وظيفة الفرز وخطوط الأنابيب.
دعم مخصص لنمط SORT وSORT/GET والقيم المجمعة التي تم إرجاعها.
تنفيذ Redis لتجريد ذاكرة التخزين المؤقت لـ Spring 3.1.
التنفيذ التلقائي لواجهات Repository
بما في ذلك دعم أساليب البحث المخصصة باستخدام @EnableRedisRepositories
.
دعم CDI للمستودعات.
يخضع هذا المشروع لمدونة قواعد السلوك الخاصة بالربيع. من خلال المشاركة، يُتوقع منك الالتزام بقواعد السلوك هذه. يرجى الإبلاغ عن السلوك غير المقبول إلى [email protected].
فيما يلي إعلان تشويقي سريع لتطبيق يستخدم Spring Data Redis في 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 ();
}
}
أضف تبعية 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 >
هل تواجه مشكلة مع بيانات الربيع؟ نحن نحب أن نساعد!
تحقق من الوثائق المرجعية وJavadocs.
تعلم أساسيات Spring - تعتمد Spring Data على Spring Framework، قم بمراجعة موقع Spring.io الإلكتروني للحصول على مجموعة كبيرة من الوثائق المرجعية. إذا كنت قد بدأت للتو مع فصل الربيع، فجرّب أحد الأدلة.
إذا كنت تقوم بالترقية، فاطلع على ملاحظات الإصدار لمعرفة الميزات "الجديدة والجديرة بالملاحظة".
اطرح سؤالاً - نحن نراقب موقع stackoverflow.com للأسئلة الموسومة بـ spring-data-redis
. يمكنك أيضًا الدردشة مع المجتمع على Gitter.
قم بالإبلاغ عن الأخطاء باستخدام Spring Data Redis على github.com/spring-projects/spring-data-redis.
تستخدم Spring Data Github كنظام لتتبع المشكلات لتسجيل الأخطاء وطلبات الميزات. إذا كنت تريد إثارة مشكلة ما، يرجى اتباع التوصيات أدناه:
قبل تسجيل خطأ ما، يرجى البحث في أداة تعقب المشكلات لمعرفة ما إذا كان شخص ما قد أبلغ عن المشكلة بالفعل.
إذا لم تكن المشكلة موجودة بالفعل، قم بإنشاء مشكلة جديدة.
يرجى تقديم أكبر قدر ممكن من المعلومات مع تقرير المشكلة، ونود أن نعرف إصدار Spring Data الذي تستخدمه، وإصدار JVM، وStacktrace، وما إلى ذلك.
إذا كنت بحاجة إلى لصق التعليمات البرمجية، أو تضمين تتبع المكدس، فاستخدم أسوار كود Markdown ```.
حاول، إن أمكن، إنشاء حالة اختبار أو مشروع يكرر المشكلة. قم بإرفاق رابط للكود الخاص بك أو ملف مضغوط يحتوي على الكود الخاص بك.
لا تحتاج إلى البناء من المصدر لاستخدام Spring Data (الثنائيات في repo.spring.io)، ولكن إذا كنت ترغب في تجربة الأحدث والأفضل، فيمكن إنشاء Spring Data بسهولة باستخدام المجمع المخضرم. تحتاج أيضًا إلى JDK 17 أو أعلى make
. تتم إدارة بيئة البناء المحلية داخل Makefile
لتنزيل Redis وإنشائه وتشغيله في تكوينات مختلفة (مستقل، وSentinel، وCluster، وما إلى ذلك)
$ 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 على عدة أدلة توضح كيفية استخدام بيانات الربيع خطوة بخطوة:
المراسلة باستخدام Redis: تعرف على كيفية استخدام Redis كوسيط للرسائل.
الوصول إلى البيانات بشكل تفاعلي باستخدام Redis: تعرف على كيفية التفاعل بشكل تفاعلي مع Redis وSpring Data.
تحتوي أمثلة بيانات الربيع على أمثلة للمشاريع التي تشرح ميزات محددة بمزيد من التفاصيل.
Spring Data Redis هو برنامج مفتوح المصدر تم إصداره بموجب ترخيص Apache 2.0.