From 933db735869c29237b5958c139111bacd2d08f0b Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Wed, 18 Sep 2024 14:23:02 +0100
Subject: [PATCH] DOC-4082 code examples for DEL, EXPIRE, and TTL (#3945)

---
 .../io/redis/examples/CmdsGenericExample.java | 113 ++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 src/test/java/io/redis/examples/CmdsGenericExample.java

diff --git a/src/test/java/io/redis/examples/CmdsGenericExample.java b/src/test/java/io/redis/examples/CmdsGenericExample.java
new file mode 100644
index 0000000000..c43364f105
--- /dev/null
+++ b/src/test/java/io/redis/examples/CmdsGenericExample.java
@@ -0,0 +1,113 @@
+// EXAMPLE: cmds_generic
+// REMOVE_START
+package io.redis.examples;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+// REMOVE_END
+// HIDE_START
+import redis.clients.jedis.UnifiedJedis;
+import redis.clients.jedis.args.ExpiryOption;
+// HIDE_END
+
+// HIDE_START
+public class CmdsGenericExample {
+    @Test
+    public void run() {
+        UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
+
+        //REMOVE_START
+        // Clear any keys here before using them in tests.
+
+        //REMOVE_END
+// HIDE_END
+
+        // STEP_START del
+        String delResult1 = jedis.set("key1", "Hello");
+        System.out.println(delResult1); // >>> OK
+
+        String delResult2 = jedis.set("key2", "World");
+        System.out.println(delResult2); // >>> OK
+
+        long delResult3 = jedis.del("key1", "key2", "key3");
+        System.out.println(delResult3); // >>> 2
+        // STEP_END
+
+        // Tests for 'del' step.
+        // REMOVE_START
+        Assert.assertEquals("OK", delResult1);
+        Assert.assertEquals("OK", delResult2);
+        Assert.assertEquals(2, delResult3);
+        // REMOVE_END
+
+
+        // STEP_START expire
+        String expireResult1 = jedis.set("mykey", "Hello");
+        System.out.println(expireResult1);  // >>> OK
+
+        long expireResult2 = jedis.expire("mykey", 10);
+        System.out.println(expireResult2);  // >>> 1
+
+        long expireResult3 = jedis.ttl("mykey");
+        System.out.println(expireResult3);  // >>> 10
+
+        String expireResult4 = jedis.set("mykey", "Hello World");
+        System.out.println(expireResult4);  // >>> OK
+
+        long expireResult5 = jedis.ttl("mykey");
+        System.out.println(expireResult5);  // >>> -1
+
+        long expireResult6 = jedis.expire("mykey", 10, ExpiryOption.XX);
+        System.out.println(expireResult6);  // >>> 0
+
+        long expireResult7 = jedis.ttl("mykey");
+        System.out.println(expireResult7);  // >>> -1
+
+        long expireResult8 = jedis.expire("mykey", 10, ExpiryOption.NX);
+        System.out.println(expireResult8);  // >>> 1
+
+        long expireResult9 = jedis.ttl("mykey");
+        System.out.println(expireResult9);  // >>> 10
+        // STEP_END
+
+        // Tests for 'expire' step.
+        // REMOVE_START
+        Assert.assertEquals("OK", expireResult1);
+        Assert.assertEquals(1, expireResult2);
+        Assert.assertEquals(10, expireResult3);
+        Assert.assertEquals("OK", expireResult4);
+        Assert.assertEquals(-1, expireResult5);
+        Assert.assertEquals(0, expireResult6);
+        Assert.assertEquals(-1, expireResult7);
+        Assert.assertEquals(1, expireResult8);
+        Assert.assertEquals(10, expireResult9);
+        jedis.del("mykey");
+        // REMOVE_END
+
+
+        // STEP_START ttl
+        String ttlResult1 = jedis.set("mykey", "Hello");
+        System.out.println(ttlResult1); // >>> OK
+
+        long ttlResult2 = jedis.expire("mykey", 10);
+        System.out.println(ttlResult2); // >>> 1
+
+        long ttlResult3 = jedis.ttl("mykey");
+        System.out.println(ttlResult3); // >>> 10
+        // STEP_END
+
+        // Tests for 'ttl' step.
+        // REMOVE_START
+        Assert.assertEquals("OK", ttlResult1);
+        Assert.assertEquals(1, ttlResult2);
+        Assert.assertEquals(10, ttlResult3);
+        jedis.del("mykey");
+        // REMOVE_END
+
+// HIDE_START
+        
+    }
+}
+// HIDE_END
+