GraphQL 中如何实现文件上传和下载？

AI 编程助手，豆包旗下的编程助手，提供智能补全、智能预测、智能问答等能力，节省开发时间，释放脑海中的创造力，支持 VSCode，点击体验 AI

GraphQL 是一种查询语言和运行时环境，用于管理 API 中的数据。GraphQL 的优点在于有着强大的类型系统和灵活的查询语言，允许客户端只请求所需的数据，避免了 REST API 中过度获取数据的问题。

然而，GraphQL 难以处理文件上传和下载这类操作，因为文件通常需要使用 multipart/form-data 格式进行传输，而不是像 JSON 和 GraphQL 查询一样的普通格式。

在本文中，我们将学习如何在 GraphQL 中实现文件上传和下载的功能，并提供一些示例代码供参考。

文件上传

在 GraphQL 中处理文件上传的方法主要有两种：一是基于 Multipart/form-data 格式的传输；二是使用 Base64 编码字符串的方式。

Multipart/form-data 格式

在使用 Multipart/form-data 格式进行文件上传时，客户端需要将数据打包为多部分的形式发送给服务端。每个部分都必须带有 Content-Disposition 首部指定其类型和名称。服务端需要根据 Content-Disposition 处理上传文件的部分。

以下是一个示例的 GraphQL 查询：

-------- ----------------- -------- -
  ----------------- - ----- ----- -- -
    --
    --------
    --------
  -
-

其中，文件上传参数 file 声明为 Upload 类型。

在客户端，可以使用 FormData 对象构建表单，将需要上传的文件添加到其中，并将其作为 fetch 方法的第二个参数传递。

以下是一个使用了 FormData 的示例代码：

----- ----- - ---------------------------------------
----- ---- - --- -----------
------------------------- ----------------
  ------ -
    -------- ----------------- -------- -
      ----------------- - ----- ----- -- -
        --
        --------
        --------
      -
    -
  --
  ---------- -
    ----- -----
  --
----
------------------ ---------------- ---- ------------------ ----
---------------- ----------------

----------------- -
  ------- -------
  ----- -----
----------- -- --------------------- -- -------------------

在服务端，需要使用 graphql-upload 这个中间件来承载上传的文件。以下是使用 graphql-upload 的示例：

----- - ------------- --- - - ---------------------------------
----- ------- - -------------------
----- - ----------------- - - --------------
----- - -------------------- - - --------------------------

----- -------- - ----
  ------ ------

  ---- ---- -
    --- ---
    --------- -------
    --------- -------
  -

  ---- -------- -
    ----------------- --------- -----
  -
--

----- --------- - -
  --------- -
    ----------- ----- --- - ----- -- -- -
      ----- - ----------------- --------- -------- - - ----- ------
      ----- ------ - -------------------
      ----- ---- - - --- ---------- --------- -------- --
      ----- ---- - --------------------------------
      ----- --- --------------- -- ------------------------------------------------ ----------
      ------ -----
    --
  --
--

----- ------ - --- --------------
  ---------
  ----------
---

----- --- - ----------

------------------------------ ------------ --------- --------- -- ----

------------------------ --- ---

---------------- -- -- ------------------- ------- -- -------------------------

Base64 编码

在使用 Base64 编码上传文件时，客户端需要将文件数据转换为一个 Base64 编码的字符串，然后将其包含在 GraphQL 查询中。服务端需要将 Base64 解码后处理上传的文件。

以下是一个使用 Base64 编码上传文件的示例：

-------- ----------------- -------- -
  ----------------- - ----- ----- -- -
    --
    --------
    --------
  -
-

上传参数 file 声明为 String 类型。

在客户端，可以使用 FileReader 对象读取文件数据，将其转换为 Base64 编码的字符串，并将其作为 GraphQL 查询中文件参数的占位符。

以下是一个使用了 FileReader 的示例代码：

----- ----- - ---------------------------------------
----- ------ - --- -------------
------------------------------- -- -- -
  ----- ---- - ---------------------------------------------- - ---
  ----------------- -
    ------- -------
    -------- - --------------- ------------------ --
    ----- ----------------
      ------ -
        -------- ----------------- -------- -
          ----------------- - ----- ----- -- -
            --
            --------
            --------
          -
        -
      --
      ---------- - ----- ---- --
    ---
  ----------- -- --------------------- -- -------------------
---
-------------------------------------

在服务端，需要在代码中解码 Base64 编码的文件数据，如下所示：

