Snabb start: använda Azure cache för Redis i JavaQuickstart: Use Azure Cache for Redis in Java

I den här snabb starten införlivar du Azure cache för Redis i en Java-app med hjälp av Jedis Redis-klienten för att få åtkomst till en säker, dedikerad cache som är tillgänglig från alla program i 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.

FörutsättningarPrerequisites

Skapa en Azure Cache for RedisCreate an Azure Cache for Redis

  1. Om du vill skapa en cache loggar du in på Azure Portal och väljer skapa en resurs.To create a cache, sign in to the Azure portal and select Create a resource.

    Skapa en resurs markeras i det vänstra navigerings fönstret.

  2. Välj databaser på sidan nytt och välj sedan Azure cache för Redis.On the New page, select Databases and then select Azure Cache for Redis.

    På nytt markeras databaser och Azure cache för Redis är markerat.

  3. På sidan ny Redis cache konfigurerar du inställningarna för din nya cache.On the New Redis Cache page, configure the settings for your new cache.

    InställningSetting Föreslaget värdeSuggested value BeskrivningDescription
    DNS-namnDNS name Ange ett globalt unikt namn.Enter a globally unique name. Cache-namnet måste vara en sträng mellan 1 och 63 tecken som bara innehåller siffror, bokstäver eller bindestreck.The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. Namnet måste börja och sluta med en siffra eller en bokstav och får inte innehålla flera bindestreck i rad.The name must start and end with a number or letter, and can't contain consecutive hyphens. Din cacheposts värdnamn är <DNS name> . Redis.cache.Windows.net.Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    PrenumerationSubscription List rutan och välj din prenumeration.Drop down and select your subscription. Den prenumeration som du vill skapa den här nya Azure-cache för Redis-instansen för.The subscription under which to create this new Azure Cache for Redis instance.
    ResursgruppResource group List rutan och välj en resurs grupp, eller Välj Skapa ny och ange ett nytt resurs grupp namn.Drop down and select a resource group, or select Create new and enter a new resource group name. Namnet på resurs gruppen där du vill skapa cachen och andra resurser.Name for the resource group in which to create your cache and other resources. Genom att lägga till alla dina app-resurser i en resurs grupp kan du enkelt hantera eller ta bort dem tillsammans.By putting all your app resources in one resource group, you can easily manage or delete them together.
    PlatsLocation List rutan och välj en plats.Drop down and select a location. Välj en region nära andra tjänster som ska använda din cache.Select a region near other services that will use your cache.
    PrisnivåPricing tier List rutan och välj en pris nivå.Drop down and select a Pricing tier. Prisnivån avgör storlek, prestanda och funktioner som är tillgängliga för cacheminnet.The pricing tier determines the size, performance, and features that are available for the cache. Mer information finns i Översikt över Azure Cache for Redis.For more information, see Azure Cache for Redis Overview.
  4. Välj fliken nätverk eller klicka på knappen nätverk längst ned på sidan.Select the Networking tab or click the Networking button at the bottom of the page.

  5. På fliken nätverk väljer du anslutnings metod.In the Networking tab, select your connectivity method.

  6. Välj Nästa: fliken Avancerat eller klicka på Nästa: Avancerat längst ned på sidan.Select the Next: Advanced tab or click the Next: Advanced button on the bottom of the page.

  7. På fliken Avancerat för en Basic-eller standard-cachepost väljer du aktivera växling om du vill aktivera en icke-TLS-port.In the Advanced tab for a basic or standard cache instance, select the enable toggle if you want to enable a non-TLS port. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller (för hands version) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

    Redis-version 4 eller 6.

  8. På fliken Avancerat för Premium-cache-instans konfigurerar du inställningarna för icke-TLS-port, klustring och data beständighet.In the Advanced tab for premium cache instance, configure the settings for non-TLS port, clustering, and data persistence. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller (för hands version) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

  9. Välj fliken Nästa: Taggar eller klicka på knappen Nästa: Taggar längst ned på sidan.Select the Next: Tags tab or click the Next: Tags button at the bottom of the page.

  10. Alternativt går du till fliken taggar och anger namn och värde om du vill kategorisera resursen.Optionally, in the Tags tab, enter the name and value if you wish to categorize the resource.

  11. Välj Granska + skapa.Select Review + create. Du kommer till fliken Granska + skapa där Azure verifierar konfigurationen.You're taken to the Review + create tab where Azure validates your configuration.

  12. När meddelandet grön verifiering har skickats visas väljer du skapa.After the green Validation passed message appears, select Create.

Det tar en stund innan cacheminnet skulle skapas.It takes a while for the cache to create. Du kan övervaka förloppet på översikts sidan för Azure-cache för Redis.You can monitor progress on the Azure Cache for Redis Overview page. När statusen är igång är cacheminnet redo att användas.When Status shows as Running, the cache is ready to use.

Hämta värdnamn, portar och åtkomst nycklar från Azure PortalRetrieve host name, ports, and access keys from the Azure portal

