Flutter功能未知插件palace的使用（由于介绍为undefined，故侧重于插件名称）

Introduction

palace 是一个用于处理 HTTP 请求的 Dart 微框架。它可以帮助开发者更方便地处理服务器端的请求。

Hello World App

以下是一个简单的 “Hello World” 应用程序：

Future<void> main(List<String> args) async {
  final palace = Palace();
  palace.get('/greet_the_queen', (req, res) => res.send('Long Live The Queen 👑'));
  await palace.openGates();
}

在这个示例中，我们创建了一个 Palace 实例，并注册了一个 GET 路由 /greet_the_queen。当访问该路由时，服务器会返回 “Long Live The Queen 👑”。

Hello World with Decoration

装饰器可以帮助你将代码拆分成模块化部分，使应用更容易维护。

void main(List<String> args) async {
  final palace = Palace();
  palace.controllers([MainController()]);
  await palace.openGates();
}

class MainController extends PalaceController {
  MainController() : super('/');

  @Get()
  void greetTheQueen(Request req, Response res) {
    return res.send('Long Live The Queen 👑');
  }
}

在这个示例中，我们将控制器拆分成了 MainController 类。MainController 继承自 PalaceController，并注册了一个 GET 路由 /。当访问该路由时，服务器会返回 “Long Live The Queen 👑”。

Core Parts

Palace 类

Palace 类的主要功能包括：

• 注册路由及其回调函数
• 使用中间件（例如 palace.use(CORSGuard())）
• 打开服务器
• 关闭服务器

Request 类

Request 类是 dart:io 的 HttpRequest 的包装类，提供了额外的功能和属性，使得处理请求更加容易。

Response 类

Response 类是 dart:io 的 HttpResponse 的包装类，提供了额外的功能和属性，使得发送响应更加容易。一些常用的方法包括：

• res.json(data?)：将给定数据转换为 JSON 并返回给用户
• res.file(path)：给定路径后，将文件返回给用户
• res.notFound(data?)：返回 404 错误
• res.internalServerError(data?)：返回 500 错误
• res.accepted(data?)：返回 200 状态码
• res.created(data?)：返回 201 状态码

Middleware 也称为 Guard

中间件（或称为 Guard）是一种简单的函数，用于在处理程序之前或之后执行一些逻辑。它们可以被注册为特定路由的中间件，也可以作为全局中间件应用于所有请求。

Callback Parameters

如果你正在使用装饰器，你可以从传入的请求中提取这些类型的数据。如果没有使用装饰器，你可以通过声明请求或响应的类型来访问它们。

@Get()
void sayHi(Request req, Response res) {
  // 逻辑
}

如果需要直接访问强类型的请求体，可以使用 @Body() 装饰器：

class SignUpBody {
  late String name;
  late String email;
  late String password;
}

@Post()
void signUp(Request req, Response res, @Body() SignUpBody body) {
  // 逻辑
}

如果需要访问请求体中的特定值，可以这样做：

@Body('email') String email

同样的方法适用于其他装饰器如 @Query(), @QueryParam(), 和 @Param()。

如果正在构建中间件，可以使用 [@Next](/user/Next)() 来获取下一个回调的访问权限。

[@Next](/user/Next)()
void myMiddleware(Request req, Response res, Next next) {
  // 逻辑
  next();
}