Skip to content

xiastars/CoffeeKotlin-Learn

BranchesTags

Repository files navigation

Author:xiastars Time:2019-4-28

image image

简介

SummerHelper封装了最常用的开发框架，比如可刷新的RecycleView及Adapter，网络请求及数据缓存等

1.了解MaterialRefreshLayout

一般的RecycleView:com.summer.helper.view.NRecycleView

xml:

 <com.summer.helper.view.NRecycleView
        android:id="@+id/nv_container"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

java:

 mRecycleView.setList();//设置为ListView样式
 mRecycleView.setListInScrollView();//设置为ListView样式，当此RecycleView嵌套在ScrollView内
 mRecycleView.setGridView(int num);设置为GridView样式，传入展现列数
 mRecycleView.setHorizontalList();设置为横向滚动的ListView样式

可以刷新，上拉加载的RecycleView:com.summer.helper.view.SRecycleView

SRecycleView包含NRecycleView的一切用法，除此之外有以下用法

    mRecycleView.setLoadMore();//支持上拉加载
    mRecycleView.setOverLay();//加载样式悬浮在View上，如果不设置，则View整体跟着下拉
	//添加刷新Listener
    mRecycleView.setMaterialRefreshListener(new MaterialRefreshListener() {
                @Override
                public void onRefresh(final MaterialRefreshLayout materialRefreshLayout) {
                    loadData();
                }
    
                @Override
                public void onfinish() {
                }
    
                @Override
                }
            });
    mRecycleView.finishRefresh();//完成刷新 
    mRecycleView.finishRefreshLoadMore();//完成上拉加载

可以刷新，上拉加载的ScrollVIew:com.summer.helper.recycle.ScollViewRefreshLayout：用法与SRecycleView一致

注:父类MaterialRefreshLayout里封装了空页面的展示,当调用到finishRefresh时,会调用到showEmptyView方法,该方法通过判断RecycleView的ItemCount个数来决定是否展现空页面

2. 缓存处理

本缓存处理没有采取第三方框架，包含两种方式，一种为原始数据一个个插入的方式，另外一种为存储序列化后的对象

该框架下数据缓存已封闭在数据请求里，开发人员不必手动写缓存(后面再讲)，这里只使用第二种处理方式

核心类：com.summer.helper.db.CommonService

获取CommonService对象:CommonService mService = new CommonService(Context context)
插入一个单个对象或List<?>:mService.insert(int type,Object data);//该对象及所属类必须实现Serializable,type类型必需,区分数据
根据ID插入:mService.insert(int type,String key,Object data);有时同类数据也要区别,或者需要一个个对象插入,则插入KEY

获取单个对象:mService.getObjectData(int type)
获取List<?>:mService.getListData(int type)
删除数据:mService.commonDeleteData(int type)

3.数据请求与数据下载

核心类:com.summer.helper.server.EasyHttp

数据请求示例-GET:

 SummerParameter params = Const.getBasicParameters();//传入固定的一些参数
 params.put("id",122);//传入后台需要的参数
 params.putLog("我的圈子");//最好传这个进去,打印的时候方便看 
 //Context传入,用来做网络判断,当无网络时,直接Toast提示
 //第二个参数是请求链接 
 //第三个参数是要被注入的类
 EasyHttp.get(context, Server.HOME_HUNK, GroupResp.class, params, new  RequestCallback<GroupResp>() {
            @Override
            public void done(GroupResp hunkResp) {
                //请求错误返回NULL,这里需要判断
                if (hunkResp != null) {

                }
            }
        });

数据请求示例-POST:

  EasyHttp.post(context, url, className, params, new RequestCallback<Object>() {
                @Override
                public void done(Object hunkResp) {

                }
            });

数据请求的链接与数据都在Logs里打印了,TAG为默认的,见Logs章

数据下载示例:

//第二个参数:下载链接 
 //第三个参数:保存文件的位置
 //第三个参数:保存文件的名称
 EasyHttp.download(getContext(), downloadUrl, path, fileName, new DownloadTaskListener() {
           @Override
           public void onDownloading(DownloadTask downloadTask) {
   		   //返回下载数据的百分比,用于ProgressBar显示
               float progress = downloadTask.getPercent();
   			//下载完毕
               if(downloadTask.getDownloadStatus() == DownloadStatus.DOWNLOAD_STATUS_COMPLETED){

            }
           }

           @Override
           public void onPause(DownloadTask downloadTask) {

           }

           @Override
           public void onError(DownloadTask downloadTask, int errorCode) {

           }
       });