----- - ------------- --- - - ---------------------------------
----- ------- - -------------------
----- - ----------------- - - --------------
----- - ---- - - ----------------

----- -------- - ----
  ---- ---- -
    --- ---
    --------- -------
    --------- -------
  -

  ---- -------- -
    ----------------- --------- -----
  -
--

----- --------- - -
  --------- -
    ----------- ----- --- - ----- -- -- -
      ----- --- - ------------------ ----------
      ----- -------- - ------- - ----------------------- - --- - ------------ -------------------
      ----- -- - ------------------------
      ----- ---- - - --- --------- --------- -------------------------- --
      ----- ---- - --------------- -------- ---------
      ----- --- --------------- -- --------------------------------------------- ----------
      ------ -----
    --
  --
--

----- ------ - --- --------------
  ---------
  ----------
---

----- --- - ----------

------------------------ --- ---

---------------- -- -- ------------------- ------- -- -------------------------

文件下载

在 GraphQL 中实现文件下载通常需要借助于 HTTP 响应，服务端需要将文件数据作为响应数据发送给客户端。React-Native 和 React DOM 支持使用 URL.createObjectURL() 方法将响应转化为本地 url。

以下是一个使用 GraphQL 下载文件的示例：

----- ----------------- ---- -
  ---------------- ----
-

其中，查询参数 id 指定要下载的文件的 ID。

在服务端，需要通过 ID 查询文件数据，并将其作为响应数据重定向到需要下载该文件的页面。

以下是一个使用了 express 的示例代码：

----- - ---- - - ----------------
----- ------- - -------------------

----- --- - ----------

------------------------ ----- ---- -- -
  ----- ---- - --------------- -------- ---------------
  -------------------
---

---------------- -- -- ------------------- ------- -- -------------------------

在客户端，我们需要发送一个 HTTP 请求到服务端，然后使用传统的下载方式来下载文件。

以下是一个使用了 fetch 的示例代码：

----- ------------ - ----- ---- --------- -- -
  ----- --- - ----- -------------------------
  ----- --- - ----- --- --------------- -- -
    ----- ---- - -----------
    ----- --------- - --------------------------
    -------------------
  ---
  ----- ---- - ----------------------------
  --------- - ----
  ----------------------------- ----------
  -------------
--

结论

通过本文的学习，我们了解到了如何在 GraphQL 中实现文件的上传和下载功能。在上传文件时，我们需要借助于 graphql-upload 中间件来处理请求体，支持用户使用 multipart/form-data 格式进行文件上传和处理。在下载文件时，我们需要依赖于服务端的 HTTP 响应和客户端的传统下载方式。这些方法为在 GraphQL 中使用文件提供了强大的基础。

希望本文能为您在 GraphQL 开发中的文件操作提供有益的指导和启示。

来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/6721c8352e7021665e08bce3

阅读全文

