Szybki Start: korzystanie z usługi Azure cache for Redis w języku JavaQuickstart: Use Azure Cache for Redis in Java

W tym przewodniku szybki start dodaliśmy usługę Azure cache for Redis do aplikacji Java przy użyciu klienta Jedis Redis, aby uzyskać dostęp do bezpiecznej, dedykowanej pamięci podręcznej dostępnej z dowolnej aplikacji na platformie 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.

Wymagania wstępnePrerequisites

Tworzenie usługi Azure Cache for RedisCreate an Azure Cache for Redis

  1. Aby utworzyć pamięć podręczną, zaloguj się do Azure Portal i wybierz pozycję Utwórz zasób.To create a cache, sign in to the Azure portal and select Create a resource.

    W okienku nawigacji po lewej stronie zostanie wyróżniony zasób.

  2. Na stronie Nowy wybierz pozycję bazy danych , a następnie wybierz pozycję Azure cache for Redis.On the New page, select Databases and then select Azure Cache for Redis.

    W obszarze nowe są wyróżnione bazy danych, a usługa Azure cache for Redis jest wyróżniona.

  3. Na stronie nowy Redis Cache Skonfiguruj ustawienia dla nowej pamięci podręcznej.On the New Redis Cache page, configure the settings for your new cache.

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    Nazwa DNSDNS name Podaj globalnie unikatową nazwę.Enter a globally unique name. Nazwa pamięci podręcznej musi być ciągiem z przedziału od 1 do 63 znaków, który zawiera tylko cyfry, litery lub łączniki.The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. Nazwa musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać następujących po sobie łączników.The name must start and end with a number or letter, and can't contain consecutive hyphens. Nazwa hosta wystąpienia pamięci podręcznej to <DNS name> . Redis.cache.Windows.NET.Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    SubskrypcjaSubscription Lista rozwijana i wybierz swoją subskrypcję.Drop down and select your subscription. Subskrypcja, w ramach której ma zostać utworzone nowe wystąpienie usługi Azure cache for Redis.The subscription under which to create this new Azure Cache for Redis instance.
    Grupa zasobówResource group Rozwiń i wybierz grupę zasobów lub wybierz pozycję Utwórz nową , a następnie wprowadź nową nazwę grupy zasobów.Drop down and select a resource group, or select Create new and enter a new resource group name. Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna i inne zasoby.Name for the resource group in which to create your cache and other resources. Umieszczenie wszystkich zasobów aplikacji w jednej grupie zasobów pozwala łatwo zarządzać nimi i usuwać je razem.By putting all your app resources in one resource group, you can easily manage or delete them together.
    LokalizacjaLocation Lista rozwijana i wybierz lokalizację.Drop down and select a location. Wybierz region blisko innych usług, które będą korzystać z pamięci podręcznej.Select a region near other services that will use your cache.
    Warstwa cenowaPricing tier Lista rozwijana i wybierz warstwę cenową.Drop down and select a Pricing tier. Warstwa cenowa decyduje o rozmiarze, wydajności i funkcjach dostępnych dla pamięci podręcznej.The pricing tier determines the size, performance, and features that are available for the cache. Aby uzyskać więcej informacji, zobacz Omówienie pamięci podręcznej Azure Cache for Redis.For more information, see Azure Cache for Redis Overview.
  4. Wybierz kartę Sieć lub kliknij przycisk sieci w dolnej części strony.Select the Networking tab or click the Networking button at the bottom of the page.

  5. Na karcie Sieć wybierz metodę łączności.In the Networking tab, select your connectivity method.

  6. Wybierz kartę Dalej: Zaawansowane lub kliknij przycisk Dalej: Zaawansowane w dolnej części strony.Select the Next: Advanced tab or click the Next: Advanced button on the bottom of the page.

  7. Na karcie Zaawansowane dla podstawowego lub standardowego wystąpienia pamięci podręcznej wybierz opcję Włącz przełącznik, jeśli chcesz włączyć port inny niż TLS.In the Advanced tab for a basic or standard cache instance, select the enable toggle if you want to enable a non-TLS port. Możesz również wybrać, która wersja Redis ma być używana, 4 lub (wersja zapoznawcza) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

    Redis w wersji 4 lub 6.

  8. Na karcie Zaawansowane wystąpienia pamięci podręcznej Premium Skonfiguruj ustawienia dla portu niezwiązanego z protokołem TLS, klastrowanie i trwałość danych.In the Advanced tab for premium cache instance, configure the settings for non-TLS port, clustering, and data persistence. Możesz również wybrać, która wersja Redis ma być używana, 4 lub (wersja zapoznawcza) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

  9. Wybierz kartę następne: Tagi lub kliknij przycisk Dalej: Tagi w dolnej części strony.Select the Next: Tags tab or click the Next: Tags button at the bottom of the page.

  10. Opcjonalnie na karcie Tagi wprowadź nazwę i wartość, jeśli chcesz przydzielić zasób.Optionally, in the Tags tab, enter the name and value if you wish to categorize the resource.

  11. Wybierz pozycję Przeglądanie + tworzenie.Select Review + create. Nastąpi przekierowanie do karty Recenzja + tworzenie, w której platforma Azure weryfikuje konfigurację.You're taken to the Review + create tab where Azure validates your configuration.

  12. Po wyświetleniu komunikatu o pomyślnym sprawdzeniu poprawności, wybierz pozycję Utwórz.After the green Validation passed message appears, select Create.

