Skip to content

Latest commit

 

History

History
210 lines (162 loc) · 10.1 KB

数据绑定(Data Binding)-Part1.md

File metadata and controls

210 lines (162 loc) · 10.1 KB

#数据绑定(Data Binding)-Part1

2015年的Google I/O大会发布了很多新的Android库和工具,Data Binding就是其中之一。在本系列文章中,我们会探索它的强大之处。

值得注意的是:我写这篇文章的时候,Data Binding库正在测试中,所以很多API可能会在发布的时候有所改动。

Data Binding库提供了一个链接待显示数据与UI组件的机制,将原本非常被动的数据变成某种形式的数据源。在本篇文章中我们使用一个非常简单的Twitter客户端作为例子,将Twitter API与Data Binding一起使用。我不会在这里介绍API以及App设计,我仅仅是使用Twitter4J库抽取了你的Twitter主页上50条按时间排序的信息,并将他们展示在RecyclerView中。所有的代码都是公开发布的,你可以放心地使用它理解它。这里面最有意思的就是其中的数据及它们与View绑定的过程。

我们来看看这篇例子:

public class Status {

    private final String name;
    private final String screenName;
    private final String text;
    private final String imageUrl;

    public Status(@NonNull String name, @NonNull String screenName, @NonNull String text, @NonNull String imageUrl) {
        this.name = name;
        this.screenName = screenName;
        this.text = text;
        this.imageUrl = imageUrl;
    }

    public String getName() {
        return name;
    }

    public String getScreenName() {
        return screenName;
    }

    public String getText() {
        return text;
    }

    public String getImageUrl() {
        return imageUrl;
    }
}

这个类维持了几个需要展示给用户的基本元素,每一个在RecyclerView中的单位都会绑定一个Status对象。它里面的信息可以从twitter4j.Status(由Twitter4j的API获取)中得到,所以我们还要创建一个将twitter4j.Status转化为Status的类:

public class StatusMarshaller {

    public List<Status> marshall(List<twitter4j.Status> statuses) {
        List<Status> newStatuses = new ArrayList<>(statuses.size());
        for (twitter4j.Status status : statuses) {
            newStatuses.add(marshall(status));
        }
        return newStatuses;
    }

    private Status marshall(twitter4j.Status status) {
        User user = status.getUser();
        return new Status(user.getName(), user.getScreenName(), status.getText(), user.getBiggerProfileImageURL());
    }
}

这里没有用到任何技巧,只是一个简单的Java操作,跟Data Binding无关,甚至跟Android也无关。

不过需要指出的是,我们本可以直接将View与twitter4j.Status绑定在一起,这样无疑效率会更高。但是Data Binding库使用了MVVM(Model-View-ViewModel)设计模式 - Model是twitter4j.Status,View是UI组件,ViewModel是我们的Status对象。ViewModel代表着专门为View设计的一个数据结构,它与View的适配性比Model更好。虽然Model与ViewModel很像,在目前你可能还感觉不出他们的区别,但是随着我们一步步深入下去,我相信你会明白这样设计的深意。

接下来我们看一下RecyclerView的Adapter是怎么设计的:

public class StatusAdapter extends RecyclerView.Adapter<StatusViewHolder> {
    private final List<Status> statuses;
    private final StatusMarshaller marshaller;

    public static StatusAdapter newInstance() {
        List<Status> statuses = new ArrayList<>();
        StatusMarshaller marshaller = new StatusMarshaller();
        return new StatusAdapter(statuses, marshaller);
    }

    StatusAdapter(List<Status> statuses, StatusMarshaller marshaller) {
        this.statuses = statuses;
        this.marshaller = marshaller;
    }

    @Override
    public StatusViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        Context context = parent.getContext();
        LayoutInflater inflater = LayoutInflater.from(context);
        View statusContainer = inflater.inflate(R.layout.status_item, parent, false);
        return new StatusViewHolder(statusContainer);
    }

    @Override
    public void onBindViewHolder(StatusViewHolder holder, int position) {
        Status status = statuses.get(position);
        holder.bind(status);
    }

    @Override
    public int getItemCount() {
        return statuses.size();
    }

    public void setStatuses(List<twitter4j.Status> statuses) {
        this.statuses.clear();
        this.statuses.addAll(marshaller.marshall(statuses));
        notifyDataSetChanged();
    }

}