猜你喜欢

  • 解决 Custom Elements 遇到的元素生命周期问题

    Custom Elements 是一项 Web Components API，允许开发者创建自定义 HTML 元素，这些元素可以完全贴合业务逻辑从而增强页面的功能。

    9 天前
  • RxJS 的应用场景及优缺点分析

    RxJS 是响应式编程库的 JavaScript 实现，它可以使我们以一种难以置信的方式处理异步数据流。本文将讨论 RxJS 的应用场景，以及它的优缺点分析。本文假设读者对 ReactiveX 有一定...

    9 天前
  • 学习 ES6 之前，你需要掌握的 JavaScript 基础知识

    JavaScript 是一门广泛使用的编程语言，特别是在 Web 开发领域。ECMAScript 6 （简称 ES6）是 JavaScript 新版本的标准化，于 2015 年发布。

    9 天前
  • 使用 Chai 和 Mocha 测试基于 MongoDB 的 Node.js 应用程序

    在开发 Node.js 应用程序时，我们通常会涉及到与数据库的交互。而 MongoDB 作为一种非关系型数据库，其在 Node.js 中得到了广泛的应用。在编写 MongoDB 的 Node.js 应...

    9 天前
  • Kubernetes 中的灰度部署技术

    前言 在进行 web 应用程序开发的过程中，往往需要进行部署和更新。但是，如果直接进行全量部署或全量更新，很可能会出现一些异常情况，如系统崩溃等。因此，灰度部署技术就应运而生了。

    9 天前
  • PWA 应用中实现音频播放功能

    Progressive Web App（PWA）是一种越来越流行的 Web 应用开发模式。PWA 应用是通过使用现代 Web 技术，为用户提供类似于本机应用程序的体验。

    9 天前
  • Redux 中的跨组件通信解决方案

    在前端应用中，多个组件之间的通信问题一直是令人头疼的难题。但是，Redux 提供了一个非常好的解决方案。本文将介绍 Redux 中如何处理多个组件之间的通信问题，同时还会提供示例代码。

    9 天前
  • 如何使用 Enzyme 进行 React 组件的 Props 测试？

    简介 Enzyme 是一个流行的 React 的 JavaScript 测试实用工具，它可以帮助开发者测试 React 组件的行为和状态。除了测试组件的状态，Enzyme 还可以测试组件的 Props...

    9 天前
  • Cypress 中如何对页面元素的可见性进行测试

    当我们在编写前端代码时，经常需要对页面元素的可见性进行测试，以确保用户可以正常看到并与页面交互。在 Cypress 中，我们可以使用 Cypress 如何对页面元素的可见性进行测试，本文将详细介绍如何...

    9 天前
  • 使用 Node.js 构建实时应用程序的最佳实践

    Node.js 是使用 JavaScript 语言构建高性能网络应用程序的开放源代码跨平台运行时环境。它提供了事件驱动、非阻塞 I/O 模型，使得开发者可以在单一线程上构建高并发的实时应用程序。

    9 天前
  • Fastify 学习笔记：最常见的 5 个问题的解决方案

    Fastify 是一款快速、低开销且易于扩展的 Node.js Web 框架，其通过采用异步编程技术和优化的路由处理来提升应用程序性能。尽管 Fastify 是一个相对新的框架，但已经获得了越来越多的...

    9 天前
  • 全面了解 ES7 async/await 语法及其与 Promise 的差异

    随着 JavaScript 成为最流行的编程语言之一，前端开发中 Promise 的使用已经变得非常普遍。但是，Promise 仍然存在一些限制，例如它们的嵌套方式使得代码难以阅读和理解。

    9 天前
  • Apollo Client：如何在 React 中使用 GraphQL

    GraphQL 是一种快速、高效、灵活的查询语言，用于构建 API。它提供了一种强大的方式来描述数据的形状，使得客户端可以精确地指定需要从 API 中获取的数据。Apollo Client 是一个用于...

    9 天前
  • Express.js 的性能优化策略及最佳实践

    Express.js 是 Node.js 上广泛使用的 Web 框架之一。虽然它轻量级且易于使用，但是在高并发场景下，性能可能成为瓶颈。因此，在开发过程中要注意采用合适的策略和最佳实践来优化性能。

    9 天前
  • Serverless 中的日志管理与异常排查实战

    Serverless 架构模式已经成为云计算领域中的新宠，它被设计为迅速构建应用程序，减少资源消耗，并提高可伸缩性和弹性。但是，Serverless 应用程序通常是由多个无服务器计算资源组成的，并且每...

    9 天前
  • Kubernetes RBAC 权限管理

    Kubernetes 是现在最流行的容器编排工具，可用于管理大型生产环境中的容器应用。当您的生产环境变得庞大且需要团队协作时，如何确保每个团队成员的权限正确且安全地分配成为关键问题。

    9 天前
  • 一份专业的 CSS Reset 可以帮您快速构建响应式页面

    在前端开发中，CSS Reset 是一份必不可少的文件。它可以解决各个浏览器对于默认 CSS 样式的不同实现，以达到统一页面样式的效果。本篇文章将会介绍如何编写一份专业的 CSS Reset 文件，以...

    9 天前
  • Next.js 开发中如何处理图片资源？

    在 Next.js 的开发中，处理图片资源是非常重要的一项任务。本文将详细讨论如何在 Next.js 应用中处理图片资源以及提高网站加载速度的方法。 1. 使用 Image 组件 在 Next.js ...

    9 天前
  • 在使用 Enzyme 测试 React 组件时如何模拟 Redux state？

    前言：本文假设你已经有一定的 React 和 Redux 基础。 在测试 React 组件时，我们不仅需要关注组件的视图层，还要把整个组件的状态（包括 Redux state）模拟出来，以便我们随时检...

    9 天前
  • Angular 中的 3 种服务实现方法

    在 Angular 中，服务是提供代码重用和可维护性的关键因素。它们在 Angular 中很重要，因为它们被用来封装一些在应用程序中需要用到的功能以及将组件之间的数据共享。

    9 天前

相关推荐

    暂无文章