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

相关文章

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

《Android悬浮窗开发示例((动态权限请求|前台服务和通知|悬浮窗创建)》本文介绍了Android悬浮窗的实现效果,包括动态权限请求、前台服务和通知的使用,悬浮窗权限需要动态申请并引导... 目录一、悬浮窗 动态权限请求1、动态请求权限2、悬浮窗权限说明3、检查动态权限4、申请动态权限5、权限设置完毕后

前端原生js实现拖拽排课效果实例

《前端原生js实现拖拽排课效果实例》:本文主要介绍如何实现一个简单的课程表拖拽功能,通过HTML、CSS和JavaScript的配合,我们实现了课程项的拖拽、放置和显示功能,文中通过实例代码介绍的... 目录1. 效果展示2. 效果分析2.1 关键点2.2 实现方法3. 代码实现3.1 html部分3.2

浅析如何使用Swagger生成带权限控制的API文档

《浅析如何使用Swagger生成带权限控制的API文档》当涉及到权限控制时,如何生成既安全又详细的API文档就成了一个关键问题,所以这篇文章小编就来和大家好好聊聊如何用Swagger来生成带有... 目录准备工作配置 Swagger权限控制给 API 加上权限注解查看文档注意事项在咱们的开发工作里,API

JS 实现复制到剪贴板的几种方式小结

《JS实现复制到剪贴板的几种方式小结》本文主要介绍了JS实现复制到剪贴板的几种方式小结,包括ClipboardAPI和document.execCommand这两种方法,具有一定的参考价值,感兴趣的... 目录一、Clipboard API相关属性方法二、document.execCommand优点:缺点:

Python利用自带模块实现屏幕像素高效操作

《Python利用自带模块实现屏幕像素高效操作》这篇文章主要为大家详细介绍了Python如何利用自带模块实现屏幕像素高效操作,文中的示例代码讲解详,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1、获取屏幕放缩比例2、获取屏幕指定坐标处像素颜色3、一个简单的使用案例4、总结1、获取屏幕放缩比例from

nginx-rtmp-module模块实现视频点播的示例代码

《nginx-rtmp-module模块实现视频点播的示例代码》本文主要介绍了nginx-rtmp-module模块实现视频点播,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习... 目录预置条件Nginx点播基本配置点播远程文件指定多个播放位置参考预置条件配置点播服务器 192.

基于Python开发PPTX压缩工具

《基于Python开发PPTX压缩工具》在日常办公中,PPT文件往往因为图片过大而导致文件体积过大,不便于传输和存储,所以本文将使用Python开发一个PPTX压缩工具,需要的可以了解下... 目录引言全部代码环境准备代码结构代码实现运行结果引言在日常办公中,PPT文件往往因为图片过大而导致文件体积过大,

使用DeepSeek API 结合VSCode提升开发效率

《使用DeepSeekAPI结合VSCode提升开发效率》:本文主要介绍DeepSeekAPI与VisualStudioCode(VSCode)结合使用,以提升软件开发效率,具有一定的参考价值... 目录引言准备工作安装必要的 VSCode 扩展配置 DeepSeek API1. 创建 API 请求文件2.

Java访问修饰符public、private、protected及默认访问权限详解

《Java访问修饰符public、private、protected及默认访问权限详解》:本文主要介绍Java访问修饰符public、private、protected及默认访问权限的相关资料,每... 目录前言1. public 访问修饰符特点:示例:适用场景:2. private 访问修饰符特点:示例:

基于Python开发电脑定时关机工具

《基于Python开发电脑定时关机工具》这篇文章主要为大家详细介绍了如何基于Python开发一个电脑定时关机工具,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 简介2. 运行效果3. 相关源码1. 简介这个程序就像一个“忠实的管家”,帮你按时关掉电脑,而且全程不需要你多做