För att ansluta till en Azure-cache för Redis-instansen behöver cache-klienterna värd namnet, portarna och en nyckel för cachen.To connect to an Azure Cache for Redis instance, cache clients need the host name, ports, and a key for the cache. Vissa klienter kan hänvisa till dessa objekt med namn som skiljer sig något.Some clients might refer to these items by slightly different names. Du kan hämta värdnamn, portar och nycklar från Azure Portal.You can get the host name, ports, and keys from the Azure portal.

  • Hämta åtkomst nycklarna genom att gå till vänster navigering i cachen och välja åtkomst nycklar.To get the access keys, from your cache left navigation, select Access keys.

    Nycklar för Azure Cache for Redis

  • För att hämta värd namnet och portarna, från din cache-vänstra navigering, väljer du Egenskaper.To get the host name and ports, from your cache left navigation, select Properties. Värd namnet är av formatet <DNS name> . Redis.cache.Windows.net.The host name is of the form <DNS name>.redis.cache.windows.net.

    Egenskaper för Azure Cache for Redis

Konfigurera arbets miljönSetting up the working environment

Beroende på vilket operativ system du använder lägger du till miljövariabler för värd namnet och den primära åtkomst nyckeln.Depending on your operating system, add environment variables for your Host name and Primary access key. Öppna en kommando tolk eller ett terminalfönster och Ställ in följande värden:Open a command prompt, or a terminal window, and set up the following values:

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 plats hållarna med följande värden:Replace the placeholders with the following values:

  • <YOUR_HOST_NAME>: DNS-värdnamnet hämtas från avsnittet Egenskaper i Azure cache för Redis-resursen i Azure Portal.<YOUR_HOST_NAME>: The DNS host name, obtained from the Properties section of your Azure Cache for Redis resource in the Azure portal.
  • <YOUR_PRIMARY_ACCESS_KEY>: Den primära åtkomst nyckeln som hämtats från avsnittet åtkomst nycklar i Azure cache för Redis-resurser i Azure Portal.<YOUR_PRIMARY_ACCESS_KEY>: The primary access key, obtained from the Access keys section of your Azure Cache for Redis resource in the Azure portal.

Skapa en ny Java-appCreate a new Java app

Generera en ny snabbstartsapp med Maven: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

Ändra till den nya redistest-projektkatalogen.Change to the new redistest project directory.

Öppna filen pom.xml och lägg till ett beroende för Jedis:Open the pom.xml file and add a dependency for Jedis:

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

Spara pom.xml -filen.Save the pom.xml file.

Öppna App.java och ersätt koden med följande kod: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 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.This code shows you how to connect to an Azure Cache for Redis instance using the cache host name and key environment variables. Koden lagrar och hämtar även ett strängvärde i cacheminnet.The code also stores and retrieves a string value in the cache. Kommandona PING och CLIENT LIST körs också.The PING and CLIENT LIST commands are also executed.

Spara App.java.Save App.java.

Kompilera och köra appenBuild and run the app

Skapa och kör appen genom att köra följande Maven-kommando:Execute the following Maven command to build and run the app:

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.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. Appen uppdatera det cachelagrade värdet.The app updated that cached value. Appen körde även kommandona PING och CLIENT LIST.The app also executed the PING and CLIENT LIST commands.

Azure cache för Redis-appen har slutförts

Rensa resurserClean up resources

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.If you will be continuing to the next tutorial, you can keep the resources created in this quickstart and reuse them.

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.Otherwise, if you are finished with the quickstart sample application, you can delete the Azure resources created in this quickstart to avoid charges.

Viktigt

Det går inte att ångra borttagningen av en resursgrupp och att resursgruppen och alla resurser i den tas bort permanent.Deleting a resource group is irreversible and that the resource group and all the resources in it are permanently deleted. Kontrollera att du inte av misstag tar bort fel resursgrupp eller resurser.Make sure that you do not accidentally delete the wrong resource group or resources. Om du har skapat resurserna som värd för det här exemplet i en befintlig resursgrupp som innehåller resurser som du vill behålla, kan du ta bort varje resurs separat från deras respektive blad istället för att ta bort resursgruppen.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. Logga in på Azure Portal och välj Resursgrupper.Sign in to the Azure portal and select Resource groups.

  2. Skriv namnet på din resurs grupp i text rutan Filtrera efter namn .In the Filter by name textbox, type the name of your resource group. Anvisningarna för den här artikeln använde en resursgrupp med namnet TestResources.The instructions for this article used a resource group named TestResources. I resurs gruppen i resultat listan väljer du ... och sedan ta bort resurs grupp.On your resource group in the result list, select ... then Delete resource group.

    Azure-resurs gruppen har tagits bort

  3. Du blir ombedd att bekräfta borttagningen av resursgruppen.You will be asked to confirm the deletion of the resource group. Skriv namnet på resurs gruppen som ska bekräftas och välj ta bort.Type the name of your resource group to confirm, and select Delete.

Efter en liten stund tas resursgruppen och resurser som finns i den bort.After a few moments, the resource group and all of its contained resources are deleted.

Nästa stegNext steps

I den här snabbstarten har du lärt dig att använda Azure Cache for Redis från ett Java-program.In this quickstart, you learned how to use Azure Cache for Redis from a Java application. Fortsätt till nästa snabbstart om du vill använda Azure Cache for Redis med en ASP.NET-webbapp.Continue to the next quickstart to use Azure Cache for Redis with an ASP.NET web app.