启动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
