Android空数据页面提示控件

前言

通常，当我们的应用页面没有数据可以显示时，我们需要给予用户一些界面提示，以避免空空如也的页面带来较差的用户体验。一般这样的页面都为ListView， ListView 很贴心的提供了

    setEmptyView(View emptyView)；

方法来保证用户体验，但是如果你有2年以上的开发经验，你肯定知道，系统的原生控件是永远都满足不了需求的。 setEmptyView 的Bug之一：一般来说现在的应用ListView都会配备下拉刷新，那么当下拉刷新时，ListView是要被清空的，所以你会发现：空数据提示信息忽隐忽现。再者，当刚进页面，数据还没有加载完成时，空数据提示信息已经显示了，当数据加载完之后空数据提示信息又隐藏，说实话，这样的体验真的很差，你应该没有看到哪个应用的效果是这样的吧？

那么好，今天带来的一个自定义控件，就是为了解决这个需求的，同时，它不止满足于ListView,可以应对所有你想出现的页面。

首先看下效果
`

在看代码之前，要说一个开发的技巧：避免相同一段逻辑重复出现两次以上，当一段逻辑代码出现2次以上，你很难保证将来它不会出现3次，4次 ，10次。

所以去规范你的代码，让你的类、方法单一。既可以调高代码可读性，维护性，又可以实现代码复用，最重要的，你的代码可测试了。

实现的技巧：将你的代码按照数据接收、数据转换、逻辑判断、数据输出等进行区分，放到不同方法里。下面的代码算是一个实现，虽然有很多的重载方法，但是你看不到相同的逻辑代码段，修改时，只需要修改一个方法就好了，不需要去每个地方改。

看下类结构：

然后看代码，先自定义控件的实现。判断一个ListView是否为空，可以通过数据集和Adapter来判断，所以这里写了几个重载方法接收数据集或Adapter。

Message的作用是判断是否什么原因导致无数据的：数据库空、无网络、服务器请求失败。

如果你有不同的需求，只要继承这个类，实现你自己的方法就OK。

/**
 * Created by zhaoxuan.li on 2015/8/28.
 * 无数据时提示的自定义控件
 */
public class NoDataTipsWidget extends RelativeLayout {
    protected static final int TASK_COMPLETED = 1;//网络请求成功
    protected static final int TASK_FAILED = -1;//服务器连接失败
    protected static final int TASK_NONETWORK = -2;//无网络
    private ImageView tipImage;
    private TextView tipText;
    public TipsOnClickListener tipsOnClickListener;

public NoDataTipsWidget(Context context) {
    super(context);
    init(context, null);
}

public NoDataTipsWidget(Context context, AttributeSet attrs) {
    super(context, attrs);
    init(context, attrs);
}

/**
 * 对控件进行初始化，并取得xml文件里给予的资源
 * @param context
 * @param attrs
 */
private void init(Context context, AttributeSet attrs){
    if(attrs ==null)
        return;
    LayoutInflater.from(context).inflate(R.layout.nodata_tipsview, this, true);
    tipImage = (ImageView)findViewById(R.id.tipImage);
    tipText = (TextView)findViewById(R.id.tipText);

    TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.NoDataTipsWidget);
    CharSequence text = a.getText(R.styleable.NoDataTipsWidget_android_text);
    if(text!=null) tipText.setText(text);
    Drawable drawable = a.getDrawable(R.styleable.NoDataTipsWidget_android_src);
    if(drawable != null) tipImage.setImageDrawable(drawable);
    a.recycle();
    //设置图片的点击事件，通常我们在这里设置点击图片刷新
    tipImage.setOnClickListener(new OnClickListener() {
        @Override
        public void onClick(View view) {
            if (tipsOnClickListener != null)
                tipsOnClickListener.OnClick();
        }
    });
}


/**
 * 设置提示图片的监听事件，一个事件接口，需要调用处来实现
 * @param onClickListener
 */
public void setTipsClickListener(TipsOnClickListener onClickListener){
    tipsOnClickListener = onClickListener;
}
/**
 * 设置提示文字
 * @param str
 */
public void setText(String str){
    tipText.setText(str);
}

/**
 * 设置提示图片
 * @param drawable
 */
public void setImage(Drawable drawable){
    tipImage.setImageDrawable(drawable);
}

/**
 * 图片点击事件回调接口
 */
public interface TipsOnClickListener{
    void OnClick();
}


/**
 * 重載方法，當無Adapter可以加入時，使用List判斷
 * @param msg   handler Message
 * @param dto   List 数据集
 */
public void doTipsView(Message msg , List dto){ doTipsView(msg, isEmpty(dto));}
/**
 * 重載方法  仅根据List 数据集判断提示样式
 * @param dto   List 数据集
 */
public void doTipsView(List dto){   doTipsView(null,isEmpty(dto));}
/**
 * 重載方法 仅根据Adapter设置提示样式
 * @param adapter   Adapter
 */
public void doTipsView(Adapter adapter){    doTipsView(null,isEmpty(adapter));}
/**
 * 根据 Message  和 Adapter 设置提示样式
 * @param msg   handler Message
 * @param adapter   Adapter 数据集
 */
public void doTipsView(Message msg , Adapter adapter){
    doTipsView(msg, isEmpty(adapter));
}
/**
 * 重载方法仅用于数据接收，具体的判断逻辑由此方法统一处理
 * @param msg
 * @param noData
 */
private  void doTipsView(Message msg , boolean  noData){
    if(!noData){   //如果数据集不为空，就隐藏
        this.setVisibility(View.GONE);
        return ;
    }else{
        if(msg==null){
            showTip_noData();
            return;
        }
        switch (msg.what){
            case TASK_COMPLETED:  //网络请求成功
                showTip_noData();return;
            case TASK_FAILED:   //网络请求失败
                showTip_noServer();return;
            case TASK_NONETWORK:
                showTip_noConnect();return;
        }
    }
}

private boolean isEmpty(Adapter adapter){
    if(adapter == null)
        return true;
    return adapter.isEmpty();
}
private boolean isEmpty(List list){
    if(list == null)
        return true;
    return list.isEmpty();
}

/**
 * 设置样式为无数据样式
 */
public void showTip_noData(){
    tipImage.setImageResource(R.drawable.nodatatip_nodata);
    tipText.setText("无任何数据");
    this.setVisibility(View.VISIBLE);
}
/**
 * 设置样式为无连接样式
 */
public void showTip_noConnect(){
    tipImage.setImageResource(R.drawable.nodatatip_noserver);
    tipText.setText("无网络连接");
    this.setVisibility(View.VISIBLE);
}
/**
 * 设置样式为无服务器样式
 */
public void showTip_noServer(){
    tipImage.setImageResource(R.drawable.nodatatip_noserver);
    tipText.setText("暂时无法连接服务器，请稍后再试");
    this.setVisibility(View.VISIBLE);
}
}

实际上就是一个继承相对布局的View，只不过这个View可以自己控制自己是否显示。View的布局文件很简单一个ImageView一个TextView，这里就不放了。

注释已经写得很清楚了，这里不在详细解释。

另外需要在你要的布局里引入控件：

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
android:paddingBottom="@dimen/activity_vertical_margin"
android:background="#436EEE"
tools:context=".MainActivity">

<ListView
    android:id="@+id/listview"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

<com.example.zhaoxuanli.nodatatipdemo.widget.NoDataTipsWidget
    android:id="@+id/nodata_tipsview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:visibility="gone"/>

这里有一个限制，就是根布局只能是相对布局或帧布局

Activity中引用。一般情况下，noDataTipsView.doTipsView(msg, list);的调用处实在 数据接收完毕后，或刷新处调用。
目的就是给noDataTipsView最新的数据集让他判断。

public class MainActivity extends AppCompatActivity {
    protected static final int TASK_COMPLETED = 1; //网络请求成功
    protected static final int TASK_FAILED = -1;  //服务器连接失败
    protected static final int TASK_NONETWORK = -2;//无网络

private NoDataTipsWidget noDataTipsView;

/**
 * 因为是一个简单的Demo，空数据提示是肯定要显示的，ListView我们也用不到，就不初始化了
 * @param savedInstanceState
 */
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    noDataTipsView = (NoDataTipsWidget)findViewById(R.id.nodata_tipsview);
    new Timer().schedule(new TimerTask() {

        @Override
        public void run() {
            handler.sendEmptyMessage(-1);// 测试是请求失败的情况
        }
    }, 2000);// 延迟1秒,然后加载
}

Handler handler = new Handler() {
    public void handleMessage(android.os.Message msg) {
        ArrayList list = new ArrayList(); //List是空的，所以应该显示空数据提示
        switch (msg.what){
            case TASK_COMPLETED:  //请求成功后处理
                break;
            case TASK_FAILED:  //请求失败后处理
                break;
            case TASK_NONETWORK:  //无网络情况处理
                break;
        }
        //所有状况处理完毕后，调用noDataTipsView.doTipsView（）方法 adapter 或List都可以
        noDataTipsView.doTipsView(msg, list);

    };
};

}

最后是源代码 ：http://download.csdn.net/detail/u010255127/9198155