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

相关文章

用js控制视频播放进度基本示例代码

《用js控制视频播放进度基本示例代码》写前端的时候,很多的时候是需要支持要网页视频播放的功能,下面这篇文章主要给大家介绍了关于用js控制视频播放进度的相关资料,文中通过代码介绍的非常详细,需要的朋友可... 目录前言html部分:JavaScript部分:注意:总结前言在javascript中控制视频播放

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis

Python基于wxPython和FFmpeg开发一个视频标签工具

《Python基于wxPython和FFmpeg开发一个视频标签工具》在当今数字媒体时代,视频内容的管理和标记变得越来越重要,无论是研究人员需要对实验视频进行时间点标记,还是个人用户希望对家庭视频进行... 目录引言1. 应用概述2. 技术栈分析2.1 核心库和模块2.2 wxpython作为GUI选择的优

PyCharm如何设置新建文件默认为LF换行符

《PyCharm如何设置新建文件默认为LF换行符》:本文主要介绍PyCharm如何设置新建文件默认为LF换行符问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录PyCharm设置新建文件默认为LF换行符设置换行符修改换行符总结PyCharm设置新建文件默认为LF

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark

Python使用date模块进行日期处理的终极指南

《Python使用date模块进行日期处理的终极指南》在处理与时间相关的数据时,Python的date模块是开发者最趁手的工具之一,本文将用通俗的语言,结合真实案例,带您掌握date模块的六大核心功能... 目录引言一、date模块的核心功能1.1 日期表示1.2 日期计算1.3 日期比较二、六大常用方法详

利用Go语言开发文件操作工具轻松处理所有文件

《利用Go语言开发文件操作工具轻松处理所有文件》在后端开发中,文件操作是一个非常常见但又容易出错的场景,本文小编要向大家介绍一个强大的Go语言文件操作工具库,它能帮你轻松处理各种文件操作场景... 目录为什么需要这个工具?核心功能详解1. 文件/目录存javascript在性检查2. 批量创建目录3. 文件

基于Python开发批量提取Excel图片的小工具

《基于Python开发批量提取Excel图片的小工具》这篇文章主要为大家详细介绍了如何使用Python中的openpyxl库开发一个小工具,可以实现批量提取Excel图片,有需要的小伙伴可以参考一下... 目前有一个需求,就是批量读取当前目录下所有文件夹里的Excel文件,去获取出Excel文件中的图片,并

python中time模块的常用方法及应用详解

《python中time模块的常用方法及应用详解》在Python开发中,时间处理是绕不开的刚需场景,从性能计时到定时任务,从日志记录到数据同步,时间模块始终是开发者最得力的工具之一,本文将通过真实案例... 目录一、时间基石:time.time()典型场景:程序性能分析进阶技巧:结合上下文管理器实现自动计时

SpringSecurity 认证、注销、权限控制功能(注销、记住密码、自定义登入页)

《SpringSecurity认证、注销、权限控制功能(注销、记住密码、自定义登入页)》SpringSecurity是一个强大的Java框架,用于保护应用程序的安全性,它提供了一套全面的安全解决方案... 目录简介认识Spring Security“认证”(Authentication)“授权” (Auth