add visitor

Author: jarry

docs/uml/design-pattern-source3.eddx

@@ -39,7 +39,6 @@ public static void main(String[] args) {
  * jarry@jarrys-MacBook-Pro java % javac -encoding utf-8 test/Test.java
  * jarry@jarrys-MacBook-Pro java % java test/Test
  * test start:
- * test start:
  * ConcreteSubject::register() [observer = ConcreteObserver]
  * ConcreteSubject::register() [observer = ConcreteObserver2]
  * ConcreteSubject::notify() [content = hello, this is broadcast.]

docs/uml/state-pattern.png

@@ -16,6 +16,7 @@ ConcreteStateA,ConcreteStateB: 具体的实现类，实现了State中定义的
 1. 创建State状态接口，包括全部动作状态。
 2. 分别创建不同的状态类，实现State抽象接口，不同状态类的方法要实现不同类的切换。
 3. 创建Context执行对象，关联到状态接口，允许状态切换。
+4. 客户调用方通过初始化执行对象，设置初始状态，再调用执行对象动作的同时切换状态。
 
 # UML
 <img src="../docs/uml/state-pattern.png">

docs/uml/visitor-pattern.png

@@ -11,7 +11,7 @@ class ConcreteStateOff(State):
     def on(self, context):
         print(self.__class__.__name__ + '::on() [turn ON ok!]')
         # 状态变为on后，状态类切换到ConcreteStateOn
-        context.setState(ConcreteFactory.get('on'))
+        context.set_state(ConcreteFactory.get('on'))
 
     def off(self, context):
         # 当前是off状态，再点击off只是提示，不切换状态类

observer-pattern/java/test/Test.java

@@ -18,5 +18,5 @@ def off(self, context):
         # 状态变为off后，状态类切换到ConcreteStateOff
         print(self.__class__.__name__ +
               "::off() [needn't switch, state is OFF.]")
-        context.setState(ConcreteFactory.get('off'))
+        context.set_state(ConcreteFactory.get('off'))
 

state-pattern/README.md

@@ -13,16 +13,16 @@ def __init__(self, state):
     def __init__(self):
         self.state = None
 
-    def getState(self):
+    def get_state(self):
         return self.state
 
-    def setState(self, state):
-        print(self.__class__.__name__ + '::setState() [state = ' +
+    def set_state(self, state):
+        print(self.__class__.__name__ + '::set_state() [state = ' +
               state.__class__.__name__ + ']')
         self.state = state
 
-    def turnOn(self):
+    def turn_on(self):
         self.state.on(self)
 
-    def turnOff(self):
+    def turn_off(self):
         self.state.off(self)

state-pattern/python/src/ConcreteStateOff.py

@@ -21,16 +21,16 @@ def test():
 
     context = Context()
     # 初始状态是off
-    context.setState(ConcreteStateOff())
+    context.set_state(ConcreteStateOff())
     # turn on
-    context.turnOn()
+    context.turn_on()
     # 再次turn on
-    context.turnOn()
+    context.turn_on()
     # turn off
-    context.turnOff()
+    context.turn_off()
     # 再次turn off
-    context.turnOff()
-    print('context.state: ' + context.getState().__class__.__name__)
+    context.turn_off()
+    print('context.state: ' + context.get_state().__class__.__name__)
 
 
 if __name__ == '__main__':

state-pattern/python/src/ConcreteStateOn.py

@@ -0,0 +1,26 @@
+# 简介
+访问者模式（Visitor Pattern）是一种行为型模式。它封装一个访问者类，把各元素类的操作集合起来，目的是将数据结构与数据操作分离。在不改变原有元素类数据结构的前提下，改变了元素类的执行算法。
+
+当某些较为稳定的东西（数据结构或算法），不想直接被改变但又想扩展功能，这时候适合用访问者模式。访问者模式的使用频率并不是很高，大多数情况下，你并不需要使用访问者模式，但是当你一旦需要使用它时，那你就是需要使用它了。
+
+访问者模式有以下几个角色：
+- 结构对象(ObjectStructure)：结构对象角色，这是访问者模式的基础角色，包含多个类或者接口.
+- 抽象元素(Element)：定义一个接受访问操作accept()，以一个访问者Visitor作为参数。
+- 具体元素(ConcreteElement)：实现抽象节点的accept()方法和处理操作，调用Vistor的访问方法实现具体功能。
+- 抽象访问者(Visitor)：定义一个抽象接口，声明一个或多个访问操作，使得所有具体访问者都必须实现。
+- 具体访问者(ConcreteVisitor)：具体访问者角色，实现Visitor声明的接口。
+
+# 作用
+1. 在数据基础类里面有一个方法接受访问者，将自身引用传入访问者，从而把不变的固定起来，把变化的开放出去。
+2. 通过隔离类中变化的东西，固定不变的东西，符合单一职责原则，同时具备较好的扩展性和灵活性。
+
+# 实现步骤
+1. 先创建基本元素抽象类Element，确定accept()抽象方法。
+2. 分别创建几个具体的元素类，实现抽象元素的accept方法。
+3. 在创建Visitor抽象接口，定义visit方法，调用具体元素。
+4. 创建1个或多个Visitor类，继承抽象接口，客户将以此去访问具体元素。
+5. 再创建对象结构类，这是核心入口类，负责组合各种元素，以及传递访问者Visitor。
+6. 客户调用时先创建对象结构类，再指定访问者类，通过访问这类调用具体元素类
+
+# UML
+<img src="../docs/uml/visitor-pattern.png">