NodeJS 초보자는 종종 API를 이해하기 어렵다고 생각합니다. 다행히도 많은 개발자가 Node.js 작업을 더 쉽게 해주는 프레임워크를 만들었습니다. Connect는 그러한 프레임워크입니다. Node의 API 위에 위치하며 편안함과 제어 사이의 경계를 그립니다.
Connect를 미들웨어 스택으로 생각하세요. 각 요청에 대해 Connect는 미들웨어 계층을 통해 필터링되며, 각 계층은 HTTP 요청을 처리할 수 있는 기회를 얻습니다. T.J. Holowaychuk은 Connect를 발표했을 때 두 가지 유형의 미들웨어가 있다고 말했습니다. 첫 번째는 Filter입니다.
필터는 요청을 처리하지만 응답하지 않습니다(서버 로깅을 생각해 보세요).
또 다른 유형은 요청에 응답하는 Provider입니다. 원하는 만큼 미들웨어를 결합할 수 있습니다. 요청은 미들웨어 중 하나가 요청에 응답할 때까지 각 계층을 통과합니다.
먼저 npm을 통해 Connect 패키지를 설치해야 합니다.
으아악이제 server.js
파일을 만들고 다음 코드를 추가하세요.
connect
변수는 새로운 Connect 애플리케이션을 반환하는 함수입니다. 따라서 다음 단계는 앱을 만드는 것입니다.
대부분의 앱을 연결하려면 app
变量。创建应用程序涉及的函数(connect()
和 use()
)을 생성할 필요가 없습니다.
use()
函数向应用程序添加了一层中间件,而 listen()
함수는 애플리케이션에 지정된 포트(이 경우 3000)에서 연결 수락을 시작하도록 지시합니다.
간단한 것부터 시작해 보겠습니다. 바로 로깅입니다. 로깅 미들웨어만 사용하는 Connect 앱의 코드는 매우 간단합니다.
으아악기본적으로 Node는 들어오는 요청을 거의 구문 분석하지 않습니다.
이 코드를 파일에 추가하고 node server.js
를 실행하여 서버를 시작하세요. 브라우저에서 임의의 경로로 이동하고 "...을 얻을 수 없습니다." 결과를 무시하십시오. 우리는 서버가 브라우저에 다시 보내는 내용에는 관심이 없습니다. 서버의 로그에 관심이 있습니다. 터미널을 보면 요청 로그가 표시됩니다. 추가 기능 및 사용자 정의에 대한 정보는 로거 설명서를 확인하세요.
그것은 필터였습니다. 이제 공급자를 살펴보겠습니다. 가장 간단한 공급자는 지정된 폴더에서 정적 파일을 제공하는 정적 공급자입니다. 구문은 다음과 같습니다.
으아악Node의 __dirname
변수의 목적을 추측할 수 있습니다. 현재 디렉터리의 경로입니다. 이 미들웨어는 현재 디렉터리의 public
폴더에 있는 모든 항목을 정적으로 제공합니다. 따라서 public/page.html
을 만들고 <h1></h1>
요소를 추가하세요. 서버를 다시 시작하고(__dirname
变量的用途:它是当前目录的路径。该中间件静态地提供当前目录中 public
文件夹中的任何内容。因此,创建 public/page.html
并添加 <h1></h1>
元素。重新启动服务器(node server.js
),然后在浏览器中导航到 localhost:3000/page.html
。您应该在浏览器中呈现 page.html
) 브라우저에서 localhost:3000/page.html
로 이동합니다. 브라우저에서 page.html
을 렌더링해야 합니다.
이제 Connect의 다른 미들웨어 옵션 중 일부를 간단히 살펴보겠습니다.
기본적으로 Node는 들어오는 요청을 거의 구문 분석하지 않지만 더 복잡한 상황을 처리해야 하는 경우 여러 필터를 결합하여 요청을 구문 분석할 수 있습니다. 네 가지 필터가 있습니다:
connect.json()
解析 JSON 请求体(其中 content-type
为 application/json
). connect.urlencoded()
解析 x-ww-form-urlencoded
요청 본문. connect.multipart()
解析 multipart/form-data
요청 본문. connect.bodyParser()
는 위의 세 가지 기능을 모두 활성화하는 바로가기입니다. 이 필터 중 하나를 사용하면 request.body
访问已解析的正文(我们很快就会讨论如何获取 request
개체를 전달할 수 있습니다.
저는 이 필터가 Connect를 통해 어떻게 세밀한 제어가 가능한지 보여주는 좋은 예라고 생각합니다. 아주 적은 처리만으로 애플리케이션을 단순화할 수 있습니다.
쿠키와 세션은 모든 웹 애플리케이션의 중요한 부분이며 이를 관리하는 데 도움이 되는 여러 미들웨어가 있습니다. connect.cookieParser()
会为您解析 cookie,您可以通过 request.cookies
对象检索 cookie 及其值。如果您将 connect.session()
앱에 필터를 추가하면 더욱 유용해집니다. 이 필터를 사용하려면 쿠키 파서가 있어야 합니다. 다음은 작은 예입니다:
작성하는 모든 미들웨어 함수는 요청을
next
레이어에 전달하거나 요청에 응답해야 합니다.
cookieParser
之后,我们包含 session
필터에 두 가지 옵션을 전달합니다:
secret
创建一个签名 cookie,用于跟踪会话。cookie.maxAge
定义其生命周期(以毫秒为单位);此代码中的 30000 是 30 秒。在最后的 use()
调用中,我们传递一个响应请求的函数。我们使用 request
对象中的两个属性:req.session
用于会话数据,req.url
用于请求 URL。
如果应用程序收到对 /name/some_name
的请求,则它将值 some_name
存储在 req.session.name
中。会话中存储的任何内容都可以在会话期间的后续请求中检索。对 /name/other
发出的任何请求都会替换会话变量,对其他 URL 的任何请求都会输出会话变量的值和会话剩余时间。
因此,您可以导航到 localhost:3000/name/your_name
,然后转到 localhost:3000
查看 your_name
。刷新页面几次并观察秒数倒计时。当会话过期时,您将看到默认的“未存储名称”消息。
我提到 cookieParser
过滤器必须位于 session
之前。
包含的顺序对于中间件很重要,因为请求是按顺序从一层传递到另一层的。
由于session
需要解析后的cookie数据,因此请求必须先经过cookieParser
,然后再经过session
。
我可以解释所有其他内置中间件,但在我们编写自己的代码与 Connect 交互之前,我只会再提一些。
您刚刚学习了如何使用 Connect 编写自己的代码。这是基本语法:
.use(function (req, res, next) { })
函数的三个参数很重要;它们提供了通往外部世界的通道。 req
参数当然是请求对象,res
是响应。第三个参数 next
是使函数在中间件堆栈中正常运行的关键。它是一个将请求传递到堆栈中的下一个中间件的函数。请参阅此示例:
connect() .use(function (req, res, next) { if (req.method === 'POST') { res.end("This is a POST request"); } else { next(); } }) .use(function (req, res) { res.end("This is not a POST request (probably a GET request)"); }).listen(3000);
这段代码使用了两个中间件函数。第一个函数检查请求方法以查看是否是 POST 请求。如果是,它就会这样回应。否则,我们调用 next()
并将请求传递给下一个函数,该函数无论如何都会响应。使用 curl
在终端中测试两层:
$ curl http://localhost:3000 This is not a POST request (probably a GET request) $ curl -X POST http://localhost:3000 This is a POST request
如果您不喜欢该终端,请尝试这个有用的 Chrome 插件。
重要的是要记住,您编写的每个中间件函数都需要将请求传递到 next
层或响应请求。如果您的函数分支(通过 if 语句或其他条件),您必须确保每个分支都会传递请求或响应请求。如果您的应用程序在浏览器中挂起,可能是因为您忘记在某个时刻调用 next()
。
现在,那些 request
和 response
参数怎么样?这些与您在使用“原始”节点服务器时收到的请求和响应对象完全相同:
require("http").createServer(function (req, res) { // ... }).listen(3000);
如果您以前没有使用过 Node 的服务器 API,让我向您展示可以用它做什么。
request
对象实际上是一个http.IncomingMessage
对象,其重要属性如下::
req.method
告诉您使用了哪种 HTTP 方法。req.url
告诉您请求的是哪个 URL。req.headers
是一个包含标头名称和值的对象。req.query
是一个包含查询字符串中任何数据的对象(要解析它,您需要 connect.query()
中间件)。req.body
是表单数据的对象(您需要一些正文解析中间件)。req.cookies
是cookie数据的对象(需要cookie解析)。req.session
是会话数据的对象(同样,您需要 cookie 解析和会话中间件)您可以使用以下代码查看所有这些工作:
connect() .use(connect.query()) // gives us req.query .use(connect.bodyParser()) // gives us req.body .use(connect.cookieParser()) // for session .use(connect.session({ secret: "asdf" })) // gives us req.session .use(function (req, res) { res.write("req.url: " + req.url + "\n\n"); res.write("req.method: " + req.method + "\n\n"); res.write("req.headers: " + JSON.stringify(req.headers) + "\n\n"); res.write("req.query: " + JSON.stringify(req.query) + "\n\n"); res.write("req.body: " + JSON.stringify(req.body) + "\n\n"); res.write("req.cookies: " + JSON.stringify(req.cookies) + "\n\n"); res.write("req.session: " + JSON.stringify(req.session)); res.end(); }).listen(3000);
要查看其中每个值的某些内容,您需要使用查询字符串将一些数据发布到 URL。以下内容应该足够了:
curl -X POST -d "name=YourName" "http://localhost:3000/some/url?some=data"
通过这七个属性,您几乎可以管理收到的任何请求。我不认为经常使用预告片(根据我的经验,我从未见过它们),但是如果您希望在请求中使用预告片,则可以使用 req.trailers
(预告片就像标头一样,但位于正文之后)。
那么,你的回应呢?
原始响应对象不提供库(如 Express)为您提供的便利。例如,您无法通过对预制模板的简单渲染调用来响应 - 至少默认情况下不能。响应中的假设很少,因此您需要填写所有小细节。
我们将从状态代码和响应标头开始。您可以使用 writeHead()
方法一次性设置所有这些。以下是 Node 文档中的示例:
var body = 'hello world'; response.writeHead(200, { 'Content-Length': body.length, 'Content-Type': 'text/plain' });
如果需要单独设置header,可以使用setHeader()
方法:
connect() .use(function (req, res) { var accept = req.headers.accept.split(","), body, type; console.log(accept); if (accept.indexOf("application/json") > -1) { type = "application/json"; body = JSON.stringify({ message: "hello" }); } else if (accept.indexOf("text/html") > -1) { type = "text/html"; body = "<h1> Hello! </h1>"; } else { type = "text/plain"; body = "hello!"; } res.statusCode = 200; res.setHeader("Content-Type", type); res.end(body); }).listen(3000);
将此代码添加到文件中,启动服务器并从浏览器请求它。你有 HTML!现在运行:
curl http://localhost:3000
您将收到纯文本。对于 JSON,请尝试以下操作:
curl -H "accept:application/json" http://localhost:3000
全部来自同一个 URL!
如果您需要知道已经设置了哪些标头,请使用 res.getHeader(name)
。您还可以使用 res.removeHeader(name)
删除标头。
当然,没有正文的响应是没有用的。正如您在本教程中所看到的,您可以使用 res.write()
方法将数据块写入正文。它接受字符串或缓冲区对象作为参数。如果是字符串,第二个参数是编码类型(默认为utf8
)。
res.end()
方法关闭主体,但您可以向其传递数据以写入响应流。这在您只需要输出一行的情况下非常有用。
在普通的旧 Node 和 Connect 中响应较大的 HTML 主体有些困难。这是将第三方中间件加入其中的好地方。您可以在 Connect Github wiki 上找到第三方中间件的列表。例如,我们将使用 connect-jade 包,它允许我们渲染 jade 视图。
首先,安装connect-jade
:
npm install connect-jade
接下来,需要并将其添加为中间件。您需要设置一些默认值:
var connect = require("connect"), connectJade = require("connect-jade"); connect() .use(connectJade({ root: __dirname + "/views", defaults: { title: "MyApp" } })) .use(function (req, res) { res.render("index", { heading: "Welcome to My App" }); }).listen(3000);
将根目录设置为包含视图文件的目录。您还可以设置 defaults
;这些是每个视图中可用的变量,除非我们稍后在调用 render()
时覆盖它们。
此代码中的最后一个函数调用 res.render()
。该方法由 connect-jade
包提供。
它接受的第一个参数是要渲染的视图的名称。
它是视图的路径,无我们在添加中间件时定义的路径,无 jade 文件扩展名。对于这段代码,我们需要一个 views/index.jade
模板来渲染。我们会保持简单:
html head title= title body h1= heading
如果您不熟悉jade,我们会缩进标签名称来创建HTML 结构。等号检索 JavaScript 变量的值。这些变量来自我们设置的 defaults
,加上传递给 res.render()
的(可选)第二个参数对象。
还有许多其他第三方中间件,但它们的工作原理彼此相似。您可以通过 npm 安装它们、需要它们并将它们付诸实践。
如果你深入研究 Connect 的工作原理,你会发现每一层实际上都是一个 Node 模块——这是一个非常智能的设计。如果您将 Connect 用于大型应用程序,那么以 Node 模块格式编写代码将是理想的选择。您可能有一个 app.js
文件,如下所示:
// app.js module.exports = function (req, res, next) { res.end("this comes from a module"); };
在你的 server.js
中:
var connect = require("connect"), app = require("./app"); connect() .use(app) .listen(3000);
如果您想要一个适合初学者的库来轻松构建大型 Web 应用程序,那么 Connect 不是您的解决方案。 Connect 旨在成为原始 Node API 之上的一个薄层,让您可以完全控制服务器应用程序。如果你想要更多,我推荐 Express(顺便说一下,是同一个人做的)。除此之外,Connect 是一个出色的、可扩展的 Node Web 应用程序库。
위 내용은 Connect 프레임워크로 연결의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!