4. 综合使用,创建一个支持刷新与上拉加载的列表页面

//创建一个Activity继承自BaseActivity

public class SubjectActivity extends BaseActivity {

    SubjectAdapter subjectAdapter;
    SRecycleView svContainer;

    @Override
    protected int setTitleId() {//设置标题
        return R.string.subject;
    }

    @Override
    protected int setContentView() {//设置主内容界面
        return R.layout.view_srecyleview;
    }

    @Override
    protected void initData() {//初始化数据
        svContainer = (SRecycleView) findViewById(R.id.sv_container);
        setSRecyleView(svContainer);//将此SRecycleView传给BaseActivity
        subjectAdapter = new SubjectAdapter(context);//设置Adapter
        svContainer.setAdapter(subjectAdapter);
        loadData();
    }

    @Override
    protected void dealDatas(Object obj) {//处理数据
       handleViewData(obj);
    }

   //支持下一页加载的页面必须继承此方法,在这里做数据请求
    @Override
    public void loadData() {
        final SummerParameter params = Const.getPostParameters();
        params.put("page", pageIndex);
        params.put("count", 10);
        requestData(SubjectInfo.class, params, Server.SUBJECT_LIST, true);
    }
}

BaseActivity里主要写了SRecycleView的刷新Listener和刷新完后的处理,它的父类BaseRequestActivity才是关键

解析BaseRequestActivity

此类与相关类做了以下工作:

A.添加了默认的头部栏,如果需要自定义,在这里设置

B.当第一次请求数据时,显示加载条;

注:了解LoadingDialog

C.当网络断开时,显示网络连接异常界面

D.请求数据,包括缓存

 //由BaseHelper调用此方法
 public void requestData(final Class className, SummerParameter params, final String url, boolean post) {
        if(params != null){

            //获取加载数据的数量，用来做底部View展现
            if(params.containsKey("count")){
                String count = (String) params.get("count");
                if(count != null){
                    loadCount = Integer.parseInt( count);
                }
            }
        }
        long time = System.currentTimeMillis();
		//缓存处理
        final String saveurl = params.encodeUrl(url);
        if (!firstRequest) {
            firstRequest = true;
            Object hunkResp = new CommonService(context).getObjectData(DBType.COMMON_DATAS, saveurl);
            if (hunkResp != null) {
                myHandlder.obtainMessage(2, hunkResp).sendToTarget();
                cancelLoading();
            }
            Logs.i("xia", "处理缓存数据时间:" + (System.currentTimeMillis() - time));
        }
		//只有在第一次加载时才显示，刷新时不显示
        if (!isRefresh && loadingDialog == null) {
            loadingDialog = LoadingDialog.getInstance(context);
            loadingDialog.startLoading();
        }
		//两种数据返回，一种返回datas里的数据，一种全部返回，这里做判断
        Class injectClass = BaseResp.class;
        if (BaseResp.class.isAssignableFrom(className) && className != BaseResp.class) {
            injectClass = className;
        }
        if (post) {
            EasyHttp.post(context, url, injectClass, params, new RequestCallback<Object>() {
                @Override
                public void done(Object hunkResp) {
                    handleData(hunkResp, saveurl, className);
                    isRefresh = false;
                }
            });
        } else {
            EasyHttp.get(context, url, injectClass, params, new RequestCallback<Object>() {
                @Override
                public void done(Object hunkResp) {
                    handleData(hunkResp, saveurl, className);
                    isRefresh = false;
                }
            });
        }
    }

E.设置沉浸式状态栏:setLayoutFullscreen

F.请求数据的Code统一处理

BaseResp resp = (BaseResp) object;
new CodeRespondUtils(activity.context, resp.getCode());

