Nest.js权限管理系统开发(六)新建模块

2024-02-25 21:52

本文主要是介绍Nest.js权限管理系统开发(六)新建模块,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

本文相关文档:NestJS 中文网

创建模块

nest g命令

我们知道一个模块往往包含controller、module、service等文件,为了方便我们创建这些文件,nest cli提供了一些命令:

生成模块 (nest g mo) 以保持代码井井有条并建立清晰的边界(对相关组件进行分组)
生成控制器 (nest g co) 来定义 CRUD 路由(或 GraphQL 应用的查询/变更)
生成服务 (nest g s) 以实现和隔离业务逻辑
生成一个实体类/接口来表示资源数据形状
生成数据传输对象(或 GraphQL 应用的输入)以定义数据将如何通过网络发送

你可以执行nest -h 查看这些命令。

为了生成上述的全部文件,nest还提供了一个命令:

nest g resource

nest g resource 命令不仅生成所有 NestJS 构建块(模块、服务、控制器类),还生成实体类、DTO 类以及测试 (.spec) 文件。

取消生成spec文件

为了避免生成测试文件,你可以传递 --no-spec 标志,如下所示:nest g resource user --no-spec。或者nest-cli.json中配置:

  "generateOptions": {"spec": false}

我们在项目根目录下执行nest g res user命令:

我们可以看到生成的资源文件里没有出现spec文件。值得注意的一点是,我们可以在任何路径下执行nest g命令,并在对应位置生成相关文件。但是如果你想让nest-cli.json生效的话,只能在项目根目录执行命令,会在相对于src的路径下生成相应的资源。因为nest cli只会在当前路径下寻找配置文件,可以查看相关实现。 此外,我们还会发现刚才生成的UserModule已经被自动注册到了AppModule中。

样板代码

nest cli已经为我们的user模块创建了样板代码。

样板类和注解

在UserController中,通过构造方法注入了一个USerService的对象。整个UserController使用@Controller('user')进行注解,这个语法叫做装饰器。这个注解表示的是路由路径前缀,UserController中的每个方法对应一个具体的路由,如果这些路由有相同的前缀,我们就可以将这个前缀上升到类本身,这样每个路由只要标注不同的后缀部分即可。

样板方法

方法注解

每个方法都有例如@Post(),@Get(':id')之类的注解,Post、Get本身表示该路由支持的请求方法。括号里是路由,路由可以是静态的路径,也可以带动态的参数。@Get(':id')就表示/user/1之类的路由。此外路由还支持模式匹配,'ab*cd' 路由路径将匹配 abcdab_cdabecd 等。字符 ?+*() 可以在路由路径中使用,并且是它们对应的正则表达式的子集。连字符 (-) 和点 (.) 由基于字符串的路径逐字解释。仅 express 支持路由中间的通配符。

我们发现每个方法最终都是返回了一个值,其实框架已经替我们处理响应的状态码,对于get请求是200,post则是201。如果想自定义返回的状态码,可以使用以下注解:

@HttpCode(204)

同理,如果想自定义响应的header,也可以:

@Header('Cache-Control', 'none')

甚至指定重定向路径:

@Redirect('https://nest.nodejs.cn', 301)

样板代码中的方法都是同步的,我们也可以实现异步的,也就是返回类型为Promise<T>。

参数注解

方法参数中也存在着注解,例如findOne(@Param('id') id: string)表示id是路由中的参数值,同理@Query("id")就表示id是路由中的查询参数值。对于get请求,我们使用这两个注解就能获得我们关心的数据。对于post请求,我们关心的数据在请求实体里,需要使用@Body()注解来获取。

载荷转换

用户提交的数据是一个纯 JavaScript 对象,但在我们的DTO架构中,我们希望处理的是具体的类对应的对象。这里我们不能使用接口类型,因为TypeScript 接口在转换过程中被删除。update(@Param('id') id: string, @Body() updateUserDto: UpdateUserDto)表明框架已经将提交的数据转为了UpdateUserDto对象。要启用这个转换,需要使用ValidationPipe。在main.js中添加代码:

// 全局验证app.useGlobalPipes(new ValidationPipe({transform: true,enableDebugMessages: true, // 开发环境disableErrorMessages: false,forbidUnknownValues: false,}),)

我们把用于转换或验证输入数据的provider称为管道pipe。provider的作用域可以是指定模板或者全局,这里使用useGlobalPipes设置全局管道。transform:true表示自动将有效负载转换为根据其 DTO 类类型化的对象。当然这种转换也适用于param和query。

数据验证

使用pipe进行数据验证,有如下几种方式:

1.基于schema的验证:


@Post()
async create(@Body() createCatDto: CreateCatDto) {this.catsService.create(createCatDto);
}export class CreateCatDto {name: string;age: number;breed: string;
}

2.基于zod库的Object schema验证

3.类验证器

需要安装class-validator和class-transformer:

npm i --save class-validator class-transformer

一旦安装了这些,我们就可以向 CreateCatDto 类添加一些装饰器。在这里,我们看到了这种技术的一个显着优势:CreateCatDto 类仍然是我们的 Post 主体对象的唯一真实来源(而不是必须创建一个单独的验证类)。


import { IsString, IsInt } from 'class-validator';export class CreateCatDto {@IsString()name: string;@IsInt()age: number;@IsString()breed: string;
}

然后我们可以创建一个自定义的pipe,在实现中利用这些注解,对数据进行验证。当然内置的 ValidationPipe已经为我们实现了这一切,方便我们开箱即用。

这篇关于Nest.js权限管理系统开发(六)新建模块的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/746829

相关文章

Python中logging模块用法示例总结

《Python中logging模块用法示例总结》在Python中logging模块是一个强大的日志记录工具,它允许用户将程序运行期间产生的日志信息输出到控制台或者写入到文件中,:本文主要介绍Pyt... 目录前言一. 基本使用1. 五种日志等级2.  设置报告等级3. 自定义格式4. C语言风格的格式化方法

SpringBoot 多环境开发实战(从配置、管理与控制)

《SpringBoot多环境开发实战(从配置、管理与控制)》本文详解SpringBoot多环境配置,涵盖单文件YAML、多文件模式、MavenProfile分组及激活策略,通过优先级控制灵活切换环境... 目录一、多环境开发基础(单文件 YAML 版)(一)配置原理与优势(二)实操示例二、多环境开发多文件版

使用docker搭建嵌入式Linux开发环境

《使用docker搭建嵌入式Linux开发环境》本文主要介绍了使用docker搭建嵌入式Linux开发环境,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面... 目录1、前言2、安装docker3、编写容器管理脚本4、创建容器1、前言在日常开发全志、rk等不同

Three.js构建一个 3D 商品展示空间完整实战项目

《Three.js构建一个3D商品展示空间完整实战项目》Three.js是一个强大的JavaScript库,专用于在Web浏览器中创建3D图形,:本文主要介绍Three.js构建一个3D商品展... 目录引言项目核心技术1. 项目架构与资源组织2. 多模型切换、交互热点绑定3. 移动端适配与帧率优化4. 可

Python 基于http.server模块实现简单http服务的代码举例

《Python基于http.server模块实现简单http服务的代码举例》Pythonhttp.server模块通过继承BaseHTTPRequestHandler处理HTTP请求,使用Threa... 目录测试环境代码实现相关介绍模块简介类及相关函数简介参考链接测试环境win11专业版python

Python实战之SEO优化自动化工具开发指南

《Python实战之SEO优化自动化工具开发指南》在数字化营销时代,搜索引擎优化(SEO)已成为网站获取流量的重要手段,本文将带您使用Python开发一套完整的SEO自动化工具,需要的可以了解下... 目录前言项目概述技术栈选择核心模块实现1. 关键词研究模块2. 网站技术seo检测模块3. 内容优化分析模

基于Java开发一个极简版敏感词检测工具

《基于Java开发一个极简版敏感词检测工具》这篇文章主要为大家详细介绍了如何基于Java开发一个极简版敏感词检测工具,文中的示例代码简洁易懂,感兴趣的小伙伴可以跟随小编一起学习一下... 目录你是否还在为敏感词检测头疼一、极简版Java敏感词检测工具的3大核心优势1.1 优势1:DFA算法驱动,效率提升10

Nginx添加内置模块过程

《Nginx添加内置模块过程》文章指导如何检查并添加Nginx的with-http_gzip_static模块:确认该模块未默认安装后,需下载同版本源码重新编译,备份替换原有二进制文件,最后重启服务验... 目录1、查看Nginx已编辑的模块2、Nginx官网查看内置模块3、停止Nginx服务4、Nginx

Python开发简易网络服务器的示例详解(新手入门)

《Python开发简易网络服务器的示例详解(新手入门)》网络服务器是互联网基础设施的核心组件,它本质上是一个持续运行的程序,负责监听特定端口,本文将使用Python开发一个简单的网络服务器,感兴趣的小... 目录网络服务器基础概念python内置服务器模块1. HTTP服务器模块2. Socket服务器模块

python urllib模块使用操作方法

《pythonurllib模块使用操作方法》Python提供了多个库用于处理URL,常用的有urllib、requests和urlparse(Python3中为urllib.parse),下面是这些... 目录URL 处理库urllib 模块requests 库urlparse 和 urljoin编码和解码