Rychlý start: Použití Azure Cache for Redis v Javě

V tomto rychlém startu začleníte Azure Cache for Redis do aplikace v Javě pomocí klienta Jedis Redis, abyste měli přístup k zabezpečené vyhrazené mezipaměti, která je přístupná z libovolné aplikace v Azure.

Přeskočte na kód na GitHub

Pokud chcete přeskočit přímo na kód, podívejte se na rychlý start pro Javu na GitHub.

Požadavky

• Předplatné Azure – vytvořte si ho zdarma.
• Apache Maven

Vytvoření instance Azure Cache for Redis

1. Pokud chcete vytvořit mezipaměť, přihlaste se k Azure Portal a vyberte Vytvořit prostředek.

   

2. Na stránce Nový vyberte Databáze a pak vyberte Azure Cache for Redis.

   

3. Na stránce Nový Redis Cache nakonfigurujte nastavení nové mezipaměti.

   Nastavení	Volba hodnoty	Popis
   Předplatné	Rozevírací seznam a vyberte své předplatné.	Předplatné, ve kterém chcete vytvořit tuto novou Azure Cache for Redis instance.
   Skupina prostředků	Rozevírací seznam a vyberte skupinu prostředků nebo vyberte Vytvořit novou a zadejte název nové skupiny prostředků.	Název skupiny prostředků, ve které chcete vytvořit mezipaměť a další prostředky. Když všechny prostředky aplikace dáte do jedné skupiny prostředků, můžete je snadno spravovat nebo odstraňovat společně.
   Název DNS	Zadejte jedinečný název.	Název mezipaměti musí být řetězec o 1 až 63 znacích, který obsahuje pouze číslice, písmena nebo pomlčky. Název musí začínět a končovat číslem nebo písmenem a nesmí obsahovat po sobě jdoucí pomlčky. Název hostitele instance mezipaměti bude <DNS name> .redis.cache.windows.net.
   Umístění	Rozevírací seznam a vyberte umístění.	Vyberte oblast blízko jiných služeb, které budou používat vaši mezipaměť.
   Typ mezipaměti	Rozevírací seznam a vyberte vrstvu.	Úroveň určuje velikost, výkon a funkce, které jsou pro mezipaměť k dispozici. Další informace najdete v tématu Azure Cache for Redis .

4. Vyberte kartu Sítě nebo vyberte tlačítko Sítě v dolní části stránky.

5. Na kartě Sítě vyberte metodu připojení.

6. Vyberte kartu Další: Upřesnit nebo vyberte tlačítko Další: Upřesnit v dolní části stránky.

7. Na kartě Upřesnit instance základní nebo standardní mezipaměti vyberte přepínač Povolit, pokud chcete povolit port, který není TLS. Můžete také vybrat, kterou verzi Redis chcete použít, a to buď 4, nebo 6.

   

8. Na kartě Upřesnit pro instanci služby Premium Cache nakonfigurujte nastavení pro porty bez TLS, clustering a trvalost dat. Můžete také vybrat, kterou verzi Redis chcete použít, a to buď 4, nebo 6.

9. Vyberte kartu Další: Značky nebo vyberte tlačítko Další: Značky v dolní části stránky.

10. Volitelně můžete na kartě Značky zadat název a hodnotu, pokud chcete prostředek kategorizovat.

11. Vyberte Zkontrolovat a vytvořit. Budete na kartě Zkontrolovat a vytvořit, kde Azure ověří vaši konfiguraci.

12. Jakmile se zobrazí zelená zpráva Ověření bylo předáno, vyberte Vytvořit.

Vytvoření mezipaměti chvíli trvá. Průběh můžete sledovat na Azure Cache for Redis přehledu. Když se stav zobrazí jako Spuštěno, je mezipaměť připravená k použití.

Načtení názvu hostitele, portů a přístupových klíčů z Azure Portal

Pro připojení k instanci Azure Cache for Redis potřebují klienti mezipaměti název hostitele, porty a klíč pro mezipaměť. Někteří klienti mohou tyto položky označovat trochu odlišnými názvy. Název hostitele, porty a klíče můžete získat z Azure Portal .

• Přístupové klíče získáte tak, že v levé navigaci v mezipaměti vyberete Přístupové klíče.

  

• Pokud chcete získat název hostitele a porty, v levém navigačním panelu mezipaměti vyberte Vlastnosti. Název hostitele má tvar <DNS name> .redis.cache.windows.net.

  

Nastavení pracovního prostředí

V závislosti na operačním systému přidejte proměnné prostředí pro název hostitele a primární přístupový klíč. Otevřete příkazový řádek nebo okno terminálu a nastavte následující hodnoty:

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>

Zástupné symboly nahraďte následujícími hodnotami:

• <YOUR_HOST_NAME>: Název hostitele DNS získaný v části Vlastnosti vašeho Azure Cache for Redis v Azure Portal.
• <YOUR_PRIMARY_ACCESS_KEY>: Primární přístupový klíč získaný v části Přístupové klíče vašeho Azure Cache for Redis v Azure Portal.

Vytvoření nové aplikace Java

Pomocí Mavenu vygenerujte novou aplikaci rychlého startu:

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

Přejděte do nového adresáře projektu redistest.

Otevřete soubor pom.xml a přidejte závislost pro Jedis:

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

Uložte soubor pom.xml.

Otevřete App.java a kód nahraďte následujícím kódem:

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

Tento kód ukazuje, jak se připojit k instanci Azure Cache for Redis pomocí názvu hostitele mezipaměti a klíčových proměnných prostředí. Kód také ukládá a načítá hodnotu řetězce v mezipaměti. Spouští se také příkazy PING a CLIENT LIST.

Uložte App.java.

Sestavte a spusťte aplikaci.

Spusťte následující příkaz Maven k sestavení a spuštění aplikace:

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

V níže uvedeném příkladu můžete vidět, že klíč Message měl předtím hodnotu z mezipaměti, která byla nastavena pomocí konzoly Redis na webu Azure Portal. Aplikace tuto hodnotu z mezipaměti aktualizovala. Aplikace rovněž spustila příkazy PING a CLIENT LIST.

Vyčištění prostředků

Pokud budete pokračovat k dalšímu kurzu, můžete prostředky vytvořené v tomto rychlém startu zachovat a znovu je použít.

V opačném případě, pokud jste už s ukázkovou aplikací v tomto rychlém startu skončili, můžete prostředky Azure vytvořené v tomto rychlém startu odstranit, abyste se vyhnuli poplatkům.

1. Přihlaste se k webu Azure Portal a potom vyberte Skupiny prostředků.

2. Do textového pole Filtrovat podle názvu zadejte název vaší skupiny prostředků. V pokynech v tomto článku se používala skupina prostředků TestResources. V seznamu výsledků ve vaší skupině prostředků vyberte ... a pak Odstranit skupinu prostředků.

   

3. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte to tak, že zadejte název vaší skupiny prostředků, a vyberte Odstranit.

Po chvíli bude skupina prostředků včetně všech obsažených prostředků odstraněná.

Další kroky

V tomto rychlém startu jste zjistili, jak používat Azure Cache for Redis z aplikace v Javě. Pokračujte k dalšímu rychlému startu a Azure Cache for Redis s ASP.NET aplikací.