Jedis هو عميل Java لـ Redis مصمم للأداء وسهولة الاستخدام.
هل تبحث عن مكتبة عالية المستوى للتعامل مع تعيين الكائنات؟ انظر redis-om-spring!
تعلم مجانًا في جامعة ريديس
جرب سحابة Redis
الغوص في البرامج التعليمية للمطورين
انضم إلى مجتمع ريديس
العمل في ريديس
يدعم الإصدار الأحدث من هذه المكتبة إصدارات redis 5.0 و6.0 و6.2 و7.0 و7.2 و7.4.
يسلط الجدول أدناه الضوء على توافق الإصدار لأحدث إصدارات المكتبة وإصدارات Redis. التوافق يعني ميزات الاتصال وقدرات أوامر Redis.
نسخة جيديس | إصدارات Redis المدعومة | توافق JDK |
---|---|---|
3.9+ | 5.0 إلى 6.2 عائلة الإصدارات | 8، 11 |
>= 4.0 | الإصدار 5.0 إلى 7.2 عائلة الإصدارات | 8، 11، 17 |
>= 5.0 | الإصدار 6.0 إلى الحالي | 8، 11، 17، 21 |
>= 5.2 | الإصدار 7.2 إلى الحالي | 8، 11، 17، 21 |
للبدء في استخدام Jedis، قم أولاً بإضافته باعتباره تابعًا في مشروع Java الخاص بك. إذا كنت تستخدم Maven، فسيبدو الأمر كما يلي:
< dependency >
< groupId >redis.clients</ groupId >
< artifactId >jedis</ artifactId >
< version >5.2.0</ version >
</ dependency >
لاستخدام Jedis المتطور، تحقق هنا.
بعد ذلك، ستحتاج إلى الاتصال بـ Redis. فكر في تثبيت عامل إرساء redis-stack:
docker run -p 6379:6379 -it redis/redis-stack:latest
بالنسبة للعديد من التطبيقات، من الأفضل استخدام تجمع اتصال. يمكنك إنشاء مثيل لتجمع اتصالات Jedis كما يلي:
JedisPool pool = new JedisPool ( "localhost" , 6379 );
باستخدام مثيل JedisPool
، يمكنك استخدام كتلة Try-with-resources للحصول على اتصال وتشغيل أوامر Redis.
فيما يلي كيفية تشغيل أمر SET واحد ضمن كتلة المحاولة باستخدام الموارد :
try ( Jedis jedis = pool . getResource ()) {
jedis . set ( "clientName" , "Jedis" );
}
تنفذ مثيلات Jedis
معظم أوامر Redis. راجع Jedis Javadocs للحصول على القائمة الكاملة للأوامر المدعومة.
قد يكون استخدام كتلة Try-with-resources لكل أمر أمرًا مرهقًا، لذا قد تفكر في استخدام JedisPooled.
JedisPooled jedis = new JedisPooled ( "localhost" , 6379 );
يمكنك الآن إرسال أوامر مثل الإرسال من Jedis.
jedis . sadd ( "planets" , "Venus" );
تتيح لك Jedis الاتصال بمجموعات Redis، مما يدعم مواصفات مجموعة Redis. للقيام بذلك، ستحتاج إلى الاتصال باستخدام JedisCluster
. انظر المثال أدناه:
Set < HostAndPort > jedisClusterNodes = new HashSet < HostAndPort >();
jedisClusterNodes . add ( new HostAndPort ( "127.0.0.1" , 7379 ));
jedisClusterNodes . add ( new HostAndPort ( "127.0.0.1" , 7380 ));
JedisCluster jedis = new JedisCluster ( jedisClusterNodes );
يمكنك الآن استخدام مثيل JedisCluster
وإرسال الأوامر كما تفعل مع الاتصال المجمع القياسي:
jedis . sadd ( "planets" , "Mars" );
يتضمن Jedis دعمًا لوحدات Redis مثل RedisJSON وRediSearch.
راجع RedisJSON Jedis أو RediSearch Jedis للحصول على التفاصيل.
يدعم Jedis إعادة المحاولة وتجاوز الفشل لعمليات نشر Redis الخاصة بك. وهذا مفيد عندما:
للحصول على خيارات وأمثلة تكوين تجاوز الفشل الكاملة، راجع مستندات تجاوز فشل Jedis.
يحتوي موقع Jedis wiki على العديد من المقالات المفيدة لاستخدام Jedis.
يمكنك أيضًا التحقق من أحدث إصدارات Jedis Javadocs.
يمكن العثور على بعض أمثلة حالات الاستخدام المحددة في حزمة redis.clients.jedis.examples
الخاصة بأكواد مصدر الاختبار.
إذا واجهت مشكلة أو لديك أي أسئلة، فنحن هنا لمساعدتك!
تابعنا على Redis Discord Server أو مناقشات Jedis GitHub أو القائمة البريدية لـ Jedis.
نحن نحب مساهماتك!
تقارير الأخطاء هي موضع ترحيب دائما! يمكنك فتح تقرير خطأ على GitHub.
يمكنك أيضًا المساهمة بالوثائق - أو أي شيء لتحسين Jedis. يرجى الاطلاع على المبادئ التوجيهية للمساهمة لمزيد من التفاصيل.
Jedis مرخص بموجب ترخيص MIT.