android使用DataBinding来设置空状态

写在前面

在成都网站设计、做网站过程中，需要针对客户的行业特点、产品特性、目标受众和市场情况进行定位分析，以确定网站的风格、色彩、版式、交互等方面的设计方向。创新互联还需要根据客户的需求进行功能模块的开发和设计，包括内容管理、前台展示、用户权限管理、数据统计和安全保护等功能。

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

空数据
网络异常
加载中等等情况

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

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

android使用DataBinding来设置空状态

首先

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

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

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

/**
 * 页面描述：空状态
 * 
 * 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用于显示我们需要的状态信息

/**
 * 页面描述：异常
 * 
 * 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;
  }
}

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

加载中的进度条
错误信息
空状态
...

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

布局

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

<?xml version="1.0" encoding="utf-8"?>

布局文件中有几个方法

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

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

/**
 * 页面描述：状态页面设置模型
 * 
 * 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);
    }
  }

}

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

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

下面讲讲实际运用：

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

<?xml version="1.0" encoding="utf-8"?>

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

loadData().subscribe(new Subscriber>() {

  @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 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来设置空状态
网页网址：http://cqcxhl.cn/article/jcddjs.html

重庆分公司，新征程启航

android使用DataBinding来设置空状态

其他资讯