#acl alstamber:read,write,revert,delete,admin All:read

== なにこれ ==
 * android-bindingという便利なフレームワークを使ってMVVCモデルでの開発をしてみようという趣旨
  * C#やったことある人ならXAMLみたいに書けるよ、と言うとわかりやすいか

== 前提 ==
 * android-bindingのjarのある場所にビルドパスが通っていること
  * mavenなどを使えば楽

== Viewの定義 ==
 * AndroidではViewはActivityと等価と考えてしまって良いだろう
 * ViewはXMLで定義することにする
 * 下のXMLを見るとそれぞれのUIコンポーネントにidが振られていないことがわかる
  * この部分がミソ
  * 一般にAndroidではidを振っておいて以下の様なコードでUIコンポーネントのオブジェクトのインスタンスを手に入れて操作することが一般的
   * その結果ViewであるActivityにプレゼンテーションロジックが溢れてActivityに書かれているコード量が多くなってしまう
{{{#!highlight java
mEditText = (EditText)findViewById(R.id.num1);
}}}
{{{#!highlight html
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:binding="http://www.gueei.com/android-binding/"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:orientation="vertical">
    <EditText
            android:contentDescription="height"
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:inputType="number"
            binding:text="num1"/>
    <EditText
            android:contentDescription="weight"
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:inputType="number"
            binding:text="num2"/>
    <EditText
            android:contentDescription="weight"
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:inputType="number"
            binding:text="answer"/>
    <Button
            android:contentDescription="calc"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="right"
            android:text="calc"
            binding:onClick="calculate"/>
</LinearLayout>
}}}

== Activityの定義 ==
 * Activityには次のコードを書くだけで良い
  * 最後の二行がポイント
  * 意訳するとmain.xmlに書かれたActivityのデザイン設計を元にActivityのUIが実際に作られて、そこにMainViewModelというものがひもづけられた
  * ActivityはViewだから見た目のことだけ気にしていればいい
{{{#!highlight java
public class MainActivity extends BindingActivity {
    /**
     * Called when the activity is first created.
     */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        MainViewModel model = new MainViewModel();
        setAndBindRootView(R.layout.main, model);
    }
}
}}}

== ViewModelの定義 ==
 * Activityは見た目の構造の事しか専念しなくなったので、実際にUIを変化させる仕事をする別のものが必要になる
  * ViewModel

 * 最初のStringObservable型の3つのインスタンス変数がさきほどXMLに書いたEditTextに対応している
  * binding:text="num1"と書かれているEditTextが1つ目のインスタンス変数、binding:text="num2"と書かれているEditTextが2つ目のインスタンス変数に対応
  * この操作によってnum1, num2というオブジェクトと、画面上に実際にあるEditTextが結びついた
   * データバインドという
   * android-bindingではオブジェクトを変更するとEditTextにそれが反映され、EditTextを変更するとオブジェクトにもそれが反映される、双方向データバインドになっている

 * Command型のインスタンス変数calculateは勘の良い人なら気づくだろうがbinding:onClick="calculate"と書かれているButtonに対応している。binding:onClickというからには後ろのInvokeメソッドがButtonをクリックすると実行される、という仕組みになっている。
 * Buttonのクリックされた時の仕事はCalcというクラスに定義されているcalcメソッドにEditTextの値を渡すことである。そして帰ってきた結果をanswerにセットしている。
 * ViewModelの仕事はあくまでViewから何か入力をとってきてそれをべつのクラスに投げ、結果をViewに通知することだけである。
  * この入力を取ってくる、あるいはViewへ結果を通知する、という作業のためにデータバインドを使っているわけだ
{{{#!highlight java
public class BmiViewModel {

    public final StringObservable num1 = new StringObservable();

    public final StringObservable num2 = new StringObservable();

    public final StringObservable answer = new StringObservable();

    public final Command calculate = new Command() {
        @Override
        public void Invoke(View arg0, Object... arg1) {
            double result = Calc.calc(Double.parseDouble(num1.get()), Double.parseDouble(num2.get()));
            .set(String.format("%.1f", result));
        }
    };
}
}}}

== Modelの定義 ==
 * ViewModelから入力をもらって、実際に仕事をして結果を返すのがModelの役割である。
{{{#!highlight java
public class Calc
    public static double calc(double num1, double num2){
        return num1 + num2;
    }
}
}}}

== ViewModelからViewに仕事を移譲する ==
 * Androidの場合、Contextがないとできない処理というのが結構ある
  * ContextはView(Activity)が持っているが、ViewModelがContextへの参照をもつのはよろしくない
  * 一般にViewModelはViewより長寿命であり、Contextへの参照を持ち続けることはメモリリークの原因になる
 * この問題を解決するためのMessageパターンというデザインパターンを用いる
  * android-bindingではEventAggregatorというものが使える

 * まずViewでEventAggregatorを生成する
{{{#!highlight java
EventAggregator eventAggregator = EventAggregator.getInstance(this);
}}}

 * ViewModelにEventAggregatorのセッタを用意する
{{{#!highlight java
public void setEventAggregator(EventAggregator ea){
    mEventAggregator = ea;
}
}}}

 * ViewからViewModelにEventAggregatorへの参照を渡す
{{{#!highlight java
model.setEventAggregator(eventAggregator);
}}}

 * Viewのほうにsubscribeを実装する
{{{#!highlight java
eventAggregator.subscribe("hoge", new EventSubscriber(){
    @Override
    public void onEventTriggered(String arg0, Object arg1, Bundle arg2){
				
    }
});
}}}

 * ViewModelのほうにpublishを実装する
{{{#!highlight java
mEventAggregator.publish("hoge", MainActivityModel.this, null);
}}}

 * このように記述するとpublishの第一引数が一致するようなsubscribeに対応するonEventTriggeredメソッドが呼び出される。
  * onEventTriggeredメソッドはViewに実装されているのでここでContextを要するような処理を行えば良い