Tworzenie pamięci podręcznej zajmuje trochę czasu.It takes a while for the cache to create. Postęp można monitorować na stronie Przegląd usługi Azure cache for Redis.You can monitor progress on the Azure Cache for Redis Overview page. Gdy stan jest wyświetlany jako uruchomiony, pamięć podręczna jest gotowa do użycia.When Status shows as Running, the cache is ready to use.

Pobieranie nazwy hosta, portów i kluczy dostępu z Azure PortalRetrieve host name, ports, and access keys from the Azure portal

Aby nawiązać połączenie z usługą Azure cache for Redis, klienci pamięci podręcznej potrzebują nazwy hosta, portów i klucza dla pamięci podręcznej.To connect to an Azure Cache for Redis instance, cache clients need the host name, ports, and a key for the cache. Niektórzy klienci mogą odwoływać się do tych elementów przy użyciu nieco innych nazw.Some clients might refer to these items by slightly different names. Możesz uzyskać nazwę hosta, porty i klucze z Azure Portal.You can get the host name, ports, and keys from the Azure portal.

  • Aby uzyskać klucze dostępu, w obszarze nawigacji po lewej stronie wybierz pozycję klucze dostępu.To get the access keys, from your cache left navigation, select Access keys.

    Klucze usługi Azure Cache for Redis

  • Aby uzyskać nazwę hosta i porty, z okienka nawigacji po lewej stronie wybierz pozycję Właściwości.To get the host name and ports, from your cache left navigation, select Properties. Nazwa hosta ma postać <DNS name> . Redis.cache.Windows.NET.The host name is of the form <DNS name>.redis.cache.windows.net.

    Właściwości usługi Azure Cache for Redis

Konfigurowanie środowiska roboczegoSetting up the working environment

W zależności od używanego systemu operacyjnego Dodaj zmienne środowiskowe dla nazwy hosta i podstawowego klucza dostępu.Depending on your operating system, add environment variables for your Host name and Primary access key. Otwórz wiersz polecenia lub okno terminalu i skonfiguruj następujące wartości: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>

Zastąp symbole zastępcze następującymi wartościami:Replace the placeholders with the following values:

  • <YOUR_HOST_NAME>: Nazwa hosta DNS uzyskana z sekcji Właściwości w pamięci podręcznej platformy Azure dla zasobu Redis w 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>: Podstawowy klucz dostępu uzyskany z sekcji klucze dostępu w pamięci podręcznej platformy Azure dla zasobu Redis w 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.

Tworzenie nowej aplikacji JavaCreate a new Java app

Za pomocą programu Maven wygeneruj nową aplikację przewodnika Szybki Start: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

Zmień katalog projektu redistest na nowy.Change to the new redistest project directory.

Otwórz plik pom.xml i dodaj zależność dla 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>

Zapisz plik pom.xml .Save the pom.xml file.

