LoonAndroid说明示文档101版.docxVIP

LoonAndroid 说明文档白皮书 2014年-5月23日作者：lic源程序编写工程师:panc技术翻译支持：panc 写在文档之前：此文档根据当前编写日期来编写，后期源程序更改将持续跟进。此文档仅限公司内部交流使用，如有其他人拿做其它商业用途产生其它影响，本人概不负责。程序如有雷同，纯属虚构。 程序介绍：程序大体拥有几大常用模块的封装，包括网络请求集成框架，控件View注解，数据库常用方法集成，图片下载控件，通用适配器，文件下载，通知集成，ListView下拉刷新等等。其中功能还在持续完善添加中 @panc ， 此程序在本公司最终解释权归panc 所有，版本维护信息请咨询 @pan 或发送邮件 panc@。1 程序集成到项目工程使用。1 集成打开安卓开发集成IDE(推荐使用最常用的安卓应用开发工具 Eclipse，下面实例只针对eclipse讲解，其它工具请参见想关工具官方文档)，如下图1.1 ，将程序导入到eclipse，其中两种方式加入到自己工程项目中，1：右键--preferencesAndroid--勾选 Is Library。然后在自己的项目中 右键--preferencesAndroid--Add 选中Ioc_Android，即可使用。 2：右键项目--Export,将项目打包成jar文件(其中除了com.android.pc.ioc.a.demo包名之外，其他必须全部打包进jar)，本项目中添加到lib，build path 流程。1.1 2 使用 在自己项目的Application中进行框架初始化其中Ioc.getIoc().init(this)是整个框架的入口 必须在super.onCreate()之前调用2 网络传输2.1 网络请求 网络请求模块分为两大部分 一：手动判断返回状态二: 自动判断返回状态结果2.1.1 返回对象ResponseEntityResponseEntity这个类包含了所有返回结果相关的信息其中每个方法都可以用get获取set进行设置Url表示你提交的请求Content表示返回数据的字符串Cookies 表示从请求中获取的cookiesParams 表示你提交的参数Status 表示请求结果的状态（主要是用来处理异常情况）其值有如下几种其中result_ok表示请求成功 result_net_err表示请求失败 这里所有的请求 失败全部归结为网络问题Key用来区分来源于哪个接口2.1.2 请求属性配置InternetConfigInternetConfig这个类包含了所有请求配置相关的信息设置是否从请求中拿取cookies设置以后可以从ResponseEntity获取cookies设置请求头 这些键值对会附加在请求头中传递给服务器设置请求的编码格式轮询模式下的轮询间隔时间 单位为秒soap请求时候 设置的域空间 一般我们公司的soap接口无需设置默认为/设置连接超时时间对于异步请求当多个请求公用一个回调的时候 用这个来进行区分 你可以从返回结果ResponseEntity中获得设置的这个key来判断设置文件上传提交的进度条监听2.1.3 手动判断返回状态 同步请求（get,post,soap,form表单） EQ \o\ac(○,1) get同步请求你可以从ResponseEntity中拿取来判断请求是否成功 然后通过下面的方法拿取请求结果参数可以以键值对传递进去如果需要设置参数 如下 EQ \o\ac(○,2) post同步请求Post请求和get请求一样 只需要把改为即可 EQ \o\ac(○,3) soap同步请求其中第一个为url ，第二个为参数（可以不设置），第三个为配置（可以不设置）第四个为请求方法其中如果服务器有需要 请设置 EQ \o\ac(○,4 )表单提交其中params为表单参数，files为上传文件键值对（可以不传），config为配置（可以不传）如果要监控上传进度，请在InternetConfig中设置Progress目前上传理论支持最大2GB文件 异步请求（get,post,soap,form表单）和上面的都类似只是在所有接口前面添加了ajaxGet 为FastHttp.ajaxGetPost 为FastHttp.ajaxSoap 为FastHttp.ajaxWebServerForm 为FastHttp.ajaxForm其中每个方法都多了一个参数为 这个AjaxCallBack 是用来处理异步请求回调其中可以获取getStatus来判断是否请求成功其中如果多个请求公用一个AjaxCallBack ,那么getKey来判断是哪个请求其中 stop是用来表示是否取消回调，比如在activity中 可以用 this.isD