Inicio rápido: uso de Azure Cache for Redis con una aplicación de Java

En este inicio rápido, se incorpora Azure Redis Cache a una aplicación Java mediante el cliente de Redis Jedis. La aplicación se conecta a una caché segura y dedicada a la que se puede acceder desde cualquier aplicación de Azure.

Ir al código

En este inicio rápido se usa la característica de arquetipo Maven para generar andamiaje para una aplicación de Java. En el inicio rápido se describe cómo configurar el código para crear una aplicación funcional que se conecte a Azure Cache for Redis.

Si quiere ir directamente al código, consulte el ejemplo de inicio rápido de Java en GitHub.

Requisitos previos

• Suscripción a Azure. Crear una cuenta gratuita
• Apache Maven

Creación de una caché

1. Para crear una caché, inicie sesión en Azure Portal. En el menú de Azure Portal, seleccione Crear un recurso.

   

2. En el panel Comenzar, escriba Azure Cache for Redis en la barra de búsqueda. En los resultados de la búsqueda, encuentre Azure Cache for Redis y a continuación, seleccioneCrear.

   

3. En el panel Nueva Redis Cache, en la pestaña Aspectos básicos, configure las siguientes opciones para la memoria caché:

   Configuración	Acción	Descripción
   Suscripción	Seleccione la suscripción a Azure.	La suscripción que se va a usar para crear la nueva instancia de Azure Cache for Redis.
   Grupo de recursos	Seleccione un grupo de recursos o Crear nuevo, y escriba un nombre nuevo para el grupo de recursos.	Nombre del grupo de recursos en el que se va a crear la memoria caché y otros recursos. Al colocar todos los recursos de la aplicación en un grupo de recursos, puede administrarlos o eliminarlos fácilmente.
   Nombre DNS	Escriba un nombre único.	El nombre de caché debe ser una cadena de 1 a 63 caracteres que contenga solo números, letras y guiones. El nombre debe comenzar y terminar por un número o una letra y no puede contener guiones consecutivos. El nombre de host de la instancia de caché es \<DNS name>.redis.cache.windows.net.
   Ubicación	Seleccione una ubicación.	Una región de Azure cercana a otros servicios que usan la memoria caché.
   SKU de la caché	Seleccione una SKU.	La SKU determina los parámetros de tamaño, rendimiento y característica que están disponibles para la memoria caché. Para más información, consulte la introducción a Azure Cache for Redis.
   Tamaño de la caché	Seleccione un tamaño de caché.	Para más información, consulte la introducción a Azure Cache for Redis.

4. Seleccione la pestaña Redes o seleccione Siguiente: Redes.

5. En la pestaña Redes, seleccione un método de conectividad que se usará para la memoria caché.

6. Seleccione la pestaña Opciones avanzadas o seleccione Siguiente: Opciones avanzadas.

7. En el panel Opciones avanzadas, compruebe o seleccione un método de autenticación en función de la siguiente información:

   

   • De manera predeterminada, para una nueva caché Básica, Estándar o Premium, la Autenticación de Microsoft Entra está habilitada y la Autenticación de claves de acceso está deshabilitada.
   • Para las cachés Básica o Estándar, puede elegir la selección de un puerto que no sea TLS.
   • Para las cachés Estándar y Premium, puede habilitar las zonas de disponibilidad. No puede deshabilitar las zonas de disponibilidad una vez creada la caché.
   • En el caso de una caché Premium, configure las opciones para un puerto que no sea TLS, la agrupación en clústeres, la identidad administrada y la persistencia de datos.

   Importante

   Para obtener una seguridad óptima, se recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché si es posible. La autorización mediante Microsoft Entra ID y las identidades administradas proporciona mayor seguridad y facilidad de uso a través de la autorización de claves de acceso compartido. Para obtener más información sobre el uso de identidades administradas con la memoria caché, consulte Usar Microsoft Entra ID para la autenticación de caché.

8. (Opcional) Seleccione la pestaña Etiquetas o seleccione Siguiente: Etiquetas.

9. (Opcional) En la pestaña Etiquetas, escriba un nombre de etiqueta y un valor si desea clasificar el recurso de caché.

10. Seleccione el botón Revisar y crear.

    En la pestañaRevisar y crear, Azure valida automáticamente la configuración.

11. Tras aparecer el mensaje verde Validación superada, seleccione Crear.

Se produce una nueva implementación de caché durante varios minutos. Puede supervisar el progreso de la implementación en el panel Información general de Azure Cache for Redis. Cuando Estado muestra En ejecución, la memoria caché está lista para usarse.

Obtención del nombre de host, los puertos y la clave de acceso

