docs: update .all-contributorsrc [skip ci]

docs: update README.md [skip ci]
Improve french translation, fix some typographic issues. (#1730 )
2021-04-29 13:25:05 +00:00 · 2021-04-29 13:25:04 +00:00 · 2021-04-29 18:54:03 +05:30 · 2021-04-29 18:51:14 +05:30 · 2021-04-29 18:49:45 +05:30
4 changed files with 178 additions and 30 deletions
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1476,8 +1476,16 @@
      "avatar_url": "https://avatars.githubusercontent.com/u/22493821?v=4",
      "profile": "https://al-assad.github.io/notion/",
      "contributions": [
-        "translation",
-        "projectManagement"
+        "translation"
+      ]
+    },
+    {
+      "login": "STudio26",
+      "name": "Alain",
+      "avatar_url": "https://avatars.githubusercontent.com/u/6988911?v=4",
+      "profile": "https://github.com/STudio26",
+      "contributions": [
+        "translation"
      ]
    }
  ],
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-162-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-163-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->

 <br/>
@@ -317,7 +317,8 @@ This project is licensed under the terms of the MIT license.
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/zWeBrain"><img src="https://avatars.githubusercontent.com/u/46642512?v=4?s=100" width="100px;" alt=""/><br /><sub><b>zWeBrain</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=zWeBrain" title="Code">💻</a></td>
-    <td align="center"><a href="https://al-assad.github.io/notion/"><img src="https://avatars.githubusercontent.com/u/22493821?v=4?s=100" width="100px;" alt=""/><br /><sub><b>余林颖</b></sub></a><br /><a href="#translation-Al-assad" title="Translation">🌍</a> <a href="#projectManagement-Al-assad" title="Project Management">📆</a></td>
+    <td align="center"><a href="https://al-assad.github.io/notion/"><img src="https://avatars.githubusercontent.com/u/22493821?v=4?s=100" width="100px;" alt=""/><br /><sub><b>余林颖</b></sub></a><br /><a href="#translation-Al-assad" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://github.com/STudio26"><img src="https://avatars.githubusercontent.com/u/6988911?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Alain</b></sub></a><br /><a href="#translation-STudio26" title="Translation">🌍</a></td>
  </tr>
 </table>

--- a/fr/README.md
+++ b/fr/README.md
@@ -1,12 +1,12 @@
 <!-- Cette ligne doit restée vide pour des raisons de formatage
