التشغيل السريع: استخدام ذاكرة التخزين المؤقت Azure ل Redis في Java مع عميل Jedis Redis

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

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

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

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

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

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

توضح لك الخطوات التالية كيفية إعداد بيئة العمل لتطبيق Java. يمكنك اختيار المصادقة باستخدام Azure Cache for Redis باستخدام معرف Microsoft Entra (مستحسن) أو مفاتيح الوصول.

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export USER_NAME=<user-name>
export REDIS_CACHE_PORT=10000

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export USER_NAME=<user-name>
export REDIS_CACHE_PORT=6380

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export REDIS_CACHE_KEY=<your-primary-access-key>
export REDIS_CACHE_PORT=10000

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export REDIS_CACHE_KEY=<your-primary-access-key>
export REDIS_CACHE_PORT=6380

إنشاء تطبيق Java جديد

1. استخدم maven لإنشاء تطبيق تشغيل سريع جديد:

   mvn archetype:generate \
       -DarchetypeGroupId=org.apache.maven.archetypes \
       -DarchetypeArtifactId=maven-archetype-quickstart \
       -DarchetypeVersion=1.3 \
       -DinteractiveMode=false \
       -DgroupId=example.demo \
       -DartifactId=redis-jedis-test \
       -Dversion=1.0
   

2. قم بالتغيير إلى دليل مشروع redis-jedis-test الجديد.

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

   • مصادقة معرف Microsoft Entra (مستحسن)
   • مصادقة مفتاح الوصول

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.15.0</version> <!-- {x-version-update;com.azure:azure-identity;dependency} -->
   </dependency>
   
   <dependency>
       <groupId>redis.clients</groupId>
       <artifactId>jedis</artifactId>
       <version>5.2.0</version> <!-- {x-version-update;redis.clients:jedis;external_dependency} -->
   </dependency>
   

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

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

   • مصادقة معرف Microsoft Entra (مستحسن)
   • مصادقة مفتاح الوصول

   package example.demo;
   
   import com.azure.identity.DefaultAzureCredential;
   import com.azure.identity.DefaultAzureCredentialBuilder;
   import com.azure.core.credential.TokenRequestContext;
   import redis.clients.jedis.DefaultJedisClientConfig;
   import redis.clients.jedis.Jedis;
   
   /**
    * Redis test
    *
    */
   public class App
   {
       public static void main( String[] args )
       {
   
           boolean useSsl = true;
   
           //Construct a Token Credential from Identity library, e.g. DefaultAzureCredential / ClientSecretCredential / Client CertificateCredential / ManagedIdentityCredential etc.
           DefaultAzureCredential defaultAzureCredential = new DefaultAzureCredentialBuilder().build();
   
           // Fetch a Microsoft Entra token to be used for authentication. This token will be used as the password.
                   String token = defaultAzureCredential
                           .getToken(new TokenRequestContext()
                                   .addScopes("https://redis.azure.com/.default")).block().getToken();
   
           String cacheHostname = System.getenv("REDIS_CACHE_HOSTNAME");
           String username = System.getenv("USER_NAME");
           int port = Integer.parseInt(System.getenv().getOrDefault("REDIS_CACHE_PORT", "6380"));
   
           // Connect to the Azure Cache for Redis over the TLS/SSL port using the key.
           Jedis jedis = new Jedis(cacheHostname, port, DefaultJedisClientConfig.builder()
                   .password(token) // Microsoft Entra access token as password is required.
                   .user(username) // Username is Required
                   .ssl(useSsl) // SSL Connection is Required
                   .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 تنفذ أيضًا.

6. أغلق ملف App.java.

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

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

mvn compile 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. في مجموعة الموارد في قائمة النتائج، حدد Test Resources ثم Delete resource group.

   

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

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

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

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

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