首页 > web前端 > js教程 > API 与中间件:了解差异

API 与中间件:了解差异

DDD
发布: 2025-01-14 08:09:44
原创
630 人浏览过

在进行后端开发时,你一定会遇到两个术语:API中间件

虽然两者在应用程序架构中都发挥着关键作用,但它们的用途却截然不同。

让我们将他们分解,比较他们的角色,并以一种不会让你想翻桌子的方式澄清他们的差异。

什么是 API?

API 代表应用程序编程接口。它本质上是一个允许不同软件组件相互通信的合约。

将其视为餐厅的服务员:它接受您的订单(请求),将其送到厨房(服务器),然后带回您的食物(响应)。

API 的主要特征

  • 公开端点以与数据或服务交互。
  • 通过 HTTP/HTTPS 运行(对于 Web API 最常见)。
  • 可以遵循 REST、GraphQL 或 gRPC 等协议。

现实世界的类比

每次订购 Uber 或发布推文时,您都在使用 API。应用程序的后端为前端提供API来获取或发送数据。

  • 代码示例 Express.js 应用程序中的简单 API 端点可能如下所示:
  const express = require('express');
  const app = express();

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });
登录后复制
  • API 定义您的应用向外界公开的什么功能。

API vs Middleware: Understanding the Difference

什么是中间件?

中间件更像是厨房的幕后工作人员——它不是直接为你服务,但它保证一切顺利进行。

用技术术语来说,中间件是位于应用程序管道中的请求和响应之间的一个函数或一组函数。

中间件的主要特征

  • 在请求到达最终处理程序(例如 API)之前对其进行处理。
  • 可以修改请求或响应。​​
  • 通常用于身份验证、日志记录、验证或错误处理等任务。

现实世界的类比

将中间件视为建筑物中的保安。

它确保只有授权个人(有效请求)才能到达办公室(API)。

  • 代码示例 下面是 Express.js 中的简单日志中间件示例:
  const express = require('express');
  const app = express();

  const loggingMiddleware = (req, res, next) => {
    console.log(`Request made to: ${req.url}`);
    next(); // Pass control to the next middleware or handler
  };

  app.use(loggingMiddleware);

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });
登录后复制
  • 中间件处理请求在到达端点之前如何处理

API vs Middleware: Understanding the Difference

API 和中间件之间的主要区别

Aspect API Middleware
Purpose Defines endpoints for interaction. Processes requests/responses.
Visibility Exposed to external systems. Works internally within the app.
Examples /users, /products, /login Authentication, logging, error handling
Interaction Invoked by external clients. Invoked automatically in the request pipeline.
Code Placement Found in controllers. Found in the middleware functions.

何时使用 API 与中间件

  • API

    • 当您想为外部应用程序或服务提供与您的系统交互的方式时,请使用 API。
    • 示例:移动应用通过 /users/:id 获取用户详细信息。
  • 中间件

    • 使用中间件来实现适用于多个路由或 API 的横切关注点。
    • 示例:验证所有受保护路由的 JWT 令牌,在浏览器中设置 cookie。

API vs Middleware: Understanding the Difference

将其整合在一起

想象一下构建一个拼车应用程序。 API 可能包括:

  • /drivers:获取可用的驱动程序。
  • /trips:预订或管理行程。

在幕后,中间件确保:

  • 只有经过身份验证的用户才能访问/trips。
  • 每个请求都会保留日志。
  • 实施速率限制是为了防止滥用。

API 和中间件对于构建强大的应用程序都是不可或缺的 - 一个公开功能,另一个确保其顺利、安全地工作。

说到 API,

我一直在开发一个名为 LiveAPI 的超级方便的工具。

它旨在让开发人员轻松编写 API 文档。

API vs Middleware: Understanding the Difference

使用LiveAPI,您可以快速生成交互式API文档,允许用户直接从浏览器执行API。

API vs Middleware: Understanding the Difference

如果您厌倦了手动创建文档或不想花时间为 API 集成 swagger,这个工具可能会让您的生活更轻松,现在就尝试 LiveAPI!

以上是API 与中间件:了解差异的详细内容。更多信息请关注PHP中文网其他相关文章!

来源:dev.to
本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板