Para conectarse al servidor de Azure Cache for Redis, el cliente de la caché necesita el nombre de host, los puertos y una clave de acceso de la caché. Es posible que algunos clientes utilicen nombres ligeramente diferentes para estos elementos. Puede obtener el nombre de host, los puertos y las claves en Azure Portal.

• Para obtener una clave de acceso para la caché:

  1. En Azure Portal, acceda a la caché.
  2. En el menú del servicio, en Configuración, seleccione Autenticación.
  3. En el panel Autenticación, seleccione la pestaña Claves de acceso.
  4. Para copiar el valor de una clave de acceso, seleccione el icono Copiar en el campo de clave.

  

• Para obtener el nombre de host y los puertos de la memoria caché:

  1. En Azure Portal, acceda a la caché.
  2. En el menú del servicio, seleccione Información general.
  3. En Esenciales, para Nombre de host, seleccione el icono Copiar para copiar el valor del nombre de host. El valor del nombre de host tiene la forma <DNS name>.redis.cache.windows.net.
  4. En Puertos, seleccione el icono Copiar para copiar los valores de puerto.

  

Configuración del entorno de trabajo

En función del sistema operativo, agregue variables de entorno para el nombre de host y la clave de acceso primaria que anotó anteriormente. En una ventana del símbolo del sistema o una ventana de terminal, establezca los siguientes valores:

export REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
export REDISCACHEKEY=<your-primary-access-key>

set REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
set REDISCACHEKEY=<your-primary-access-key>

Reemplace los marcadores de posición por los siguientes valores:

• <your-host-name>: nombre de host DNS, que se obtiene en la sección Propiedades del recurso de Azure Cache for Redis en Azure Portal.
• <your-primary-access-key>: clave de acceso principal, que se obtiene en la sección Claves de acceso del recurso de Azure Cache for Redis en Azure Portal.

Revisión del ejemplo de Java

En este ejemplo, usará Maven para ejecutar la aplicación de inicio rápido.

1. Vaya al nuevo directorio del proyecto redistest.

2. Abra el archivo pom.xml. En el archivo, compruebe que aparece una dependencia de Jedis:

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

3. Cierre el archivo pom.xml.

4. Abra App.java y compruebe que aparece el siguiente código:

   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("REDISCACHEHOSTNAME");
           String cachekey = System.getenv("REDISCACHEKEY");
   
           // Connect to the Azure Cache for Redis over the TLS/SSL port using the key.
           Jedis jedis = new Jedis(cacheHostname, 6380, DefaultJedisClientConfig.builder()
               .password(cachekey)
               .ssl(useSsl)
               .build());
   
           // Perform cache operations by 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();
       }
   }
   

   Este código muestra cómo conectarse a una instancia de Azure Cache for Redis mediante el nombre de host de caché y las variables de entorno clave. El código también almacena y recupera un valor de cadena en la memoria caché. También se ejecutan los comandos PING y CLIENT LIST.

5. Cierre App.java.

Compilar y ejecutar la aplicación

1. Establezca las variables de entorno como se indicó anteriormente:

   • Linux
   • Windows

   export REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
   export REDISCACHEKEY=<your-primary-access-key>
   

2. Para compilar y ejecutar la aplicación, ejecute el siguiente comando de Maven:

   • Linux
   • Windows

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

En la siguiente salida, puede ver que la clave Message tenía un valor almacenado en la caché. El valor se actualizó a uno nuevo mediante jedis.set. La aplicación también ejecutó los comandos PING y CLIENT LIST.

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

Limpieza de recursos

Si desea seguir usando los recursos que creó en este artículo, mantenga el grupo de recursos.

De lo contrario, para evitar cargos relacionados con los recursos, si ha terminado de usarlos, puede eliminar el grupo de recursos de Azure que creó.

Eliminación de un grupo de recursos

1. Inicie sesión en Azure Portal y después seleccione Grupos de recursos.

2. Seleccione el grupo de recursos que se eliminará.

   Si hay muchos grupos de recursos, en Filtro para cualquier campo, escriba el nombre del grupo de recursos que creó para completar este artículo. En la lista de resultados de búsqueda, seleccione el grupo de recursos.

   

3. Seleccione Eliminar grupo de recursos.

4. En el panel Eliminar un grupo de recursos, escriba el nombre del grupo de recursos para confirmar y, a continuación, seleccione Eliminar.

   

En unos instantes, el grupo de recursos y todos sus recursos se eliminan.

Contenido relacionado

• Procedimientos recomendados de resistencia de conexión para la caché
• Procedimientos recomendados de desarrollo para la caché
• Uso de Azure Cache for Redis con Jakarta EE
• Uso de Azure Cache for Redis con Spring