
ExtractJWT.fromAuthHeaderAsBearerToken() 方法将从请求的授权标头中提取 JWT 作为 Bearer 令牌。 如果找到 JWT,它将被解码并与 done 函数一起传递给该函数。 该函数将检查 JWT 中的用户对象以查看其是否有效。 如果有效,则调用带有用户对象的 done 函数,表明用户已通过身份验证,否则将调用 done 函数并出错。,对于 /signup 路由,我们将设置一个本地策略,它使用 passport-local 模块通过用户名(在本例中为他们的电子邮件地址)和密码对用户进行身份验证。 当用户注册时,我们将在数据库中创建一个新的用户文档并将其返回给 Passport。,我们仍然需要验证用户的密码。 在
/src/models/user.models.js 中,在 User 模型中创建一个名为 isValidPassword() 的方法。,isValidPassword 将密码作为参数,并使用 bcrypt 的比较方法将其与用户的散列密码进行比较。 该方法返回一个布尔值,指示密码是否匹配。,在
src/authentication/passport.js中,在登录策略中调用isValidPassword验证用户密码:,完整的文件应如下所示:,为了验证用户输入,我们将使用 Joi 库。 Joi 提供了一种简单但功能强大的方法来定义和验证 Node.js 应用程序中的数据结构。,在 /validators 目录中,创建一个名为 author.validator.js 的文件:,我们导出两个中间件函数,newArticleValidationMW 和 updateArticleValidationMW。 newArticleValidationMW 使用
newArticleValidationSchema 来验证新建文章请求的请求正文是否包含所有必填字段(标题、正文)以及所有提供的字段是否格式正确。 如果所有字段都有效,它将调用下一个函数以继续。 updateArticleValidationMW,与前者类似,但它使用 updateArticleValidationSchema 来验证更新文章请求的请求。,这两个函数都使用 Joi 库提供的 validateAsync 方法来执行验证。 此方法接受一个对象(请求主体)并返回一个承诺(promise),如果对象无效则拒绝该对象,如果对象有效则返回该对象。,在 /validators 目录中,创建一个名为 user.validator.js 的文件:,完成身份验证和验证后,我们就可以开始构建 API 路由和控制器了。,现在我们已经完成了 API 设计、模型设置、数据库连接建立和身份验证策略到位,是时候开始构建实际的 API 了。,express.Router() 函数创建一个新的路由对象,可用于定义将用于处理对服务器的 HTTP 请求的路由。,定义的第一个路由是路由器根路径中的 GET 路由。 此路由将处理对服务器的 HTTP GET 请求,并将使用 blogController 中的 getPublishedArticles 函数返回所有已发布文章的列表。,第二个路由是 GET 路由,在路径中包含一个参数 :articleId。 此路由将处理对路径中具有特定文章 ID 的服务器的 HTTP GET 请求,并将使用 blogController 中的 getArticle 函数返回具有指定 ID 的文章。,在 /routes 目录中创建一个名为 author.routes.js 的文件并编写以下代码:,在这里,我们导入了前文中创建的验证中间件:,当发出 POST 或 PATCH 请求时,验证中间件会检查请求主体的格式是否正确:,在 /routes 目录中为身份验证路由创建一个名为 auth.routes.js 的文件:,用户注册的路由使用 passport.authenticate() 函数,使用其注册策略对请求进行身份验证。 它还指定应使用 { session: false } 选项禁用session会话管理。 如果请求成功通过身份验证,则会将其传递给 authController.signup 函数进一步处理。,用户登录的路由类似,但它使用登录策略,如果身份验证成功,则将请求传递给 authController.login 函数。,这两个路由还使用 userValidator 中间件在将请求主体传递给控制器函数之前对其进行验证。,在 /routes 中创建一个 index.js 文件并导出路由:,导入路由并在 app.js 文件中使用它们。,请记住,我们将路由分为博客路由和作者路由,因为我们想保护作者路由的安全。 我们使用 passport 来保护 /author/blog 路由,这样只有经过身份验证的用户才能访问这些资源。 未经身份验证的用户只能访问 /blog 路由。,现在我们已经定义了路由,我们需要编写代码来处理请求并发送适当的响应。 控制器是匹配路由时调用的函数,负责处理请求和发送响应。,在 /controllers 目录中创建一个名为 blog.controllers.js 的文件。 在此文件中定义由博客路由调用的函数:,当匹配到 GET /blog 路由时,将调用 getPublishedArticles 函数,它将从数据库中检索所有已发布文章的列表,并将响应发送给客户端。 它首先从 req.query 对象中解构查询参数。 这些查询参数用于过滤和排序返回的文章。,此函数中的排序是使用 Mongoose .sort() 方法完成的,该方法将以字段名称作为键并将排序顺序作为值的对象作为参数。 字段名称和排序顺序在 sortQuery 对象中指定,该对象是根据 order 和 order_by 查询参数构造。,order_by 查询参数是一个字符串,可以包含多个字段名称,以逗号分隔。 sortAttributes 变量是这些字段名称的数组。 对于数组中的每个字段名,sortQuery 对象将以字段名作为键并以排序顺序作为值进行更新。 如果顺序查询参数是“asc”,排序顺序设置为1,如果顺序查询参数是“desc”,排序顺序设置为-1。,查找查询是使用 findQuery 对象构造的,该对象使用过滤器进行初始化以仅返回已发布的文章。 然后使用基于作者、标题和标签(如果存在)查询参数的附加过滤器更新 findQuery 对象。,例如,如果 author 查询参数存在,则 findQuery.author 字段设置为 author 查询参数的值。 这将过滤结果,以仅包括作者字段等于对应作者参数值的文章。 同样,如果存在 tags 查询参数,则 findQuery.tags 字段将设置为对应的 MongoDB 运算符,用于搜索标签与搜索标签匹配的文章。 搜索标签被指定为逗号分隔的字符串,并使用 split 方法拆分为一个数组。 $in 运算符用于搜索带有包含在搜索标签数组中标签的文章。,findQuery 对象作为参数传递给 BlogModel 对象的 .find() 方法。 此方法返回一个 Mongoose 查询对象,该对象可用于在博客集合中查找与指定过滤器匹配的文档。 然后在查询对象上调用 .populate() 方法以使用相应的用户文档填充作者字段,并且 .sort() 使用 sortQuery 对象对结果进行排序。 调用 .skip() 和 .limit() 对结果进行分页。 skip() 指定查询中要跳过的文档数,而 limit() 指定要返回的文档数。 page 和 per_page 查询参数用于确定传递给 skip() 和 limit() 的值。 默认情况下,page 设置为 1,per_page 设置为 20。这意味着如果未提供这些查询参数,默认行为是检索结果的第一页,每页 20 个文章。,getArticle 函数从数据库中检索具有指定 ID 的文章,并在将文章返回给客户端之前增加文章的阅读计数。,这两个函数都使用 async 关键字并包含一个 try/catch 块来处理函数执行期间可能发生的任何错误。 如果发生错误,将以错误作为参数调用next函数,以将错误传递给在我们的 app.js 中设置的错误处理中间件。,在 /controllers 目录中创建一个名为 author.controllers.js 的文件,并定义作者路由将调用的函数,如下所示:,createArticle 函数首先从 req.body 对象中解构新文章数据,并使用 blogService 模块中的 calculateReadingTime 函数计算文章的阅读时间,我们将在接下来创建该模块一些抽象功能。,该函数检查 newArticle 数据中是否存在标签(tags)字段,并使用 split 方法将标签字符串拆分为一个数组。 回想一下,标签在博客模型中被定义为一个数组。,接下来,如果用户上传封面图片,我们想要访问该文件,将其上传到云存储服务,获取上传图片的 URL 并将其保存到我们的数据库中。已安装的 express-fileupload 将允许我们访问 req.files 对象。,最后,该函数使用 newArticle 数据以及当前时间戳和用户 ID ,创建一个新的 BlogModel 实例,并使用 save 方法将其保存到数据库中。 我们使用 npm 模块 moment 来处理时间戳。 您可以通过运行 npm install moment 来安装 moment。,作者字段是引用用户模型的 ObjectId。 在这里,我们分配了用户的 ID,以便我们可以在需要时使用 Mongoose .populate 方法来检索作者的详细信息。,同样,我们希望能够获取用户创建的所有文章,因此接下来,我们在向客户端返回响应之前更新数据库中用户的文章数组以包含新文章的 ID。,在 editState 函数中,我们从数据库中检索文章并检查用户是否有权更改文章的状态。 如果用户拥有权限,我们会更新数据库中文章的状态和时间戳。,在 editArticle 函数中,我们从数据库中检索文章并检查用户是否有权编辑该文章。 如果用户获得授权,我们将更新数据库中的文章数据。,在 /controllers 目录中为身份验证路由创建一个名为 auth.controllers.js 的文件:,注册函数使用提供的名字、姓氏、电子邮件和密码创建一个新的用户对象。 然后将此用户对象保存到数据库,并返回一条成功消息和用户对象,对象中不包含密码字段。 永远不要暴露密码。,当用户尝试登录时调用登录函数。如果提供的电子邮件和密码与数据库中的用户不匹配,它将返回 401 状态代码和错误消息。 否则,它会创建一个 JWT,其中包含用户 ID 和电子邮件作为负载,并使用密钥(我们存储在 .env 文件中)对其进行签名。由于我们不使用会话,注销很棘手,所以我们已经 为令牌设置一小时的过期时间。该函数返回一条成功消息和 JWT。,在 /controllers 目录中创建一个名为 /index.js 的文件:,将 author.controller.js 的一些逻辑抽象为 blogService 模块。,在开始之前,我们将使用 Cloudinary,这是一个媒体管理平台,可让您存储、优化和传送图像和视频。 按照 Cloudinary 网站上的说明设置您的帐户,然后通过运行以下命令安装 SDK:,现在,在 /services 中,创建一个名为 blog.service.js 的文件,其中包含以下功能:,userAuth 函数检查发出请求的用户是否与正在访问的帖子的作者相同。 如果用户不是作者,它会抛出状态码为 401(未授权)的错误。,calculateReadingTime 函数以一段文本为参数,通过将文本中的字数除以每分钟平均字数来计算估计的阅读时间(以分钟为单位)(根据 Marc 的说法,成人的平均阅读速度约为 200wpm 来自比利时根特大学的 Brysbaert)。 然后它四舍五入到最接近的整数并返回一个包含阅读时间的字符串。,uploadImage 函数将图像上传到 Cloudinary 并返回安全 URL。 它以 req、res 和 next 作为参数,从 req 对象中检索上传图像的文件路径,并将其存储在 filePath 变量中(这是通过我们安装的 express-fileupload npm 包实现的)。 然后设置上传选项,包括 use_filename 和 overwrite 选项,这些选项指定上传的文件应使用其原始文件名并覆盖任何具有相同名称的现有文件。 然后该函数使用
cloudinary.uploader.upload 方法将文件上传到 Cloudinary。 如果上传成功,则返回上传文件的安全 URL。,在/services/index.js文件中:,有了路由和控制器,我们现在可以测试我们的 API 以确保它按预期工作。 您可以使用 Postman 测试 API 中的所有路由,以确保它们按预期工作。,要测试需要请求正文的路由,例如 POST 和 PATCH 路由,您需要在 Postman 请求表单中以适当的格式指定请求正文。 测试受保护路由时,您还需要在 Authorization 标头中提供token。,例如,如果您向 /author/blog 路由发送 POST 请求,请求正文中应该包含文章数据。,首先,您需要通过在终端中运行以下命令来启动服务器:,如果成功,您将获得成功响应:,如果成功,您将获得带有token的成功响应:,你应该得到一个 401(Unauthorised) 状态码。 再试一次,但添加一个带有不记名令牌 Bearer {token} 的授权标头。 将 {token} 替换为您登录后获得的令牌。您应该会收到成功响应:,测试其他路由。,就是这样! 通过实施和测试 API 路由和控制器,我们现在拥有一个功能齐全的博客 API。
文章版权声明
1 原创文章作者:cmcc,如若转载,请注明出处: https://www.52hwl.com/17889.html
2 温馨提示:软件侵权请联系469472785#qq.com(三天内删除相关链接)资源失效请留言反馈
3 下载提示:如遇蓝奏云无法访问,请修改lanzous(把s修改成x)
4 免责声明:本站为个人博客,所有软件信息均来自网络 修改版软件,加群广告提示为修改者自留,非本站信息,注意鉴别
微信扫一扫
支付宝扫一扫