G.底部View显示，了解SRecycleMoreAdapter SRecycleMoreAdapter默认有一个底部栏，如果需要头部栏，则在子类的构造器里调用setHeaderCount（int count) 如果不需要底部栏，则Adapter引用了解SRecycleAdapter 然后重写以下方法：

    @Override
    public RecyclerView.ViewHolder setContentView(ViewGroup parent) {
        View view = LayoutInflater.from(context).inflate(layout, parent, false);
        return new TabViewHolder(view);
    }

    @Override
    public void bindContentView(RecyclerView.ViewHolder holder, int position) {
        TabViewHolder hd = (TabViewHolder) holder;
    }

在BaseHelper里对数据做了处理

/**
     * 处理RecyleView的数据，支持上拉加载显示
     *
     * @param obj
     * @param sRecycleView
     * @param pageIndex
     */
    public void handleViewData(Object obj, SRecycleView sRecycleView, int pageIndex) {
        if (sRecycleView == null) {
            return;
        }
        if (sRecycleView.getRefreshView() == null) {
            return;
        }
        if (obj != null) {
            List resp = (List) obj;
            SRecycleMoreAdapter adapter = (SRecycleMoreAdapter) sRecycleView.getRefreshView().getAdapter();
            if (resp != null && resp.size() > 0) {
                if (pageIndex > 0 && adapter.items != null) {
                    adapter.items.addAll(resp);
                } else {
                    adapter.items = resp;
                }
				//如果当前加载的数据量小于设定的单页数量，则显示底部栏
                if (resp.size() < loadCount) {
                    sRecycleView.setLoadMore(false);
                    adapter.notifyDataChanged(adapter.items, false);
                } else {
                    adapter.notifyDataChanged(adapter.items, true);
                }
            //如果不是第一页，且没有更多数据了，显示底部栏
            } else if (pageIndex > 0) {
                sRecycleView.setLoadMore(false);
                adapter.setBottomViewVisible();
            }
        }
    }

H.一步实现Broadcast消息通知 子类调用initBroadcast（String... args）便可注册广播了，然后重写onMsgReceiver（int position),这个position是依据args添加的顺序

5.可追踪的Log打印

核心类:com.summer.helper.utils.Logs

当使用Logs.i("msg),使用的是默认的TAG,数据请求的信息都在此TAG下,建议开发人员在使用时,不要使用默认TAG,以使数据这些的信息纯粹

当软件要发布时,请在Application下,设置Logs.isDebug = false;//避免数据泄露

示例:

04-27 16:08:39.076 30733-30733/? I/hxq: at EasyHttp.java(84) onResponse: 请求结果:我的圈子{"code":"0","message":"request success","handleTime":1493280519555}

Logs文件增加是否打印日志到本地手机的设置，isNeedWriteLogToLocal，默认为false

6. com.summer.helper.utils.SUtils

SUtils类是本框架非常重要的类,熟悉它后会有效地提高开发人员的效率,以下是基本方法描述:

1.屏幕尺寸获取

initScreenDisplayMetrics(Activity context);//在首个Activity里调用此代码,初始化数据
SUtils.screenWidth;//屏幕宽度
SUtils.screenHeight;//屏幕高度

2.自定义样式的Toast,不会重复的Toast

makeToast(Context context, String text)

3.SharedPreferences的简单使用

saveIntegerData(Context mContext, String type, int selected);插入int类型数据
getIntegerData(Context mContext, String type);获取int数据
支持各种基本类型数据的插入与获取

4.getDip(Context context,int value);转换为DIP值

5.检查网络是否可用

isNetworkAvailable(Context context)

6.点击时,让View展现缩放动画

clickTransColor(final TextView view)

7.时间距 ,一般评论时需要显示特定的时间,比如刚刚,一个小时前

getRecentlyTime(long dtTime, long serverTime, Context mContext)

8.获取手机默认文件夹

getSDPath()

9.获取状态栏高度

getStatusBarHeight(Activity activity)

10.对Bitmap高斯模糊处理

fastBlur(Bitmap sbitmap, float radiusf)

11.获取网络状态,有时需要判断是不是WIFI

getNetWorkType(Context context)

12.将文件转为byte[]

readFileAsBytes(String filename)

13.将文件写到Bitmap

createScaleBitmap(String path, int width, int height)

14.加载图片,这里使用的Glide框架

setPic(ImageView view, String img, boolean download)

About

Kotlin快速开发框架

Resources

Readme
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages