android使用DataBinding来设置空状态

写在前面

在平时的开发之中，我们需要对于数据加载的情况进行展示：

1. 空数据
2. 网络异常
3. 加载中等等情况

现在设置页面状态的方式有多种，由于笔者近期一直在使用databinding，而数据绑定通过改变模型来展示view的方式和状态页的设置也满契合的。

所以这里就讲讲使用databinding来设置android中的各种状态页。很简单，先看看效果

首先

在app的build.gradle文件中开启databinding

android{
  ...
  dataBinding {
    enabled = true
  }
}

我们先定义一些用于状态的注解EmptyState

/**
 * 页面描述：空状态
 * <p>
 * Created by ditclear on 2017/2/24.
 */
@IntDef({NORMAL, PROGRESS, EMPTY, NET_ERROR, NOT_AVAILABLE})
@Retention(RetentionPolicy.SOURCE)
public @interface EmptyState {

  int NORMAL = -1; //正常
  int PROGRESS = -2;//显示进度条

  int EMPTY = 11111; //列表数据为空
  int NET_ERROR = 22222; //网络未连接
  int NOT_AVAILABLE = 33333; //服务器不可用

  //...各种页面的空状态，可以自己定义、添加

}

再自定义一个异常EmptyException用于显示我们需要的状态信息

/**
 * 页面描述：异常
 * <p>
 * Created by ditclear on 2017/3/5.
 */
public class EmptyException extends Exception {

  private int code;

  public EmptyException(@EmptyState int code) {
    super();
    this.code = code;
  }


  @EmptyState
  public int getCode() {
    return code;
  }

  public void setCode(@EmptyState int code) {
    this.code = code;
  }
}

现在，大多数展示状态页的控件都会提供

1. 加载中的进度条
2. 错误信息
3. 空状态
4. ...

所以我们的目标也是显示这些

布局

以数据绑定的形式进行布局，使用StateModel来控制状态页展示的消息

<?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="stateModel"
      type="com.ditclear.app.state.StateModel"/>
  </data>

  <RelativeLayout
    android:id="@+id/rv_empty_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@color/background"
    android:clickable="true"
    android:focusableInTouchMode="true"
    android:visibility="@{stateModel.empty?View.VISIBLE:View.GONE}">

    <android.support.v4.widget.ContentLoadingProgressBar
      style="?android:attr/progressBarStyle"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerInParent="true"
      android:visibility="@{stateModel.progress?View.VISIBLE:View.GONE}"/>

    <LinearLayout
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:layout_alignParentBottom="true"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true"
      android:gravity="center"
      android:orientation="vertical"
      android:visibility="@{stateModel.progress?View.INVISIBLE:View.VISIBLE}">

      <ImageView
        android:id="@+id/none_data"
        android:layout_width="345dp"
        android:layout_height="180dp"
        android:scaleType="fitCenter"
        android:src="@{stateModel.emptyIconRes}"/>


      <TextView
        android:layout_width="wrap_content"
        android:layout_height="25dp"
        android:layout_below="@+id/none_data"
        android:layout_centerHorizontal="true"
        android:text="@{stateModel.currentStateLabel}"
        android:textSize="16sp"/>


    </LinearLayout>
  </RelativeLayout>
</layout>

布局文件中有几个方法

1. empty 用于控制状态页是显示还是隐藏，数据加载正常（即状态为NORMAL）的时候隐藏，否则展示
2. isProgress 是否显示加载中，如果显示进度条（即状态为PROGRESS），就隐藏异常页
3. emptyIconRes 显示状态的图片信息
4. currentStateLabel 显示状态的文字消息

我们定义状态的ViewModel ，就叫StateModel，来控制状态

/**
 * 页面描述：状态页面设置模型
 * <p>
 * Created by ditclear on 2017/2/24.
 */

public class StateModel extends BaseObservable {

  private Context mContext = MyApp.instance();

  @EmptyState
  private int emptyState = EmptyState.NORMAL;

  private boolean empty;

  public int getEmptyState() {
    return emptyState;
  }

  /**
   * 设置状态
   *
   * @param emptyState
   */
  public void setEmptyState(@EmptyState int emptyState) {
    this.emptyState = emptyState;
    notifyChange();
  }

