cache-java-get-started.md

title	description	services	documentationcenter	author	manager	editor	ms.assetid	ms.service	ms.devlang	ms.topic	ms.tgt_pltfrm	ms.workload	ms.date	ms.author
How to use Azure Redis Cache with Java | Microsoft Docs	Get started with Azure Redis Cache using Java	redis-cache		steved0x	douge		29275a5e-2e39-4ef2-804f-7ecc5161eab9	cache	java	hero-article	cache-redis	tbd	02/10/2017	sdanie

How to use Azure Redis Cache with Java

[!div class="op_single_selector"]

• .NET
• ASP.NET
• Node.js
• Java
• Python

Azure Redis Cache gives you access to a dedicated Redis cache, managed by Microsoft. Your cache is accessible from any application within Microsoft Azure.

This topic shows you how to get started with Azure Redis Cache using Java.

Prerequisites

Jedis - Java client for Redis

This tutorial uses Jedis, but you can use any Java client listed at http://redis.io/clients.

Create a Redis cache on Azure

[!INCLUDE redis-cache-create]

Retrieve the host name and access keys

[!INCLUDE redis-cache-create]

Connect to the cache securely using SSL

The latest builds of jedis provide support for connecting to Azure Redis Cache using SSL. The following example shows how to connect to Azure Redis Cache using the SSL endpoint of 6380. Replace <name> with the name of your cache and <key> with either your primary or secondary key as described in the previous Retrieve the host name and access keys section.

boolean useSsl = true;
/* In this line, replace <name> with your cache name: */
JedisShardInfo shardInfo = new JedisShardInfo("<name>.redis.cache.windows.net", 6379, useSsl);
shardInfo.setPassword("<key>"); /* Use your access key. */

Note

The non-SSL port is disabled for new Azure Redis Cache instances. If you are using a different client that doesn't support SSL, see How to enable the non-SSL port.

Add something to the cache and retrieve it

package com.mycompany.app;
import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisShardInfo;

public class App
{
  public static void main( String[] args )
  {
    boolean useSsl = true;
    /* In this line, replace <name> with your cache name: */
    JedisShardInfo shardInfo = new JedisShardInfo("<name>.redis.cache.windows.net", 6379, useSsl);
    shardInfo.setPassword("<key>"); /* Use your access key. */
    Jedis jedis = new Jedis(shardInfo);
    jedis.set("foo", "bar");
    String value = jedis.get("foo");
  }
}

Next steps

• Enable cache diagnostics so you can monitor the health of your cache.
• Read the official Redis documentation.