Gyorsútmutató: Az Azure Cache for Redis használata a Javában

Ebben a rövid útmutatóban az Azure Cache for Redist egy Java-alkalmazásba építi be a Jedis Redis-ügyfél használatával. A gyorsítótár egy biztonságos, dedikált gyorsítótár, amely az Azure bármely alkalmazásából elérhető.

Ugrás a GitHubon található kódra

Klónozza a GitHubon a Java adattár rövid útmutatót .

Előfeltételek

• Azure-előfizetés – hozzon létre egyet ingyenesen
• Apache Maven

Az Azure Cache for Redis létrehozása

1. Gyorsítótár létrehozásához jelentkezzen be az Azure Portalra, és válassza az Erőforrás létrehozása lehetőséget.

   

2. Az Új lapon válassza az Adatbázisok, majd az Azure Cache for Redis lehetőséget.

   

3. Az Új Redis Cache lapon konfigurálja az új gyorsítótár beállításait.

   Beállítás	Válasszon egy értéket	Leírás
   Előfizetés	Legördülő menüben válassza ki az előfizetését.	Az előfizetés, amely alatt létre kell hozni ezt az új Azure Cache for Redis-példányt.
   Erőforráscsoport	Legördülő menüben jelöljön ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, és adjon meg egy új erőforráscsoportnevet.	Annak az erőforráscsoportnak a neve, amelyben létre kívánja hozni a gyorsítótárat és más erőforrásokat. Ha az összes alkalmazás-erőforrást egy erőforráscsoportba helyezi, egyszerűen kezelheti vagy törölheti őket.
   DNS-név	Adjon meg egy egyedi nevet.	A gyorsítótár nevének 1 és 63 karakter közötti sztringnek kell lennie, amely csak számokat, betűket vagy kötőjeleket tartalmaz. A névnek számmal vagy betűvel kell kezdődnie és végződnie, és nem tartalmazhat egymást követő kötőjeleket. A gyorsítótárpéldány állomásneve< DNS name.redis.cache.windows.net.>
   Helyen	Legördülő menüben válasszon ki egy helyet.	Válasszon ki egy régiót a gyorsítótárat használó más szolgáltatások közelében.
   Gyorsítótár típusa	Legördülő menü, és válasszon ki egy szintet.	A szint határozza meg a gyorsítótár számára elérhető méretet, teljesítményt és szolgáltatásokat. További információt az Azure Cache for Redis áttekintésében talál.

4. Válassza a Hálózat lapfület , vagy válassza a Lap alján található Hálózatkezelés gombot.

5. A Hálózatkezelés lapon válassza ki a kapcsolati módszert.

6. Válassza a Tovább: Speciális lapot, vagy a Lap alján található Tovább: Speciális gombot a Speciális lap megjelenítéséhez.

   

   • Alapszintű vagy standard gyorsítótárak esetén állítsa be a nem TLS-portok kijelölését. Kiválaszthatja azt is, hogy engedélyezni szeretné-e a Microsoft Entra-hitelesítést.
   • Prémium szintű gyorsítótár esetén konfigurálja a nem TLS-port, a fürtözés, a felügyelt identitás és az adatmegőrzés beállításait. Kiválaszthatja azt is, hogy engedélyezni szeretné-e a Microsoft Entra-hitelesítést.

7. Válassza a Tovább: Címkék lapot, vagy válassza a Következő: Címkék gombot a lap alján.

8. Ha kategorizálni szeretné az erőforrást, a Címkék lapon adja meg a nevet és az értéket.

9. Válassza az Áttekintés + létrehozás lehetőséget. Ekkor megjelenik a Véleményezés + létrehozás lap, ahol az Azure ellenőrzi a konfigurációt.

10. A zöld érvényesítési üzenet megjelenése után válassza a Létrehozás lehetőséget.

A gyorsítótár létrehozása eltarthat egy ideig. Az előrehaladást az Azure Cache for Redis áttekintési oldalán követheti nyomon. Ha az állapot futásként jelenik meg, a gyorsítótár készen áll a használatra.

Állomásnév, portok és hozzáférési kulcsok lekérése az Azure Portalról

Az Azure Cache for Redis-kiszolgáló csatlakoztatásához a gyorsítótár-ügyfélnek szüksége van a gazdagép nevére, portjára és kulcsára a gyorsítótárhoz. Egyes ügyfelek különböző neveken hivatkozhatnak ezekre az elemekre. A gazdagép nevét, portját és kulcsait az Azure Portalról szerezheti be.

