التشغيل السريع: استخدم Azure Cache لـ Redis في Java

في التشغيل السريع هذا، تقوم بدمج Azure Cache for Redis في تطبيق Java باستخدام عميل Jedis Redis. ذاكرة التخزين المؤقت الخاصة بك هي ذاكرة تخزين مؤقت آمنة ومخصصة يمكن الوصول إليها من أي تطبيق داخل Azure.

انتقل إلى الكود على GitHub

استنساخ البدء السريع لـ repo Java على GitHub.

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجاني
• Apache Maven

إنشاء Azure Cache for Redis

1. لإنشاء ذاكرة تخزين مؤقت، قم بتسجيل الدخول إلى منصة Azure وحدد إنشاء مورد.

   

2. في صفحة بدء الاستخدام ، اكتب ذاكرة التخزين المؤقت Azure ل Redis في مربع البحث. وبعد ذلك، حدد إنشاء.

   

3. في صفحة New Redis Cache ، قم بتكوين إعدادات ذاكرة التخزين المؤقت.

   الإعدادات	اختيار قيمة	‏‏الوصف
   الاشتراك	اضغط على القائمة المنسدلة وحدد اشتراكك.	الاشتراك الذي يتم بموجبه إنشاء مثيل Azure Cache الجديد لـ Redis.
   مجموعة الموارد	حدد مجموعة موارد، أو حدد "إCreate new"، ثم أدخل اسماً فريداً لمجموعة الموارد الجديدة.	اسم مجموعة الموارد المراد إنشاء ذاكرة التخزين المؤقت والموارد الأخرى فيها. وعبر وضع جميع موارد التطبيق في مجموعة موارد واحدة، يمكنك إدارتها أو حذفها بسهولة.
   اسم DNS	أدخل اسمًا فريدًا.	يجب أن يكون اسم ذاكرة التخزين المؤقت عبارة عن سلسلة بين 1 و63 حرفًا تحتوي فقط على أرقام أو أحرف أو واصلات. لا بد أن يبدأ الاسم وينتهي برقم أو حرف، ولا يمكن أن يحتوي على واصلات متتالية. اسم مضيف مثيل ذاكرة التخزين المؤقت هو <اسم DNS.redis.cache.windows.net>.
   Location	من القائمة المنسدلة، حدد موقعاً.	حدد منطقة بالقرب من الخدمات الأخرى التي تستخدم ذاكرة التخزين المؤقت.
   ذاكرة التخزين المؤقت SKU	منسدلة وحدد SKU.	تحدد SKU معلمات الحجم والأداء والميزات المتوفرة لذاكرة التخزين المؤقت. لمزيد من المعلومات، راجع Azure Cache من أجل Redis Overview.
   حجم ذاكرة التخزين المؤقت	القائمة المنسدلة وحدد حجم ذاكرة التخزين المؤقت	لمزيد من المعلومات، راجع Azure Cache من أجل Redis Overview.

4. حدد علامة التبويب Networking أو انقر فوق زر Networking في أسفل الصفحة.

5. في علامة التبويب شبكة الاتصال، حدد أسلوب الاتصال.

6. حدد علامة التبويب Next: Advanced أو حدد الزر Next: Advanced أسفل الصفحة لمشاهدة علامة التبويب Advanced.

   

   • بالنسبة لذاكرة التخزين المؤقت الأساسية أو القياسية، قم بتبديل التحديد لمنفذ غير TLS. يمكنك أيضا تحديد ما إذا كنت تريد تمكين مصادقة Microsoft Entra.
   • بالنسبة لذاكرة التخزين المؤقت Premium، قم بتكوين الإعدادات لمنفذ غير TLS والتكتلة والهوية المدارة واستمرارية البيانات. يمكنك أيضا تحديد ما إذا كنت تريد تمكين مصادقة Microsoft Entra.

7. حدد علامة Next: Tags أو حدد الزر Next: Tags في أسفل الصفحة.

8. اختياريا، من علامة التبويب أدخل الاسم والقيمة إذا كنت ترغب في تصنيف المورد.

9. حدد "Review + create". يتم نقلك إلى علامة التبويب Review + create إذ يقوم Azure بالتحقق من صحة التكوين الخاص بك.

