Démarrage rapide : Utiliser le cache Azure pour Redis avec JavaQuickstart: Use Azure Cache for Redis with Java

Dans ce guide de démarrage rapide, vous allez incorporer le cache Azure pour Redis dans une application Java à l’aide du client Redis Jedis pour avoir accès à un cache sécurisé et dédié accessible à partir de n’importe quelle application dans Azure.In this quickstart, you incorporate Azure Cache for Redis into a Java app using the Jedis Redis client to have access to a secure, dedicated cache that is accessible from any application within Azure.

PrérequisPrerequisites

Créer un cache Azure pour RedisCreate an Azure Cache for Redis

  1. Pour créer un cache, connectez-vous au portail Azure.To create a cache, first sign in to the Azure portal. Sélectionnez ensuite Créer une ressource > Bases de données > Cache Azure pour Redis.Then select Create a resource > Databases > Azure Cache for Redis.

    Menu Nouveau cache Azure pour Redis

  2. Dans Nouveau cache Azure pour Redis, configurez les paramètres du nouveau cache.In New Azure Cache for Redis, configure the settings for your new cache.

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    Nom DNSDNS name Nom globalement uniqueGlobally unique name Le nom du cache.The cache name. Il doit être une chaîne de 1 à 63 caractères et contenir uniquement des chiffres, des lettres et le caractère -.It must be a string between 1 and 63 characters and contain only numbers, letters, and the - character. Le nom du cache ne peut ni commencer ni se terminer par le caractère - et il n’accepte pas de caractères - consécutifs.The cache name cannot start or end with the - character, and consecutive - characters are not valid.
    AbonnementSubscription Votre abonnementYour subscription L’abonnement sous lequel est créée cette nouvelle instance de cache Azure pour Redis.The subscription under which this new Azure Cache for Redis instance is created.
    Groupe de ressourcesResource group TestResourcesTestResources Nom du nouveau groupe de ressources dans lequel créer votre cache.Name for the new resource group in which to create your cache. En plaçant toutes les ressources d’une application dans un groupe, vous pouvez les gérer ensemble.By putting all the resources for an app in a group, you can manage them together. Par exemple, si vous supprimez le groupe de ressources, vous supprimez également toutes les ressources associées à l’application.For example, deleting the resource group deletes all resources that are associated with the app.
    LieuLocation USA EstEast US Choisissez une région à proximité des autres services qui utilisent votre cache.Choose a region near to other services that will use your cache.
    Niveau tarifairePricing tier De base C0 (cache de 250 Mo)Basic C0 (250 MB Cache) Le niveau tarifaire détermine la taille, les performances et les fonctionnalités disponibles pour le cache.The pricing tier determines the size, performance, and features that are available for the cache. Pour plus d’informations, consultez Présentation du cache Azure pour Redis.For more information, see Azure Cache for Redis Overview.
    Épingler au tableau de bordPin to dashboard Volumes sélectionnésSelected Épinglez le nouveau cache à votre tableau de bord pour en faciliter la recherche.Pin the new cache to your dashboard to make it easy to find.

    Créer un cache Azure pour Redis

  3. Une fois les paramètres du nouveau cache configurés, sélectionnez Créer.After the new cache settings are configured, select Create.

    La création du cache peut prendre plusieurs minutes.It can take a few minutes for the cache to be created. Pour vérifier l’état d’avancement de l’opération, vous pouvez consulter le tableau de bord.To check the status, you can monitor the progress on the dashboard. Après sa création, le nouveau cache indique l’état En cours d’exécution, et il est prêt à être utilisé.After the cache has been created, it shows the status Running, and is ready for use.

    Cache Azure pour Redis créé

Récupération du nom d’hôte, des ports et des clés d’accès à l’aide du portail AzureRetrieve host name, ports, and access keys by using the Azure portal

Lors de la connexion à une instance de cache Azure pour Redis, les clients de cache ont besoin du nom d’hôte, des ports et d’une clé pour le cache.When connecting to an Azure Cache for Redis instance, cache clients need the host name, ports, and a key for the cache. Certains clients peuvent référencer ces éléments par des noms légèrement différents.Some clients might refer to these items by slightly different names. Vous pouvez récupérer ces informations dans le portail Azure.You can retrieve this information in the Azure portal.

Récupération des clés d'accès et du nom d’hôteTo retrieve the access keys and host name

  1. Pour récupérer les clés d’accès à l’aide du portail Azure, accédez à votre cache, puis sélectionnez Clés d’accès.To retrieve the access keys by using the Azure portal, go to your cache and select Access keys.

    Clés du cache Azure pour Redis

  2. Pour récupérer le nom d’hôte et les ports, sélectionnez Propriétés.To retrieve the host name and ports, select Properties.

    Propriétés du cache Azure pour Redis

