Page Contents

什么是应用(Application)?

在 LoopBack 4 中,Application(应用)类是一个重要的类,用于设置你所有的模块组件、控制器、服务器和绑定。Application扩展了Context (上下文),并且提供了启动和停止相关服务器的控制方法。

使用 LoopBack 4 时,我们强烈鼓励你建立你自己的Application的子类,以更好地组织你的配置(Configuration)和设置(Setup)。

编写你自己的 Application 类

通过编写你自己的 Application 类,你可以执行下列其他几项任务,将其作为你的设置的一部分:

  • Pass the configuration into the base class constructor
  • 在启动应用程序之前,执行异步启动功能。
  • 在应用程序停止时,执行优雅的清理功能。

src/widget.application.ts

import { Application } from "@loopback/core";
import { RestComponent } from "@loopback/rest";
import { UserController, ShoppingCartController } from "./controllers";

export class WidgetApplication extends Application {
  constructor() {
    // 在此处传递配置给基类的构造函数
    // (当然,你也可以自己处理)
    super({
      rest: {
        port: 8080
      }
    });

    const app = this;
    // 为了使代码更清晰,
    // 你可以在此处绑定应用层上下文。
    // app.bind('foo').to(bar);
    app.component(RestComponent);
    app.controller(UserController);
    app.controller(ShoppingCartController);
  }

  async stop() {
    // 应用停止之前,在此处进行必要的清理工作。
    // (优雅地关闭链接、刷新缓冲区等)
    console.log("Widget application is shutting down...");
    // 基类的stop方法会调用所有绑定到此应用的Servers(服务器)的的stop方法。
    await super.stop();
  }
}

配置你的应用

你可以通过“构造函数的参数”和“绑定”配置你的应用,或同时使用以上两者。

绑定(Binding)配置

Binding(绑定)是我们的示例代码中最常见的配置应用的方式。建议你在设置你的应用时使用绑定(Binding)方法。

进一步地,绑定函数由上下文(Context)提供,Application类同样提供了一些语法糖函数用于常见的绑定,例如component, servercontroller:

export class MyApplication extends Application {
  constructor() {
    super();
    this.component(MagicSuite);
    this.server(RestServer, "public");
    this.server(RestServer, "private");

    this.controller(FooController);
    this.controller(BarController);
    this.controller(BazController);
  }
}

你可以在Application的 API 文档页面查看完整的函数列表。

更进一步,你可以使用更高级的形式进行绑定,以便微调你的应用配置:

export class MyApplication extends Application {
  constructor() {
    super();
    this.server(RestServer);
    this.controller(FooController);
    this.bind("fooCorp.logger").toProvider(LogProvider);
    this.bind("repositories.widget")
      .toClass(WidgetRepository)
      .inScope(BindingScope.SINGLETON);
  }
}

在上述示例代码中:

  • 注入调用fooCorp.logger 会被 LogProvider类处理。
  • 注入调用repositories.widget 会被单例WidgetRepository类处理。

组件(Components)

app.component(MyComponent);
app.component(RestComponent);

component 函数允许在你的 Application 实例的上下文中,绑定组件的构造函数。

关于如何利用组件的更多信息,请查看使用组件(Components)页面。

控制器(Controller)

app.controller(FooController);
app.controller(BarController);

component函数类似,controller 函数允许你在Application的上下文中,绑定控制器(Controller)

服务器(Server)

app.server(RestServer);
app.servers([MyServer, GrpcServer]);

server 函数与前述函数类似,但是使用servers函数能够对服务器(Server) 进行批量绑定。

const app = new Application();
app.server(RestServer, "public"); // {'public': RestServer}
app.server(RestServer, "private"); // {'private': RestServer}

在上述示例代码中,有两个服务器的实例被绑定到了 Application 的上下文中,这两个实例分别绑定到了servers.publicservers.private键。

构造函数(Constructor)配置

Application 类的构造函数同样接受包含了组件层配置的ApplicationConfig对象,例RestServerConfig. 它将自动为这些配置创建绑定,之后通过“Dependency Injection(依赖注入)”进行注入。 访问依赖注入(Dependency Injection) 以了解更多信息。

export class MyApplication extends RestApplication {
  constructor() {
    super({
      rest: {
        port: 4000,
        host: "my-host"
      }
    });
  }
}

设置应用的小提示

这里是一些小提示,可以在设置应用时避开常见的陷阱和错误。

使用RestServer,从RestApplication 扩展

如果你希望使用 @loopback/rest 包的RestServer,我们建议你在你的应用中扩展RestApplication 而不是手动绑定RestServerRestComponentRestApplication已经使用了RestComponent,并且在RestServer 中提供了一些可用的应用层函数,例如handler()。 这意味着你可以在在应用的构造函数中,调用RestServer函数来执行你所有服务器层的设置,而不需明确地获取你的 Server(服务器)的实例。

提供静态文件

RestServer允许提供静态文件。通过调用static() 来设置 API。

app.static("/html", rootDirForHtml);

或者

server.static(["/html", "/public"], rootDirForHtml);

静态资产不允许被挂载到/以避免性能惩罚。因为/ 符合所有的路径,使得每个 HTTP 请求都会导致文件系统的访问。

static() API 委托serve-static提供静态文件。

请访问下列链接以了解详情: https://expressjs.com/en/starter/static-files.html https://expressjs.com/en/4x/api.html#express.static

警告:

静态资产在 LoopBack 的动作时序之前提供。如果一个错误被抛出,reject动作不会被触发。

使用唯一绑定

使用带有前缀字符串的绑定名,以避免与 LoopBack 的绑定重复。例如,如果你的应用是为你的雇主 FooCorp 开发的,你可以为你的绑定添加前缀fooCorp

// 这个绑定的键,不太可能被其他的组件开发者或者LoopBack自身使用。
app.bind("fooCorp.widgetServer.config").to(widgetServerConfig);

避免使用getSync

我们提供getSync函数是为了应对你无法异步获取你的绑定的情形,例如在构造函数体内。

然而,你必须这样做的情形有限,你需要避免潜在的竞争条件,并且尽可能使用get以异步获取你的绑定。

小心使用单例绑定范围

默认情况下,每当被注入或获取时,绑定的 Controller(控制器)会实例化一个新的实例。你的应用应当仅在有理由时才为 Controller(控制器)设置单例绑定范围。