10. بعد ظهور رسالة "التحقق من الصحة" الخضراء، حدد إنشاء.

يستغرق إنشاء ذاكرة التخزين المؤقت بعض الوقت. يمكنك مراقبة التقدم المحرز فيAzure Cache لـصفحة Redis الخاصة بالنظرة العامة. عندما تظهر الحالة ك تشغيل، تكون ذاكرة التخزين المؤقت جاهزة للاستخدام.

استرجع اسم المضيف والمنافذ ومفاتيح الوصول من مدخل Azure

لتوصيل مخزن Azure الخاص بك لخادم Redis، يحتاج العميل المخزن إلى اسم المضيف والمنافذ ومفتاح للتخزين المؤقت. قد يشير بعض العملاء إلى هذه العناصر بأسماء مختلفة قليلًا. يمكنك الحصول على اسم المضيف والمنافذ والمفاتيح من مدخل Microsoft Azure.

• للحصول على مفاتيح الوصول، حدد Authentication من قائمة Resource. ثم حدد علامة التبويب مفاتيح الوصول.

  

• للحصول على اسم المضيف والمنافذ لذاكرة التخزين المؤقت، حدد نظرة عامة من قائمة الموارد. اسم المضيف هو من نموذج<DNS name>.redis.cache.windows.net.

  

إعداد بيئة العمل

استنادا إلى نظام التشغيل الخاص بك، أضف متغيرات البيئة لاسم المضيف ومفتاح الوصول الأساسي الذي لاحظته سابقا. افتح موجه أوامر أو نافذة طرفية ثم قم بإعداد القيم التالية:

Linux

export REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
export REDISCACHEKEY=<your-primary-access-key>

Windows

set REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
set REDISCACHEKEY=<your-primary-access-key>

استبدل العناصر النائبة بالقيم التالية:

• <your-host-name>: اسم مضيف DNS، الذي تم الحصول عليه من قسم الخصائص في Azure Cache لمورد Redis في مدخل Azure.
• <your-primary-access-key>: مفتاح الوصول الأساسي، الذي تم الحصول عليه من قسم مفاتيح الوصول في مورد ذاكرة التخزين المؤقت لـ Azure لـ Redis في مدخل Azure.

فهم نموذج Java

في هذه العينة، يمكنك استخدام Maven لتشغيل تطبيق التشغيل السريع.

1. تغيير إلى دليل المشروع إعادة تقسيم جديد.

2. افتح ملف pom.xml. في الملف، ترى تبعية ل Jedis:

   <dependency>
     <groupId>redis.clients</groupId>
     <artifactId>jedis</artifactId>
     <version>4.1.0</version>
     <type>jar</type>
     <scope>compile</scope>
   </dependency>
   

3. أغلق ملف pom.xml.

4. افتح App.java وسترى التعليمات البرمجية بالرمز التالي:

   package example.demo;
   
   import redis.clients.jedis.DefaultJedisClientConfig;
   import redis.clients.jedis.Jedis;
   
   /**
    * Redis test
    *
    */
   public class App 
   {
       public static void main( String[] args )
       {
   
           boolean useSsl = true;
           String cacheHostname = System.getenv("REDISCACHEHOSTNAME");
           String cachekey = System.getenv("REDISCACHEKEY");
   
           // Connect to the Azure Cache for Redis over the TLS/SSL port using the key.
           Jedis jedis = new Jedis(cacheHostname, 6380, DefaultJedisClientConfig.builder()
               .password(cachekey)
               .ssl(useSsl)
               .build());
   
           // Perform cache operations using the cache connection object...
   
           // Simple PING command
           System.out.println( "\nCache Command  : Ping" );
           System.out.println( "Cache Response : " + jedis.ping());
   
           // Simple get and put of integral data types into the cache
           System.out.println( "\nCache Command  : GET Message" );
           System.out.println( "Cache Response : " + jedis.get("Message"));
   
           System.out.println( "\nCache Command  : SET Message" );
           System.out.println( "Cache Response : " + jedis.set("Message", "Hello! The cache is working from Java!"));
   
           // Demonstrate "SET Message" executed as expected...
           System.out.println( "\nCache Command  : GET Message" );
           System.out.println( "Cache Response : " + jedis.get("Message"));
   
           // Get the client list, useful to see if connection list is growing...
           System.out.println( "\nCache Command  : CLIENT LIST" );
           System.out.println( "Cache Response : " + jedis.clientList());
   
           jedis.close();
       }
   }
   

   يوضح هذا الرمز كيفية الاتصال بمثيل ذاكرة التخزين المؤقت Azure لـ Redis باستخدام اسم مضيف ذاكرة التخزين المؤقت ومتغيرات بيئة المفتاح. كما تقوم التعليمات البرمجية بتخزين قيمة سلسلة واستردادها في ذاكرة التخزين المؤقت. أوامر PING وCLIENT LIST تنفذ أيضًا.

