nestjs-redis

KO | EN

gitlite — search

#react #ai #typescript #llm #go #machine-learning #rust #java #awesome-list #vue #pytorch #mcp #openai #open-source

(★ 25)

🚀 Redis module for Nest framework (node.js)

nestjs-redis 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# nestjs-redis

Redis(ioredis) module for Nest framework (node.js) 🚀

[![NPM version][npm-img]][npm-url]
[![NPM Downloads][downloads-image]][npm-url]
[![License][license-img]][license-url]

## Installation

```bash
$ npm i --save @jasonsoft/nestjs-redis ioredis
```

## Usage

Import `RedisModule`:

```typescript
@Module({
  imports: [
    RedisModule.forRoot({
      url: 'redis://username:password@localhost:6379',
    }),
  ],
  providers: [...],
})
export class AppModule {}
```

```typescript
@Module({
  imports: [
    RedisModule.forRoot({
      port: 6379, // Redis port
      host: 'localhost', // Redis host
      username: 'default', // needs Redis >= 6
      password: 'password',
      db: 0, // Defaults to 0
    }),
  ],
  providers: [...],
})
export class AppModule {}
```

Inject `RedisCacheHelper`:

```typescript
@Injectable()
export class AppService {
  constructor(private readonly redisCacheHelper: RedisCacheHelper) {}
}
```

## Async options

Quite often you might want to asynchronously pass your module options instead of passing them beforehand. In such case, use `forRootAsync()` method.

```typescript
RedisModule.forRootAsync({
  imports: [ConfigModule],
  useFactory: (configService: ConfigService) => ({
    url: configService.get('REDIS_URL'),
  }),
  inject: [ConfigService],
}),
```

## Example

```typescript
import { RedisCacheHelper } from '@jasonsoft/nestjs-redis';
import { Injectable } from '@nestjs/common';

export interface User {
  id: number;
  name: string;
  age: number;
}

export const USERS: User[] = [
  {
    id: 1,
    name: 'Jason Song',
    age: 18,
  },
  {
    id: 2,
    name: '成长的小猪',
    age: 30,
  },
];

@Injectable()
export class AppService {
  constructor(private readonly redisCacheHelper: RedisCacheHelper) {}

async getUser(id: number): Promise<User> {
    const cacheKey = `user:${id}`;
    let user = await this.redisCacheHelper.getAsObj<User>(cacheKey);
    if (!user) {
      user = USERS.find((user) => user.id === id);
      if (user) {
        await this.redisCacheHelper.set(cacheKey, user);
      }
    }
    return user;
  }

async commonOperation() {
    /** string type */
    await this.redisCacheHelper.set('string:type', 'test', 60);
    const stringValue = await this.redisCacheHelper.getAsStr('string:type');

/** number type */
    await this.redisCacheHelper.set('number:type', 1, '30m');
    const numberValue = await this.redisCacheHelper.getAsNum('number:type');

/** boolean type */
    await this.redisCacheHelper.set('boolean:type', true, '8h');
    const booleanValue = await this.redisCacheHelper.getAsBool('boolean:type');

/** object:type */
    const user = USERS.find((user) => user.name === 'Jason Song');
    await this.redisCacheHelper.set('object:type', user, '7d');
    const objectValue = await this.redisCacheHelper.getAsObj<User>(
      'object:type',
    );
  }
}
```

## ioredis usage

> To use ioredis built-in usage

```typescript
/** Import `InjectRedis` and `Redis` from `@jasonsoft/nestjs-redis` */
import { InjectRedis, Redis } from '@jasonsoft/nestjs-redis';
import { Injectable } from '@nestjs/common';

@Injectable()
export class AppService {
  /** The @InjectRedis() decorator provides injection into Redis */
  constructor(@InjectRedis() private readonly redis: Redis) {}

async getUser(): Promise<string> {
    const names = ['jason', 'jasonsoft', '成长的小猪'];
    await this.redis.lpush('names', ...names);
    return await this.redis.lpop('names');
  }

/** ioredis basic usage */
  async basicUsage() {
    await this.redis.set('mykey', 'value');

let result = await this.redis.get('mykey');
    console.log(result); // Prints "value"

result = await this.redis.get('mykey');
    console.log(result); // Prints "value"

await this.redis.zadd(
      'sortedSet',
      1,
      'one',
      2,
      'dos',
      4,
      'quatro',
      3,
      'three',
    );
    const elements = await this.redis.zrange('sortedSet', 0, 2, 'WITHSCORES');
    console.log(elements);
    // ["one", "1", "dos", "2", "three", "3"] as if the command was `redis> ZRANGE sortedSet 0 2 WITHSCORES`
  }
}
```

[npm-img]: https://img.shields.io/npm/v/@jasonsoft/nestjs-redis.svg?style=flat-square
[npm-url]: https://npmjs.org/package/@jasonsoft/nestjs-redis
[license-img]: https://img.shields.io/badge/license-MIT-green.svg?style=flat-square
[license-url]: LICENSE
[downloads-image]: https://img.shields.io/npm/dt/@jasonsoft/nestjs-redis.svg?style=flat-square
[project-icon]: https://avatars.githubusercontent.com/u/22167571?v=4

nestjs-redis

nestjs-redis 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

nestjs-redis

nestjs-redis 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README