Koa.js 簡介：API 與 Web 應用程式的輕量級框架

Koa 是由 Express.js 團隊開發的一個輕量級現代中間件框架，允許我們使用非同步中間件函數。

範例應用程式

const Koa = require('koa');
const app = new Koa();

app.use(async function(ctx) {
  ctx.body = 'Hello';
});

app.listen(3000);

這裡我們建立了一個 Koa 實例，並設定了一個中間件，對每個請求回傳 "Hello"。

特性

現代文法
支援非同步/等待中間件。
輕量級，只有約 570 行程式碼。
• 零捆綁中間件。
上下文 (ctx) 對象，代替 (req, res)
• 中介軟體簽章為 middleware(ctx, next)
更好的錯誤處理

什麼是中間件？

中間件是一個接收 HTTP 請求並在請求/回應週期內可能回應請求的函數。它也可以呼叫清單中的下一個中間件。這是一個例子。

async function exampleMiddleware(ctx, next) {
  // 从 ctx（上下文）读取请求数据
  // 更多逻辑
  // 设置 ctx.body 作为响应

  // 调用下一个中间件
  await next();

  // 在调用 next 之后，由于使用了 await 语法，我们可以做更多的事情。
  // 例如记录所花费的时间
}

// 设置中间件
app.use(exampleMiddleware);

中間件框架允許我們定義多個中間件函數並按定義順序執行它們。您可能已經注意到上面範例中的 next 參數。它是一個函數，當被呼叫時，將控制權傳遞給下一個中間件。

使用非同步函數允許我們使用 await 在中間件執行後以堆疊方式執行某些操作。

如果不需要進一步執行，則不需要呼叫 next。例如，考慮一個身份驗證中間件。如果使用者已登錄，則呼叫 next，否則顯示登入頁面。

// 身份验证中间件
app.use(async (ctx, next) => {
  if(user){
    // 调用列表中的下一个中间件
    await next();
  } else {
    // 显示登录页面
  }
});

// Hello 中间件
app.use(async (ctx) => {
  ctx.body = 'Hello';
});

如您所見，中間件的順序也很重要。

Koa 上下文 (ctx)

每個中間件接收兩個參數。第一個是上下文（簡寫為 ctx）和 next。

ctx 包含來自請求的屬性。此外，它還包含可以回應請求的設定器。

以下是常見屬性的清單。您可以在此處找到完整清單。

如何執行常見任務 ------------------------

添加中間件

使用 app.use - 文檔。請注意，中間件的順序很重要。

const Koa = require('koa');
const app = new Koa();

app.use(async function(ctx) {
  ctx.body = 'Hello';
});

app.listen(3000);

啟動服務器

使用 app.listen - 文檔。

async function exampleMiddleware(ctx, next) {
  // 从 ctx（上下文）读取请求数据
  // 更多逻辑
  // 设置 ctx.body 作为响应

  // 调用下一个中间件
  await next();

  // 在调用 next 之后，由于使用了 await 语法，我们可以做更多的事情。
  // 例如记录所花费的时间
}

// 设置中间件
app.use(exampleMiddleware);

設置響應正文

使用 ctx.body 設置器 - 文檔。

// 身份验证中间件
app.use(async (ctx, next) => {
  if(user){
    // 调用列表中的下一个中间件
    await next();
  } else {
    // 显示登录页面
  }
});

// Hello 中间件
app.use(async (ctx) => {
  ctx.body = 'Hello';
});

重定向

使用 ctx.redirect - 文檔。

app.use(middlewareFunction1);
app.use(middlewareFunction2);
app.use(middlewareFunction3);

錯誤處理

使用 ctx.throw - 文檔。

app.listen(3000);

如何構建完整的應用程序

Koa 提供了中間件框架和可在中間件中使用的 ctx。它不包含任何捆綁的中間件。

要構建完整的應用程序，我們需要使用 Koa 社區提供的中間件。以下是常見中間件的列表。

• 路由器
• 主體解析器
• 日誌記錄器
• ejs 渲染器

您可以瀏覽 Koa GitHub 以獲取更多可用的中間件。

結論

Koa 是一個很棒的輕量級現代 Web 框架，用於構建 API 和 Web 應用程序。您可以在 Koa 網站上閱讀更多文檔。

以上是Koa.js 簡介：API 與 Web 應用程式的輕量級框架的詳細內容。更多資訊請關注PHP中文網其他相關文章！