Quickstart: Azure Cache voor Redis in Java gebruiken

  • Artikel

In deze quickstart neemt u Azure Cache voor Redis op in een Java-app met behulp van de Jedis Redis-client. Uw cache is een beveiligde, toegewezen cache die toegankelijk is vanuit elke toepassing in Azure.

Ga naar de code op GitHub

Kloon de Java-quickstart voor de opslagplaats op GitHub.

Vereisten

Een Azure Cache voor Redis-instantie maken

  1. Als u een cache wilt maken, meldt u zich aan bij de Azure-portal en selecteert u Een resource maken.

    Create a resource is highlighted in the left navigation pane.

  2. Selecteer op de pagina Nieuw de optie Databases en selecteer vervolgens Azure Cache voor Redis.

    On New, Databases is highlighted, and Azure Cache for Redis is highlighted.

  3. Configureer op de pagina Nieuwe Redis-cache de instellingen voor de nieuwe cache.

    Instelling Een waarde kiezen Beschrijving
    Abonnement Open de vervolgkeuzelijst en selecteer uw abonnement. Het abonnement waarmee dit nieuwe Azure Cache voor Redis-exemplaar wordt gemaakt.
    Resourcegroep Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op. Naam voor de resourcegroep waarin de cache en andere resources moeten worden gemaakt. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
    DNS-naam Voer een unieke naam in. De cachenaam moet een tekenreeks tussen 1 en 63 tekens zijn die alleen cijfers, letters of afbreekstreepjes bevatten. De naam moet beginnen en eindigen met een cijfer of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is <DNS-naam.redis.cache.windows.net>.
    Location Open de vervolgkeuzelijst en selecteer een locatie. Selecteer een regio in de buurt van andere services die gebruikmaken van uw cache.
    Cachetype Vervolgkeuzelijst en selecteer een laag. De grootte, prestaties en functies die beschikbaar zijn voor de cache, zijn afhankelijk van de gekozen laag. Zie het Azure Cache voor Redis-overzicht voor meer informatie.

  4. Selecteer het tabblad Netwerken of selecteer de knop Netwerken onderaan de pagina.

  5. Selecteer uw verbindingsmethode op het tabblad Netwerk.

  6. Selecteer het tabblad Volgende: Geavanceerd of selecteer de knop Volgende: Geavanceerd onder aan de pagina om het tabblad Geavanceerd weer te geven.

    Screenshot showing the Advanced tab in the working pane and the available option to select.

    • Voor Basic- of Standard-caches schakelt u de selectie voor een niet-TLS-poort in. U kunt ook selecteren of u Microsoft Entra-verificatie wilt inschakelen.
    • Voor een Premium-cache configureert u de instellingen voor niet-TLS-poort, clustering, beheerde identiteit en gegevenspersistentie. U kunt ook selecteren of u Microsoft Entra-verificatie wilt inschakelen.

  7. Selecteer het tabblad Volgende: Tags of selecteer de knop Volgende: Tags onderaan de pagina.

  8. Voer desgewenst in het tabblad Tags de naam en waarde in om de resource te categoriseren.

  9. Selecteer Controleren + maken. Het tabblad Beoordelen + maken wordt weergegeven, waar uw configuratie wordt gevalideerd in Azure.

  10. Selecteer Maken nadat het groene bericht Validatie geslaagd verschijnt.

Het duurt even voordat een cache is gemaakt. U kunt de voortgang bekijken op de overzichtspagina van Azure Cache voor Redis. Als u bij StatusWordt uitgevoerd ziet staan, kunt u de cache gebruiken.

Hostnaam, poorten en toegangssleutels ophalen uit Azure Portal

