@m92/redis

This is an SDK Wrapper which provides Redis functionalities to interact with a Redis Instance. This package uses Node-Redis package using its v4.x.x version.

This package provides the following functionalities:

• Redis Connection Helper
• Redis SDK Class

Table of Content

• Installation
• Environment Variables
• Connecting to Redis
• Creating a Redis SDK Instance
  • Properties of RedisSdk Instance
  • Methods of RedisSdk Instance
• Resources
• License

Installation

$ npm install --save @m92/redis

Environment Variables

The following environment variables need to be set to work with this package:

##### Redis Config
export REDIS_ENABLED=false
export REDIS_AUTH_ENABLED=false
export REDIS_CHECK_SERVER_IDENTITY=false
export REDIS_HOST=
export REDIS_PORT=
export REDIS_KEY_PREFIX=
export REDIS_AUTH=

Note:

• If 'REDIS_ENABLED' is set to 'true', 'REDIS_HOST' and 'REDIS_PORT' are required
• If 'REDIS_AUTH_ENABLED' is set to 'true', 'REDIS_AUTH'is required
• 'REDIS_KEY_PREFIX' prepends all redis keys with the specified value

Connecting to Redis

Redis needs to be connected before the 'RedisSdk' methods can executed. The connection can be established as shown below:

import redisClientManager from '@m92/redis/redisClientManager'
await redisClientManager.connect()

Note: Establish this connection only if you set the environment variable 'REDIS_ENABLED' value to 'true'.

Creating a Redis SDK Instance

import RedisSdk from '@m92/redis'

const redisSdk = new RedisSdk()
export default redisSdk

If you wish to pass your custom 'config' for the RedisSdk, then you can build it as follows: Note: You will have to call the redisSdk.connect() to establish a connection before using the RedisSdk Methods

import RedisSdk from '@m92/redis'

const config = {
  CONNECTION_CONFIG: {
    host: '',
    port: '',
    password: ''
  }
  KEY_PREFIX: ''
}

const redisSdk = new RedisSdk(config)
export default redisSdk

To manage redis connections for RedisSdk Instances with custom 'config', 'connect' and 'disconnect' Methods are provided and they can be called as shown below. The 'connect' method must be called before before using the RedisSdk Methods.

// To establish a connection
await redisSdk.connect()

// To release the connection
await redisSdk.disconnect()

Properties of RedisSdk Instance

| Properties | Description | | :------------------------- | :-------------------------------- | | redisSdk.CONNECTION_CONFIG | Connection Config used by the SDK | | redisSdk.KEY_PREFIX | Redis Key Prefix used by the SDK |

Methods of RedisSdk Instance

| Method | Description | | :------------------------------------------------------------------------ | :------------------------------------------------------ | | redisSdk.get | Gets the value of a redis key | | redisSdk.set | Sets the value for a redis key | | redisSdk.getAndExpire | Gets the value of a redis key and sets its expiry | | redisSdk.setAndExpire | Sets the value of a redis key and sets its expiry | | redisSdk.del | Deletes a redis key | | redisSdk.keys | Gets all redis keys for a given key pattern | | redisSdk.delByPattern | Deletes all redis keys for a given key pattern | | redisSdk.incrBy | Increments the value of a redis key | | redisSdk.incrByAndExpire | Increments the value of a redis key and sets its expiry | | redisSdk.decrBy | Decrements the value of a redis key | | redisSdk.decrByAndExpire | Decrements the value of a redis key and sets its expiry | | redisSdk.exists | Returns if keys exists or not |

redisSdk.get(key, options)

Arguments

• key (String): Redis key name
• options (Object): options as mentioned by 'get' method of redis package

Returns

• value (any): Value stored in redis

Example

const value = await redisSdk.get(key, options)

redisSdk.set(key, value, options)

Arguments

• key (String): Redis key name
• value (any): Value to be stored in redis
• options (Object): options as mentioned by 'set' method of redis package

Returns

• undefined

Example

await redisSdk.set(key, value, options)

redisSdk.getAndExpire(key, ttlInSecs, options)

Arguments

• key (String): Redis key name
• ttlInSecs (Number): Redis key expiry in seconds
• options (Object): options as mentioned by 'get' method of redis package

Returns

• value (any): Value stored in redis

Example

const value = await redisSdk.getAndExpire(key, ttlInSecs, options)

redisSdk.setAndExpire(key, value, ttlInSecs, options)

Arguments

• key (String): Redis key name
• value (any): Value to be stored in redis
• ttlInSecs (Number): Redis key expiry in seconds
• options (Object): options as mentioned by 'set' method of redis package

Returns

• undefined

Example

await redisSdk.setAndExpire(key, value, ttlInSecs, options)

redisSdk.del(key)

Arguments

• key (String): Redis key name

Returns

• undefined

Example

await redisSdk.del(key)

redisSdk.keys(pattern)

Arguments

• pattern (String): Redis key pattern

Returns

• keys (Array): Array of keys

Example

const keys = await redisSdk.keys(pattern)

redisSdk.delByPattern(pattern)

Arguments

• pattern (String): Redis key pattern

Returns

• undefined

Example

await redisSdk.delByPattern(pattern)

redisSdk.incrBy(key, value)

Arguments

• key (String): Redis key name
• value (Number): Redis value to be incremented by (Defaults to 0)

Returns

• incrValue (Number): Incremented redis value

Example

const incrValue = await redisSdk.incrBy(key, value)

redisSdk.incrByAndExpire(key, value, ttlInSecs)

Arguments

• key (String): Redis key name
• value (Number): Redis value to be incremented by (Defaults to 0)
• ttlInSecs (Number): Redis key expiry in seconds

Returns

• incrValue (Number): Incremented redis value

Example

const incrValue = await redisSdk.incrByAndExpire(key, value, ttlInSecs)

redisSdk.decrBy(key, value)

Arguments

• key (String): Redis key name
• value (Number): Redis value to be decremented by (Defaults to 0)

Returns

• decrValue (Number): Decremented redis value

Example

const decrValue = await redisSdk.decrBy(key, value)

redisSdk.decrByAndExpire(key, value, ttlInSecs)

Arguments

• key (String): Redis key name
• value (Number): Redis value to be decremented by (Defaults to 0)
• ttlInSecs (Number): Redis key expiry in seconds

Returns

• decrValue (Number): Decremented redis value

Example

const decrValue = await redisSdk.decrByAndExpire(key, value, ttlInSecs)

redisSdk.exists(keys)

Arguments

• keys (Array): Array of redis key names

Returns

• keyCount (Number): Returns '0' if key does not exist and '1' if exists

Example

const keyCount = await redisSdk.exists(keys)

Resources

• Node-Redis

License

• MIT