From b99299416718a80fc841da43a99ea33ea0c7cfb3 Mon Sep 17 00:00:00 2001 From: Davirain Date: Thu, 17 Aug 2023 16:14:10 +0800 Subject: [PATCH] =?UTF-8?q?update=20=F0=9F=8E=A5=20=E6=9E=84=E5=BB=BA?= =?UTF-8?q?=E4=B8=80=E4=B8=AA=E7=94=B5=E5=BD=B1=E8=AF=84=E8=AE=BA=E7=A8=8B?= =?UTF-8?q?=E5=BA=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../build-a-movie-review-program/README.md | 79 +++++++++---------- 1 file changed, 38 insertions(+), 41 deletions(-) diff --git a/docs/Solana-Co-Learn/module3/native-solana-development/build-a-movie-review-program/README.md b/docs/Solana-Co-Learn/module3/native-solana-development/build-a-movie-review-program/README.md index a11fbbe06..87c21b79f 100644 --- a/docs/Solana-Co-Learn/module3/native-solana-development/build-a-movie-review-program/README.md +++ b/docs/Solana-Co-Learn/module3/native-solana-development/build-a-movie-review-program/README.md @@ -6,10 +6,9 @@ sidebar_class_name: green # 🎥 构建一个电影评论程序 +还记得我们在第一节中互动开发的电影评论节目吗？现在我们要继续深入开发它。当然，你可以随意评论任何内容，不仅限于电影，毕竟我并不是你的长辈，你自由发挥就好。 -还记得我们在第一节互动的电影评论节目吗？我们要在这里继续开发它。随意评论其他东西，不一定非得是电影，我又不是你爸爸。 - -回到操场（上一节课的那个，不是中学的那个），并开始一个新项目。我们将从基本结构开始 `lib.rs` ： +让我们回到操场（是上一节课的操场，不是中学时的那个），开始一个全新的项目。我们将从基础的结构编写开始，具体如 `lib.rs` 文件： ```rust use solana_program::{ @@ -32,12 +31,11 @@ pub fn process_instruction( } ``` -到目前为止都是一如既往的。与记事程序一样，我们将从定义指令结构和创建反序列化逻辑开始。 +到目前为止，一切都很熟悉。就像我们构建记事程序一样，我们将从定义指令结构开始，并创建用于反序列化的逻辑。 ## 🔪 反序列化指令数据 -我们将在一个名为 `instruction.rs` 的新文件中进行此操作。 - +我们将在一个名为 `instruction.rs` 的新文件中完成这个任务。 ```rust use borsh::{BorshDeserialize}; @@ -61,19 +59,19 @@ struct MovieReviewPayload { 我们需要引入的只有 `BorshDeserialize` 宏和 `ProgramError` 枚举。 -虽然我们只有一种指令类型，但我们仍然会使用枚举。以后我们可能会决定添加更多的指令 :) +虽然我们只有一种指令类型，但我们仍然会使用枚举。未来我们可能会考虑添加更多的指令 :) -你可能会想为什么我们需要在有效载荷中指定类型。这些类型告诉Borsh在哪里分割字节。在切割之前，得先知道香肠有多长，记住了吗？ +你可能会好奇，为何我们需要在有效负载中指定类型。这些类型告诉Borsh如何分割字节。在切割之前，得先知道香肠有多长，记得吗？ -我们在这里需要的最后一件事情是为 `MovieInstruction` 枚举添加实现。在枚举定义下面添加这个。 +我们还需要为 `MovieInstruction` 枚举添加实现。在枚举定义下方添加以下内容。 ```rust impl MovieInstruction { pub fn unpack(input: &[u8]) -> Result { - let (&variant, rest) = input.split_first().ok_or(ProgramError::InvalidInstructionData)?; + let (&variant, rest) = input.split_first().ok_or(ProgramError::InvalidInstructionData)?; - let payload = MovieReviewPayload::try_from_slice(rest).unwrap(); + let payload = MovieReviewPayload::try_from_slice(rest).unwrap(); Ok(match variant { 0 => Self::AddMovieReview { @@ -86,40 +84,40 @@ impl MovieInstruction { } ``` -你已经知道这里发生的一切！我们正在解析指令数据并返回枚举的正确变体。 +你应该能理解这里发生的一切！我们正在解析指令数据，并返回枚举的正确变体。 -注意在我们分割第一个字节时的 `?`。 +注意我们在分割第一个字节时使用的 `?`。 ```rust let (&variant, rest) = input.split_first().ok_or(ProgramError::InvalidInstructionData)?; ``` -如果 `unpack` 的结果是错误的，这是一种返回错误并退出 `unpack` 函数的简写方式。就像一个简单的`try/catch`。这是Rust中常见的模式，你会经常看到它。 +如果 `unpack` 的结果是错误，这是一种返回错误并退出 `unpack` 函数的简写方式。就像一个精简版的 `try/catch`。这在Rust中是常见的模式，你会经常看到它。 ```rust let payload = MovieReviewPayload::try_from_slice(rest).unwrap(); ``` -我也想更深入地探讨一下： `.unwrap();` 在Rust中，“`unwrap`”意味着“给我计算的结果，如果出现错误，就会发生恐慌并停止程序。”你可能会想：“嗯，但为什么我们需要从函数的结果中返回东西呢？难道 `try_from_slice()` 函数不会返回我们想要的吗？” +此外，我还想深入探讨一下 `.unwrap();` 在Rust中，“`unwrap`”意味着“给我计算的结果，如果出错就产生恐慌并停止程序。”你可能会想：“嗯，但是为什么我们需要从函数的结果中返回东西呢？难道 `try_from_slice()` 函数不会返回我们想要的吗？” -不是的。Rust有 `Option` 类型：一种使用Rust的类型系统来表示可能的缺失的方式。这与其他语言中的 `null` 不同。 `Option` 是一种类型，可以是 `Some` 或 `None` 。 `Some` 是一个值， `None` 是一个值的缺失。为什么？因为有时候你没有一个值，这是可以接受的。从[文档](https://web.mit.edu/rust-lang_v1.25/arch/amd64_ubuntu1404/share/doc/rust/html/book/first-edition/error-handling.html#unwrapping-explained?utm_source=buildspace.so&utm_medium=buildspace_project)中： +不是的。Rust有一个 `Option` 类型：一种使用Rust类型系统来表示可能缺失的方式。这与其他语言中的 `null` 不同。 `Option` 是一种类型，可以是 `Some` 或 `None` 。 `Some` 是一个值，`None` 是一个值的缺失。为什么呢？因为有时候你没有一个值，这是可以接受的。从[文档](https://web.mit.edu/rust-lang_v1.25/arch/amd64_ubuntu1404/share/doc/rust/html/book/first-edition/error-handling.html#unwrapping-explained?utm_source=buildspace.so&utm_medium=buildspace_project)中了解更多： -> 将缺席的可能性编码到类型系统中是一个重要的概念，因为它会迫使编译器强制程序员处理这种缺席。 +> 将缺失的可能性编码到类型系统中是一项重要的概念，因为它会迫使编译器强制程序员处理这种缺失的情况。 -Rust让你成为一个更好的开发者！现在你又了解了Rust蛋糕的另一个小部分🍰 +Rust助你成为更出色的开发者！现在，你又多了解了Rust的另一部分内容🍰 -## 👀 添加指令到程序中 +## 👀 将指令添加到程序中 -这里的最后一部分是将指令引入程序中。我们将在 `lib.rs` 中完成这个步骤。 +最后一部分的工作是将指令整合到程序中。我们将在 `lib.rs` 文件中完成此操作。 ```rust pub mod instruction; use instruction::{MovieInstruction}; ``` -如果你改变了枚举名称，请确保更新导入 +如果你更改了枚举名称，请确保相应地更新导入。 -现在我们只需将指令数据记录到控制台。在 `process_instruction` 函数之后添加这段代码。 +现在我们只需将指令数据记录到控制台。在 `process_instruction` 函数后添加以下代码。 ```rust pub fn add_movie_review( @@ -130,16 +128,16 @@ pub fn add_movie_review( description: String ) -> ProgramResult { - msg!("Adding movie review..."); - msg!("Title: {}", title); - msg!("Rating: {}", rating); - msg!("Description: {}", description); + msg!("正在添加电影评论..."); + msg!("标题: {}", title); + msg!("评分: {}", rating); + msg!("描述: {}", description); Ok(()) } ``` -现在我们可以更新 `process_instruction` 函数，使用 `unpack` 和 `add_movie_review` 函数： +现在，我们可以更新 `process_instruction` 函数，使用 `unpack` 和 `add_movie_review` 函数： ```rust pub fn process_instruction( @@ -158,19 +156,19 @@ pub fn process_instruction( } ``` -我们在这里所做的只是解析指令数据，然后使用正确的参数调用 `add_movie_review` 函数。 +我们在这里做的只是解析指令数据，然后使用正确的参数调用 `add_movie_review` 函数。 -我们的程序现在已经完成了！确保你点击部署按钮，并从游乐场复制程序ID。 +我们的程序现在已经完成了！请确保你点击部署按钮，并从游乐场复制程序ID。 -如果你觉得这有点令人失望，那是因为我们在上一课已经讲解了每个部分。让我们尝试使用客户端将电影评论添加到我们的程序中。 +如果你觉得这有点让人失望，那是因为我们在上一课已经逐一讲解了每个部分。现在，让我们尝试使用客户端将电影评论添加到我们的程序中。 ## 提交电影评论 -我们飞快地前进着，咱们走吧！ +我们的进展飞速，走吧！ -不需要从头开始写脚本，我相信你知道怎么做 :) +不需要从头开始编写脚本，我相信你知道该怎么做 :) -这是如何设置一个完整的脚本，包括你所需的一切： +下面是如何设置完整脚本的步骤，包括你所需的一切： ```rust git clone https://github.com/buildspace/solana-movie-client @@ -178,26 +176,25 @@ cd solana-movie-client npm install ``` -打开 `src/index.js` 并将第94行的程序ID更新为从playground复制的ID。如果你对程序进行了任何更改，这里也需要更新客户端。 - -在终端中输入 `npm start` ，然后你应该会得到一个资源管理器链接。点击那个链接，然后向下滚动到程序指令日志，你应该能看到你的电影评论！ +打开 `src/index.js` 并将第94行的程序ID更新为从playground复制的ID。如果你对程序做了任何更改，这里还需要更新客户端。 +在终端输入 `npm start` ，你应该会得到一个资源管理器链接。点击该链接，然后向下滚动到程序指令日志，你应该能看到你的电影评论！ ![](./img/movie-logo.png) -轻松愉快，我们能搞定的，出发！ +轻松有趣，我们可以做到，继续前进！ ## 🚢 船舶挑战 -对于本课程的挑战，尝试复制学生介绍程序。 +对于本课程的挑战，尝试复制一个学生介绍程序。 -该程序接收用户的姓名和短信作为指令数据，并创建一个账户来将数据存储在区块链上。 +该程序接收用户的姓名和短信作为指令数据，并创建一个账户以将数据存储在区块链上。 利用你在本课程中学到的知识，构建一个学生介绍程序，使得当程序被调用时，能够将用户提供的姓名和信息打印到程序日志中。 解决方案代码 你可以通过构建这个前端并在Solana Explorer上检查程序日志来测试你的程序。记得用你部署的程序ID替换前端代码中的ID。 -如果可以的话，尽量独立完成这个任务！但如果遇到困难，可以[参考解决方案代码](https://beta.solpg.io/62b0ce53f6273245aca4f5b0)。 +如果可以的话，尽量自己独立完成这个任务！但如果遇到困难，可以[参考解决方案代码](https://beta.solpg.io/62b0ce53f6273245aca4f5b0)。 -我相信你。 +我对你有信心。