用Dart&Henson玩转Activity跳转

作者: soaringEveryday | 来源:发表于2016-06-16 21:18 被阅读603次

    Extra是Android标准的组件之间(Activity/Fragment/Service等)传递数据的方式。本文介绍了开源项目Dart的使用,它优雅的处理了组件间跳转和数据传递

    内容提要

    • 传统的方式
    • Dart & Henson
    • 小改进建议

    本文中所演示的例子sample代码位于DartHensonSample

    传统的方式

    会Android的人都会这个的,这里就简单说下,一般流程是

    1. 定好传递数据对应的Key
    2. SecondActivity设置好属性,通过getIntent().getXXXExtra()获得数据
    3. FirstActivity通过intent.putExtra()设置数据,并执行startActivity()

    具体这里就不在贴上代码了,主要讲讲这里会导致的一些问题。

    1. 首先这个Key要保持维护状态,有时候前后两个Activity不是同一个写的,Key的使用交流会出现误解或者指定错误
    2. SecondActivity中有些传入的数据可能是必须的,但是对于这个FirstActivity的作者可并不知道啊

    好在Dart这个开源项目顺利的处理了上述等问题,而且处理的非常优雅。

    Dart & Henson

    Dart的原理和ButterKnife类似,都是通过注解处理器在编译阶段生成一些代码。所以你再写好一些注解后,必须要构建一些项目才能生成一些后面你所需要的代码(后面会详细说明)。

    首先引入android-apt,在项目gradle中加入插件

    buildscript {
      repositories {
        mavenCentral()
       }
      dependencies {
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
      }
    }
    

    再在build.gradle引用

    apply plugin: 'android-apt'
    

    引入Dart & Henson(Henson实际是Dart项目的子项目)

    compile 'com.f2prateek.dart:dart:2.0.0'
    provided 'com.f2prateek.dart:dart-processor:2.0.0'
    compile 'com.f2prateek.dart:henson:2.0.0'
    provided 'com.f2prateek.dart:henson-processor:2.0.0'
    

    这里我们假设要从MainActivity跳转到DetailActivity,DetailActivity中要接受三个参数分别是String name,int ageUser user。这里的user是一个自定义类型,我们知道要想传递数据,必须序列化,文的例子中引入了Parceler项目通过同样一个注解@Parcel自动在编译器声场Parcelable的繁杂的代码:User.java

    DetailActivity需要接受上述三个参数,仅仅通过@InjectExtra注解即可,然后在onCreate中执行Dart.inject(this),详细的代码为:

    public class DetailActivity extends AppCompatActivity {
        @InjectExtra
        String name = "default name";
    
        @InjectExtra
        int age = 0;
    
        @Nullable
        @InjectExtra
        User user;
    
        @BindView(R.id.tvName)
        TextView tvName;
    
        @BindView(R.id.tvAge)
        TextView tvAge;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_detail);
            ButterKnife.bind(this);
            Dart.inject(this);
            initView();
        }
    
        private void initView() {
            // 使用name,age,user
        }
    }
    

    String name = "default name";这句话给了name一个默认值,但是当Dart.inject执行后会被传递过来的数据覆盖。
    @Nullable加在了user上说明这个数据可以不用传递。接受端就这么多代码,下面让我们看看发送端如果发送数据,如何跳转到DetailActivity。

    注意编写上述代码后,我们要先编译下项目,编译好后Henson会通过注解处理器生成可以跳转到DetailActivity的DSL(领域特定语言)段,方便其他组件对DetailActivity的跳转,我们在MainActivity上只要写上下列代码,即可完成界面跳转和数据传递:

    User user = new User();
    user.setAge(Integer.parseInt(age.getText().toString()));
    user.setName(name.getText().toString());
    startActivity(
            Henson.with(this)
                    .gotoDetailActivity()
                    .age(27)
                    .name("jason")
                    .user(user)
                    .build()
    );
    

    当你写完Henson.with(this)后代码提示会自动弹出.gotoDetailActivity(),Henson帮助你提示你DetailActivity是可以被跳转的;随后你继续写下.gotoDetailActivity()后,又自动弹出.age()方法,提示你传入一个int类型给age,写好后,又自动弹出.name()方法,以此类推,最后以一个build()收场。
    注意,这里你可以不写.user(),因为在DetailActivity中我们指定它是nullable的,可以不传。但是.age().name()都是会强制弹出让你填写数据的。

    至此,Henson&Dart的基本介绍结束。

    小改进建议

    Dart还有一个@HensonNavigable注解,它标注在将会被跳转到的Activity的classname上,说明这个activity可以被跳转,会自动生成.gotoXXXActivity()这样的代码,但是它不能在这个类中存在@InjectExtra注解,这里总觉得这个注解有些多余。

    第二,和Dart项目的作者提了issue问了关于参数指定的顺序问题,上述例子中我们传递数据的代码是:

     Henson.with(this)
           .gotoDetailActivity()
           .age(Integer.parseInt(age.getText().toString()))
           .name(name.getText().toString())
           .build()
    

    但是如果我偏向要对调name和age呢?发现不行~如果你写完.gotoDetailActivity()后发现只有.age()的提示,却没有.name()的,即强制要求你先传递age。这里作者说明后才知道他们是按照字幕顺序来排数据传入的,目前没有更好的方法。

    欢迎你开心的使用Dart & Henson!

    相关文章

      网友评论

      • 7cebe854da85:问楼主一个问题啊,就是我在build.gradle中添加了对Dart和Henson的引用,可是在开发中一直找不到Henson这个类,我将例子中的代码运行也遇到同样的问题,导致无法使用Henson.with(context)方法。
        anyanyan:解决了吗?我遇到同样的问题

      本文标题:用Dart&Henson玩转Activity跳转

      本文链接:https://www.haomeiwen.com/subject/fgomdttx.html