Android之Blade的使用

启动Activity并传递参数

Extra

正常情况下启动Activity并且传递参数的代码:

Intent intent = new Intent(context,LoginActivity.class);
intent.putExtra("phone","123456);
intent.putExtra("pwd","123456);
startActivity(intent);

使用Blade启动Activity的方式

public class LoginActivity extends AppcompatActivity{
    @Extra
    String mText;
    @Extra
    MyData mData;
}

通过上面的代码就会自动生成一个如下两个方法

Intent forX(Context c, T1 extra1[, T2 extra2, ...])

void startX(Context c, T1 extra1[, T2 extra2, ...])

然后我们就可以直接通过I.startLoginActivity来启动Activity。

创建Fragment实例

@Arg

用来为Fragment生成newInstance方法

通常我们创建Fragment对象都是些如下的样板代码

public class MyFragment extends Fragment{

  public MyFragment newInstance(String data){
    MyFragment fragment = new MyFragment();
    Bundle bundle = new Bundle();
    bundle.putExtra("data",data);
    fragment.setArguments(bundle);
    return fragment;
  }
  ...
}

使用Blade的方式

public class MyFragment extends Fragment {

    @Arg
    String mText;
    @Arg
    MyData mData;

}

自定义序列化

public class MyFragment extends Fragment {

    @Arg(MyTypeBundler.class)
    MyType mMyType;
}

public class MyTypeBundler implements Bundler<MyType> {

    void save(@Nullable final MyType value, @NonNull final Bundle state) {
        // save given value to the state
    }
    
    @Nullable
    MyType restore(@NonNull final Bundle state) {
        // restore and return value from state
    }
}

@Parcel

当我们创建一个实体类需要实现Parcelable的时候，可以按如下的方法写

@blade.Parcel
public class MyClass implements Parcelable {

     String text;
     int number;
     boolean flag;
     double[] doubleArray;

     protected MyClass(Parcel in) {
     }

     @Override
     public int describeContents() {
         return 0;
     }

     @Override
     public void writeToParcel(Parcel dest, int flags) {
     }
}

如果某个字段想忽略，不需要被序列化的话，使用@blade.ParcelIgnore

Mvp

Mvp是和Dager配合使用的。
第一步：在你的build.gradle中添加dager依赖

compile 'com.google.dagger:dagger:2.x'
apt 'com.google.dagger:dagger-compiler:2.x'

第二步：创建一个继承自IView的接口

public interface IMyView extends blade.mvp.IView {
    void show(String something);
}

第三步：创建Prensenter和View接口相互影响

public class MyPresenter extends blade.mvp.BasePresenter<IMyView> {

    public void onUserDidSomething() {
        String s = // do something ...

        if (getView() != null) {
            getView().show(s);
        }
    }

    //...
}

第四步：创建View的实现，使用@Inject注入Presenter，现在支持Fragmnt，Activit，View

public class MyView extends android.support.v4.app.Fragment implements IMyView {

    @Inject
    MyPresenter mPresenter;

    @Override
    public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);

        yourDaggerComponent.inject(this);
    }

    @Override
    void show(String something) { /* ... */ }

    // ...
}

第五步：Activity中包含存在Presenter的Fragment，View，那么该Activity需要使用@Blade注解一遍让Blade知道。

State

简化状态管理，@State注解会生成一个帮助类，里面包含两个静态的方法：

public class StateArgFragment extends Fragment {

    @Arg
    @State
    int num;
}

@Weave(
      into = "0_onSaveInstanceState",
      args = {"android.os.Bundle"},
      statement = "eu.f3rog.blade.sample.state.StateArgFragment_Helper.saveState(this, $1);"
  )
  public static void saveState(StateArgFragment target, Bundle state) {
    if (state == null) {
      throw new IllegalArgumentException("State cannot be null!");
    }
    BundleWrapper bundleWrapper = BundleWrapper.from(state);
    bundleWrapper.put("<Stateful-num>", target.num);
  }

  @Weave(
      into = "1^onCreate",
      args = {"android.os.Bundle"},
      statement = "eu.f3rog.blade.sample.state.StateArgFragment_Helper.restoreState(this, $1);"
  )
  public static void restoreState(StateArgFragment target, Bundle state) {
    if (state == null) {
      return;
    }
    BundleWrapper bundleWrapper = BundleWrapper.from(state);
    target.num = bundleWrapper.get("<Stateful-num>", target.num);
  }

继承自Fragment、Activity或View的类都会自动管理状态。自定义序列化的功能如上所示。

Blade可以让我们少写很多的样板代码，具体的我还没有应用到项目中，之后会在项目中进行使用，用来使项目看起来更加清晰。
Blade地址：https://github.com/FrantisekGazo/Blade