koa开启cors允许跨域,携带cookies

koa开启cors允许跨域,携带cookies,第1张

使用koa开发想要开启 cors 非常简单,已经有对应的库: @koa/cors 。

虽然库的readme没有具体介绍具体的用法,但是我们可以通过阅读测试用例知道可以传什么参数,什么类型。

只需要两行,接口就会在返回数据的时候带上 Access-Control-Allow-Origin 响应头。默认允许所有请求方式跨域, Access-Control-Allow-Origin 默认为 * 。

为了安全考虑,携带cookies的跨域请求只允许 Access-Control-Allow-Origin 为单一域名,即只支持一个域名在请求的时候携带cookies。且需要带上响应头 Access-Control-Allow-Credentials

对 @koa/cors 添加配置 origin 和 credentials :

同时,前端要发起携带cookies的跨域请求,需要设置 XMLHttpRequest 的 withCredentials 为 true ,如果你是使用 axios ,只需要在请求配置里加上一句 withCredentials: true ,请看例子:

这样前端( http://koa.com )就可以向后端( http://localhost:8000 )发送请求了。

如果你的前端地址只有一个,给 @koa/cors 的 origin 添加一个域名就能满足需求,如果需要支持跨域的域名有多个呢?

通过观察 @koa/cors 的 单元测试用例 ,可以发现 origin 是支持用函数的方式传入的。这样我们就可以维护一个域名数组,判断请求地址是否在域名数组内,就能知道是否要对请求地址提供携带cookies请求支持了。

要想知道发起请求的前端地址,可以使用 ctx.request.header.origin 。注意 ctx.request.header.origin 和 ctx.request.origin 是不同的。 ctx.request.origin 是接口域名, ctx.request.header.origin 是发起请求的页面域名。

Koa 是基于 node.js 平台平台的 web 开发框架,如今也被广泛地运用,中文官方地址: Koa

本文将介绍 Koa 的简单应用,并且依托 Koa 搭建一个简单的 web 服务

首先,我们需要先通过 npm i koa 安装 koa,然后在项目中引入:

如下:

要在 koa 中使用 session ,需要先引入 koa-session ,设置 app.keys 作为 session 对应 cookie 的签名,如下配置:

要在 koa 中使用 cookies ,则直接通过 ctx.cookies.set() 和 ctx.cookies.get() 使用即可,如下:

原始方法中,我们需要先封装一个异步方法接收数据:

然后在 koa 中使用:

而我们可以通过 bodyparser 中间件更轻松地实现:

通常,将静态资源放在 static 文件夹中,然后通过以下配置静态文件:

中间件的使用在 node 中十分重要,用好中间件可以极大提高我们的开发效率以及项目的性能

中间件通过 app.use(async (ctx,next)={...}) 的方式定义, ctx 是当前请求的上下文,包含当前信息,而 next 则是定义继续向下匹配中间价以及路由,在中间件中一定要调用 await next()

配置匹配路由的 *** 作,通过以下方式:

设置好路由后,需要启动路由并且监听端口,如下:

本文介绍 koa 的基础用法,供参考

koa 是由 Express 原班人马打造的,致力于成为一个更小、更富有表现力、更健壮的 Web 框架。使用 koa 编写 web 应用,通过组合不同的 generator,可以免除重复繁琐的回调函数嵌套,并极大地提升错误处理的效率。koa 不在内核方法中绑定任何中间件,它仅仅提供了一个轻量优雅的函数库,使得编写 Web 应用变得得心应手。

Koa需要 node v7.6.0或更高版本来支持ES2015、异步方法

你可以安装自己支持的node版本。

在node <7.6的版本中使用async 函数, 我们推荐使用babel's require hook.

为了解析和转译异步函数,你应该至少有transform-async-to-generator or transform-async-to-module-method这2个插件。例如,在你的.babelrc文件中,应该有如下代码

也可以使用env preset并设置"node": "current"来替代.

Koa 应用是一个包含一系列中间件 generator 函数的对象。 这些中间件函数基于 request 请求以一个类似于栈的结构组成并依次执行。 Koa 类似于其他中间件系统(比如 Ruby's Rack 、Connect 等), 然而 Koa 的核心设计思路是为中间件层提供高级语法糖封装,以增强其互用性和健壮性,并使得编写中间件变得相当有趣。

Koa 包含了像 content-negotiation(内容协商)、cache freshness(缓存刷新)、proxy support(代理支持)和 redirection(重定向)等常用任务方法。 与提供庞大的函数支持不同,Koa只包含很小的一部分,因为Koa并不绑定任何中间件。

任何教程都是从 hello world 开始的,Koa也不例外^_^:

Koa 的中间件通过一种更加传统(您也许会很熟悉)的方式进行级联,摒弃了以往 node 频繁的回调函数造成的复杂代码逻辑。 然而,使用异步函数,我们可以实现"真正" 的中间件。与之不同,当执行到 yield next 语句时,Koa 暂停了该中间件,继续执行下一个符合请求的中间件('downstrem'),然后控制权再逐级返回给上层中间件('upstream')。

下面的例子在页面中返回 "Hello World",然而当请求开始时,请求先经过 x-response-time 和 logging 中间件,并记录中间件执行起始时间。 然后将控制权交给 reponse 中间件。当一个中间件调用next()函数时,函数挂起并控件传递给定义的下一个中间件。在没有更多的中间件执行下游之后,堆栈将退出,并且每个中间件被恢复以执行其上游行为。

应用配置是 app 实例属性,目前支持的配置项如下:

Koa 应用并非是一个 1-to-1 表征关系的 HTTP 服务器。 一个或多个Koa应用可以被挂载到一起组成一个包含单一 HTTP 服务器的大型应用群。

如下为一个绑定3000端口的简单 Koa 应用,其创建并返回了一个 HTTP 服务器,为 Server#listen() 传递指定参数(参数的详细文档请查看nodejs.org)。

The app.listen(...) 实际上是以下代码的语法糖:

这意味着您可以同时支持 HTTPS 和 HTTPS,或者在多个端口监听同一个应用。

返回一个适合 http.createServer() 方法的回调函数用来处理请求。 您也可以使用这个回调函数将您的app挂载在 Connect/Express 应用上。

为应用添加指定的中间件,详情请看 Middleware

设置签名cookie密钥。

该密钥会被传递给KeyGrip, 当然,您也可以自己生成 KeyGrip. 例如:

在进行cookie签名时,只有设置 signed 为 true 的时候,才会使用密钥进行加密:

app.context是从中创建ctx的原型。 可以通过编辑app.context向ctx添加其他属性。当需要将ctx添加到整个应用程序中使用的属性或方法时,这将会非常有用。这可能会更加有效(不需要中间件)和/或更简单(更少的require()),而不必担心更多的依赖于ctx,这可以被看作是一种反向模式。

例如,从ctx中添加对数据库的引用:

注:

默认情况下Koa会将所有错误信息输出到 stderr, 除非 app.silent 是 true.当err.status是404或者err.expose时,默认错误处理程序也不会输出错误。要执行自定义错误处理逻辑,如集中式日志记录,您可以添加一个"错误"事件侦听器:

如果错误发生在 请求/响应 环节,并且其不能够响应客户端时,Contenxt 实例也会被传递到 error 事件监听器的回调函数里。

当发生错误但仍能够响应客户端时(比如没有数据写到socket中),Koa会返回一个500错误(Internal Server Error)。 无论哪种情况,Koa都会生成一个应用级别的错误信息,以便实现日志记录等目的。

Koa Context 将 node 的 request 和 response 对象封装在一个单独的对象里面,其为编写 web 应用和 API 提供了很多有用的方法。 这些 *** 作在 HTTP 服务器开发中经常使用,因此其被添加在上下文这一层,而不是更高层框架中,因此将迫使中间件需要重新实现这些常用方法。

context 在每个 request 请求中被创建,在中间件中作为接收器(receiver)来引用,或者通过 this 标识符来引用:

许多 context 的访问器和方法为了便于访问和调用,简单的委托给他们的 ctx.request 和 ctx.response 所对应的等价方法, 比如说 ctx.type 和 ctx.length 代理了 response 对象中对应的方法,ctx.path 和 ctx.method 代理了 request 对象中对应的方法。


欢迎分享,转载请注明来源:内存溢出

原文地址:https://54852.com/tougao/11317191.html

(0)
打赏 微信扫一扫微信扫一扫 支付宝扫一扫支付宝扫一扫
上一篇 2023-05-15
下一篇2023-05-15

发表评论

登录后才能评论

评论列表(0条)

    保存