终于看到了跟Android有关的地方了吧,实际上没什么特殊的地方——这只是一个基本的RecyclerView.Adapter而已,跟Data Binding其实关系不大。这里面唯一跟MVVM有关系的就是在setStatuses()中将twitter4j.Status转换成Status。我们马上将会在StatusViewHolder中看到怎么进行数据绑定,首先我们来看看layout是怎么定义的。

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

  <data>
    <import type="android.view.View" />
    <variable
      name="status"
      type="com.stylingandroid.databinding.data.Status" />
  </data>

  <RelativeLayout
    android:id="@+id/status_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ImageView
      android:id="@+id/status_avatar"
      android:layout_width="64dp"
      android:layout_height="64dp"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true"
      android:layout_alignParentTop="true"
      android:layout_margin="8dip"
      android:contentDescription="@null" />

    <TextView
      android:id="@+id/status_name"
      style="@style/Status.Name"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignParentTop="true"
      android:layout_marginTop="8dip"
      android:layout_toEndOf="@id/status_avatar"
      android:layout_toRightOf="@id/status_avatar"
      android:text="@{status.name}" />

    <TextView
      android:id="@+id/status_screen_name"
      style="@style/Status.ScreenName"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignBaseline="@id/status_name"
      android:layout_marginLeft="4dip"
      android:layout_marginStart="4dip"
      android:layout_toEndOf="@id/status_name"
      android:layout_toRightOf="@id/status_name"
      android:text="@{&quot;@&quot; + status.screenName}" />

    <TextView
      android:id="@+id/status_text"
      style="@style/Status.Text"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:layout_alignLeft="@id/status_name"
      android:layout_alignParentEnd="true"
      android:layout_alignParentRight="true"
      android:layout_alignStart="@id/status_name"
      android:layout_below="@id/status_name"
      android:maxLines="2"
      android:singleLine="false"
      android:text="@{status.text}" />

  </RelativeLayout>
</layout>

这部分代码是Data Binding运作的核心。其中id为status_containerRelativeLayout是一个普通的layout控件,但是它的父控件<layout>就不是那么熟悉了。<layout>是Data Binding库的一个组件,它含有一个<data>子组件说明了需要绑定的数据对象(在此处为Status),然后我们就可以在此layout中引用该数据对象。

在此布局中TextView的android:text属性值可能跟你正常见到样子的不大一样-它们其实都使用了Status中的getter。使用@{}包装说明这是一个Data Binding表达式,status.name等同于Java中的status.getName()。这是Data Binding工作的核心,但是这只是冰山一角,它还有更多有趣的功能值得我们探索。

你看id为status_screen_name的TextView,它的text设置为@{&quot;@&quot; + status.screenName}。你可能看到觉得很困惑,实际上&quot;@&quot;就代表着@,用&quot;将它包装起来是为了防止@被xml转义。这个语句告诉我们Data Binding语句是很强大的,我们会进一步挖掘它的强大之处。

在定义完layout之后,需要将它和实际数据对象结合,这也是StatusViewHolder做的事:

public class StatusViewHolder extends RecyclerView.ViewHolder {
    private StatusItemBinding binding;

    public StatusViewHolder(View itemView) {
        super(itemView);
        binding = DataBindingUtil.bind(itemView);
    }

    public void bind(Status status) {
        binding.setStatus(status);
    }

}

它比正常使用的ViewHolder(通常用于维持子View对象)更简单一点,在bind()方法中将对象赋予它绑定的layout。首先要注意到我们使用了StatusItemBinding,可以通过DataBindingUtil.bind()函数获取到它,这个函数及StatusItenBinding类都是Data Binding库生成的。

在下一章中我们会讨论更多的细节,不过此处我们已经有一个基本的应用能够让你对data binding的作用有一定认识:

part-1

本文章中的例子在这里可以看到。