Flutter网页渲染插件dart_webcore_new的使用

dart_webcore 处理高级路由、HttpServers、网站托管、静态文件托管等。最重要的是个性化中间件，您可以为单个处理器、路由器甚至整个管道设置中间件。

特性

1. 允许添加路由系统。
2. 托管静态文件夹或网站。
3. 预编程的代码用于一些工具（如HTML响应、JSON响应）。

教程

路由 (请求处理器)

dart_webcore 由不同的层组成，这些层是一种 RequestProcessor，意味着它们可以处理传入的请求。

处理器

处理器是请求生命周期中的最终阶段，在服务器上，处理器必须向客户端返回响应（API消费者）。处理器可以有一个仅适用于该处理器的本地中间件。

// 定义一个处理器
Handler handler = Handler('/hello', HttpMethods.get,
    (request, response, pathArgs) => response.write('Hello world!'));

中间件

中间件是一组函数，位于处理器和客户端之间，用于对请求进行一些认证或验证。中间件可以返回一个请求以让请求传递到下一个中间件或处理器，或者返回一个响应以关闭并阻止请求传递到管道中的下一个实体。中间件可以添加到单个处理器、路由器或整个管道，甚至是每个传入服务器请求的全局中间件。

// 定义一个中间件
Middleware middleware = Middleware('/hello', HttpMethods.get, (request, response, pathArgs) {
  print('new request');
  return request;
});

路由器

路由器是处理器的父级，您可以向路由器添加多个处理器，路由器负责选择正确的处理器执行。您还可以为路由器添加中间件，这些中间件将仅在此路由器中执行。

// 定义一个路由器
Router router = Router()
  ..get('/hello',
      (request, response, pathArgs) => response.write('Hello world!'))
  ..post('/register',
      (request, response, pathArgs) => response.write('user registered!'));

管道

管道是所有先前实体的主控。您可以向管道添加多个路由器和单独的处理器，它将选择正确的中间件和正确的处理器来运行每个传入请求。

// 定义一个管道
Pipeline pipeline = Pipeline().addRouter(router);

服务器

ServerHolder 是一个类，用于创建和关闭服务器。它需要上述的请求处理器之一，以便处理运行正确的处理器和正确的中间件集。

// 创建一个服务器
ServerHolder serverHolder = ServerHolder(pipeline);
serverHolder.bind(InternetAddress.anyIPv4, 3000);

请求处理器参数

路径模板

路径模板是与传入请求路径比较的路径模板，每个处理器应该具有唯一的路径模板，并遵循以下公式：

e.g: /login
     /register
     /users/list
     /users/<user_id>/getData
     /users/<users_id>/deleteUser
     /files/*<file_path>

• 正常路径模板如 /login, /register 或 /users/list，如果任何请求具有相同的路径，则相应的处理器将被执行。
• 带有路径参数的路径模板如 /users/<user_id>/getData 和 /users/<user_id>/deleteUser，任何请求路径如 /users/the_actual_user_id/deleteUser 将匹配此处理器，并且可以通过 pathArgs 访问参数，例如 {'user_id':'the_actual_user_id'}。
• 最终路径模板示例用于包含多个斜杠的路径参数，例如任何请求路径如 /files/path/to/file 将匹配具有路径模板 /files/*<file_path> 的处理器，并且 pathArgs 映射将为 {'file_path':'path/to/file'}。

// 定义一个带路径参数的处理器
Handler pathArgHandler = Handler(
    '/getUser/<user_id>',
    HttpMethods.get,
    (request, response, pathArgs) => response
        .write('you requested the user with id ${pathArgs['user_id']}'));

方法

方法是为此处理器或中间件指定的方法（GET、POST、PUT等）。对于处理器，您可以指定 HttpMethods.all 以使此中间件在特定路径模板下运行所有方法。最好将此类处理器（带有 HttpMethods.all）放在管道的最后。对于中间件，您可以指定路径模板为空以使此中间件在所有路径下运行，并且可以将中间件的方法设置为 HttpMethods.all 以使其成为特定请求处理器（如路由器或管道）的全局中间件。

处理器

处理器是实际的中间件或处理器的代码。

// 处理器的定义
(response, response, pathArgs) => response.write('Hello world!');

如果返回类型是 ResponseHolder，则表示响应已发送且管道已关闭；否则，如果返回类型是 RequestHolder，则表示将继续并且响应尚未关闭，将返回的请求传递给管道中的下一个实体。

网站托管

使用 dart_webcore，您可以托管整个文件夹的所有内容，无论是网站文件夹还是普通的静态文件夹。只需为该文件夹路径设置一个别名，以保护系统路径不被API消费者访问。

// 定义一个路由器
Router router = Router()
  ..get(
    '/*<path>',
    (request, response, pathArgs) {
      return response.serveFolders(
        [
          FolderHost(path: './bin/website', alias: 'website'),
        ],
        pathArgs['path'],
        allowServingFoldersContent: true,
        autoViewIndexTextFiles: true,
        allowViewingEntityPath: true,
        viewTextBasedFiles: true,
      );
    },
  );

单个文件下载/流式传输

您可以流式传输文件或提供下载。

// 定义一个路由器
router
..get(
    '/downloadImage',
    (request, response, pathArgs) =>
        response.writeFile('./bin/website/images/img.jpg'))