{"id":246,"date":"2022-12-14T20:38:38","date_gmt":"2022-12-14T19:38:38","guid":{"rendered":"https:\/\/chigisoft.com\/blog\/?p=246"},"modified":"2023-07-15T14:31:38","modified_gmt":"2023-07-15T13:31:38","slug":"redis-cloud-developers-experience-with-typescript-part-2","status":"publish","type":"post","link":"https:\/\/chigisoft.com\/blog\/redis-cloud-developers-experience-with-typescript-part-2\/","title":{"rendered":"REDIS Cloud Developers’ Experience With TypeScript – Part 2"},"content":{"rendered":"\n

Welcome to the second part of this tutorial<\/p>\n\n\n\n

If you are just joining us I will recommend you check out the first edition: REDIS Cloud Developers’ Experience With TypeScript – Part 1<\/a>.<\/p>\n\n\n\n

In this blog, we are going to learn how to set up a Redis Cloud account but before we do that let’s talk about the benefits of using Redis Enterprise<\/a><\/strong> or Redis Enterprise Cloud<\/a><\/strong> on our application.<\/p>\n\n\n\n

In the previous article, we were storing data on our local storage and I mentioned such a method is only applicable or recommended for personal test development. If you are developing an application that will be used on production then you have to get a bigger memory by purchasing and setting up your own server and ensuring your server is up and running whenever it is needed. We all know that setting up a personal server or servers is tedious and doesn’t come cheap. This is where Cloud Service Providers come to play.<\/p>\n\n\n\n

Redis Enterprise<\/h5>\n\n\n\n

Redis Enterprise is a multi-tenancy Cloud Service Provider that allows you to deploy and self-manage your data by yourself. Instead of spending so much to acquire and set up your own server you can create a free account on the Redis Cloud and deploy your dataset for a far cheaper cost. Some of the benefits of using Redis Enterprise: Cost efficiency, High Availability, Sharding, Security, Support, Automation and Backup. Imagine doing all these on your own or setting up a team to manage it. That will be pretty expensive!<\/p>\n\n\n\n

Redis Account Set Up<\/h5>\n\n\n\n

Use this link<\/a><\/strong> to create a free account or you can login<\/a><\/strong> into your account if you already have one. For those of us who are new on Redis then follow the instructions to set up your account.<\/p>\n\n\n\n

Go to the account page and create an account by filling out the form and clicking on Get Started<\/code> or sign up with your GitHub or Google Account button.<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n

If you are new to Redis Enterprise or Redis Cloud there is a free $200 coupon you can use.<\/p>\n\n\n\n

After creating the account you should have an interface similar to the image below.<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n

Click on the New subscription<\/code> button. it will direct you to the List of Plan page.<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n

Redis has a free plan that comes with 30MB of storage space. I recommend this free plan for test purposes. Go ahead and select your plan. For this tutorial, I am using the free plan. Scroll down to the end of the page, enter a subscription name and click on the Create subscription<\/code> button.<\/p>\n\n\n\n

You can use the Flexible or Annual plan and pay with your free $200 coupon. The code is TIGER200.<\/p>\n\n\n\n

The Redis cloud server is up and running.<\/p>\n\n\n\n

Let’s create the database that will hold our records. Click on the New database<\/code> to create a database:<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n

Enter a database name, select the Redis Stack<\/code> under Type, scroll down and click on the Activate database<\/code> button on the top-right of the page.<\/p>\n\n\n\n

Before we proceed further let me introduce you to Redis Stack<\/strong>.<\/p>\n\n\n\n

Redis Stack<\/h5>\n\n\n\n

Redis Stack is a bundle of Redis modules that are embedded in Redis that enables developers to easily build real-time applications by enabling you to define your data through data modelling. Mind you Redis Stack does not replace Redis Open Source instead is an enhancement to migrate from using Redis just for caching to creating data models and still maintaining performance and reliability. Redis modules are made up of RedisJSON, RediSearch, RedisGraph, RedisTimeSeries and RedisBloom. You can find more details on Redis Stack here<\/a>.<\/p>\n\n\n\n

Now we have a database that is ready to be used.<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n

With our database set-up completed, let’s go to our application and reconfigure the database connection. Adding your remote credentials to your application can be a little bit tricky so I need you to pay attention to these instructions. A sample of how your remote URL should look like:<\/p>\n\n\n\n

redis:\/\/username:password@public-endpoint<\/pre>\n\n\n\n
Go to your .env<\/code> file add a new variable with the sample URL:<\/p>\n\n\n\n
REMOTE_REMOTE_URL=redis:\/\/username:password@public-endpoint<\/pre>\n\n\n\n
On your cloud database page scroll down to the Security<\/code> section under Configuration<\/code> tab, copy your username and password.<\/p>\n\n\n\n
\"\"\/<\/figure>\n\n\n\n
Where you have the username on the local URL replace it with your Redis remote database username and replace the local password with the remote password.<\/p>\n\n\n\n
Scroll up to the General<\/code> section under the same Configuration<\/code> tab copy the Public end-point value and paste it on your local URL. Your URL on the the .env<\/code> file should look like this:<\/p>\n\n\n\n
# main
REDIS_REMOTE_URL=redis:\/\/default:szNKL1W***f94S**ctD5XK**Y4z**o57@redis-17630.***********.cloud.redislabs.com:17630
\u200b
#sample
REMOTE_REMOTE_URL=redis:\/\/username:password@public-endpoint<\/pre>\n\n\n\n
Go to your src\/connection.ts<\/code> script, replace the process.env.REDIS_URL<\/code> with process.env.REDIS_REMOTE_URL<\/code>. Restart your application. Your application should run as if nothing happened.<\/p>\n\n\n\n
The next step is to open Postman and hit the create endpoint. This time around your record will be stored on the remote database.<\/p>\n\n\n\n
\"\"\/<\/figure>\n\n\n\n
We need to populate our database with more records. Go ahead and add your favourite novels or literature books to your database.<\/p>\n\n\n\n
Let’s fetch all the records that we have stored so far on our database. Go to your src\/controllers\/BookController.ts<\/code> script and add the following methods to the BookController class:<\/p>\n\n\n\n
public static getBooks = async (\nreq: Request, \nres: Response, \nnext: NextFunction\n) => {\n        try {\n           const result = await (await BookRepo()).search().return.all()\n\u200b\n           return res.send({\n            status: 'success',\n            data: result\n        })\n\u200b\n        } catch (error) {\n            next(error)\n        }\n    }<\/pre>\n\n\n\n
If you skipped or missed the first part of this tutorial I recommend you use the link at the top of this blog to get yourself updated<\/p>\n\n\n\n
Navigate to your routes.ts<\/code> file and add the following endpoint:<\/p>\n\n\n\n
router.get('\/books', BookController.getBooks)<\/pre>\n\n\n\n
Your endpoint should fetch an array of all the books stored in your database. Go to your Postman and hit the endpoint:<\/p>\n\n\n\n
\"\"\/<\/figure>\n\n\n\n
Now we have a list of all our records.<\/p>\n\n\n\n
Let’s add other functionalities to our application.<\/p>\n\n\n\n
Let’s assume we have readers on the platform. We want to know about books that are often read by users on our platform. At this point, we want to make use of some commands from core Redis (i.e. Redis open source). We have to install the Redis client that supports NodeJs which will enable our application to utilise the Redis command. I will be using the node-redis<\/code> npm package but you are free to check out other clients here<\/a><\/strong>. Open your terminal and install the package:<\/p>\n\n\n\n
yarn add redis<\/pre>\n\n\n\n
We have to refactor the Redis connection again. Go to your src\/connection.ts<\/code> script:<\/p>\n\n\n\n
import 'dotenv\/config'
import { Client } from 'redis-om'
import { createClient } from 'redis'
\u200b
const url = process.env.REDIS_REMOTE_URL
\u200b
export async function redisConnection() {
    const connection = createClient({ url })
    await connection.connect()
\u200b
    return connection
}
\u200b
export async function redisOmConnection() {
    const client = new Client()
    const redisConn = await client.use(await redisConnection())
\u200b
    \/\/ to check for connection. you can delete it after we have confirmed our connection is successful
    const dbCheck = await client.execute(['PING']);
    console.log(dbCheck)
    
    return redisConn
}<\/pre>\n\n\n\n
Go to your src\/app.ts<\/code> and replace the redisClient<\/code> method with the new one:<\/p>\n\n\n\n
import express from 'express';
import { redisOmConnection }  from '.\/connection';
import router from '.\/routes';
\u200b
const app = express()
app.use(express.json());
\u200b
const PORT = process.env.PORT || 3000
\u200b
app.use('\/api\/v1', router);
\u200b
app.listen(PORT, async () => {
    await redisOmConnection();
    console.log(`app is running on port ${PORT}`)
})<\/pre>\n\n\n\n
Restart your application.<\/p>\n\n\n\n
We want to know popular books by how often users read the book. Every time a user selects and start reading a book, this endpoint is called. On the src\/routes.ts<\/code> add this endpoint:<\/p>\n\n\n\n
router.post('\/read\/:id', BookController.bookRead)<\/pre>\n\n\n\n
Add this method to the BookController class src\/controllers\/BookController.ts<\/code>:<\/p>\n\n\n\n
    public static bookRead = async (req: Request, res: Response, next: NextFunction) => {
        const key = req.params.id
\u200b
        try {
            \/\/ check if key exist
            const keyExist = await (await redisConnection()).EXISTS(key)
\u200b
            let result;
\u200b
            if (keyExist == 0) {
                await (await redisConnection()).SET(key, '0')
                result = await (await redisConnection()).INCR(key)
            } else {
                \/\/ returns 'ok' if command was executed successully
                result = await (await redisConnection()).INCR(key)
            }
\u200b
            return res.send({
                status: 'success',
                data: result
            })
        } catch (error) {
            next(error)
        }
    }<\/pre>\n\n\n\n
Try hitting the endpoint with a different book Id.<\/p>\n\n\n\n
Create an endpoint that will return the number of times a book has been read. Add this method to the BookController class:<\/p>\n\n\n\n
    public static popularBookByReading = async (req: Request, res: Response, next: NextFunction) => {
        const keyArr = req.body.keys
        console.log(keyArr)
        try {
            const result = await (await redisConnection()).MGET([keyArr[0], keyArr[1], keyArr[2], keyArr[3]])
\u200b
            return res.send({
                status: 'success',
                data: result
            })
        } catch (error) {
            next(error)
        }
    }<\/pre>\n\n\n\n
In your route file:<\/p>\n\n\n\n
router.post('\/books\/poupular', BookController.popularBookByReading)<\/pre>\n\n\n\n
On your Postman create an array and paste copies of your book Ids inside the array:<\/p>\n\n\n\n
\"\"\/<\/figure>\n\n\n\n
An overview of the scripts in the application.<\/p>\n\n\n\n
src\/repositories\/BookRepo.ts<\/code><\/p>\n\n\n\n
import { Entity, Schema } from 'redis-om';
import { redisOmConnection }  from '..\/connection'
\u200b
class Book extends Entity {}
\u200b
const BookSchema: any = new Schema(Book, {
    title: { type: 'string' },
    author: { type: 'string' },
    pages: { type: 'number' },
    publisher: { type: 'string' },
    category: { type: 'string' },
    publishedDate: { type: 'date' },
},{
    dataStructure: 'JSON'
});
\u200b
\u200b
const setup = async () => {
    const bookRepo = (await redisOmConnection()).fetchRepository(BookSchema)
    await bookRepo.createIndex()
    return bookRepo;
\u200b
}
\u200b
export default setup<\/pre>\n\n\n\n
src\/controllers\/BookController.ts<\/code><\/p>\n\n\n\n
import { Request, Response, NextFunction } from 'express'
import BookRepo from '..\/repositories\/BookRepo'
import { redisConnection } from '..\/connection'
\u200b
export default class BookController {
    public static createBook = async (req: Request, res: Response, next: NextFunction) => {
        try {
            const result = await (await BookRepo()).createAndSave(req.body)
\u200b
            return res.send({
                status: 'success',
                data: result
            })
        } catch (error) {
            next(error)
        }
    }
\u200b
    public static getBookById = async (req: Request, res: Response, next: NextFunction) => {
        try {
            const result = await (await BookRepo()).fetch(req.params.id)
\u200b
            return res.send({
                status: 'success',
                data: result,
            })
        } catch (error) {
            next(error)
        }
    }
\u200b
    public static getBooks = async (req: Request, res: Response, next: NextFunction) => {
        try {
           const result = await (await BookRepo()).search().return.all()
\u200b
           return res.send({
            status: 'success',
            data: result,
        })
\u200b
        } catch (error) {
            next(error)
        }
    }
\u200b
    public static bookRead = async (req: Request, res: Response, next: NextFunction) => {
        const key = req.params.id
\u200b
        try {
            \/\/ check if key exist
            const keyExist = await (await redisConnection()).EXISTS(key)
\u200b
            let result;
\u200b
            if (keyExist == 0) {
                await (await redisConnection()).SET(key, '0')
                result = await (await redisConnection()).INCR(key)
            } else {
                \/\/ returns 'ok' if command was executed successully
                result = await (await redisConnection()).INCR(key)
            }
\u200b
\u200b
            return res.send({
                status: 'success',
                data: result
            })
        } catch (error) {
            next(error)
        }
    }
\u200b
    public static popularBookByReading = async (req: Request, res: Response, next: NextFunction) => {
        const keyArr = req.body.keys
        console.log(keyArr)
        try {
            const result = await (await redisConnection()).MGET([keyArr[0], keyArr[1], keyArr[2], keyArr[3]])
\u200b
            return res.send({
                status: 'success',
                data: result
            })
        } catch (error) {
            next(error)
        }
    }
}<\/pre>\n\n\n\n
src\/routes.ts<\/code><\/p>\n\n\n\n
import express, { Router } from 'express';
import BookController from '.\/controllers\/BookController';
\u200b
const router = express.Router();
\u200b
router.post('\/books', BookController.createBook)
router.get('\/books\/:id', BookController.getBookById)
router.get('\/books', BookController.getBooks)
router.post('\/read\/:id', BookController.bookRead)
router.post('\/books\/popular', BookController.popularBookByReading)
\u200b
export default router<\/pre>\n\n\n\n
Conclusion<\/h5>\n\n\n\n
We have come to the end of this series.<\/p>\n\n\n\n
I hope you learnt a lot from this article. You can go ahead and create more functionalities such as user registration and login.<\/p>\n\n\n\n
As usual, I am in the comment section waiting for your feedback.<\/p>\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n
This post is in collaboration with Redis<\/a><\/strong><\/em><\/p>\n\n\n\n
Related<\/h5>\n\n\n\n
Try Redis Cloud for free<\/a><\/strong><\/p>\n\n\n\n
Redis Developer Hub – tools, guides, and tutorials about Redis<\/a><\/strong><\/p>\n\n\n\n
RedisInsight Desktop GUI<\/a><\/strong><\/p>\n\n\n\n
Watch this video on the benefits of Redis Cloud over other Redis providers<\/a><\/strong><\/p>\n\n\n\n
Also related:<\/h5>\n\n\n\n
\n
REDIS Cloud Developers’ Experience With TypeScript – Part 1<\/a><\/blockquote>