• A hozzáférési kulcsok lekéréséhez a gyorsítótár bal oldali navigációs sávjáról válassza az Access-kulcsok lehetőséget.

  

• A gazdagép nevének és portjának lekéréséhez a gyorsítótár bal oldali navigációs sávjáról válassza a Tulajdonságok lehetőséget. A gazdagép neve a DNS name.redis.cache.windows.net> formátumú<.

  

A munkakörnyezet beállítása

Az operációs rendszertől függően adjon hozzá környezeti változókat a gazdagép nevéhez és az elsődleges hozzáférési kulcshoz, amelyet korábban feljegyzett. Nyisson meg egy parancssort vagy egy terminálablakot, és állítsa be a következő értékeket:

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>

Cserélje le a helyőrzőket a következő értékekre:

• <your-host-name>: Az Azure Cache for Redis-erőforrás Tulajdonságok szakaszából beszerzett DNS-gazdagép neve az Azure Portalon.
• <your-primary-access-key>: Az Azure Cache for Redis-erőforrás Hozzáférési kulcsok szakaszából beszerzett elsődleges hozzáférési kulcs az Azure Portalon.

A Java-minta ismertetése

Ebben a példában a Maven használatával futtatja a rövid útmutató alkalmazást.

1. Váltson át az új redistest projektkönyvtárra.

2. Nyissa meg a pom.xml fájlt. A fájlban a Jedik függősége látható:

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

3. Zárja be a pom.xml fájlt.

4. Nyissa meg App.java , és tekintse meg a következő kóddal rendelkező kódot:

   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();
       }
   }
   

   Ez a kód bemutatja, hogyan csatlakozhat egy Azure Cache for Redis-példányhoz a gyorsítótár-gazdagép neve és a kulcsfontosságú környezeti változók használatával. A kód emellett tárolja és lekéri gyorsítótár egyik sztringértékét. A rendszer a PING és a CLIENT LIST parancsot is végrehajtja.

5. Zárja be a App.java.

Készítsen buildet és futtassa az alkalmazást

1. Először is, ha még nem tette meg, be kell állítania a környezeti változókat a korábban leírtak szerint.

   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. Hajtsa végre a következő Maven-parancsot az alkalmazás buildeléséhez és elindításához:

   Linux

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

   Windows

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

Az alábbi kimenetben láthatja, hogy a Message kulcs korábban gyorsítótárazott értékkel rendelkezett. Az érték új értékre lett frissítve a következő használatával jedis.set: . Az alkalmazás továbbá végrehajtotta a PING és a CLIENT LIST parancsot.

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

Az erőforrások eltávolítása

Ha továbbra is használja a rövid útmutató kódot, megtarthatja az ebben a rövid útmutatóban létrehozott erőforrásokat, és újra felhasználhatja őket.

Ellenkező esetben, ha végzett a gyorsútmutató-mintaalkalmazással, törölheti az ebben a rövid útmutatóban létrehozott Azure-erőforrásokat a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem visszaállítható; az erőforráscsoport és a benne foglalt erőforrások véglegesen törlődnek. Figyeljen arra, hogy ne töröljön véletlenül erőforráscsoportot vagy erőforrásokat. Ha a minta üzemeltetéséhez létrehozott erőforrásokat egy meglévő erőforráscsoporton belül hozta létre, amely a megtartani kívánt erőforrásokat tartalmazza, az erőforráscsoport törlése helyett egyenként törölheti az egyes erőforrásokat.

1. Jelentkezzen be az Azure Portalra, és válassza az Erőforráscsoportok elemet.

2. A Szűrő név szerint szövegmezőbe írja be az erőforráscsoport nevét. A jelen cikk utasításai egy TestResources nevű erőforráscsoportot használtak. Az eredménylistában az erőforráscsoportban válassza a ... lehetőséget, majd az Erőforráscsoport törlése lehetőséget.

   

3. Írja be az erőforráscsoport nevét a törlés megerősítéséhez, majd válassza a Törlés lehetőséget.

A rendszer néhány pillanaton belül törli az erőforráscsoportot és a benne foglalt erőforrásokat.

Következő lépések

Ebben a rövid útmutatóban megtanulta, hogyan használhatja az Azure Cache for Redist Egy Java-alkalmazásból. Folytassa a következő rövid útmutatóval az Azure Cache for Redis ASP.NET webalkalmazással való használatához.

• Fejlesztés
• Kapcsolat rugalmassága
• Azure Cache for Redis és Jakarta Enterprise kiadás
• Azure Cache for Redis a Spring használatával