Merge pull request #388 from GuoJikun/patch-1

Update recipes.md

Author: huadong zuo

10/recipes.md

@@ -2,7 +2,140 @@
 
 ## REPL
 
-（待翻译）
+REPL 是一个简单的交互式环境，它接受单个用户输入，执行这些输入，并将结果返回给用户。REPL 功能允许您直接从终端检查依赖关系图并调用提供程序（和控制器）上的方法。
+
+### 用法
+
+若要在 REPL 模式下运行 NestJS 应用程序，请创建一个新 `repl.ts` 文件 (与现有的 `main.ts` 文件放在一起) ，并在其中添加以下代码：
+
+```typescript
+@@filename(repl)
+import { repl } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  await repl(AppModule);
+}
+bootstrap();
+@@switch
+import { repl } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  await repl(AppModule);
+}
+bootstrap();
+```
+
+现在可以在终端中，使用以下命令启动 REPL：
+
+```bash
+$ npm run start -- --entryFile repl
+```
+
+> info **提示** `repl` 返回 [Node.js REPL server](https://nodejs.org/api/repl.html) 对象.
+
+启动并运行后，您应该会在控制台中看到以下消息：
+
+```bash
+LOG [NestFactory] Starting Nest application...
+LOG [InstanceLoader] AppModule dependencies initialized
+LOG REPL initialized
+```
+
+现在你可以开始与依赖图交互了。例如，您可以检索 `AppService` (我们在这里使用 starter 项目作为示例)并调用 `getHello()` 方法:
+
+```typescript
+> get(AppService).getHello()
+'Hello World!'
+```
+
+您可以从终端中执行任何 JavaScript 代码，例如，将 AppController 的 实例分配给局部变量，并使用 `await` 调用异步方法：
+
+```typescript
+> appController = get(AppController)
+AppController { appService: AppService {} }
+> await appController.getHello()
+'Hello World!'
+```
+
+要显示给定 provider 或 controller 中可用的所有公共方法，请使用 `methods()` 函数，如下所示:
+
+```typescript
+> methods(AppController)
+
+Methods:
+ ◻ getHello
+```
+
+To print all registered modules as a list together with their controllers and providers, use `debug()`.
+要将所有注册的模块以及它们的控制器和提供者打印为一个列表，请使用 `debug()`。
+
+```typescript
+> debug()
+
+AppModule:
+ - controllers:
+  ◻ AppController
+ - providers:
+  ◻ AppService
+```
+
+快速演示：
+
+<figure><img src="/assets/repl.gif" alt="REPL example" /></figure>
+
+您可以在下面的小节中找到有关现有的、预定义的本机方法的更多信息。
+
+### 原生函数
+
+内置的 NestJS REPL 提供了一些全局可用的原生函数。你可以调用 `help()` 来列出它们。
+
+If you don't recall what's the signature (ie: expected parameters and a return type) of a function, you can call `<function_name>.help`.
+For instance:
+
+如果你不记得函数的签名是什么(即:预期参数和返回类型)，你可以调用 `<function_name>.help`。
+例如
+
+```text
+> $.help
+Retrieves an instance of either injectable or controller, otherwise, throws exception.
+Interface: $(token: InjectionToken) => any
+```
+
+> info **提示** 这些函数接口使用[TypeScript函数类型表达式语法](https://www.typescriptlang.org/docs/handbook/2/functions.html#function-type-expressions)编写。
+
+| Function     | Description                                                                                                        | Signature                                                             |
+| ------------ | --------------------------------------------------------- | --------------------------------------------------------------------- |
+| `debug`      | 将所有注册的模块以及它们的控制器和提供者打印为一个列表。       | `debug(moduleCls?: ClassRef \| string) => void`                       |
+| `get` or `$` | 获取可注入对象或控制器的实例，否则抛出异常。                  | `get(token: InjectionToken) => any`                                   |
+| `methods`    | 显示给定提供程序或控制器上可用的所有公共方法。                | `methods(token: ClassRef \| string) => void`                          |
+| `resolve`    | 解析可注入对象或控制器的瞬态或请求作用域实例，否则抛出异常。   | `resolve(token: InjectionToken, contextId: any) => Promise<any>`      |
+| `select`     | 允许在模块树中导航，例如，从选定的模块中拉出特定实例。         | `select(token: DynamicModule \| ClassRef) => INestApplicationContext` |
+
+### 监视模式
+
+在开发过程中，可以在监视模式下运行REPL，以自动反映所有代码更改:
+
+```bash
+$ npm run start -- --watch --entryFile repl
+```
+
+这有一个缺陷，REPL的命令历史记录在每次重新加载后都会被丢弃，这可能很麻烦。
+幸运的是，有一个非常简单的解决方案。像这样修改你的 `bootstrap` 函数:
+
+```typescript
+async function bootstrap() {
+  const replServer = await repl(AppModule);
+  replServer.setupHistory(".nestjs_repl_history", (err) => {
+    if (err) {
+      console.error(err);
+    }
+  });
+}
+```
+
+现在，在运行/重新加载之间保存历史记录。
 
 ## CRUD生成器
 
@@ -3512,4 +3645,4 @@ export class AppModule {}
 
 | 用户名 | 头像 | 职能 | 签名 |
 |---|---|---|---|
-| [@ThisIsLoui](https://github.com/ThisIsLoui) | <img class="avatar-66 rm-style" height="70" src="https://avatars.githubusercontent.com/u/69883404?s=96&v=4"> | 翻译 | 你好，这里是 Loui |
+| [@ThisIsLoui](https://github.com/ThisIsLoui) | <img class="avatar-66 rm-style" height="70" src="https://avatars.githubusercontent.com/u/69883404?s=96&v=4"> | 翻译 | 你好，这里是 Loui |