Nestjs 自翻中文文档（一）

Nestjs中文文档(一)

nestjs原中文文档缺乏太多 故有此系列。直接对比nestjs英文网站翻译，先机翻再推敲， 一个模块一个章节
版本: 6.10.14

首次安装

在这组文章中，您将学习Nest的核心基础知识。为了熟悉Nest应用程序的基本构建块，咱们将构建一个基本的CRUD应用程序，它的特性在入门级涵盖了不少方面

语言

咱们喜欢使用typescript,可是咱们更喜欢nodejs!,这就是为何nestjs会兼容typescript和纯javascript.

nestjs主要使用typescript做为主力开发语言，您不用特地学习它，由于它真的和es6很像，您能够在模仿过程当中逐渐了解到typescript.nestjs主要借鉴了angular，而angular借鉴了spring，因此有angular或者java开发经验将会变得更加容易。

开始

使用Nest CLI设置新项目很是简单。安装了npm后，能够在OS终端中使用如下命令建立新的Nest项目

$ npm i -g @nestjs/cli
$ nest new project-name

将建立项目目录，安装节点模块和其余几个样板文件，并建立一个src/目录，并用几个核心文件填充,结构以下：

src

---app.controller.ts

---app.module.ts

---main.ts

如下是这些核心文件的简要概述

文件名	描述
app.module.ts	项目的根模块
app.controller.ts	一个基本的控制器
main.ts	使用核心函数NestFactory建立Nest应用程序实例的应用程序的入口文件

main.ts包含一个异步函数，它将引导整个Nest程序

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000);
}
bootstrap();

要建立一个Nest应用程序实例，咱们使用核心NestFactory类。NestFactory公开了一些容许建立应用程序实例的静态方法。这个create()方法返回一个application对象,该对象实现了INestApplication接口，如今只须要监听3000端口，等待http请求便可。

注意，使用Nest CLI构建的项目会建立一个初始的项目结构，咱们鼓励开发者们将模块module放到本身的专用目录中去。

平台

Nest的目标是成为一个平台无关的框架。平台独立性使得建立可重用的逻辑部件成为可能，开发人员能够跨多种不一样类型的应用程序利用这些逻辑部件。从技术上讲，一旦建立了适配器，Nest就可使用任何Node HTTP框架。有两个现成支持的HTTP平台：express和fastfy。你能够选择最适合你须要的

平台	描述
express	Express是一个在nodejs中最著名的极简web框架。这是一个通过时间检验，生产完备的库，有不少社区实现的资源。默认状况下使用@nestjs/platform express包。许多用户都能很好地使用Express，无需采起任何措施便可启用它。
fastify	fastify 是一个高性能和低开销的框架，高度集中于提供最大的效率和速度。能够在搜索引擎中了解它。

不管使用哪一个平台，它都会公开本身的应用程序接口。分别为NestExpressApplication和nestFastFyApplication

当您将类型传递给NestFactory.create（）方法时，以下面的示例所示，app对象将具备专门用于该特定平台的方法。可是，请注意，您不须要指定平台类型（express或fastify），除非您真正想访问底层平台API。

const app = await NestFactory.create<NestExpressApplication>(AppModule);

运行

安装过程完成后，能够在操做系统命令提示符下运行如下命令

$ npm run start

此命令经过HTTP服务器监听src/main.ts文件中定义的端口来启动应用程序,应用程序运行后，打开浏览器并导航到http://localhost:3000/。你应该看到了hello world!