android-Ultra-Pull-To-Refresh 源码解析 一个强大的安卓下拉刷新框架.pdfVIP

android-Ultra-Pull-To-Refresh 源码解析 一个强大的 Andriod 下拉刷新框架 @codeKK Android 开源项 目源码分 析站 android-Ultra-Pull-To-Refresh 源码解析 本文为 Android 开源项 目源码解析 中 android-Ultra-Pull-To-Refresh 部分 项 目地址：android-Ultra-Pull-To-Refresh，分析的版本：508c632，Demo 地址：android-Ultra- Pull-To-Refresh Demo 分析者：Grumoon，校对者：lightSky，校对状态：已完成 1. 功能介绍 下拉刷新，几乎是每个 Android 应用都会需要的功能。 android-Ultra-Pull-To-Refresh （以下简称 UltraPTR ）便是一个强大的 Andriod 下拉刷新框架。 主要特点： (1).继承于 ViewGroup， Content 可以包含任何 View。 (2).简洁完善的 Header 抽象，方便进行拓展，构建符合需求的头部。 对比 Android-PullToRefresh 项 目，UltraPTR 没有实现 加载更多 的功能，但我认为 下拉刷新 和 加载更多 不是同一层次的功能， 下拉刷新 有更广泛的需求，可以适用于任何页面。而 加载更多 的功能应该交由具体的 Content 自己去实现。这应该是和 Google 官方推出 SwipeRefreshLayout 是 相同的设计思路，但对比 SwipeRefreshLayout， UltraPTR 更灵活，更容易拓展。 2. 总体设计 UltraPTR 总体设计比较简单清晰。 首先抽象出了两个接口，功能接口和 UI 接口。 PtrHandler 代表下拉刷新的功能接口，包含刷新功能回调方法以及判断是否可以下拉的方法。用户实现 此接口来进行数据刷新工作。 PtrUIHandler 代表下拉刷新的 UI 接口，包含准备下拉，下拉中，下拉完成，重置以及下拉过程中的位 置变化等回调方法。通常情况下， Header 需要实现此接口，来处理下拉刷新过程中头部 UI 的变化。 整个项 目围绕核心类 PtrFrameLayout。 PtrFrameLayout 代表了一个下拉刷新的自定义控件。 PtrFrameLayout 继承自 ViewGroup，有且只能有两个子 View，头部 Header 和内容 Content。通常情 况下 Header 会实现 PtrUIHandler 接口， Content 可以为任意的 View。 和所有的自定义控件一样， PtrFrameLayout 通过重写 onFinishInflate， onMeasure， onLayout 来 确定控件大小和位置。通过重写 dispatchTouchEvent 来确定控件的下拉行为。 3. 流程图 请参照 4.1.5 PtrFrameLayout 事件拦截流程图 4. 详细设计 4.1 核心类功能介绍 4.1.1 PtrHandler.java 下拉刷新功能接口，对下拉刷新功能的抽象，包含以下两个方法。 public void onRefreshBegin (final PtrFrameLayout frame) 刷新回调函数，用户在这里写自己的刷新功能实现，处理业务数据的刷新。 public boolean checkCanDoRefresh (final PtrFrameLayout frame, final View content, final View header) 判断是否可以下拉刷新。 UltraPTR 的 Content 可以包含任何内容，用户在这里判断决定是否可以下 拉。 例如，如果 Content 是 TextView，则可以直接返回 true，表示可以下拉刷新。 如果 Content 是 ListView，当第一条在顶部时返回 true，表示可以下拉刷新。 如果 Content 是 ScrollView，当滑动到顶部时返回 true，表示可以刷新。 4.1.2 PtrDefaultHandler.java 抽象类，实现了 PtrHandler.java 接口，给出了 checkCanDoRefresh 的默认实现，给出了常见 View 是否可以下拉的判断方法。 @Override public boolean checkCanDoRefresh (PtrFrameLayout frame, Vi