diff --git a/localization/zh/servant/README.md b/localization/zh/servant/README.md new file mode 100644 index 000000000..4889a924a --- /dev/null +++ b/localization/zh/servant/README.md @@ -0,0 +1,230 @@ +--- +title: Servant +category: Behavioral +language: zh +tag: +- Decoupling +--- + +## 含义 +仆人类被用于向一组类提供一些行为,区别于在每个类定义行为-或者当我们无法排除 +公共父类中的这种行为,这些行为在仆人类被定义一次 + +## 解释 + +现实例子 + +> 国王、王后和其他宫廷皇室成员需要仆人为他们提供饮食、准备饮料等服务 + +简单地说 + +> 确保一个仆人对象为一组被服务的对象提供一些特定的服务 + +维基百科 + +> 在软件工程中,仆人模式定义了一个对象,用于向一组类提供某些功能,而无需在每个类中定义该功能。 仆人是一个类,其实例(甚至只是类)提供了处理所需服务的方法,而仆人为其(或与谁)做某事的对象被视为参数。 + +**编程示例** + +那些能够为其他宫廷皇室成员提供服务的仆人类 + +```java +/** + * Servant. + */ +public class Servant { + + public String name; + + /** + * Constructor. + */ + public Servant(String name) { + this.name = name; + } + + public void feed(Royalty r) { + r.getFed(); + } + + public void giveWine(Royalty r) { + r.getDrink(); + } + + public void giveCompliments(Royalty r) { + r.receiveCompliments(); + } + + /** + * Check if we will be hanged. + */ + public boolean checkIfYouWillBeHanged(List tableGuests) { + return tableGuests.stream().allMatch(Royalty::getMood); + } +} +``` + +皇家是一个接口,它被国王和女王类实现,以获取仆人的服务 + +```java +interface Royalty { + + void getFed(); + + void getDrink(); + + void changeMood(); + + void receiveCompliments(); + + boolean getMood(); +} +``` +国王类正在实现皇家接口 +```java +public class King implements Royalty { + + private boolean isDrunk; + private boolean isHungry = true; + private boolean isHappy; + private boolean complimentReceived; + + @Override + public void getFed() { + isHungry = false; + } + + @Override + public void getDrink() { + isDrunk = true; + } + + public void receiveCompliments() { + complimentReceived = true; + } + + @Override + public void changeMood() { + if (!isHungry && isDrunk) { + isHappy = true; + } + if (complimentReceived) { + isHappy = false; + } + } + + @Override + public boolean getMood() { + return isHappy; + } +} +``` +女王类正在实现皇家接口 +```java +public class Queen implements Royalty { + + private boolean isDrunk = true; + private boolean isHungry; + private boolean isHappy; + private boolean isFlirty = true; + private boolean complimentReceived; + + @Override + public void getFed() { + isHungry = false; + } + + @Override + public void getDrink() { + isDrunk = true; + } + + public void receiveCompliments() { + complimentReceived = true; + } + + @Override + public void changeMood() { + if (complimentReceived && isFlirty && isDrunk && !isHungry) { + isHappy = true; + } + } + + @Override + public boolean getMood() { + return isHappy; + } + + public void setFlirtiness(boolean f) { + this.isFlirty = f; + } + +} +``` + +然后,为了使用: + +```java +public class App { + + private static final Servant jenkins = new Servant("Jenkins"); + private static final Servant travis = new Servant("Travis"); + + /** + * Program entry point. + */ + public static void main(String[] args) { + scenario(jenkins, 1); + scenario(travis, 0); + } + + /** + * Can add a List with enum Actions for variable scenarios. + */ + public static void scenario(Servant servant, int compliment) { + var k = new King(); + var q = new Queen(); + + var guests = List.of(k, q); + + // feed + servant.feed(k); + servant.feed(q); + // serve drinks + servant.giveWine(k); + servant.giveWine(q); + // compliment + servant.giveCompliments(guests.get(compliment)); + + // outcome of the night + guests.forEach(Royalty::changeMood); + + // check your luck + if (servant.checkIfYouWillBeHanged(guests)) { + LOGGER.info("{} will live another day", servant.name); + } else { + LOGGER.info("Poor {}. His days are numbered", servant.name); + } + } +} +``` + +程序输出 + +``` +Jenkins will live another day +Poor Travis. His days are numbered +``` + + +## 类图 +![alt text](./etc/servant-pattern.png "Servant") + +## 适用场景 +在什么时候使用仆人模式 + +* 当我们希望某些对象执行一个公共操作并且不想将该操作定义为每个类中的方法时 + +## 鸣谢 + +* [Let's Modify the Objects-First Approach into Design-Patterns-First](http://edu.pecinovsky.cz/papers/2006_ITiCSE_Design_Patterns_First.pdf) diff --git a/localization/zh/servant/etc/servant-pattern.png b/localization/zh/servant/etc/servant-pattern.png new file mode 100644 index 000000000..a8237775e Binary files /dev/null and b/localization/zh/servant/etc/servant-pattern.png differ