开始在 Apigee Edge 上使用 Node.js

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

本主题介绍使用管理界面将 Node.js 应用封装在 API 代理中的最简单方法。

简介

您创建的第一个 Node.js 应用可能是 HTTP 服务器,它能以“Hello World!”响应请求如需在 Apigee Edge 上试用 Node.js,最简单的方法是执行非常类似的操作。只需点击几次鼠标,即可获得一个在 Edge 上运行且正常运行的代理 Node.js HTTP 服务器。然后,您可以使用界面中的代码编辑器修改 Node.js 应用、添加其他 Node.js 文件、添加政策等。

创建示例 Hello World!API 代理

本部分介绍如何创建与 Node.js HTTP 服务器交互的 Edge API 代理。我们已为您编写了 Node.js HTTP 服务器代码,并会在您按照这些简单步骤操作后,自动将其部署到 Edge。
  1. 在“Build a Proxy”向导中,选择 Node.js App
  2. 点击下一步
  3. 按照“构建代理”向导中的说明操作,并进行以下选择。
    字段 选择
    详细说明
    代理名称 输入 Nodejs-Hello。为您的 API 显示的名称。
    代理基本路径 输入 nodejs-hello
    来源 选择“Hello World”示例。(我们稍后会在本主题中讨论其他选项。)
    说明 输入 API 说明。
    安全性
    通过(无) 选择直通(无)。创建简单的直通式代理。
    虚拟主机
    默认, 安全 请勿更改默认设置。如需了解虚拟主机,请参阅虚拟主机(Beta 版)简介
    build
    部署环境 选择 test
  4. 点击构建和部署
    您应该会看到一则确认消息,告知您新的 API 代理已成功创建并部署在“测试”环境中。
  5. 点击 在编辑器中查看 <proxy name> 代理以显示 API 代理的详情页面。

调用 Hello 代理

当您调用 hello 代理时,Node.js 应用会自动执行,并返回“Hello, World!”。请注意,除非另行指定,否则 Node.js 应用将部署到名为 test 的环境中。以下是使用 Curl 的基本调用(将 myorg 替换为组织名称)。
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

查看和修改 Node.js 代码

我们来看一下添加到 API 代理中的 Node.js 代码。转到 Hello World 代理的摘要页面,然后点击开发



此时将打开包含代码编辑器的“开发”视图。您可以直接在该工具中修改代码。

例如,将响应从 Hello, World! 更改为其他值(如 Hello, Node!),然后点击 Save。系统会保存并重新部署代理。

最后,重新调用代理以验证更改:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

详细了解如何在 Apigee Edge 上运行 Node.js 应用

与所有 Node.js 应用一样,在 Apigee Edge 上运行的 Node.js 应用都在单个控制线程中运行。无需(实际上也无需)启动另一个线程,或在线程之间同步变量。由于 Node.js 强制执行非阻塞编程,因此单个脚本可以支持数千个并发请求,因为每当必须等待时,该脚本会让出 CPU,并且会在需要等待时通知它。

如需在 Apigee Edge 上使用 Node.js,您需要指定 Node.js 主脚本文件。此脚本必须配置为处理传入请求,通常使用 httphttps 模块、创建客户端等操作。(如果不是以这种方式配置主脚本,则它在部署后将直接执行并退出。)在 Apigee Edge 中,每个 Node.js 应用脚本在部署代理时都会从头开始,并在取消部署代理时停止。在此期间,它会等待新请求并处理它们。如需了解详情,请参阅部署独立的 Node.js 应用中的“调用导入的 Node.js 文件”。

后续步骤

您还可以直接从文件系统创建和部署独立的 Node.js 应用。下一个主题是部署独立的 Node.js 应用,其中介绍了如何使用 apigeetool 命令从命令行部署 Node.js 应用。