入门

前置需求

安装Node.js （8.9 或更高版本），如果之前未曾安装。

安装 LoopBack 4 CLI

LoopBack 4 CLI 是基于命令行的项目脚手架，也是一个用于生成基本代码的扩展。CLI 提供了快速创建 LoopBack 4 项目的方式， 采取这种方式是一个良好的实践。

在命令行运行以下代码以安装全局的 CLI 程序。

npm i -g @loopback/cli

建立一个新的项目

CLI 工具会搭建项目的脚手架，配置 TypeScript 的编译器，并且安装所有其他需要的依赖。运行以下 CLI 命令来建立一个新的项目，然后依据提示输入信息：

lb4 app

根据提示输入信息如下： （依序是：项目名、项目描述、项目根目录、Application 类名、开启功能选项）

? Project name: getting-started
? Project description: Getting started tutorial
? Project root directory: (getting-started)
? Application class name: StarterApplication
? Select features to enable in the project:
❯◉ Enable eslint: add a linter with pre-configured lint rules
 ◉ Enable prettier: install prettier to format code conforming to rules
 ◉ Enable mocha: install mocha to run tests
 ◉ Enable loopbackBuild: use @loopback/build helpers (e.g. lb-eslint)
 ◉ Enable vscode: add VSCode config files
 ◉ Enable docker: include Dockerfile and .dockerignore
 ◉ Enable repositories: include repository imports and RepositoryMixin
 ◉ Enable services: include service-proxy imports and ServiceMixin

启动项目

项目带有”ping”路由以便于测试。让我们试着启动项目：

cd getting-started
npm start

在浏览器中，访问http://127.0.0.1:3000/ping。

添加你自己的控制器

现在我们已经有了一个基本的项目，是时候添加我们自己的controller（控制类）. 让我们添加一个简单的”Hello World”控制类，运行以下命令：

lb4 controller

• 注意： 如果你的项目仍然在运行中，在运行命令前，按CTRL+C来停止它。

• 根据提示输入信息如下： （依序是：类名、自动生成代码模板。模板有空控制类和带有 CRUD 的控制类两种可供选择。）

  ? Controller class name: hello
  ? What kind of controller would you like to generate? Empty Controller
    create src/controllers/hello.controller.ts
    update src/controllers/index.ts
  
  Controller hello was now created in src/controllers/
  

• 复制并粘贴以下内容到文件/src/controllers/hello.controller.ts：

import { get } from "@loopback/rest";

export class HelloController {
  @get("/hello")
  hello(): string {
    return "Hello world!";
  }
}

• 用 npm start命令启动项目.

• 在浏览器中，访问http://127.0.0.1:3000/hello ，可以看到文字Hello world!

代码示例

此项目代码可在此处查看： hello-world