添加装饰者模式

Author: betty0805

decorator/.gitignore

@@ -0,0 +1 @@
+/build

decorator/build.gradle

@@ -0,0 +1,33 @@
+apply plugin: 'com.android.application'
+
+android {
+    compileSdkVersion 25
+    buildToolsVersion "25.0.2"
+
+    defaultConfig {
+        applicationId "com.tast.decorator"
+        minSdkVersion 15
+        targetSdkVersion 25
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
+
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    compile fileTree(dir: 'libs', include: ['*.jar'])
+    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
+        exclude group: 'com.android.support', module: 'support-annotations'
+    })
+    compile 'com.android.support:appcompat-v7:25.2.0'
+    testCompile 'junit:junit:4.12'
+    compile project(path: ':toast')
+}

decorator/doc/README.md

@@ -0,0 +1,24 @@
+## 装饰模式 用星巴兹的例子来体现 ##
+介绍：装饰模式指的是在不必改变原类文件和使用继承的情况下，动态地扩展一个对象的功能。它是通过创建一个包装对象，也就是装饰来包裹真实的对象。
+
+特点：—装饰对象和真实对象有相同的接口。这样客户端对象就能以和真实对象相同的方式和装饰对象交互。
+      —装饰对象包含一个真实对象的引用（reference）
+      —装饰对象接受所有来自客户端的请求。它把这些请求转发给真实的对象。
+      —装饰对象可以在转发这些请求以前或以后增加一些附加功能。这样就确保了在运行时，不用修改给定对象的结构就可以在外部增加附加的功能。在
+        面向对象的设计中，通常是通过继承来实现对给定类的功能扩展。
+
+应用场景：1、 需要扩展一个类的功能，或给一个类添加附加职责。
+          2、 需要动态的给一个对象添加功能，这些功能可以再动态的撤销。
+          3、 需要增加由一些基本功能的排列组合而产生的非常大量的功能，从而使继承关系变的不现实。
+          4、 当不能采用生成子类的方法进行扩充时。一种情况是，可能有大量独立的扩展，为支持每一种组合将产生大量的子类，使得子类数目呈爆炸性增长。另一种情
+              况可能是因为类定义被隐藏，或类定义不能用于生成子类。
+
+优缺点：优点：
+        1. Decorator模式与继承关系的目的都是要扩展对象的功能，但是Decorator可以提供比继承更多的灵活性。
+        2. 通过使用不同的具体装饰类以及这些装饰类的排列组合，设计师可以创造出很多不同行为的组合。
+
+        缺点：
+        1. 这种比继承更加灵活机动的特性，也同时意味着更加多的复杂性。
+        2. 装饰模式会导致设计中出现许多小类，如果过度使用，会使程序变得很复杂。
+        3. 装饰模式是针对抽象组件（Component）类型编程。但是，如果你要针对具体组件编程时，就应该重新思考你的应用架构，以及装饰者是否合适。当然也可以改变Component接口，
+           增加新的公开的行为，实现“半透明”的装饰者模式。在实际项目中要做出最佳选择。

decorator/proguard-rules.pro

@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in D:\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}

decorator/src/androidTest/java/com/tast/decorator/ExampleInstrumentedTest.java

@@ -0,0 +1,26 @@
+package com.tast.decorator;
+
+import android.content.Context;
+import android.support.test.InstrumentationRegistry;
+import android.support.test.runner.AndroidJUnit4;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+import static org.junit.Assert.*;
+
+/**
+ * Instrumentation test, which will execute on an Android device.
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+    @Test
+    public void useAppContext() throws Exception {
+        // Context of the app under test.
+        Context appContext = InstrumentationRegistry.getTargetContext();
+
+        assertEquals("com.tast.decorator", appContext.getPackageName());
+    }
+}

decorator/src/main/AndroidManifest.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.tast.decorator">
+
+    <application android:allowBackup="true" android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name" android:supportsRtl="true" android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

decorator/src/main/java/com/tast/decorator/Beverage.java

@@ -0,0 +1,19 @@
+package com.tast.decorator;
+
+/**
+ * 描述：抽象类
+ *
+ * @author wmm
+ * @time 2017/8/22 10:39
+ */
+
+public abstract class Beverage {
+
+    public String description = "Unknown Beverage";
+
+    public String getDescription() {
+        return description;
+    }
+
+    public abstract double cost();
+}

decorator/src/main/java/com/tast/decorator/CondimentDecorator.java

@@ -0,0 +1,12 @@
+package com.tast.decorator;
+
+/**
+ * 描述：装饰者类
+ *
+ * @author wmm
+ * @time 2017/8/22 10:47
+ */
+
+public abstract class CondimentDecorator extends Beverage {
+    public abstract String getDescription();
+}

decorator/src/main/java/com/tast/decorator/MainActivity.java