  /**
   * 显示进度条
   *
   * @return
   */
  public boolean isProgress() {
    return this.emptyState == EmptyState.PROGRESS;
  }

  /**
   * 根据异常显示状态
   *
   * @param e
   */
  public void bindThrowable(Throwable e) {
    if (e instanceof EmptyException) {
      @EmptyState
      int code = ((EmptyException) e).getCode();

      setEmptyState(code);
    }
  }

  public boolean isEmpty() {
    return this.emptyState != EmptyState.NORMAL;
  }

  /**
   * 空状态信息
   *
   * @return
   */
  @Bindable
  public String getCurrentStateLabel() {

    switch (emptyState) {
      case EmptyState.EMPTY:
        return mContext.getString(R.string.no_data);
      case EmptyState.NET_ERROR:
        return mContext.getString(R.string.please_check_net_state);
      case EmptyState.NOT_AVAILABLE:
        return mContext.getString(R.string.server_not_avaliabe);
      default:
        return mContext.getString(R.string.no_data);
    }
  }

  /**
   * 空状态图片
   *
   * @return
   */
  @Bindable
  public Drawable getEmptyIconRes() {
    switch (emptyState) {
      case EmptyState.EMPTY:
        return ContextCompat.getDrawable(mContext, R.drawable.ic_visibility_off_green_400_48dp);
      case EmptyState.NET_ERROR:
        return ContextCompat.getDrawable(mContext, R.drawable.ic_signal_wifi_off_green_400_48dp);
      case EmptyState.NOT_AVAILABLE:
        return ContextCompat.getDrawable(mContext, R.drawable.ic_cloud_off_green_400_48dp);
      default:
        return ContextCompat.getDrawable(mContext, R.drawable.ic_visibility_off_green_400_48dp);
    }
  }

}

很普通的视图模型，主要有几个用于判断状态显示的方法

1. bindThrowable 根据异常显示状态
2. setEmptyState 方法用来设置当前的状态，通过notifyChange来通知布局文件改变

下面讲讲实际运用：

在activity或者fragment布局中，添加状态页的布局

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

  <data>

    <import type="android.view.View"/>

    <variable
      name="stateModel"
      type="com.ditclear.app.state.StateModel"/>

  </data>

  <com.ditclear.app.ScrollChildSwipeRefreshLayout
    android:id="@+id/refresh_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <RelativeLayout
      android:id="@+id/container"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:orientation="vertical">


      <android.support.v4.widget.NestedScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:fillViewport="false"
        android:overScrollMode="always"
        android:visibility="@{stateModel.empty?View.GONE:View.VISIBLE}">

        <TextView
          android:id="@+id/content_tv"
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          android:gravity="center"/>


      </android.support.v4.widget.NestedScrollView>


      <include
        layout="@layout/widget_layout_empty"
        app:stateModel="@{stateModel}"/>

    </RelativeLayout>
  </com.ditclear.app.ScrollChildSwipeRefreshLayout>
</layout>

最后在activity或者fragment中我们只需要通过state.bindThrowable()和state.setEmptyState()方法便可以轻松设置各种各样的状态。

loadData().subscribe(new Subscriber<List<Contributor>>() {

  @Override
  public void onStart() {
    super.onStart();
    if (!mMainBinding.refreshLayout.isRefreshing()) {
      mStateModel.setEmptyState(EmptyState.PROGRESS);
    }
  }

  @Override
  public void onCompleted() {
    mStateModel.setEmptyState(EmptyState.NORMAL);

  }

  @Override
  public void onError(Throwable e) {
    mMainBinding.refreshLayout.setRefreshing(false);
    mStateModel.bindThrowable(e);
    Toast.makeText(MainActivity.this, mStateModel.getCurrentStateLabel(), Toast.LENGTH_SHORT).show();


  }

  @Override
  public void onNext(List<Contributor> contributors) {
    mMainBinding.refreshLayout.setRefreshing(false);
    if (contributors == null || contributors.isEmpty()) {
      onError(new EmptyException(EmptyState.EMPTY));
    } else {
      mMainBinding.contentTv.setText(contributors.toString());
    }
  }
});

