Signed-off-by: tiny-times <[email protected]>

Author: chelaile

composite/tiny-times/readme.md

@@ -1,58 +1,164 @@
-Android设计模式源码解析之${模式名} 
-====================================
-> 本文为 [Android 设计模式源码解析](https://github.com/simple-android-framework-exchange/android_design_patterns_analysis) 中 ${模式名} 分析  
-> Android系统版本： ${系统版本号，例如 4.2.1}         
-> 分析者：[${分析者}](${分析者 Github 地址})，分析状态：未完成，校对者：[Mr.Simple](https://github.com/bboyfeiyu)，校对状态：未开始   
+本文为 Android设计模式源码中 组合模式 分析  
+Android系统版本： 5.0  
+分析者：Tiny-Times，分析状态：未完成，校对者：无，校对状态：未开始
 
+## 1\. 模式介绍
 
-`复制一份到自己的项目文件夹下，然后根据自己项目替换掉 ${} 内容，删掉本行及上面两行。`   
-
-该任务不仅要用java写出该模式的一个简单示例，还有分析该模式在Android源码中的应用，可以参考[Mr.Simple的单例模式](singleton/mr.simple/readme.md)、[Mr.Simple的观察者模式](observer/mr.simple/readme.md)。
- 
-
-## 1. 模式介绍  
- 
-###  模式的定义
-`模式的一句话定义`
+### 模式的定义
 
+        组合模式(Composite Pattern)又叫作部分-整体模式，它使我们树型结构的问题中，模糊了简单元素和复杂元素的概念，客户程序可以向处理简单元素一样来处理复杂元素,从而使得客户程序与复杂元素的内部结构解耦。 GoF在《设计模式》一书中这样定义组合模式：将对象组合成树形结构以表示“部分-整体”的层次结构。使得用户对单个对象和组合对象的使用具有一致性。
 
 ### 模式的使用场景
- 
- 
-
-## 2. UML类图
-`这里是该设计模式的经典UML图` 
-
-### 角色介绍
-`对UML图中的各个角色进行介绍`
-
-
-
-
-## 3. 模式的简单实现
-###  简单实现的介绍
-`自己实现一个小型模式案例，通过这个案例让读者了解这个模式的一般应用`
-
-### 实现源码
-`上述案例的源码实现`
-
-
-### 总结
-`对上述的简单示例进行总结说明`
-
-  
-
-
-## Android源码中的模式实现
-`分析源码中的模式实现，列出相关源码，以及使用该模式原因等`  
-
-
- 
-
-## 4. 杂谈
-该模式的优缺点以及自己的一些感悟，非所有项目必须。  
-
-
-
-`写完相关内容之后到开发群告知管理员，管理员安排相关人员进行审核，审核通过之后即可。`  
 
+*   表示对象的部分-整体层次结构。
+*   从一个整体中能够独立出部分模块或功能的场景。
+
+## 2\. UML类图
+
+* * *
+
+![组合模式通用类图][1]
+
+### 角色分析
+
+*   Component抽象构件角色 ：定义参加组合对象的共有方法和属性，可以定义一些默认的行为或属性。
+*   Leaf叶子构件 : 叶子对象，其下再也没有其他的分支。
+*   Composite树枝构件 ：树枝对象，它的作用是组合树枝节点和叶子节点形成一个树形结构。
+
+## 3\. 该模式的实现实例
+
+* * *
+
+抽象构件 Component.java：
+
+     public abstract class Component {
+        //个体和整体都具有的共享
+       public void doSomething(){
+        //业务逻辑
+       }
+     }
+    
+
+树枝构件 Composite.java
+
+    public class Composite extends Component {
+       //构件容器
+       private ArrayList<Component> componentArrayList = new ArrayList<Component>();
+       //增加一个叶子构件或树枝构件
+       public void add(Component component){
+          this.componentArrayList.add(component);
+       }
+       //删除一个叶子构件或树枝构件
+       public void remove(Component component){
+          this.componentArrayList.remove(component);
+       }
+       //获得分支下的所有叶子构件和树枝构件
+       public ArrayList<Component> getChildren(){
+         return this.componentArrayList;
+       }
+     }
+    
+
+树叶构件 Leaf.java
+
+    public class Leaf extends Component {
+    
+       //可以覆写父类方法
+       public void doSomething(){    
+       }
+    
+    }
+    
+
+场景类 Client.java
+
+    public class Client {
+        public static void main(String[] args) {
+           //创建一个根节点
+          Composite root = new Composite();
+          root.doSomething();
+          //创建一个树枝构件
+          Composite branch = new Composite();
+          //创建一个叶子节点
+          Leaf leaf = new Leaf();
+          //建立整体
+          root.add(branch);
+          branch.add(leaf);
+       }
+       //通过递归遍历树
+       public static void display(Composite root){
+          for(Component c:root.getChildren()){
+             if(c instanceof Leaf){ //叶子节点
+                 c.doSomething();
+             }else{ //树枝节点
+                 display((Composite)c);
+                }
+            }
+       }
+    }
+    
+
+### 组合模式在Android源码中的应用
+
+* * *
+
+**Adnroid系统中采用组合模式的组合视图类图：**
+
+![enter image description here][2]
+
+**具体实现代码**
+
+View.java
+
+    public class View ....{
+     //此处省略无关代码...
+    }
+    
+
+ViewGroup.java
+
+    public abstract class ViewGroup extends View ...{
+    
+         //增加子节点
+        public void addView(View child, int index) { 
+    
+        }
+        //删除子节点
+        public void removeView(View view) {
+    
+        }
+         //查找子节点
+        public View getChildAt(int index) {
+          try {
+                return mChildren[index];
+              } catch (IndexOutOfBoundsException ex) {
+                return null;
+              } 
+       }
+    }
+    
+
+## 4\. 注意事项
+
+* * *
+
+使用组合模式组织起来的对象具有出色的层次结构，每当对顶层组合对象执行一个操作的时候，实际上是在对整个结构进行深度优先的节点搜索。但是这些优点都是用操作的代价换取的，比如顶级每执行一次 store.show 实际的操作就是整一颗树形结构的节点均遍历执行一次。
+
+## 5\. 杂谈
+
+* * *
+
+**优点**
+
+*   不破坏封装，整体类与局部类之间松耦合，彼此相对独立 。
+*   具有较好的可扩展性。
+*   支持动态组合。在运行时，整体对象可以选择不同类型的局部对象。
+*   整体类可以对局部类进行包装，封装局部类的接口，提供新的接口。
+
+**缺点**
+
+*   整体类不能自动获得和局部类同样的接口。
+*   创建整体类的对象时，需要创建所有局部类的对象 。
+
+ [1]: http://belial.me/wp-content/uploads/2015/03/QQ截图20150318225518.png
+ [2]: http://belial.me/wp-content/uploads/2015/03/QQ截图20150315115212.png