Om verbinding te maken met uw Azure Cache voor Redis-server, heeft de cacheclient de hostnaam, poorten en een sleutel voor de cache nodig. Sommige clients kunnen enigszins andere namen gebruiken om naar deze items te verwijzen. U kunt de hostnaam, poorten en toegangssleutels ophalen uit Azure Portal.

  • Als u de toegangssleutels wilt ophalen, selecteert u in de linkernavigatie van de cache de optie Toegangssleutels.

    Azure Cache for Redis keys

  • Als u de hostnaam en poorten wilt ophalen, selecteert u in de linkernavigatie van de cache de optie Eigenschappen. De hostnaam is van de dns-naam> van het formulier.redis.cache.windows.net<.

    Azure Cache for Redis properties

De werkomgeving instellen

Voeg, afhankelijk van uw besturingssysteem, omgevingsvariabelen toe voor uw hostnaam en primaire toegangssleutel die u eerder hebt genoteerd. Open een opdrachtprompt, of een terminalvenster, en stel de volgende waarden in:

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

Vervang de plaatsaanduidingen door de volgende waarden:

  • <your-host-name>: De DNS-hostnaam, verkregen uit de sectie Eigenschappen van uw Azure Cache voor Redis-resource in Azure Portal.
  • <your-primary-access-key>: De primaire toegangssleutel, verkregen uit de sectie Toegangssleutels van uw Azure Cache voor Redis-resource in Azure Portal.

Inzicht in het Java-voorbeeld

In dit voorbeeld gebruikt u Maven om de quickstart-app uit te voeren.

  1. Ga naar de nieuwe projectmap redistest.

  2. Open het bestand pom.xml . In het bestand ziet u een afhankelijkheid voor Jedis:

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

  3. Sluit het pom.xml bestand.

  4. Open App.java en bekijk de code met de volgende code:

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

    Deze code laat zien hoe u verbinding kunt maken met een instantie van Azure Cache voor Redis via de omgevingsvariabelen voor hostnaam en sleutel. Met de code wordt ook een tekenreekswaarde opgeslagen in de cache en daaruit opgehaald. De opdrachten PING en CLIENT LIST worden ook uitgevoerd.

  5. Sluit de App.java.

Ontwikkel de app en voer deze uit

  1. Als u dat nog niet hebt gedaan, moet u eerst de omgevingsvariabelen instellen zoals eerder is genoteerd.

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

  2. Voer de volgende Maven-opdracht uit om de app te bouwen en uit te voeren:

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

In de volgende uitvoer ziet u dat de sleutel eerder een waarde in de Message cache had. De waarde is bijgewerkt naar een nieuwe waarde met behulp van jedis.set. De app heeft ook de opdrachten PING en CLIENT LIST uitgevoerd.

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

Resources opschonen

Als u de quickstart-code blijft gebruiken, kunt u de resources die in deze quickstart zijn gemaakt, behouden en opnieuw gebruiken.

Als u klaar bent met de quickstart-voorbeeldtoepassing, kunt u de Azure-resources die in deze quickstart zijn gemaakt, verwijderen om kosten te voorkomen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. De resourcegroep en alle bijbehorende resources worden permanent verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde resourcegroep of resources verwijdert. Als u de resources hebt gemaakt voor het hosten van dit voorbeeld in een bestaande resourcegroep die resources bevat die u wilt behouden, kunt u elke resource afzonderlijk verwijderen in plaats van de resourcegroep te verwijderen.

  1. Meld u aan bij de Azure-portal en selecteer Resourcegroepen.

  2. Typ de naam van de resourcegroep in het tekstvak Filteren op naam. In de instructies voor dit artikel is een resourcegroep met de naam TestResources gebruikt. Selecteer ... in de resourcegroep in de lijst met resultaten en vervolgens Resourcegroep verwijderen.

    Screenshot of the Azure portal that shows the Resource groups page with the Delete resource group button highlighted.

  3. Typ de naam van de resourcegroep om het verwijderen te bevestigen en selecteer Vervolgens Verwijderen.

Na enkele ogenblikken worden de resourcegroep en alle resources in de groep verwijderd.

Volgende stappen

In deze snelstart hebt u geleerd hoe u Azure Cache voor Redis gebruikt vanuit een Java-toepassing. Ga verder met de volgende snelstart om Azure Cache voor Redis te gebruiken met een ASP.NET-web-app.