From 367dc5acb15a6d2ad836afc9c4b91eb147b9c9e5 Mon Sep 17 00:00:00 2001 From: gsonovb Date: Sat, 21 Aug 2021 09:42:13 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=F0=9F=93=9D=20Update=20Todo=20Tutorial?= =?UTF-8?q?=20Translate?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/zh-Hans/Tutorials/Todo/Index.md | 238 ++++++++++++++------------- 1 file changed, 123 insertions(+), 115 deletions(-) diff --git a/docs/zh-Hans/Tutorials/Todo/Index.md b/docs/zh-Hans/Tutorials/Todo/Index.md index 0676a6d894..5a18e2302a 100644 --- a/docs/zh-Hans/Tutorials/Todo/Index.md +++ b/docs/zh-Hans/Tutorials/Todo/Index.md @@ -8,15 +8,15 @@ } ```` -这是一个单独的部分,使用ABP框架构建简单待办事项应用程序的快速入门教程.这是一个最终应用的截图: +这是一个由单个部分组成的快速入门教程，旨在使用ABP框架构建一个简单的待办事项应用程序。 这是最终应用程序的屏幕截图： -![todo-list](todo-list.png) +![待办事项列表](todo-list.png) -你可以在[这里](https://github.com/abpframework/abp-samples/tree/master/TodoApp)找到已完成的项目源代码. +你可以在[这里](https://github.com/abpframework/abp-samples/tree/master/TodoApp)找到已完成的项目源代码。 ## 先决条件 -* 一个集成开发环境 (比如: [Visual Studio](https://visualstudio.microsoft.com/vs/)) 它需要支持 [.NET 5.0+](https://dotnet.microsoft.com/download/dotnet) 的开发. +* 一个集成开发环境 (比如: [Visual Studio](https://visualstudio.microsoft.com/vs/)) 它需要支持 [.NET 5.0+](https://dotnet.microsoft.com/download/dotnet) 的开发。 {{if DB=="Mongo"}} @@ -32,13 +32,13 @@ ## 创建新的解决方案 -我们将使用[ABP CLI](../../CLI.md) 创建带有ABP框架的新解决方案. 你可以在命令行终端中运行以下命令来安装它: +我们将使用[ABP CLI](../../CLI.md) 创建带有ABP框架的新解决方案。 你可以在命令行终端中运行以下命令来安装它： ````bash dotnet tool install -g Volo.Abp.Cli ```` -然后创建一个空文件夹,打开命令行终端并以打开的文件夹为路径在终端中执行以下命令: +然后创建一个空文件夹，打开命令行终端并在终端中执行以下命令： ````bash abp new TodoApp{{if UI=="Blazor"}} -u blazor{{else if UI=="BlazorServer"}} -u blazor-server{{else if UI=="NG"}} -u angular{{end}}{{if DB=="Mongo"}} -d mongodb{{end}} @@ -46,21 +46,21 @@ abp new TodoApp{{if UI=="Blazor"}} -u blazor{{else if UI=="BlazorServer"}} -u bl {{if UI=="NG"}} -这将创建一个名为*TodoApp*的新解决方案,其中包含`angular`和`aspnet core`文件夹.解决方案就绪后,在你的IDE中打开ASP.NET Core 解决方案. +这将创建一个名为*TodoApp*的新解决方案，其中包含`angular`和`aspnet core`文件夹。 一旦解决方案就绪，请在您最喜欢的 IDE 中打开ASP.NET Core 解决方案。 {{else}} -这将创建一个名为*TodoApp*的新解决方案.解决方案准备好后,在你的IDE中打开它. +这将创建一个名为*TodoApp*的新解决方案。 一旦解决方案就绪，请在您最喜欢的 IDE 中打开它。 {{end}} ### 创建数据库 -如果你使用的是visual studio,请右键单击`TodoApp.DbMigrator`项目,选择*设置为启动项目*,然后按*Ctrl+F5*运行它而不进行调试.它将创建初始数据库并播种初始数据. +如果你使用的是Visual Studio，请右键单击`TodoApp.DbMigrator`项目，选择*设置为启动项目*，然后按*Ctrl+F5*运行它而不进行调试。 它将创建初始数据库并生成初始数据。 {{if DB=="EF"}} -> 由于*DbMigrator*添加初始迁移并重新编译项目,一些ide(例如Rider)在第一次运行时可能会出现问题.在这种情况下,请打开`.DbMigrator`项目文件夹中的命令行终端,然后执行`dotnet run`命令. +> 一些IDE (例如Rider) 可能会在第一次运行时遇到问题，因为 *DbMigrator* 添加初始迁移并重新编译项目。 在这种情况下，在 `.DbMigrator` 项目文件夹中打开命令行终端并执行 `dotnet run` 命令。 {{end}} @@ -68,59 +68,59 @@ abp new TodoApp{{if UI=="Blazor"}} -u blazor{{else if UI=="BlazorServer"}} -u bl {{if UI=="MVC" || UI=="BlazorServer"}} -最好在开始开发之前运行一下应用程序.确保 {{if UI=="BlazorServer"}}`TodoApp.Blazor`{{else}}`TodoApp.Web`{{end}} 是启动项目,然后运行应用程序(Visual Studio中是Ctrl+F5)以查看查看初始UI: +最好在开始开发之前运行一下应用程序。 确保 {{if UI=="BlazorServer"}}`TodoApp.Blazor`{{else}}`TodoApp.Web`{{end}} 是启动项目，然后运行应用程序(Visual Studio中是Ctrl+F5)来查看初始UI： {{else if UI=="Blazor"}} -最好在开始开发之前运行一下应用程序.该解决方案有两个主要应用: +最好在开始开发之前运行一下应用程序。 解决方案中有两个主要应用程序 -* `TodoApp.HttpApi.Host` 托管服务器端的 HTTP API. -* `TodoApp.Blazor` 客户端托管的 Blazor WebAssembly 应用. +* `TodoApp.HttpApi.Host` 承载服务器端的 HTTP API。 +* `TodoApp.Blazor` 是客户端的Blazor WebAssembly应用程序。 -确保 `TodoApp.HttpApi.Host` 是启动项目,然后运行应用程序(Visual Studio中的Ctrl+F5)以查看[Swagger UI](https://swagger.io/tools/swagger-ui/)上server-side 的 HTTP API: +确保 `TodoApp.HttpApi.Host` 是启动项目，然后运行应用程序(Visual Studio中的Ctrl+F5)打开[Swagger UI](https://swagger.io/tools/swagger-ui/)来查看服务器端的 HTTP API： -![todo-swagger-ui-initial](todo-swagger-ui-initial.png) +![todo swagger-u 初始化](todo-swagger-ui-initial.png) -你可以使用此UI查看和测试你的HTTP API.现在,我们可以将 `TodoApp.Blazor` 设置为启动项目,并运行它来打开实际的Blazor应用程序UI: +您可以使用此 UI 探索和测试您的 HTTP API。 现在，我们可以将 `TodoApp.Blazor` 设置为启动项目并运行它来打开实际的 Blazor 应用程序UI： {{else if UI=="NG"}} -最好在开始开发之前运行应用程序.该解决方案有两个主要应用: +最好在开始开发之前运行一下应用程序。 解决方案中有两个主要应用程序； -* `TodoApp.HttpApi.Host` (在.NET解决方案中)承载服务器端HTTP API. -* `angular` 文件夹包含 Angular 应用程序. +* `TodoApp.HttpApi.Host` (在.NET解决方案中)承载服务器端HTTP API。 +* `angular` 文件夹包含 Angular 应用程序。 -确保`TodoApp.HttpApi.Host`project是启动项目,然后运行应用程序(visual studio中是Ctrl+F5)以查看[Swagger UI](https://swagger.io/tools/swagger-ui/)上server-side HTTP API: +确保 `TodoApp.HttpApi.Host` 是启动项目，然后运行应用程序(Visual Studio中的Ctrl+F5)打开[Swagger UI](https://swagger.io/tools/swagger-ui/)来查看服务器端的 HTTP API： ![todo-swagger-ui-initial](todo-swagger-ui-initial.png) -你可以使用这个UI查看和测试你的HTTP API.如果可以的话,我们可以运行Angular客户端应用程序. +您可以使用此 UI 探索和测试您的 HTTP API。 如果该功能正常，我们可以运行Angular 客户端应用程序。 -首先,运行以下命令来还原NPM包: +首先，运行以下命令来还原NPM包： ````bash npm install ```` -安装所有软件包需要一些时间.然后可以使用以下命令运行应用程序: +安装所有软件包需要一些时间。 然后可以使用以下命令运行应用程序： ````bash npm start ```` -此命令需要一点时间,但最终会在默认浏览器中运行并打开应用程序: +此命令需要时间，但最终在你的默认浏览器中运行并打开应用程序： {{end}} -![todo-ui-initial](todo-ui-initial.png) +![i待办事项 Ui](todo-ui-initial.png) -你可以单击 *登录* 按钮,以`admin`作为用户名,`1q2w3E*` 作为密码登录到应用程序. +你可以单击 *登录* 按钮，以`admin`作为用户名和`1q2w3E*` 作为密码登录到应用程序。 -一切就绪.我们可以开始编码了！ +一切就绪。 我们可以开始编程！ ## 领域层 -此应用程序只有一个 [实体](../../Entities.md) 我们开始创建它. 在*TodoApp.Domain*项目中创建一个新的 `TodoItem` 类: +此应用程序只有一个 [实体](../../Entities.md)，接下来我们开始创建它。 在 *TodoApp.Domain* 项目中创建一个新的 `TodoItem` 类： ````csharp using System; @@ -135,29 +135,35 @@ namespace TodoApp } ```` -`BasicAggregateRoot` 是创建根实体的最简单的基类之一,`Guid` 是这里实体的主键 (`Id`). +`BasicAggregateRoot` 是创建根实体的最简单的基础类。 `Guid` 是这里实体的主键 (`Id`)。 -## Database Integration 数据库集成 +## 数据库集成 {{if DB=="EF"}} -下一步是配置 [Entity Framework Core](../../Entity-Framework-Core.md). +下一步是设置 [Entity Framework Core](../../Entity-Framework-Core.md)配置 -### Mapping Configuration 映射配置 +### 映射配置 -在 *TodoApp.EntityFrameworkCore* 项目的 `EntityFrameworkCore` 文件夹中打开 `TodoAppDbContext` 类,并向该类添加一个新的 `DbSet` 属性: +打开在 *TodoApp.EntityFrameworkCore* 项目中 `EntityFrameworkCore` 文件夹中的 `TodoAppDbContext` 类，并向该类添加新的 `DbSet` 属性： ````csharp public DbSet TodoItems { get; set; } ```` -然后在同一文件夹中打开 `TodoAppDbContextModelCreatingExtensions` 类,并为 `TodoItem` 类添加映射配置,如下所示: +然后在 `TodoAppDbContext` 类中定位到 `OnModelCreating` 方法，并为 `TodoItem` 实体添加映射代码： ````csharp -public static void ConfigureTodoApp(this ModelBuilder builder) +protected override void OnModelCreating(ModelBuilder builder) { - Check.NotNull(builder, nameof(builder)); + base.OnModelCreating(builder); + + /* Include modules to your migration db context */ + builder.ConfigurePermissionManagement(); + ... + + /* Configure your own tables/entities inside here */ builder.Entity(b => { b.ToTable("TodoItems"); @@ -165,40 +171,41 @@ public static void ConfigureTodoApp(this ModelBuilder builder) } ```` -我们已经将 `TodoItem` 实体映射到数据库中的 `TodoItems` 表. +我们已经将 `TodoItem` 实体映射到数据库中的 `TodoItems` 表。 -### 代码优先迁移 +### Code First 迁移 -解决方案启动模版已经配置为使用Entity Framework Core [Code First 迁移](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations).由于我们已经更改了数据库映射配置,因此我们应该创建一个新的迁移并将更改应用于数据库. +解决方案快速模版已经配置为使用Entity Framework Core的 [Code First 迁移](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations)。 由于我们已经更改了数据库映射配置，因此我们应该创建一个新的迁移并将更改应用于数据库。 -在 *TodoApp.EntityFrameworkCore.DbMigrations* 项目的目录中打开一个命令行终端,然后键入以下命令: +在 *TodoApp.EntityFrameworkCore* 项目目录中打开一个命令行终端并输入以下命令： ````bash dotnet ef migrations add Added_TodoItem ```` -这将向项目添加一个新的迁移类: +这将向项目添加一个新的迁移类： ![todo-efcore-migration](todo-efcore-migration.png) -你可以在同一命令行终端中使用以下命令将更改应用于数据库: +你可以在同一命令行终端中使用以下命令将更改应用于数据库： ````bash dotnet ef database update ```` -> 如果你使用的是Visual Studio,*则可能希望在包管理器控制台 (PMC)* 中使用 `Add-Migration Added_TodoItem` 和 `Update-Database` 命令.在这种情况下,请确保 {{if UI=="MVC"}}`TodoApp.Web`{{else if UI=="BlazorServer"}}`TodoApp.Blazor`{{else if UI=="Blazor" || UI=="NG"}}`TodoApp.HttpApi.Host`{{end}} 是启动项目,并且 `TodoApp.EntityFrameworkCore.DbMigrations` 是PMC中的 *默认项目*. +> 如果你使用的是Visual Studio，*则可能希望在包管理器控制台 (PMC)* 中使用 `Add-Migration Added_TodoItem` 和 `Update-Database` 命令。 在这种情况下，请确保 {{if UI=="MVC"}}`TodoApp.Web`{{else if UI=="BlazorServer"}}`TodoApp.Blazor`{{else if UI=="Blazor" || UI=="NG"}}`TodoApp.HttpApi.Host`{{end}} 是启动项目，并且 `TodoApp.EntityFrameworkCore` 是PMC中的 *默认项目*。 + {{else if DB=="Mongo"}} -下一步是设置 [MongoDB](../MongoDB.md) 配置.在 *TodoApp.MongoDB* 项目的 `MongoDb` 文件夹中打开 `TodoAppMongoDbContext` 类,并进行以下更改; +下一步是设置 [MongoDB](../../MongoDB.md) 配置。 打开 *TodoApp.MongoDB* 项目中 `MongoDb` 文件夹的`TodoAppMongoDbContext` 类并做出以下更改； -1. 向类添加新属性: +1. 向类添加新属性： ````csharp public IMongoCollection TodoItems => Collection(); ```` -2. 在 `CreateModel` 方法中添加以下代码: +2. 在 `CreateModel` 方法中添加以下代码： ````csharp modelBuilder.Entity(b => @@ -209,11 +216,11 @@ modelBuilder.Entity(b => {{end}} -现在,我们可以使用ABP仓储来保存和检索待办事项列表项了,就像我们将在下一节中做的那样. +现在，我们可以使用ABP仓库保存和检索待办事项，如我们在下一节所做的那样。 ## 应用层 -[应用服务](../../Application-Services.md) 用于执行应用程序的用例.我们需要执行以下用例; +[应用程序服务](../../Application-Services.md) 用于执行应用程序的用例。 我们需要执行以下用例： * 获取待办事项列表 * 创建新的待办事项 @@ -221,7 +228,7 @@ modelBuilder.Entity(b => ### 应用服务接口 -我们可以从为应用程序服务定义一个接口开始.在 *TodoApp.Application.Contracts* 项目中创建一个新的 `ITodoAppService` 接口,如下所示: +我们可以先从为应用程序服务定义接口开始。 在 *TodoAppp.Application.application.contracts* 项目中创建新的 `ITodoAppService` 接口，如下所示： ````csharp using System; @@ -242,7 +249,7 @@ namespace TodoApp ### 数据传输对象 -`GetListAsync` 和 `CreateAsync` 方法返回 `TodoItemDto`. 通常应用服务获取或返回的是 DTO ([数据传输对象](../../Data-Transfer-Objects.md)) 而不是直接获取或返回实体对象. 所以，我们应该在此定义 DTO(数据传输对象) 类. 在 *TodoApp.Application.Contracts* 项目中创建一个名为 `TodoItemDto` 的类: +`GetListAsync` 和`CreateAsync` 方法返回 `TodoItemDto`。 `应用程序服务` 通常获取并返回 DTO ([数据传输对象](../../Data-Transfer-Objects.md)) 而不是实体。 因此，我们应该在这里定义DTO类。 在 *TodoApp.Application.Contracts* 项目中创建新的 `TodoItemDto` 类： ````csharp using System; @@ -257,11 +264,11 @@ namespace TodoApp } ```` -这是一个非常简单的DTO类,与我们的 `TodoItem` 实体相对应.我们接下来实现 `ITodoAppService` 接口. +这是一个非常简单的DTO类，它与我们的 `TodoItem` 实体相对应。 接下来，我们准备实现 `ITodoAppService`接口。 ### 应用服务实现 -在 *TodoApp.Application* 项目内部创建一个 `TodoAppService` 类,如下所示: +在 *TodoApp.Application* 项目中创建 `TodoAppService` 类，如下所示： ````csharp using System; @@ -281,17 +288,17 @@ namespace TodoApp { _todoItemRepository = todoItemRepository; } - + // TODO: Implement the methods here... } } ```` -该类继承自ABP框架的 `ApplicationService` 类,并实现了之前定义的 `ITodoAppService`接口.ABP为实体提供默认的通用的 [仓储](../repositories.md).我们可以使用它们来执行基本的数据库操作. 这个类 [注入](../Dependency-Injection.md) `IRepository` 它是 `TodoItem` 实体的默认存储库.我们将使用它来实现之前描述的用例. +该类继承自ABP框架的`ApplicationService`类，并实现了之前定义的 `ITodoAppService`接口。 ABP为实体提供默认的泛型 [仓储](../../Repositories.md)。 我们可以使用它们来执行基本的数据库操作 此类 [注入](../../Dependency-Injection.md) `IRepository`，它是 `TodoItem` 实体的默认存储库。 我们将使用它来实现之前描述的用例。 -#### 获取所有待办事项列表 +#### 获取待办事项 -让我们开始实现 `GetListAsync` 方法: +让我们先实现 `GetListAsync` 方法： ````csharp public async Task> GetListAsync() @@ -306,11 +313,11 @@ public async Task> GetListAsync() } ```` -我们只是简单的从数据库中获取完整的 `TodoItem` 列表,将它们映射到 `TodoItemDto` 对象并作为结果返回. +我们只是从数据库中获取完整的`TodoItem`列表，将它们映射到`TodoItemDto`对象并作为结果返回。 #### 创建一个新的待办事项 -下一个方法是 `CreateAsync`,我们可以像如下所示来实现: +下一个我们可以实现方法是 `CreateAsync` ，如下所示： ````csharp public async Task CreateAsync(string text) @@ -327,11 +334,11 @@ public async Task CreateAsync(string text) } ```` -仓储的 `InsertAsync` 方法将给定的 `TodoItem` 插入数据库,并返回相同的 `TodoItem` 对象.它还设置了 `Id`,因此我们可以在返回对象上使用它.我们只是通过从新的 `TodoItem` 实体创建和返回 `TodoItemDto`. +仓储的 `InsertAsync` 方法将给定的`TodoItem`插入数据库，并返回相同的`TodoItem` 对象。 它还设置了`Id`，因此我们可以在返回对象上使用它。 我们只是通过从新的 `TodoItem` 实体创建和返回 `TodoItemDto`。 #### 删除待办事项 -最后,我们可以将 `DeleteAsync` 实现为以下代码块: +最后，我们来实现 `DeleteAsync` 方法，代码如下： ````csharp public async Task DeleteAsync(Guid id) @@ -340,21 +347,21 @@ public async Task DeleteAsync(Guid id) } ```` -至此，应用程序服务已准备好了让UI层来使用. +至此，应用程序服务已准备好了让UI层来使用。 ## 用户界面层 -是时候在UI上显示待办事项了!在开始编写代码之前,最好记住我们正在尝试构建的内容.这是最终UI的示例屏幕截图: +现在是在UI上显示待办事项的时候了！ 在开始编写代码之前，最好记住我们正在尝试构建的内容。 这里是示例程序的最终用户界面的截图： -![todo-list](todo-list.png) +![待办事项列表](todo-list.png) -> **我们将在本教程中保持最简洁轻量的UI端,以使本教程简单且重点突出.请参阅[web应用程序开发教程](../Part-1.md) 以构建包含各个方面的真实页面.** +> **我们将在本教程中保持最简洁的UI端，以使本教程简单且重点突出。 请参阅 [web应用程序开发教程](../Part-1.md) 来了解构建实际应用各个方面。** {{if UI=="MVC"}} ### Index.cshtml.cs -在 *TodoApp.Web* 项目的 `Pages` 文件夹中打开 `Index.cshtml.cs` 文件,并用以下代码块替换它的默认内容: +打开在 *TodoApp.Web* 项目的 `Pages` 文件夹中`Index.cshtml.cs`文件，并用以下代码块替换它的默认内容： ````csharp using System.Collections.Generic; @@ -381,11 +388,11 @@ namespace TodoApp.Web.Pages } ```` -此类使用 `ITodoAppService` 获取待办事项目列表并将它赋值给 `TodoItems` 属性.我们将用它来渲染razor页面上的待办事项目列表. +此类使用 `ITodoAppService` 获取待办事项列表并将它赋值给 `Todoitems` 属性。 我们将用它来渲染razor页面上的待办事项目列表。 ### Index.cshtml -在 *TodoApp.Web* 项目的 `Pages` 文件夹中打开 `Index.cshtml` 文件,并替换为以下内容: +打开 *TodoApp.Web* 项目中`Pages`文件夹下的`Index.cshtml`，并替换为以下内容： ````xml @page @@ -412,7 +419,7 @@ namespace TodoApp.Web.Pages placeholder="enter text..."> - +
    @foreach (var todoItem in Model.TodoItems) @@ -427,32 +434,32 @@ namespace TodoApp.Web.Pages ```` -我们使用ABP的 [卡片标签助手](../../UI/AspNetCore/Tag-Helpers/Cards.md) 创建一个简单的卡片视图.你可以直接使用标准的bootstrap HTML, 不过ABP的[标签助手](../../UI/AspNetCore/Tag-Helpers/Index.md) 使它更简单并且类型安全. +我们使用 ABP 的 [卡片标签助手](../../UI/AspNetCore/Tag-Helpers/Cards.md) 来创建一个简单的卡片视图。 您可以直接使用标准引导HTML结构，但ABP [标签助手](../../UI/AspNetCore/Tag-Helpers/Index.md) 使它更容易并且更安全。 -这个页面要导入一个CSS和一个JavaScript文件,所以我们也应该创建它们. +此页面导入一个 CSS 和 JavaScript 文件，所以我们需要创建它们。 ### Index.js -在 *TodoApp.Web* 项目的 `Pages` 文件夹中打开 `Index.js` 文件,并替换为以下内容: +打开 *TodoApp.Web* 项目中`Pages`文件夹下的`Index.js`，并替换为以下内容： ````js $(function () { - + // DELETING ITEMS ///////////////////////////////////////// $('#TodoList').on('click', 'li i', function(){ var $li = $(this).parent(); var id = $li.attr('data-id'); - + todoApp.todo.delete(id).then(function(){ $li.remove(); abp.notify.info('Deleted the todo item.'); }); }); - + // CREATING NEW ITEMS ///////////////////////////////////// $('#NewItemForm').submit(function(e){ e.preventDefault(); - + var todoText = $('#NewItemText').val(); todoApp.todo.create(todoText).then(function(result){ $('
  • ') @@ -464,15 +471,15 @@ $(function () { }); ```` -在第一部分中,我们在待办事项目附近注册点击删除图标所要触发的事件,删除服务器上的相关待办事项并在UI上显示通知.另外,我们从DOM中删除已删除的项,因此我们不需要刷新页面. +在第一部分中，我们注册了在待办事项旁边的删除图标的点击事件，来删除服务器上的相关项目并在UI上显示通知。 此外，我们会从 DOM 中移除已删除的项目，所以我们不需要刷新页面。 -在第二部分中,我们在服务器上创建一个新的待办事项.如果成功,我们将操纵DOM以将新的 `
  • ` 元素插入todo列表.这样,创建新的待办事项后就不用刷新整个页面了. +在第二部分中，我们在服务器上创建一个新的待办事项。 如果成功，我们将操纵DOM来将新的 `
  • ` 元素插入到待办事项列表。 这样我们不需要在创建新的待办事项后刷新整个页面。 -这里有趣的部分是我们如何与服务器通信.请参阅 *动态JavaScript代理和自动API控制器* 部分,以了解其工作原理.但是现在让我们继续并完成这个应用程序. +这里有趣的部分是我们如何与服务器通信。 请参阅 *动态JavaScript代理和自动API控制器* 部分来了解其工作原理。 但是现在让我们继续并完成这个应用程序。 ### Index.css -来到最后要做的工作,请打开 *TodoApp.Web* 项目的 `Pages` 文件夹中的 `Index.css` 文件,并替换为以下内容: +最后，请打开 *TodoApp.Web* 项目的 `Pages` 文件夹中的 `Index.css` 文件，并替换为以下内容： ````css #TodoList{ @@ -501,17 +508,17 @@ $(function () { } ```` -这是待办事项页面的简单样式.我们相信你可以做得更好 :) +这是待办事项页面的简单样式。 我们相信你可以做得更好 :) -现在,你可以再次运行应用程序以查看结果. +现在，你可以再次运行应用程序并看到结果。 -### Dynamic JavaScript Proxies & Auto API Controllers 动态JavaScript代理和自动应用编程接口控制器 +### 动态JavaScript 代理服务器 和 自动API控制器 -在 `Index.js` 文件中,我们使用了 `todoApp.todo.delete(...)` 和 `todoApp.todo.create(...)` 函数与服务器通信.这些函数是由ABP框架动态创建的,这要归功于 [动态JavaScript客户端代理](../UI/AspNetCore/Dynamic-JavaScript-Proxies.md) 系统.他们对服务器执行HTTP API调用并返回承诺,因此你可以像上面所做的那样注册对 `then` 函数的回调. +在 `Index.js` 文件中，我们使用了 `todoApp.delete(...)` 和 `todoApp.todo.create(...)` 方法来与服务器通信。 这些函数是由ABP 框架动态创建的，这要归功于 [动态JavaScript 客户端代理](../../UI/AspNetCore/Dynamic-JavaScript-Proxies.md) 系统。 它们执行 HTTP API 服务器调用并返回一个Promise， 这样你就可以使用 `then` 函数注册一个回调，如之前所做的那样。 -但是,你可能会问我们还没有创建任何API控制器,那么服务器如何处理这些请求呢? 这个问题为我们引出了ABP框架的 [自动API控制器](../API/Auto-API-Controllers.md) 功能.它通过约定自动将应用程序服务转换为API Controllers(API控制器). +但是，你可能会注意到我们还没有创建任何API控制器，所以服务器如何处理这些请求？ 这个问题为我们引出了ABP 框架的 [自动API控制器](../../API/Auto-API-Controllers.md) 功能。 它通过约定自动将应用程序服务转换为 API 控制器。 -如果通过在应用程序中输入 `/swagger` URL来打开 [swagger UI](https://swagger.io/tools/ Swagger-ui/),则可以看到Todo API: +如果你在应用程序URL中输入 `/swagger` 来打开 [Swagger UI](https://swagger.io/tools/swagger-ui/) ，就会看到Todo API： ![todo-api](todo-api.png) @@ -519,7 +526,7 @@ $(function () { ### Index.razor.cs -在 *TodoApp.Blazor* 项目的 `Pages` 文件夹中打开 `Index.razor.cs` 文件,并用以下代码块替换内容: +打开在*TodoApp.Blazor*项目的`Pages`文件夹中`Index.razor.cs`文件，并替换为一下内容： ````csharp using Microsoft.AspNetCore.Components; @@ -540,7 +547,7 @@ namespace TodoApp.Blazor.Pages { TodoItems = await TodoAppService.GetListAsync(); } - + private async Task Create() { var result = await TodoAppService.CreateAsync(NewTodoText); @@ -558,17 +565,17 @@ namespace TodoApp.Blazor.Pages } ```` -这个类使用 `ITodoAppService` 对待办事项执行操作.它在创建和删除操作后操纵 `TodoItems` 列表.这样,我们不需要从服务器刷新整个todo列表. +此类使用 `ITodoAppService` 来执行待办事项的操作。 它在创建和删除操作后操纵 `TodoItems` 列表。 这样，我们不需要从服务器刷新整个待办事项列表。 {{if UI=="Blazor"}} -请参阅下面的 *动态C # 代理和自动API控制器* 部分,了解如何从浏览器上运行的Blazor应用程序注入和使用应用程序服务接口!但是现在,让我们继续并完成这个应用. +请参阅下面的 *动态C # 代理和自动API控制器* 部分，来了解我们如何在浏览器上运行的 Blazor 应用程序中注入和使用应用服务接口！ 但是现在让我们继续并完成这个应用程序。 {{end # Blazor}} ### Index.razor -在 *TodoApp.Blazor* 项目的 `Pages` 文件夹中打开 `Index.razor` 文件,并用以下代码块替换内容: +打开在*TodoApp.Blazor*项目的`Pages`文件夹中 `Index.razor`文件，并替换为以下代码块内容： ````xml @page "/" @@ -611,7 +618,7 @@ namespace TodoApp.Blazor.Pages ### Index.razor.css -最后,请在 *TodoApp.Web* 项目的 `Pages` 文件夹中打开 `Index.razor.css` 文件,并替换为以下内容: +最后，请打开 *TodoApp.Blazor* 项目的 `Pages` 文件夹中的 `Index.razor.css`文件，并替换为以下内容： ````css #TodoList{ @@ -640,21 +647,21 @@ namespace TodoApp.Blazor.Pages } ```` -这是待办事项页面的简单样式.我们相信你可以做得更好 :) +这是待办事项页面的简单样式。 我们相信你可以做得更好 :) -现在,你可以再次运行应用程序以查看结果. +现在，你可以再次运行应用程序来查看结果。 {{if UI=="Blazor"}} -### Dynamic C# Proxies & Auto API Controllers 动态C#代理和自动应用编程接口控制器 +### 动态C#代理 & 自动API控制器 -在 `Index.razor.cs` 文件中,我们已经注入(使用 `[Inject]` 特性)并像使用本地服务一样使用 `ITodoAppService`.请记住,当此应用程序服务的实例在服务器上运行的同时,Blazor应用程序正在浏览器上运行. +在 `Index.razor.cs` 文件中，我们已经注入(使用 `[Inject]` 特性)并像使用本地服务一样使用 `ITodoAppService`。 请记住，Blazor应用程序正在在浏览器上运行，而此应用程序服务正在服务器上运行。 -这个神奇的过程是由ABP框架的 [动态C#客户端代理](../API/Dynamic-CSharp-API-Clients.md) 系统完成的.它使用标准的 `HttpClient` 并向远程服务器执行HTTP API请求.它还为我们处理所有标准任务,包括授权,JSON序列化和异常处理. +这个神奇的过程是由ABP框架的 [动态 C# 客户端代理](../../API/Dynamic-CSharp-API-Clients.md) 系统完成。 它使用标准的`HttpClient` 并执行HTTP API 请求到远程服务器。 它还为我们处理所有标准任务，包括授权、JSON序列化和异常处理。 -但是,你可能会问我们还没有创建任何API控制器,那么服务器如何处理这些请求呢? 这个问题为我们引出了ABP框架的 [自动API控制器](../API/Auto-API-Controllers.md) 功能.它通过约定自动将应用程序服务转换为API控制器. +但是，你可能会问我们还没有创建任何API控制器，那么服务器如何处理这些请求呢？ 这个问题为我们引出了ABP 框架的 [自动API控制器](../../API/Auto-API-Controllers.md) 功能。 它通过约定自动将应用程序服务转换为 API 控制器。 -如果你运行 `TodoApp.HttpApi.Host` 应用程序,你可以看到Todo API: +如果你运行 `TodoApp.HttpApi.Host` 应用程序，你可以看到Todo API： ![todo-api](todo-api.png) @@ -664,20 +671,21 @@ namespace TodoApp.Blazor.Pages ### 服务代理生成 -ABP提供了一个方便的功能,可以自动创建客户端服务,轻松使用服务器提供的HTTP APIs. +ABP提供了一个便捷的功能来自动创建客户端服务，以方便地使用由服务器提供的HTTP APIs。 + +你首先需要运行 `TodoApp.HttpApi.Host` 项目，因为代理生成器从服务器应用程序读取API定义。 -你首先需要运行 `TodoApp.HttpApi.Host` 项目,因为代理生成器从服务器应用程序读取API定义. +> **请注意**: IIS Express有一个问题：它不允许从另一个进程连接到应用程序。 如果你使用的是Visual Studio，请在 “运行” 按钮下拉列表中选择`TodoApp.HttpApi.Host` 来替代IIS Express，如下图所示： -> **请注意**: IIS Express有问题; 它不允许从另一个进程连接到应用程序.如果你使用的是Visual Studio,请在 “运行” 按钮下拉列表中选择 `TodoApp.HttpApi.Host` 而不是IIS Express,如下图所示: -![run-without-iisexpress](run-without-iisexpress.png) +![运行时不使用 iisexpress](run-without-iisexpress.png) -运行 `TodoApp.HttpApi.Host` 项目后,在 `angular` 文件夹中打开命令行终端,然后键入以下命令: +当启动 `TodoApp.HttpApi.Host` 项目后，在`angular`文件夹中打开一个命令行终端并输入以下命令： ````bash abp generate-proxy ```` -如果一切顺利,应该生成如下所示的输出: +如果一切顺利，它应该生成如下输出： ````bash CREATE src/app/proxy/generate-proxy.json (170978 bytes) @@ -687,11 +695,11 @@ CREATE src/app/proxy/models.ts (66 bytes) CREATE src/app/proxy/index.ts (58 bytes) ```` -然后,我们可以使用 `todoService` 来使用服务器端HTTP APIs,就像我们将在下一节中做的那样. +然后，我们可以使用 `todoService` 来使用服务器端HTTP APIs ，就像我们将在下一节中做的那样。 ### home.component.ts -打开 `/angular/src/app/home/home.component.ts` 文件,并用以下代码块替换其内容: +打开 `/angular/src/app/home/home.component.html` 文件，并用以下代码块替换其内容： ````js import { ToasterService } from '@abp/ng.theme.shared'; @@ -718,7 +726,7 @@ export class HomeComponent implements OnInit { this.todoItems = response; }); } - + create(): void{ this.todoService.create(this.newTodoText).subscribe((result) => { this.todoItems = this.todoItems.concat(result); @@ -736,11 +744,11 @@ export class HomeComponent implements OnInit { ```` -我们已经实现了使用 `todoService` 来获取待办事项目列表,并将返回值赋值给 `todoItems` 数组.我们还添加了 `create`和 `delete` 方法.这些方法将在视图端使用. +我们已经实现了使用 `todoService` 来获取待办事项目列表，并将返回值赋值给 `todoItems` 数组。 我们还添加了 `create` 和 `delete` 方法。 这些方法将在视图端使用。 ### home.component.html -打开 `/angular/src/app/home/home.component.html` 文件,并用以下代码块替换其内容: +打开 `/angular/src/app/home/home.component.html` 文件，并用以下代码块替换其内容： ````html
    @@ -774,7 +782,7 @@ export class HomeComponent implements OnInit { ### home.component.scss -最后的最后,打开 `/angular/src/app/home/home.component.scss` 文件,并用以下代码块替换其内容: +最后，打开`/angular/src/app/home/home.component.scss` 文件，并用以下代码块替换其内容： ````css #TodoList{ @@ -803,19 +811,19 @@ export class HomeComponent implements OnInit { } ```` -这是待办事项页面的简单样式.我们相信你可以做得更好 :) +这是待办事项页面的简单样式。 我们相信你可以做得更好 :) -现在,你可以再次运行应用程序以查看结果. +现在，你可以再次运行应用程序来查看结果。 {{end}} ## 总结 -在本教程中,我们构建了一个非常简单的应用程序来抢先探究ABP框架的新特性.如果你想构建一个实际场景的应用程序,请查看 [应用程序开发教程](../Part-1.md),其中涵盖了实际web应用程序开发的所有方面. +在这个教程中，我们已经建立了一个非常简单的应用程序来熟悉 ABP 框架。 如果你想要构建一个实际场景的应用程序， 请检查 [web 应用程序开发教程](../Part-1.md) ，该教程涵盖了真实的 web 应用程序开发的所有方面。 ## 源代码 -你可以在[这里](https://github.com/abpframework/abp-samples/tree/master/TodoApp)获取到完整的应用程序源代码. +你可以在[这里](https://github.com/abpframework/abp-samples/tree/master/TodoApp)找到已完成的项目源代码。 ## 另请参见