-    afin qu'on puisse avoir un affichage agréable comme sur un 
+    afin qu’on puisse avoir un affichage agréable comme sur un 
    site web par exemple -->

 # Les patrons de conception implémentés en Java

 ![Java CI with Maven](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI%20with%20Maven/badge.svg)
 [![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md)
-[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=ncloc)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
+[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=ncloc)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
@@ -15,46 +15,56 @@

 # Introduction

-Le patron de conception est la meilleure formatalisation qu'un programmeur
-peut utiliser pour résoudre un problème lors d'une conception d'une application/system.
+Les patrons de conception (design patterns) sont les meilleures 
+pratiques formalisées qu’un programmeur peut utiliser pour résoudre
+des problèmes courants lors de la conception d’une application 
+ou d’un système.

-Le patron de conception (design pattern) est là pour accélérer le processus de 
+Les patrons de conception peuvent accélérer le processus de
 développement en fournissant des paradigmes éprouvés.

-La réutilisation de patron de conception aide à prévenir des problèmes subtiles mais
-qui sont à l'origine de problèmes majeures, comme cette pratique augmente la lisibilitée
-du code par les développeurs/architectes familiers avec l'utilisation de ces concepts.
+La réutilisation de patrons de conception aide à se prémunir des problèmes subtils
+qui causent des problèmes majeurs, et cette pratique augmente la lisibilité
+du code pour les développeurs et architectes familiers de ces concepts.

 # Commencer

-Ce site présente des modèles de conception Java. Les solutions ont été développées par des
-développeurs et architectes expérimentés de la communauté open source. Les modèles peuvent être parcourus par leurs descriptions de haut niveau ou en regardant leur code source. Les exemples de code source sont bien commentés et peuvent être considérés comme tutoriels de programmation sur la façon d'implémenter un modèle spécifique. Nous utilisons le plus technologies Java open source éprouvées au combat.
+Ce site présente des patrons de conception Java. Les solutions ont été développées 
+par des développeurs et architectes expérimentés de la communauté open source.
+Les modèles peuvent être parcourus par leurs descriptions de haut niveau ou
+en regardant leur code source.
+Les exemples de code source sont bien commentés et peuvent être considérés
+comme tutoriels de programmation sur la façon d’implémenter un modèle spécifique.
+Nous utilisons les technologies Java open source les plus populaires et éprouvées.

-Avant de plonger dans le matériau, vous devez vous familiariser avec divers
+Avant de vous plonger dans le contenu, vous devriez vous familiariser avec divers
 [Principes de conception de logiciels](https://java-design-patterns.com/principles/).

-Toutes les conceptions doivent être aussi simples que possible. Vous devriez commencer par KISS, YAGNI,
-et faire la chose la plus simple qui pourrait éventuellement fonctionner principes. Complexité et
-les modèles ne devraient être introduits que lorsqu'ils sont nécessaires pour
-extensibilité.
+Tous les modèles doivent être aussi simples que possible.
+Vous devriez commencer par les principes KISS, YAGNI et 
+Faites La Chose La Plus Simple Qui Fonctionne.
+La complexité et les modèles ne devraient être introduits
+que lorsqu’ils sont nécessaires pour une extensibilité pratique.

-Une fois que vous êtes familiarisé avec ces concepts, vous pouvez commencer à explorer
-[modèles de conception disponibles](https://java-design-patterns.com/patterns/) par tout
-des approches suivantes
+Une fois que vous êtes familiarisé avec ces concepts, vous pouvez commencer à explorer les
+[modèles de conception disponibles](https://java-design-patterns.com/patterns/)
+par n’importe laquelle les approches suivantes&nbsp:

- - Recherchez un modèle spécifique par son nom. Vous n'en trouvez pas? Veuillez signaler un nouveau modèle [ici](https://github.com/iluwatar/java-design-patterns/issues).
- - Utilisation de balises telles que `Performance`, `Gang of Four` ou `Data access`.
- - Utilisation des catégories de modèles, `Créatif`, `Comportemental` et autres.
+- Recherchez un modèle spécifique par son nom.
+  Vous n’en trouvez pas&nbsp;? Veuillez signaler un nouveau modèle [ici](https://github.com/iluwatar/java-design-patterns/issues).
+- Utilisation de balises telles que `Performance`, `Gang of Four` ou `Data access`.
+- Utilisation des catégories de modèles, `Creational`, `Behavioral` et autres.

-J'espère que les solutions orientées objet présentées sur ce site vous seront utiles
-dans vos architectures et ayez autant de plaisir à les apprendre que nous en avons eu à les développer.
+Nous espérons que vous trouverez les solutions orientées objet présentées
+sur ce site utiles dans vos architectures et que vous aurez autant 
+de plaisir à les apprendre que nous en avons eu à les développer.

 # Comment contribuer

 Si vous souhaitez contribuer au projet, vous trouverez les informations pertinentes dans
-notre [wiki développeur](https://github.com/iluwatar/java-design-patterns/wiki). Nous aiderons
-vous et répondez à vos questions dans le [Gitter chatroom](https://gitter.im/iluwatar/java-design-patterns).
+notre [wiki développeur](https://github.com/iluwatar/java-design-patterns/wiki).
+Nous vous aiderons répondrons à vos questions dans le [Gitter chatroom](https://gitter.im/iluwatar/java-design-patterns).

 # Licence

-Ce projet est concédé sous les termes de la licence MIT.
+Ce projet est concédé sous les termes de la licence MIT.
--- a/zh/balking/README.md
+++ b/zh/balking/README.md
@@ -0,0 +1,129 @@
+---
+layout: pattern
+title: Balking
+folder: balking
+permalink: /patterns/balking/
+categories: Concurrency
+tags:
+ - Decoupling
+---
+
+## 作用
+
+阻止模式用于防止一个对象在不完整或不适当的状态下执行某段代码。
+
+## 解释
+
+真实世界的案例
+
+> 洗衣机里有一个用于启动衣物洗涤的启动按钮。当洗衣机没有启动时，该按钮可以正常按下生效，但如果洗衣机已经在洗衣服了，再按下按钮就不生效了。
+
+简而言之
+
+> 使用阻止模式，只有当对象处于特定状态时，才会执行某段代码。
+
+维基百科的解释
+
+> 阻止模式是一种软件设计模式，它只在对象处于特定状态时对其执行动作。例如，如果一个对象读取 ZIP 文件，当 ZIP 文件没有打开时，如果一个方法在该对象上调用一个获取方法，该对象就会对阻止这个请求。
+
+**编程示例**
+
+在这个例子的实现中，`WashingMachine` 对象存在 2 种状态： `ENABLED` 和 `WASHING`。如果该对象处于 `ENABLED` 状态，则使用一个线程安全的方法可以其状态改变为 `WASHING`。在另一方面，如果它已经处于 `WASHING` 状态，而任何其他线程执行了 `wash()`，它不会执行该指令，而是什么都不做就返回。
+
+以下是 `WashingMachine` 类的相关代码。
+
+```java
+@Slf4j
+public class WashingMachine {
+
+  private final DelayProvider delayProvider;
+  private WashingMachineState washingMachineState;
+
+  public WashingMachine(DelayProvider delayProvider) {
+    this.delayProvider = delayProvider;
+    this.washingMachineState = WashingMachineState.ENABLED;
+  }
+
+  public WashingMachineState getWashingMachineState() {
+    return washingMachineState;
+  }
+
+  public void wash() {
+    synchronized (this) {
+      var machineState = getWashingMachineState();
+      LOGGER.info("{}: Actual machine state: {}", Thread.currentThread().getName(), machineState);
+      if (this.washingMachineState == WashingMachineState.WASHING) {
+        LOGGER.error("Cannot wash if the machine has been already washing!");
+        return;
+      }
+      this.washingMachineState = WashingMachineState.WASHING;
+    }
+    LOGGER.info("{}: Doing the washing", Thread.currentThread().getName());
+    this.delayProvider.executeAfterDelay(50, TimeUnit.MILLISECONDS, this::endOfWashing);
+  }
+
+  public synchronized void endOfWashing() {
+    washingMachineState = WashingMachineState.ENABLED;
+    LOGGER.info("{}: Washing completed.", Thread.currentThread().getId());
+  }
+}
+```
+
+以下是 `WashingMachine` 使用的简单 `DelayProvider` 接口。
+
+```java
+public interface DelayProvider {
+  void executeAfterDelay(long interval, TimeUnit timeUnit, Runnable task);
+}
+```
+
+现在我们介绍一下使用  `WashingMachine` 的应用。
+
+```java
+  public static void main(String... args) {
+    final var washingMachine = new WashingMachine();
+    var executorService = Executors.newFixedThreadPool(3);
+    for (int i = 0; i < 3; i++) {
+      executorService.execute(washingMachine::wash);
+    }
+    executorService.shutdown();
+    try {
+      executorService.awaitTermination(10, TimeUnit.SECONDS);
+    } catch (InterruptedException ie) {
+      LOGGER.error("ERROR: Waiting on executor service shutdown!");
+      Thread.currentThread().interrupt();
+    }
+  }
+```
+
+以下是程序的控制台输出。
+
+```
+14:02:52.268 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-2: Actual machine state: ENABLED
+14:02:52.272 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-2: Doing the washing
+14:02:52.272 [pool-1-thread-3] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-3: Actual machine state: WASHING
+14:02:52.273 [pool-1-thread-3] ERROR com.iluwatar.balking.WashingMachine - Cannot wash if the machine has been already washing!
+14:02:52.273 [pool-1-thread-1] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-1: Actual machine state: WASHING
+14:02:52.273 [pool-1-thread-1] ERROR com.iluwatar.balking.WashingMachine - Cannot wash if the machine has been already washing!
+14:02:52.324 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - 14: Washing completed.
+```
+
+## 类图
+
+![alt text](../../balking/etc/balking.png "Balking")
+
+## 适用性
+
+在以下情况下可以使用阻止模式：
+
+* 你想要在某个对象上调用一个动作，只有当该对象处于特定状态时才允许该调用。
+* 对象一般只处于容易暂时阻止的状态，只不过该时间是未知的。
+
+## 教学
+
+* [Guarded Suspension Pattern](https://java-design-patterns.com/patterns/guarded-suspension/)
+* [Double Checked Locking Pattern](https://java-design-patterns.com/patterns/double-checked-locking/)
+
+## 鸣谢
+
+* [Patterns in Java: A Catalog of Reusable Design Patterns Illustrated with UML, 2nd Edition, Volume 1](https://www.amazon.com/gp/product/0471227293/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=0471227293&linkId=0e39a59ffaab93fb476036fecb637b99)
Author	SHA1	Message	Date
allcontributors[bot]	575b2c731d	docs: update .all-contributorsrc [skip ci]	2021-04-29 13:25:05 +00:00
allcontributors[bot]	9599411e93	docs: update README.md [skip ci]	2021-04-29 13:25:04 +00:00
Alain	1b14ebcbb1	Improve french translation, fix some typographic issues. (#1730 ) * Improve french translation, fix some typographic issues. * Improve french translation. Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>	2021-04-29 18:54:03 +05:30
余林颖	a471ce25da	translated the balking pattern into Chinese (#1727 ) Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>	2021-04-29 18:51:14 +05:30
allcontributors[bot]	74caa0c4e5	docs: add Al-assad as a contributor (#1733 ) * docs: update README.md [skip ci] * docs: update .all-contributorsrc [skip ci] Co-authored-by: Subhrodip Mohanta <hello@subho.xyz> Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>	2021-04-29 18:49:45 +05:30