Skip to content

Commit

Permalink
minor updates
Browse files Browse the repository at this point in the history
  • Loading branch information
yingang committed Jul 5, 2024
1 parent 010b5ee commit 314ee49
Show file tree
Hide file tree
Showing 4 changed files with 4 additions and 8 deletions.
2 changes: 1 addition & 1 deletion docs/ch18.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ public static void main(String[] args) {
}
```

大多数应用程序在其主程序返回时退出,因此读者可能会认为这里也是一样的。然而,事实并非如此。`RaftClient` 的构造函数创建了额外的线程,即使应用程序的主线程结束了,该线程仍在继续运行。应该在 RaftClient 构造函数的接口注释中记录此行为,但是该行为不够明显,因此值得在 `main` 函数的末尾添加简短注释,该注释应描述该应用程序将继续在其他线程中执行。如果代码符合读者期望的约定,那么它是显而易见的。如果不是,那么将行为记录下来就很重要,这样读者才不会感到困惑。
大多数应用程序在其主程序返回时退出,因此读者可能会认为这里也是一样的。然而,事实并非如此。`RaftClient` 的构造函数创建了额外的线程,即使应用程序的主线程结束了,该线程仍在继续运行。应该在 `RaftClient` 构造函数的接口注释中记录此行为,但是该行为不够明显,因此值得在 `main` 函数的末尾添加简短注释,该注释应描述该应用程序将继续在其他线程中执行。如果代码符合读者期望的约定,那么它是显而易见的。如果不是,那么将行为记录下来就很重要,这样读者才不会感到困惑。

## 18.3 结论

Expand Down
4 changes: 1 addition & 3 deletions docs/ch19.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,9 +60,7 @@

设计模式的最大风险是过度使用。不是每个问题都可以用现有的设计模式来解决。当自定义的方法更加简洁时,请勿尝试将问题强加到设计模式中。使用设计模式并不能自动改善软件系统,只有在设计模式合适的情况下才会如此。与软件设计中的许多想法一样,设计模式是良好的并不一定意味着使用更多的设计模式也一定会更好。

## 19.6 Getter 和 Setters

19.6 Getters and setters
## 19.6 Getters 和 Setters

在 Java 编程社区中,Getter 和 Setter 方法是一种流行的设计模式。Getter 和 Setter 与一个类的实例变量相关联。它们具有类似 getFoo 和 setFoo 的名称,其中 Foo 是变量的名称。Getter 方法返回变量的当前值,Setter 方法修改该值。

Expand Down
2 changes: 1 addition & 1 deletion docs/zh-tw/ch18.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ public static void main(String[] args) {
}
```

大多數應用程式在其主程式返回時退出,因此讀者可能會認為這裡也是一樣的。然而,事實並非如此。`RaftClient` 的建構函式建立了額外的執行緒,即使應用程式的主執行緒結束了,該執行緒仍在繼續執行。應該在 RaftClient 建構函式的介面註釋中記錄此行為,但是該行為不夠明顯,因此值得在 `main` 函式的末尾新增簡短註釋,該註釋應描述該應用程式將繼續在其他執行緒中執行。如果程式碼符合讀者期望的約定,那麼它是顯而易見的。如果不是,那麼將行為記錄下來就很重要,這樣讀者才不會感到困惑。
大多數應用程式在其主程式返回時退出,因此讀者可能會認為這裡也是一樣的。然而,事實並非如此。`RaftClient` 的建構函式建立了額外的執行緒,即使應用程式的主執行緒結束了,該執行緒仍在繼續執行。應該在 `RaftClient` 建構函式的介面註釋中記錄此行為,但是該行為不夠明顯,因此值得在 `main` 函式的末尾新增簡短註釋,該註釋應描述該應用程式將繼續在其他執行緒中執行。如果程式碼符合讀者期望的約定,那麼它是顯而易見的。如果不是,那麼將行為記錄下來就很重要,這樣讀者才不會感到困惑。

## 18.3 結論

Expand Down
4 changes: 1 addition & 3 deletions docs/zh-tw/ch19.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,9 +60,7 @@

設計模式的最大風險是過度使用。不是每個問題都可以用現有的設計模式來解決。當自定義的方法更加簡潔時,請勿嘗試將問題強加到設計模式中。使用設計模式並不能自動改善軟體系統,只有在設計模式合適的情況下才會如此。與軟體設計中的許多想法一樣,設計模式是良好的並不一定意味著使用更多的設計模式也一定會更好。

## 19.6 Getter 和 Setters

19.6 Getters and setters
## 19.6 Getters 和 Setters

在 Java 程式設計社群中,Getter 和 Setter 方法是一種流行的設計模式。Getter 和 Setter 與一個類的例項變數相關聯。它們具有類似 getFoo 和 setFoo 的名稱,其中 Foo 是變數的名稱。Getter 方法返回變數的當前值,Setter 方法修改該值。

Expand Down

0 comments on commit 314ee49

Please sign in to comment.