5. أغلق App.java.

إنشاء وتشغيل التطبيق

1. أولا، إذا لم تكن قد قمت بالفعل، يجب تعيين متغيرات البيئة كما هو مشار إليه سابقا.

   Linux

   export REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
   export REDISCACHEKEY=<your-primary-access-key>
   

   Windows

   set REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
   set REDISCACHEKEY=<your-primary-access-key>
   

2. تنفيذ أوامر Maven التالية لإنشاء التطبيق وتشغيله:

   Linux

   mvn compile
   mvn exec:java -D exec.mainClass=example.demo.App
   

   Windows

   mvn compile
   mvn exec:java -D exec.mainClass=example.demo.App
   

في الإخراج التالي، يمكنك أن ترى أن Message المفتاح كان له قيمة مخزنة مؤقتا مسبقا. تم تحديث القيمة إلى قيمة جديدة باستخدام jedis.set. قام التطبيق أيضًا بتنفيذ PING وأوامر CLIENT LIST.

Cache Command  : Ping
Cache Response : PONG

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java!

Cache Command  : SET Message
Cache Response : OK

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java!

Cache Command  : CLIENT LIST
Cache Response : id=777430 addr=             :58989 fd=22 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=32768 obl=0 oll=0 omem=0 ow=0 owmem=0 events=r cmd=client numops=6

تنظيف الموارد

إذا واصلت استخدام رمز التشغيل السريع، يمكنك الاحتفاظ بالموارد التي تم إنشاؤها في هذا التشغيل السريع وإعادة استخدامها.

وإلا، في حال كنت قد انتهيت من تطبيق نموذج التشغيل السريع، يمكنك حذف موارد Azure التي تم إنشاؤها في هذه البداية السريعة لتجنب المصاريف.

هام

لا يمكن التراجع عن حذف مجموعة الموارد، ويتم حذف مجموعة الموارد وجميع الموارد الموجودة فيها نهائيًّا. تأكد من عدم حذف مجموعة الموارد الخاطئة أو الموارد غير الصحيحة بطريق الخطأ. إذا قمت بإنشاء الموارد لاستضافة هذا النموذج داخل مجموعة موارد موجودة تحتوي على الموارد التي تريد الاحتفاظ بها، يمكنك حذف كل مورد على حدة بدلا من حذف مجموعة الموارد.

1. سجل الدخول إلىمدخل Azureوحددمجموعات الموارد.

2. في المربع Filter by name اكتب اسم مجموعة الموارد. استخدمت إرشادات هذه المقالة مجموعة موارد تسمى TestResources. في مجموعة الموارد في قائمة النتائج، حدد ... ثم حذف مجموعة الموارد.

   

3. اكتب اسم مجموعة الموارد لتأكيد الحذف ثم حدد حذف.

بعد لحظات قليلة، يتم حذف مجموعة الموارد وكافة الموارد المضمنة.

الخطوات التالية

في هذه البداية السريعة، تعلمت كيفية استخدام Azure Cache لـ Redis من تطبيق Java. تابع إلى التشغيل السريع التالي لاستخدام Azure Cache for Redis مع تطبيق ويب ASP.NET.

• التطوير
• مرونة الاتصال
• ذاكرة التخزين المؤقت Azure ل Redis مع Jakarta EE
• ذاكرة التخزين المؤقت Azure ل Redis مع Spring