尽可能用少的代码实现 Serverless 与 S3 的交互-JavaScript中文网-JavaScript教程资源分享门户

Serverless 和 S3 可以一起使用，以实现创建无服务器的应用程序。借助 AWS Lambda，您可以使用少量代码与 Amazon S3 进行交互。在这篇文章中，我们将介绍如何使用 Serverless 框架和 S3 一起进行无服务器交互。同时，我们将展示如何使用 Serverless 框架和已有的 Node.js 库来简化处理 AWS 资源的过程。我们还将介绍在调试 Node.js 代码时使用 VSCode （Visual Studio Code）中的 Node.js 调试器。

简单的 Serverless 配置

让我们从一个简单的 Serverless 配置开始。下面是一份示例代码，用于在 AWS Lambda 中实现一个计算机工作负载：

// javascriptcn.com 代码示例
service: my-service
provider:
  name: aws
  runtime: nodejs12.x
  regional: us-west-2
  stage: dev

functions:
  compute:
    handler: handler.default
    memorySize: 256

在这个例子中，我们定义了一个服务 (“my-service“) 和一个函数 (“compute“)。函数使用了 Node.js 运行时环境，依赖于“handler”的入口函数。我们还设置了函数之间的 memorySize，以使其拥有足够的 RAM。现在，我们需要扩展这个功能以处理与 S3 的交互。

与 S3 交互

通过使用 Amazon S3 ，我们可以向 AWS 存储桶中添加对象，执行列操作并删除对象。本节将介绍如何使用 Node.js 操作 S3。

我们将使用 AWS SDK for Node.js 进行 S3 的交互。通过这种方法，我们将能够利用 Node.js 的强大特性对 AWS 资源进行操作。首先，让我们安装需要的 Node.js 模块：

npm install aws-sdk serverless-offline --save-dev

这将安装 AWS SDK for Node.js 和一个名为“serverless-offline”的 Serverless 插件。它可以让您在本地运行 Serverless 应用程序，而不必每次都上传代码。

列出 S3 存储桶

我们从简单的示例开始，该示例演示如何配置 S3 来列出存储桶。

我们需要做的是在Lambda中引用AWS SDK，并使用其中的S3服务方法。

// javascriptcn.com 代码示例
const AWS = require('aws-sdk');

module.exports.listObjects = async(event, context) => {
  const s3 = new AWS.S3();
  const response = await s3.listObjects({
    Bucket: 'my-bucket'
  }).promise();

  return {
    statusCode: 200,
    body: JSON.stringify(response)
  };
};

在这个示例中，我们只是引用了 AWS SDK，并用其中的S3服务方法进行了一个调用。我们设定了存储桶的名称，并使用“listObjects”来获取存储桶中的所有对象。我们使用“await”确保代码顺序执行。然后，我们将结果返回给调用者。

下载对象

让我们看看如何从 S3 存储桶中下载对象。

// javascriptcn.com 代码示例
const AWS = require('aws-sdk');
const fsp = require('fs').promises;

module.exports.getObject = async(event, context) => {
  const s3 = new AWS.S3();

  const response = await s3.getObject({
    Bucket: 'my-bucket',
    Key: 'my-key'
  }).promise();

  await fsp.writeFile('/tmp/my-file', response.Body);

  return {
    statusCode: 200,
    body: JSON.stringify({
      message: 'File successfully downloaded'
    })
  };
};

这个示例演示了如何使用“getObject”方法从 S3 存储桶中下载对象。我们设定了存储桶的名称和对象的名称。我们使用“await”确保执行文件下载操作。然后，我们将结果输出到下载位置和返回调用者的信息中。

Serverless framework 案例

我们已经查看了一些使用 Serverless 和 S3 进行交互的案例。现在，让我们看看一个完整的 S3 应用程序。我们将查看如何创建一个简单的 Serverless 应用程序，用于上传和下载图像。

写入文件

首先要做的是配置 AWS SDK 和指定一个文件名称：

// javascriptcn.com 代码示例
const AWS = require('aws-sdk');
const s3 = new AWS.S3();
const fileSizeLimit = 2;            // Size in MB
const bucket = 'my-s3-bucket';

