Quickstart: Azure Cache voor Redis gebruiken in Java met Jedis Redis-client

2025-05-20
Van toepassing op: ✅ Azure Cache for Redis, ✅ Azure Managed Redis

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.

Kloon de Java-quickstart voor de opslagplaats op GitHub.

Vereiste voorwaarden

Azure-abonnement: u kunt een gratis abonnement nemen
Apache Maven

Een Azure Managed Redis-exemplaar maken

Als u een Azure Managed Redis-exemplaar wilt maken, meldt u zich aan bij Azure Portal en selecteert u Een resource maken.
Typ op de pagina Nieuw in het zoekvak Azure Cache voor Redis.

Configureer op het tabblad Nieuwe Redis Cache de instellingen voor uw nieuwe cache bij Basisinstellingen.

Configuratie	Een waarde kiezen	Beschrijving
Abonnement	Kies uit de vervolgkeuzelijst en selecteer uw abonnement.	Het abonnement waaronder u dit nieuwe Azure Managed Redis-exemplaar wilt maken.
Resourcegroep	Klap het menu uit en selecteer een resourcegroep, of kies Nieuwe maken en geef een nieuwe resourcegroepnaam in.	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.
Naam	Voer een naam in die uniek is in de regio.	De cachenaam moet een tekenreeks tussen 1 en 63 tekens zijn in combinatie met de regionaam van de cache die alleen cijfers, letters of afbreekstreepjes bevat. (Als de cachenaam minder dan 45 tekens lang is, moet deze in alle momenteel beschikbare regio's werken.) De naam moet beginnen en eindigen met een getal of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is `\<DNS name\>.\<Azure region\>.redis.azure.net`.
Regio	Open de vervolgkeuzelijst en selecteer een locatie.	Azure Managed Redis is beschikbaar in geselecteerde Azure-regio's.
Gegevenslaag	Selecteer in-memory voor hoge prestaties of Flash voor lagere prestatiecaches	De lagen in het geheugen zijn evenwichtig, geoptimaliseerd voor geheugen en geoptimaliseerd voor rekenkracht. Gebruik de Flash-laag om gegevensopslag in het geheugen (RAM) en ssd(on-disk) te gebruiken.
Cachegrootte	Open de vervolgkeuzelijst en selecteer een grootte.	De cachegrootte is afhankelijk van de laag. De kleinste grootte is een gebalanceerd niveau. De grootste in-memory laag is een Geheugen Geoptimaliseerde laag.
prestatie	Klap het menu uit en selecteer een prestatievoorkeur.	De prestaties zijn afhankelijk van het aantal vCPU's. Het aantal vCPU's verschilt per laag. Compute Optimized heeft de meeste vCPU's.

Zie De juiste laag kiezen voor hulp bij het kiezen van de juiste prestatielaag.

Belangrijk

Alle in-memory lagen die meer dan 120 GB aan opslagruimte gebruiken, zijn in publieke preview, inclusief Geheugen Geoptimaliseerde M150 en hoger; Gebalanceerde B150 en hoger; en Rekenkracht Geoptimaliseerde X150 en hoger. Al deze lagen en hoger bevinden zich in openbare preview.

Alle voor Flash geoptimaliseerde lagen bevinden zich in openbare preview.

Selecteer Volgende: Netwerken en selecteer een openbaar eindpunt of een privé-eindpunt.
Selecteer Volgende: Actieve geo-replicatie. Als u actieve geo-replicatie wilt gebruiken, moet deze worden ingeschakeld tijdens het inrichten. Caches zonder actieve geo-replicatie kunnen later niet worden toegevoegd aan of deelnemen aan actieve geo-replicatiegroepen. Zie Actieve geo-replicatie configureren voor Azure Managed Redis-exemplaren voor meer informatie.
Selecteer het tabblad Volgende: Geavanceerd .

Configureer alle Redis-modules die u wilt toevoegen aan het exemplaar.

Standaard voor een nieuwe beheerde cache:
- Microsoft Entra-id is ingeschakeld.
- Verificatie van toegangssleutels is uitgeschakeld om veiligheidsredenen.
Belangrijk

Voor optimale beveiliging wordt u aangeraden Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen tegen uw cache te autoriseren, indien mogelijk. Autorisatie met behulp van Microsoft Entra ID en beheerde identiteiten biedt superieure beveiliging en gebruiksgemak ten opzichte van autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatievoor meer informatie over het gebruik van beheerde identiteiten met uw cache.

Clusteringbeleid instellen:
- Enterprise gebruiken om RedisSearch of andere modules te gebruiken
- GEBRUIK OSS voor een geclusterde cache.
- Gebruik niet-geclusterde (preview) voor een niet-geclusterde cache.
Zie Clusterbeleid voor meer informatie over het kiezen van Clusterbeleid.

Belangrijk

U kunt het clusteringsbeleid van een Azure Managed Redis-exemplaar niet wijzigen nadat u het hebt gemaakt. Als u RediSearch gebruikt , is het clusterbeleid voor ondernemingen vereist en NoEviction wordt het enige verwijderingsbeleid ondersteund.

Belangrijk

Als u dit cache-exemplaar in een geo-replicatiegroep gebruikt, kan verwijderingsbeleid niet worden gewijzigd nadat het exemplaar is gemaakt. Zorg ervoor dat u het verwijderingsbeleid van uw primaire knooppunten kent voordat u de cache maakt. Zie Vereisten voor actieve geo-replicatie voor meer informatie over actieve geo-replicatie.

Belangrijk

U kunt modules niet wijzigen nadat u een cache-exemplaar hebt gemaakt. Modules moeten zijn ingeschakeld op het moment dat u een Azure Cache voor Redis exemplaar maakt. Er is geen optie om de configuratie van een module in te schakelen nadat u een cache hebt gemaakt.
Selecteer Volgende: Tags en overslaan.
Selecteer Volgende: Beoordelen en maken.
Controleer de instellingen en selecteer Maken.

Het duurt enkele minuten voordat het Redis-exemplaar is gemaakt. U kunt de voortgang controleren op de overzichtspagina van Azure Managed Redis. Wanneer Status als Wordt uitgevoerd verschijnt, is de cache klaar voor gebruik.

Een Azure Cache voor Redis-instantie maken

Zoek en selecteer Azure Cache voor Redis in Azure Portal.
Op de pagina Azure Cache voor Redis selecteer je Maken>Azure Cache voor Redis.
Configureer op het tabblad Basis van de pagina Nieuwe Redis Cache de volgende instellingen:
- Abonnement: selecteer het abonnement dat u wilt gebruiken.
- Resourcegroep: Selecteer een resourcegroep of selecteer Nieuwe maken en voer een nieuwe resourcegroepnaam in. Door al uw app-resources in dezelfde resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
- Naam: Voer een cachenaam in die uniek is in de regio. De naam moet:
  - Wees een tekenreeks van 1 tot 63 tekens.
  - Alleen cijfers, letters en afbreekstreepjes bevatten.
  - Begin en eindig met een getal of letter.
  - Geen opeenvolgende afbreekstreepjes bevatten.
- Regio: Selecteer een Azure-regio in de buurt van andere services die gebruikmaken van uw cache.
- Cache-SKU: selecteer een SKU om de beschikbare grootten, prestaties en functies voor uw cache te bepalen.
- Cachegrootte: Selecteer een cachegrootte. Zie het overzicht van Azure Cache voor Redis voor meer informatie.
Selecteer het tabblad Netwerken of selecteer Volgende: Netwerken.
Selecteer op het tabblad Netwerken een connectiviteitsmethode die u voor de cache wilt gebruiken. Privé-eindpunt wordt aanbevolen voor beveiliging. Als u Privé-eindpunt selecteert, selecteert u Privé-eindpunt toevoegen en maakt u het privé-eindpunt.
Selecteer het tabblad Geavanceerd of selecteer Volgende: Geavanceerd.
Configureer in het deelvenster Geavanceerd de volgende opties:
- Selecteer Microsoft Entra-verificatie of verificatie met toegangssleutels. Microsoft Entra-verificatie is standaard ingeschakeld.
- Kies of u de niet-TLS-poort wilt inschakelen .
- Voor een Premium-cache kunt u beschikbaarheidszones configureren of uitschakelen. U kunt beschikbaarheidszones niet uitschakelen nadat de cache is gemaakt. Voor een Standard-cache worden beschikbaarheidszones automatisch toegewezen. Beschikbaarheidszones zijn niet beschikbaar voor de Basic-SKU.
- Voor een Premium-cache configureert u de instellingen voor het aantal replica's, clustering en Shard count, door het systeem toegewezen beheerde identiteit en gegevenspersistentie.
In de volgende afbeelding ziet u het tabblad Geavanceerd voor de Standard-SKU.

Belangrijk

Gebruik Microsoft Entra ID met beheerde identiteiten om aanvragen voor uw cache te autoriseren, indien mogelijk. Autorisatie met Behulp van Microsoft Entra ID en beheerde identiteit biedt betere beveiliging en is eenvoudiger te gebruiken dan autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatievoor meer informatie over het gebruik van beheerde identiteiten met uw cache.
Selecteer eventueel het tabblad Tags of selecteer Volgende: Tags en voer tagnamen en waarden in om uw cachebronnen te categoriseren.
Selecteer Beoordelen en maken en zodra de validatie is geslaagd, selecteert u Maken.

De implementatie van de nieuwe cache duurt enkele minuten. U kunt de voortgang van de implementatie controleren op de pagina Azure Cache voor Redis in de portal. Wanneer de cachestatusActief is, is de cache gereed voor gebruik.

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 hostnaam en poorten voor uw cache wilt ophalen, selecteert u Overzicht in het menu Resource. De hostnaam is van de vorm <DNS name>.redis.cache.windows.net.
Als u de toegangssleutels wilt ophalen, selecteert u Verificatie in het menu Resource. Selecteer vervolgens het tabblad Toegangstoetsen .

De werkomgeving instellen

In de volgende stappen ziet u hoe u de werkomgeving voor de Java-app instelt. U kunt ervoor kiezen om te verifiëren met Azure Cache voor Redis met behulp van Microsoft Entra ID (aanbevolen) of toegangssleutels.

Microsoft Entra ID-verificatie (aanbevolen)
toegangssleutelverificatie

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

Vervang de tijdelijke aanduidingen door de volgende waarden:

<your-host-name>: de DNS-hostnaam. Als u de hostnaam en poorten voor uw cache wilt ophalen, selecteert u Overzicht in het menu Resource. De hostnaam is van de vorm <DNS name>.redis.cache.windows.net.
<user-name>: Object-id van uw beheerde identiteit of service-principal.

U kunt de gebruikersnaam ophalen met behulp van de volgende stappen:
1. Navigeer in Azure Portal naar uw Azure Cache voor Redis-exemplaar.
2. Selecteer Data Access Configuration in het navigatiedeelvenster.
3. Zoek op het tabblad Redis-gebruikers de kolom Gebruikersnaam .

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

Vervang de tijdelijke aanduidingen door de volgende waarden:

<your-host-name>: de DNS-hostnaam. Als u de hostnaam en poorten voor uw cache wilt ophalen, selecteert u Overzicht in het menu Resource. De hostnaam is van de vorm <DNS name>.redis.cache.windows.net.
<your-primary-access-key>: De primaire toegangssleutel. Als u de toegangssleutels wilt ophalen, selecteert u Verificatie in het menu Resource. Selecteer vervolgens het tabblad Toegangstoetsen .

Een nieuwe Java-app maken

Maven gebruiken om een nieuwe quickstart-app te genereren:

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

Ga naar de nieuwe projectmap redis-jedis-test .

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

Microsoft Entra ID-verificatie (aanbevolen)
toegangssleutelverificatie

<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>

Belangrijk

Microsoft raadt het gebruik van Microsoft Entra ID-verificatie aan voor de veiligste verificatie-ervaring in plaats van wachtwoorden of toegangssleutels te gebruiken. Toegangssleutels vereisen een hoge mate van vertrouwen in de toepassing en dragen risico's die niet aanwezig zijn bij het gebruik van Microsoft Entra-id. Gebruik de toegangssleutels alleen als Microsoft Entra ID-verificatie niet haalbaar is.

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

Sluit het pom.xml bestand.

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

Microsoft Entra ID-verificatie (aanbevolen)
toegangssleutelverificatie

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

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("REDIS_CACHE_HOSTNAME");
        String cachekey = System.getenv("REDIS_CACHE_KEY");
        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(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.

Sluit het App.java-bestand .

De app bouwen en uitvoeren

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

mvn compile 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

De hulpbronnen opschonen

Als u van plan bent om door te gaan met de volgende zelfstudie, 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 bron of bronngroep 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.

Meld u aan bij de Azure-portal en selecteer Resourcegroepen.
Typ de naam van de resourcegroep in het tekstvak Filteren op naam. In de instructies voor dit artikel is een resourcegroep met de naam TestResourcesgebruikt. Selecteer In de resourcegroep in de lijst met resultaten testresources en vervolgens Resourcegroep verwijderen.
Typ de naam van de resourcegroep om het verwijderen te bevestigen en selecteer Vervolgens Verwijderen.

Na enkele ogenblikken worden de resourcegroep en alle daarin opgenomen resources 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.

Delen via

Quickstart: Azure Cache voor Redis gebruiken in Java met Jedis Redis-client

Ga naar de code op GitHub

Vereiste voorwaarden

Een Azure Managed Redis-exemplaar maken

Een Azure Cache voor Redis-instantie maken

Hostnaam, poorten en toegangssleutels ophalen uit Azure Portal

De werkomgeving instellen

Een nieuwe Java-app maken

De app bouwen en uitvoeren

De hulpbronnen opschonen

Volgende stappen

Feedback

Aanvullende resources