编写客户端应用程序时使用Aqueduct

Running an Aqueduct server locally while developing client applications is an important part of the development process. Run applications through their bin/main.dart script or aqueduct serve. The former allows for debugging the application with a debugger.

启用日志记录并返回服务器错误

Ensure that logging is on while developing client applications by registering a listener on ApplicationChannel.logger.

class MyApplicationChannel extends ApplicationChannel {
  @override
  Future prepare() async {
    logger.onRecord.listen((record) {
      print("$record ${record.error ?? ""} ${record.stackTrace ?? ""}");
    });
  }
  ...
}

A useful feature to turn on during debugging is sending stack traces for 500 Server Error responses. Turn this flag on in a ApplicationChannel while debugging:

class MyApplicationChannel extends ApplicationChannel {
  @override
  Future prepare() async {
    Controller.includeErrorDetailsInServerErrorResponses = true;
  }
  ...
}

When a 500 error is encountered, the server will send the stack trace back to the client so you can view it while developing the client application without having to switch terminals. This property should never be left on for production code.

避免端口冲突

使用 aqueduct serve运行的应用程序默认使用8888端口。你可以使用--port命令行选项来选择不同的端口。

aqueduct serve --port 4000

设置数据库以进行客户端测试

For applications that use the ORM, you must have a locally running database with a schema that matches your application's data model.

If you are using OAuth 2.0, you must have also added client identifiers to the locally running database. You may add client identifiers with the aqueduct auth command-line tool.