module.exports.upload = async(event, context) => {
  // Getting the image and its data  
  const imgData = Buffer.from(event.body.replace(/^data:image\/\w+;base64,/, ''), 'base64');
  const contentType = event.headers['content-type'];
  const fileName = `${Date.now()}${event.queryStringParameters.filename}`;

  // Checking file size
  if (event.body == null) {
    return {
      statusCode: 400,
      body: JSON.stringify({
        error: 'No file'
      })
    };
  } else if ((imgData.byteLength / 1024 / 1024) > fileSizeLimit) {
    return {
      statusCode: 400,
      body: JSON.stringify({
        error: 'File too big'
      })
    };
  }

  // Writing to server
  const params = {
    Bucket: bucket,
    Key: fileName,
    Body: imgData,
    ACL: 'public-read',
    ContentType: contentType
  };

  await s3.upload(params, function(err, data) {
    if (err) {
      return {
        statusCode: 400,
        body: JSON.stringify({
          error: err
        })
      };
    } else {
      return {
        statusCode: 200,
        body: JSON.stringify({
          url: data.Location
        })
      };
    }
  });
};

在这个示例中，我们使用“upload”方法将一个新的文件写入存储桶。

我们首先获取了图像，并检查文件大小是否超出了限制（在本例中我们选择了2MB）。如果文件大小符合条件，我们使用“upload”命令将图像上传到存储桶中。我们返回一个 URL，以便后续的操作可以使用该 URL 来访问该文件。

读取文件

我们的接口如下：

// javascriptcn.com 代码示例
const AWS = require('aws-sdk');
const s3 = new AWS.S3();
const bucket = 'my-s3-bucket';

module.exports.download = async(event, context) => {
  const fileName = event.pathParameters.filename;
  
  try {
    const data = await s3.getObject({
      Bucket: bucket,
      Key: fileName
    }).promise();
  
    return {
      statusCode: 200,
      headers: {
        'Content-Type': data.ContentType
      },
      body: data.Body.toString('base64'),
      isBase64Encoded: true
    };
  } catch (e) {
    return {
      statusCode: 404,
      body: JSON.stringify({
        error: `There was an error downloading the file: ${e.message}`
      })
    };
  }
};

这支持接受一个文件名称，然后从存储桶中检索文件并返回其内容。

在这个示例中，我们只是获取了封存的数据，并将其作为 Base64 字符串返回。这意味着您可以使用基于 Web 的应用程序(如Angular，React 等)来展示文件。

Node.js 调试器

使用 Node.js 源代码编写 AWS Lambda 源代码时，调试非常重要。一种常见的方法是使用 Node.js 浏览器调试器进行调试。

在 VSCode 中，您可以简单地打开文件并在需要断点的行点击一个小圆圈即可设置断点。然后，您可以单击“开始调试”按钮，并选择“Node.js”环境。VSCode 会自动启动 Node.js 调试器，您可以在此完成调试工作。

Serverless 应用程序会包含多个 Node.js 文件，因此调试可以变得困难。但是有一个简单的技巧可以让您更轻松地调试。您可以在“launch.json”文件中指定要包含的文件，例如：

// javascriptcn.com 代码示例
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Lambda",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/node_modules/serverless/bin/serverless",
      "args": [
        "invoke",
        "local",
        "-f",
        "my-function",
        "--path",
        "test.json"
      ],
      "runtimeExecutable": "node",
      "outFiles": [
        "${workspaceFolder}/.serverless/**"
      ]
    }
  ]
}

在这个示例中，我们指定了 VSCode 应该在启动 Serverless 应用程序之前进行哪些操作。我们告诉它在“../.serverless”目录中找到调用功能的代码，并在断点处暂停执行。这样可以使代码更易于调试。

通过使用这个技巧，您不必每次打开 VSCode 时都手动设置断点。如果您在 VSCode 中使用 JavaScript 文件和 Serverless 应用程序来创建 AWS Lambda 函数，则这是您将要了解的一些技巧。

总结

本文中，我们介绍了如何使用 Serverless 和 S3，以实现无服务器应用程序的交互。我们还讨论了如何使用 Node.js 和 AWS SDK 操作 S3 并跨框架进行操作。最后，我们还介绍了如何使用 VSCode 的 Node.js 调试器，以提高开发效率。希望本文对刚刚入门的前端开发人员提供了指导，以及帮助经验更丰富的开发人员进一步提升他们的前端技能。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/65200c1d95b1f8cacd794d78