Snabbstart: Använda Azure Cache for Redis i Java

I den här snabbstarten införlivar du Azure Cache for Redis i en Java-app med hjälp av Jedis Redis-klienten för att få åtkomst till en säker, dedikerad cache som kan nås från alla program i Azure.

Hoppa till koden på GitHub

Om du vill hoppa direkt till koden kan du gå till Snabbstart för Java på GitHub.

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• Apache Maven

Skapa en Azure Cache for Redis

1. Om du vill skapa ett cacheminne loggar du in Azure Portal och väljer Skapa en resurs.

   

2. På sidan Nytt väljer du Databaser och väljer sedan Azure Cache for Redis.

   

3. På sidan Ny Redis Cache konfigurerar du inställningarna för den nya cachen.

   Inställning	Välj ett värde	Beskrivning
   Prenumeration	I listrutan väljer du din prenumeration.	Prenumerationen där den nya instansen ska skapas Azure Cache for Redis instansen.
   Resursgrupp	Välj en resursgrupp i listrutan eller välj Skapa ny och ange ett nytt resursgruppnamn.	Namnet på den resursgrupp där du vill skapa ditt cacheminne och andra resurser. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans.
   DNS-namn	Ange ett unikt namn.	Cachenamnet måste vara en sträng mellan 1 och 63 tecken som endast innehåller siffror, bokstäver eller bindestreck. Namnet måste börja och sluta med en siffra eller bokstav och får inte innehålla efterföljande bindestreck. Cacheinstansens värdnamn blir <DNS name> .redis.cache.windows.net.
   Plats	Välj en plats i listrutan.	Välj en region nära andra tjänster som ska använda ditt cacheminne.
   Cachetyp	I listrutan väljer du en nivå.	Nivån avgör storlek, prestanda och funktioner som är tillgängliga för cachen. Mer information finns i Översikt över Azure Cache for Redis.

4. Välj fliken Nätverk eller välj knappen Nätverk längst ned på sidan.

5. På fliken Nätverk väljer du din anslutningsmetod.

6. Välj fliken Nästa: Avancerat eller välj knappen Nästa: Avancerat längst ned på sidan.

7. På fliken Avancerat för en basic- eller standard-cacheinstans väljer du aktivera om du vill aktivera en icke-TLS-port. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller 6.

   

8. På fliken Avancerat för premiumcacheinstansen konfigurerar du inställningarna för icke-TLS-port, klustring och datapersistence. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller 6.

9. Välj fliken Nästa: Taggar eller välj knappen Nästa: Taggar längst ned på sidan.

10. Du kan också ange namn och värde på fliken Taggar om du vill kategorisera resursen.

11. Välj Granska + skapa. Du kommer till fliken Granska + skapa där Azure verifierar din konfiguration.

12. När det gröna meddelandet Valideringen har godkänts visas väljer du Skapa.

Det tar en stund innan cacheminnet skapas. Du kan övervaka förloppet på Azure Cache for Redis översiktssidan. När Status visas som Körs är cacheminnet klart att användas.

Hämta värdnamn, portar och åtkomstnycklar från Azure Portal

För att kunna ansluta Azure Cache for Redis en instans behöver cacheklienter värdnamnet, portarna och en nyckel för cachen. Vissa klienter kan hänvisa till dessa objekt med namn som skiljer sig något. Du kan hämta värdnamn, portar och nycklar från Azure Portal.

• Om du vill hämta åtkomstnycklarna går du till det vänstra navigeringsfönstret i cacheminnet och väljer Åtkomstnycklar.

  

• Om du vill hämta värdnamnet och portarna går du till det vänstra navigeringsfönstret i cacheminnet och väljer Egenskaper. Värdnamnet har formen <DNS name> .redis.cache.windows.net.

  

Konfigurera arbetsmiljön

Beroende på operativsystemet lägger du till miljövariabler för värdnamnet och den primära åtkomstnyckeln. Öppna en kommandotolk eller ett terminalfönster och konfigurera följande värden:

set REDISCACHEHOSTNAME=<YOUR_HOST_NAME>.redis.cache.windows.net
set REDISCACHEKEY=<YOUR_PRIMARY_ACCESS_KEY>

export REDISCACHEHOSTNAME=<YOUR_HOST_NAME>.redis.cache.windows.net
export REDISCACHEKEY=<YOUR_PRIMARY_ACCESS_KEY>

Ersätt platshållarna med följande värden:

• <YOUR_HOST_NAME>: DNS-värdnamnet som hämtas från avsnittet Egenskaper i Azure Cache for Redis resurs i Azure Portal.
• <YOUR_PRIMARY_ACCESS_KEY>: Den primära åtkomstnyckeln, som hämtas från avsnittet Åtkomstnycklar i Azure Cache for Redis resurs i Azure Portal.

Skapa en ny Java-app

Generera en ny snabbstartsapp med Maven:

mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.3 -DgroupId=example.demo -DartifactId=redistest -Dversion=1.0

Ändra till den nya redistest-projektkatalogen.

Öppna filen pom.xml och lägg till ett beroende för Jedis:

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

Spara pom.xml fil.

Öppna App.java och ersätt koden med följande kod:

package example.demo;

import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisShardInfo;

/**
 * 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.
        JedisShardInfo shardInfo = new JedisShardInfo(cacheHostname, 6380, useSsl);
        shardInfo.setPassword(cachekey); /* Use your access key. */
        Jedis jedis = new Jedis(shardInfo);      

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

Den här koden visar hur du ansluter till en Azure Cache for Redis-instans med hjälp av cache-värdnamnet och viktiga miljövariabler. Koden lagrar och hämtar även ett strängvärde i cacheminnet. Kommandona PING och CLIENT LIST körs också.

Spara App.java.

Kompilera och köra appen

Skapa och kör appen genom att köra följande Maven-kommando:

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

I exemplet nedan ser du att Message-nyckeln tidigare hade ett cachelagrat värde som angavs med Redis-konsolen i Azure Portal. Appen uppdatera det cachelagrade värdet. Appen körde även kommandona PING och CLIENT LIST.

Rensa resurser

Om du ska fortsätta till nästa självstudie kan du behålla resurserna som du har skapat i den här självstudien och använda dem igen.

Om du är klar med exempelappen för snabbstart kan du ta bort Azure-resurserna som du skapade i snabbstarten för att undvika kostnader.

1. Logga in på Azure Portal och välj Resursgrupper.

2. I textrutan Filtrera efter namn skriver du namnet på din resursgrupp. Anvisningarna för den här artikeln använde en resursgrupp med namnet TestResources. I din resursgrupp i resultatlistan väljer du ... och sedan Ta bort resursgrupp.

   

3. Du blir ombedd att bekräfta borttagningen av resursgruppen. Skriv namnet på resursgruppen för att bekräfta och välj Ta bort.

Efter en liten stund tas resursgruppen och resurser som finns i den bort.

Nästa steg

I den här snabbstarten har du lärt dig att använda Azure Cache for Redis från ett Java-program. Fortsätt till nästa snabbstart om du vill använda Azure Cache for Redis med en ASP.NET-webbapp.