写在最后

对于要使用数据来控制视图状态的，使用databinding实在是一个事半功倍的方式。而且也十分容易理解。

最后demo地址：StateBinding_jb51.rar

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# android  # databinding  # databinding设置空状态  # Android DataBinding的官方双向绑定示例  # DataBinding onClick的七种点击方式  # 在Android中如何使用DataBinding详解(Kotlin)  # Android DataBinding手把手入门教程  # Android开发Jetpack组件DataBinding用例详解  # Winform项目中TextBox控件DataBindings属性  # 一文教你如何使用Databinding写一个关注功能  # 进度条  # 加载中  # 绑定  # 是一个  # 加载  # 几个  # 中有  # 很简单  # 便可  # 有几个  # 自定义  # 只需要  # 事半功倍  # 就叫  # 写在  # 错误信息  # 要使  # 有多种  # 大家多多  # 不可用 

相关文章： 建站之星安装需要哪些步骤及注意事项？  如何选择可靠的免备案建站服务器？  小说建站VPS选用指南：性能对比、配置优化与建站方案解析  深入理解Android中的xmlns:tools属性  建站之星后台密码遗忘？如何快速找回？  建站之星如何助力网站排名飙升？揭秘高效技巧  详解jQuery停止动画——stop()方法的使用  c# F# 的 MailboxProcessor 和 C# 的 Actor 模型  香港服务器WordPress建站指南：SEO优化与高效部署策略  长沙企业网站制作哪家好,长沙水业集团官方网站？  如何在西部数码注册域名并快速搭建网站？  网站制作知乎推荐,想做自己的网站用什么工具比较好？  导航网站建站方案与优化指南：一站式高效搭建技巧解析  python的本地网站制作,如何创建本地站点？  北京网站制作费用多少,建立一个公司网站的费用.有哪些部分,分别要多少钱？  大连网站制作公司哪家好一点,大连买房网站哪个好？  英语简历制作免费网站推荐,如何将简历翻译成英文？  如何选择域名并搭建高效网站？  公司门户网站制作流程,华为官网怎么做？  如何在建站主机中优化服务器配置？  如何有效防御Web建站篡改攻击？  新网站制作渠道有哪些,跪求一个无线渠道比较强的小说网站，我要发表小说？  如何在阿里云香港服务器快速搭建网站？  c++ stringstream用法详解_c++字符串与数字转换利器  如何在Golang中指定模块版本_使用go.mod控制版本号  电脑免费海报制作网站推荐,招聘海报哪个网站多？  如何访问已购建站主机并解决登录问题？  湖南网站制作公司,湖南上善若水科技有限公司做什么的？  制作证书网站有哪些,全国城建培训中心证书查询官网？  香港代理服务器配置指南：高匿IP选择、跨境加速与SEO优化技巧  javascript基本数据类型及类型检测常用方法小结  如何在景安服务器上快速搭建个人网站？  如何制作算命网站,怎么注册算命网站？  建站主机选择指南：服务器配置与SEO优化实战技巧  长春网站建设制作公司,长春的网络公司怎么样主要是能做网站的？  利用JavaScript实现拖拽改变元素大小  建站主机如何安装配置？新手必看操作指南  昆明网站制作哪家好,昆明公租房申请网上登录入口？  香港服务器建站指南：免备案优势与SEO优化技巧全解析  北京营销型网站制作公司,可以用python做一个营销推广网站吗？  焦点电影公司作品,电影焦点结局是什么？  如何在IIS管理器中快速创建并配置网站？  如何选择适配移动端的WAP自助建站平台？  如何确认建站备案号应放置的具体位置？  建站之星后台密码遗忘或太弱？如何重置与强化？  定制建站是什么？如何实现个性化需求？  微网站制作教程,我微信里的网站怎么才能复制到浏览器里？  大连网站制作费用,大连新青年网站，五年四班里的视频怎样下载啊？  Swift中switch语句区间和元组模式匹配  免费网站制作模板下载,除了易企秀之外还有什么H5平台可以制作H5长页面，最好是免费的？