Ajoutez des variables d’environnement pour votre NOM D’HÔTE et la clé d’accès Principale.Add environment variables for your HOST NAME and Primary access key. Vous allez utiliser ces variables à partir de votre code au lieu d’inclure les informations sensibles directement dedans.You will use these variables from your code instead of including the sensitive information directly in your code.

set REDISCACHEHOSTNAME=contosoCache.redis.cache.windows.net
set REDISCACHEKEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Créer une nouvelle application JavaCreate a new Java app

À l’aide de Maven, générez une nouvelle application de démarrage rapide :Using Maven, generate a new quickstart app:

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

Remplacez par le nouveau répertoire de projet redistest.Change to the new redistest project directory.

Ouvrez le fichier pom.xml et ajoutez une dépendance pour Jedis :Open the pom.xml file and add a dependency for Jedis:

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

Enregistrez le fichier pom.xml .Save the pom.xml file.

Ouvrez App.java et remplacez le code par le code suivant :Open App.java and replace the code with the following code:

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

Ce code vous montre comment se connecter à une instance de cache Azure pour Redis à l’aide du nom d’hôte de cache et des variables d’environnement de la clé.This code shows you how to connect to an Azure Cache for Redis instance using the cache host name and key environment variables. Le code stocke et récupère également une valeur de chaîne dans le cache.The code also stores and retrieves a string value in the cache. Les commandes PING et CLIENT LIST sont également exécutées.The PING and CLIENT LIST commands are also executed.

Enregistrez App.java.Save App.java.

Générer et exécuter l’applicationBuild and run the app

Exécutez la commande Maven suivante pour générer et exécuter l’application :Execute the following Maven command to build and run the app:

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

Dans l’exemple ci-dessous, vous pouvez voir que la clé Message présentait auparavant une valeur mise en cache, qui avait été définie à l’aide de la console Redis du portail Azure.In the example below, you can see the Message key previously had a cached value, which was set using the Redis Console in the Azure portal. L’application a mis à jour cette valeur mise en cache.The app updated that cached value. Elle a également exécuté les commandes PING et CLIENT LIST.The app also executed the PING and CLIENT LIST commands.

Application Cache Azure pour Redis terminée

Supprimer des ressourcesClean up resources

Si vous envisagez d’exécuter le didacticiel suivant, vous pouvez conserver les ressources créées dans le cadre de ce guide de démarrage rapide afin de les réutiliser.If you will be continuing to the next tutorial, you can keep the resources created in this quickstart and reuse them.

Sinon, si l’exemple d’application de démarrage rapide était votre dernière opération, vous pouvez supprimer les ressources Azure créées dans ce démarrage rapide afin d’éviter tout frais.Otherwise, if you are finished with the quickstart sample application, you can delete the Azure resources created in this quickstart to avoid charges.

Important

La suppression d’un groupe de ressources est définitive ; le groupe de ressources et l’ensemble des ressources qu’il contient sont supprimés de manière permanente.Deleting a resource group is irreversible and that the resource group and all the resources in it are permanently deleted. Veillez à ne pas supprimer accidentellement des ressources ou un groupe de ressources incorrects.Make sure that you do not accidentally delete the wrong resource group or resources. Si vous avez créé les ressources pour l’hébergement de cet exemple dans un groupe de ressources existant contenant des ressources que vous souhaitez conserver, vous pouvez supprimer chaque ressource individuellement à partir de son panneau respectif, au lieu de supprimer l’intégralité du groupe de ressources.If you created the resources for hosting this sample inside an existing resource group that contains resources you want to keep, you can delete each resource individually from their respective blades instead of deleting the resource group.

  1. Connectez-vous au portail Azure, puis sélectionnez Groupes de ressources.Sign in to the Azure portal and select Resource groups.

  2. Dans la zone de texte Filtrer par nom, saisissez le nom de votre groupe de ressources.In the Filter by name textbox, type the name of your resource group. Les instructions de cet article ont utilisé un groupe de ressources nommé TestResources.The instructions for this article used a resource group named TestResources. Sur votre groupe de ressources dans la liste des résultats, cliquez sur ... , puis sur Supprimer le groupe de ressources.On your resource group in the result list, select ... then Delete resource group.

    Groupe de ressources Azure supprimé

  3. Il vous sera demandé de confirmer la suppression du groupe de ressources.You will be asked to confirm the deletion of the resource group. Saisissez le nom de votre groupe de ressources à confirmer, puis sélectionnez Supprimer.Type the name of your resource group to confirm, and select Delete.

Après quelques instants, le groupe de ressources et toutes les ressources qu’il contient sont supprimés.After a few moments, the resource group and all of its contained resources are deleted.

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez appris à utiliser le cache Azure pour Redis à partir d’une application Java.In this quickstart, you learned how to use Azure Cache for Redis from a Java application. Passez au guide de démarrage rapide suivant pour utiliser le cache Azure pour Redis avec une application web ASP.NET.Continue to the next quickstart to use Azure Cache for Redis with an ASP.NET web app.