@@ -0,0 +1,42 @@
+package com.tast.decorator;
+
+import android.support.v7.app.AppCompatActivity;
+import android.os.Bundle;
+
+import com.design_patterns.toast.ToastUtils;
+import com.tast.decorator.coffee.DarkRoast;
+import com.tast.decorator.coffee.Espresso;
+import com.tast.decorator.coffee.HouseBlend;
+import com.tast.decorator.seasoning.Mocha;
+import com.tast.decorator.seasoning.Soy;
+import com.tast.decorator.seasoning.Whip;
+
+/**
+ * 装饰者模式（最好要配合“工厂”和“生成器”
+ * 设计模式时将有更好的方式建立装饰者对象）
+ */
+public class MainActivity extends AppCompatActivity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        ToastUtils.init(this);
+
+        Beverage beverage = new Espresso();
+        ToastUtils.showToasts(beverage.getDescription() + " ¥" + beverage.cost());
+
+        Beverage beverage2 = new DarkRoast();
+        beverage2 = new Mocha(beverage2);//用Mocha装饰它
+        beverage2 = new Mocha(beverage2);//用第二个Mocha装饰它
+        beverage2 = new Whip(beverage2);//用Whip装饰它
+        ToastUtils.showToasts(beverage2.getDescription() + " ¥" + beverage2.cost());
+
+        //最后再来一杯调料为豆浆、摩卡、奶泡的HouseBlend咖啡
+        Beverage beverage3 = new HouseBlend();
+        beverage3 = new Soy(beverage3);
+        beverage3 = new Mocha(beverage3);
+        beverage3 = new Whip(beverage3);
+        ToastUtils.showToasts(beverage3.getDescription() + " ¥" + beverage3.cost());
+    }
+}

decorator/src/main/java/com/tast/decorator/coffee/DarkRoast.java

@@ -0,0 +1,22 @@
+package com.tast.decorator.coffee;
+
+import com.tast.decorator.Beverage;
+
+/**
+ * 描述：一种咖啡类型
+ *
+ * @author wmm
+ * @time 2017/8/22 10:49
+ */
+
+public class DarkRoast extends Beverage {
+
+    public DarkRoast() {
+        description = "Dark Roast Coffee";
+    }
+
+    @Override
+    public double cost() {
+        return 2.89;
+    }
+}

decorator/src/main/java/com/tast/decorator/coffee/Decaf.java

@@ -0,0 +1,22 @@
+package com.tast.decorator.coffee;
+
+import com.tast.decorator.Beverage;
+
+/**
+ * 描述：一种咖啡类型
+ *
+ * @author wmm
+ * @time 2017/8/22 10:49
+ */
+
+public class Decaf extends Beverage {
+
+    public Decaf() {
+        description = "Decaf Coffee";
+    }
+
+    @Override
+    public double cost() {
+        return 1.39;
+    }
+}

decorator/src/main/java/com/tast/decorator/coffee/Espresso.java

@@ -0,0 +1,22 @@
+package com.tast.decorator.coffee;
+
+import com.tast.decorator.Beverage;
+
+/**
+ * 描述：一种咖啡类型
+ *
+ * @author wmm
+ * @time 2017/8/22 10:49
+ */
+
+public class Espresso extends Beverage {
+
+    public  Espresso() {
+        description = "Espresso";
+    }
+
+    @Override
+    public double cost() {
+        return 1.99;
+    }
+}

decorator/src/main/java/com/tast/decorator/coffee/HouseBlend.java

@@ -0,0 +1,22 @@
+package com.tast.decorator.coffee;
+
+import com.tast.decorator.Beverage;
+
+/**
+ * 描述：一种咖啡类型
+ *
+ * @author wmm
+ * @time 2017/8/22 10:49
+ */
+
+public class HouseBlend extends Beverage {
+
+    public HouseBlend() {
+        description = "House Blend Coffee";
+    }
+
+    @Override
+    public double cost() {
+        return 0.89;
+    }
+}

decorator/src/main/java/com/tast/decorator/seasoning/Milk.java

@@ -0,0 +1,37 @@
+package com.tast.decorator.seasoning;
+
+import com.tast.decorator.Beverage;
+import com.tast.decorator.CondimentDecorator;
+
+/**
+ * 描述：一种咖啡调料
+ *
+ * @author wmm
+ * @time 2017/8/22 11:00
+ */
+
+public class Milk extends CondimentDecorator {
+
+    Beverage beverage;
+
+    public Milk(Beverage beverage) {
+        this.beverage = beverage;
+    }
+
+    /**
+     * 不只是描述饮料（例如“DarkRoast”）,
+     * 而是能完整的连调料都描述出来（例如"“DarkRoast，Milk”）
+     */
+    @Override
+    public String getDescription() {
+        return beverage.getDescription() + ", Milk";
+    }
+
+    /**
+     * 计算带Milk饮料的价钱
+     */
+    @Override
+    public double cost() {
+        return 0.56 + beverage.cost();
+    }
+}

decorator/src/main/java/com/tast/decorator/seasoning/Mocha.java

@@ -0,0 +1,37 @@
+package com.tast.decorator.seasoning;
+
+import com.tast.decorator.Beverage;
+import com.tast.decorator.CondimentDecorator;
+
+/**
+ * 描述：一种咖啡调料
+ *
+ * @author wmm
+ * @time 2017/8/22 11:00
+ */
+
+public class Mocha extends CondimentDecorator {
+
+    Beverage beverage;
+
+    public Mocha(Beverage beverage) {
+        this.beverage = beverage;
+    }
+
+    /**
+     * 不只是描述饮料（例如“DarkRoast”）,
+     * 而是能完整的连调料都描述出来（例如"“DarkRoast，Mocha”）
+     */
+    @Override
+    public String getDescription() {
+        return beverage.getDescription() + ", Mocha";
+    }
+
+    /**
+     * 计算带Mocha饮料的价钱
+     */
+    @Override
+    public double cost() {
+        return 0.20 + beverage.cost();
+    }
+}