斛兵助手android客户端开源

    作者：93码农

    个人站点：sundroid.cn    邮箱： [e-mail]   微博：http://weibo.com/Sundroid

    

点我前往项目主页

斛兵助手 Android 客户端项目简析

启动Eclipse，点击菜单并导入Android客户端项目，请确保你当前的Android SDK是最新版。
如果编译出错，请修改项目根目录下的 project.properties 文件。
推荐使用Android 4.0 以上版本的SDK,请使用JDK1.6编译：

target=android-15

release 2.1

• 查看课表
• 查看新闻
• 计算绩点绘图
• 查看借阅图书、搜索图书
• 查看成绩

PS：此项目针对合肥工业大学在校学生，只有有教务系统登录账号才可以使用

下面将简单的解析下项目：

一、项目的目录结构

根目录
├ src
├ libs
├ res
├ AndroidManifest.xml
├ LICENSE.txt
├ proguard.cfg
└ project.properties

1、src目录
src目录用于存放项目的包及java源码文件。

下面是src目录的子目录：

src
├com.school.activity
├com.school.adapter
├com.school.domain
├com.school.fragment
├com.school.net
├com.school.view
├com.school.sqlite
├com.school.component
├com.school.util

• com.school.activity — activity类
• com.school.adapter — 界面适配器
• com.school.component — 自定义组件
• com.school.domain -实体类
  
• com.school.net —网络连接服务
  
• com.school.view —自定义listView
• com.school.sqlite —数据库
• com.school.util —工具类

2、libs目录
libs目录用于存放项目引用到的jar包文件。

下面是libs目录里的jar包文件：

libs
└ jsoup-1.6.3.jar

• jsoup-1.6.3.jar — jsoup解析网页工具包

└ jsoup-1.6.3.jar

• jsoup-1.6.3.jar — jsoup解析网页工具包

3、res目录
res目录用于存放项目的图片、布局、样式等资源文件。

下面是res目录的子目录：

res
├ anim
├ color
├ drawable
├ drawable-hdpi
├ drawable-ldpi
├ drawable-mdpi
├ layout
├ menu
├ raw
├ values
└ xml

• anim — 动画效果
• color — 颜色
• drawable/drawable-hdpi/drawable-ldpi/drawable-mdpi — 图标、图片
• layout — 界面布局
• menu — 菜单
• raw — 图片
• values — 语言包和样式
• xml — 系统设置

4、AndroidManifest.xml
AndroidManifest.xml用于设置应用程序的版本、主题、用户权限及注册Activity等。

二、项目的功能流程

1、APP启动流程

AndroidManifest.xml注册的启动界面为"SplashActivity"，具体文件为src\com.school.activity.SplashActivity.java文件。启动显示欢迎界面之后，通过意图(Intent)跳转到首页（com.school.activity\MainActivity.java）。
注：除启动界面之外，其他所有界面都放在src\com.school.activity包中。

2、APP访问API流程

以首页资讯列表显示访问API数据为例：

1) 初始化控件
首页MainActivity(MainActivity.java)在onCreate()方法里面加载布局文件(activity_main.xml)，对下拉刷新列表控件(PullToRefreshListView)进行了初始化，并设置了数据适配器(ListViewNewsAdapter)。
注：Main.xml布局文件在res\layout目录下；PullToRefreshListView控件在com.school.widget包；ListViewNewsAdapter适配器在com.school.adapter包。

2) 异步线程访问
列表控件初始化后，开启一个线程方法(loadLvNewsData())，该方法中调用全局应用程序类(AppContext)来访问API客户端类(ApiClient)。通过ApiClient以http方式请求服务器的API。返回响应的XML数据，再通过实体Bean(NewsList)解析XML，返回实体(NewsList)给UI控件(PullToRefreshListView)展示。

3) 解析数据显示
服务得到请求，将返回对应的资讯XML数据，再通过资讯实体类(NewsList)解析XML，返回实体(NewsList)给UI控件(PullToRefreshListView)展示。
注：NewsList实体类在com.school.domain包。

效果图