Otwórz plik App.java i zastąp kod następującym: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();
    }
}

W tym kodzie pokazano sposób podłączania do wystąpienia usługi Azure Cache for Redis przy użyciu nazwy hosta w pamięci podręcznej i kluczowych zmiennych środowiskowych.This code shows you how to connect to an Azure Cache for Redis instance using the cache host name and key environment variables. W kodzie jest również przechowywana i pobierana wartość ciągu w pamięci podręcznej.The code also stores and retrieves a string value in the cache. Następuje wykonanie poleceń PING i CLIENT LIST.The PING and CLIENT LIST commands are also executed.

Zapisz plik App.java.Save App.java.

Skompiluj i uruchom aplikacjęBuild and run the app

Wykonaj następujące polecenie narzędzia Maven, aby skompilować i uruchomić aplikację:Execute the following Maven command to build and run the app:

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

W poniższym przykładzie widać, że klucz Message miał już w pamięci podręcznej wartość, która została ustawiona za pomocą konsoli Redis w witrynie 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. Aplikacja zaktualizowała tę wartość w pamięci podręcznej.The app updated that cached value. Aplikacja również wykonała polecenia PING i CLIENT LIST.The app also executed the PING and CLIENT LIST commands.

Ukończono aplikację Azure cache for Redis

Czyszczenie zasobówClean up resources

Jeśli zamierzasz przejść do kolejnego samouczka, możesz zachować zasoby utworzone w tym przewodniku Szybki start i użyć ich ponownie.If you will be continuing to the next tutorial, you can keep the resources created in this quickstart and reuse them.

W przeciwnym razie po zakończeniu pracy z przykładową aplikacją poradnika Szybki start możesz usunąć zasoby platformy Azure utworzone w tym poradniku Szybki start, aby uniknąć naliczania opłat.Otherwise, if you are finished with the quickstart sample application, you can delete the Azure resources created in this quickstart to avoid charges.

Ważne

Usunięcie grupy zasobów jest nieodwracalne i grupa zasobów oraz wszystkie zawarte w niej zasoby zostaną trwale usunięte.Deleting a resource group is irreversible and that the resource group and all the resources in it are permanently deleted. Uważaj, aby nie usunąć przypadkowo niewłaściwych zasobów lub grupy zasobów.Make sure that you do not accidentally delete the wrong resource group or resources. Jeśli zasoby do hostowania tego przykładu zostały utworzone wewnątrz istniejącej grupy zasobów zawierającej zasoby, które chcesz zachować, możesz usunąć każdy zasób oddzielnie z odpowiadającego mu bloku zamiast usuwać całą grupę zasobów.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. Zaloguj się do witryny Azure Portal i wybierz pozycję Grupy zasobów.Sign in to the Azure portal and select Resource groups.

  2. W polu tekstowym Filtruj według nazwy wpisz nazwę grupy zasobów.In the Filter by name textbox, type the name of your resource group. Instrukcje w tym artykule używają grupy zasobów o nazwie TestResources.The instructions for this article used a resource group named TestResources. W grupie zasobów na liście wynik wybierz pozycję ... , a następnie Usuń grupę zasobów.On your resource group in the result list, select ... then Delete resource group.

    Usunięto grupę zasobów platformy Azure

  3. Zobaczysz prośbę o potwierdzenie usunięcia grupy zasobów.You will be asked to confirm the deletion of the resource group. Wpisz nazwę grupy zasobów, aby potwierdzić, a następnie wybierz pozycję Usuń.Type the name of your resource group to confirm, and select Delete.

Po krótkim czasie grupa zasobów i wszystkie zawarte w niej zasoby zostaną usunięte.After a few moments, the resource group and all of its contained resources are deleted.

Następne krokiNext steps

W tym przewodniku Szybki start pokazano, jak korzystać z usługi Azure Cache for Redis z poziomu aplikacji Java.In this quickstart, you learned how to use Azure Cache for Redis from a Java application. Przejdź do kolejnego Szybkiego startu, w którym wyjaśniono, jak używać usługi Microsoft Azure Cache for Redis z poziomu aplikacji internetowej ASP.NET.Continue to the next quickstart to use Azure Cache for Redis with an ASP.NET web app.