充电桩软件设计文档(android)

深圳充软件设计说明书 2016-04-28 第页，共SECTIONPAGES16页深圳充软件设计说明拟制康树乾日期2016-4-28审核日期批准日期修订记录日期修订版本修订描述作者2016-4-28V1.0创建康树乾2016-5-3V1.0创建康树乾目录1简介31.1目的31.2范围31.2.1软件名称31.2.2软件功能31.2.3软件应用32代码设计42.1模块设计描述42.1.1软件模块的划分及定义42.1.2软件源码包名解释及作用52.1.2界面级代码类命名说明5非模块性界面代码5发现模块界面代码5主页地图模块界面代码6我的模块界面代码6扫码充电模块界面代码82.2详细设计102.2.1预约流程详细设计地图模式筛选充电站预约后等待分配充电站预约确认界面预约列表界面142.2.2充电流程详细设计二维码及手动输入界面确认桩站信息界面选择充电方式界面支付界面等待插枪界面充电监控界面16

简介目的该文档主要用于项目交接的成员及项目交付的开发人员之间，使得项目得以无缝的交接完成。应用人员为动企内容开发人员及商连商用的项目交接人员。范围软件名称深圳充项目软件功能可参照设计原型图软件应用软件主要应用于对深圳地区的充电桩站进行预约与充电。

概要设计模块设计描述软件模块的划分及定义：以底部菜单栏功能划分模块，分别主页，扫码充电，发现及我的模块软件源码包名解释及作用注：以下源码包名前缀省略com.dongqi.chargepile源码包名功能划分common.config全局性app连接配置信息common.exceptionapp异常捕获后的统一处理逻辑configapp需使用全局常量controller.activity非模块性的界面代码（如登录，注册页等）controller.activity.discovery发现模块的界面代码controller.activity.home主页地图模块的界面代码controller.activity.my我的模块界面代码controller.activity.scan扫码充电模块界面代码controller.core全局服务，监听器及程序级Applicationmodel.adapter数据填充适配器model.beanJavabeanmodel.bitmap图片缓存处理model.cacheApp缓存处理model.camera程序照相机处理model.decode加解密处理model.httphttp连接处理model.receiver网络连接监听器model.task代理及mqtt推送处理model.upgrade程序更新处理utils程序使用工具类utils.baidu百度地图协助工具monbiz请求数据接口业务处理及回调utils.roundedimageview圆形图片处理widget程序使用自定义控件widget.ptr上下拖拽刷新控件集widget.pulltorefresh上下拖拽刷新协助类widget.spinner自定义下拉框控件widget.swipemenulistview自定义滑动删除控件widget.viewbadger自定义右上角标记控件widget.wheel自定义滚轮选择控件界面级代码类命名说明非模块性的界面代码GuideActivity.java初次安装引导界面InitActivity.java初始化logo界面LoginActivity.java登录界面MainActivity.java主界面包含4个FragmentRegeditActivity.java注册界面发现模块的界面代码DiscoveryFragment.java发现fragment界面InformationActivity.java资讯界面InformationDetailActivity.java资讯详情界面OperatorPhoneActivity.java运营商电话界面RepairActivity.java维修界面RescueActivity.java救援界面SearchMostActivity.java列表选择充电站界面SuggestionActivity.java投诉及建议界面主页地图模块的界面代码AppointAllotingActivity.java预约等待分配中界面AppointConditionActivity.java设置条件界面AppointConfirmActivity.java预约确认界面AppointNofoundActivity.java找不到合适充电站提示界面FeeDetailActivity.java电费详情界面GetDataHelper.java构造请求参数协助类HomeFragment.java主页fragment界面MyOrientationListener.java地图方向传感监控管理类PileActivity.java充电桩详情界面（暂未使用）StationSearch.java站点搜索界面我的模块界面代码AboutUsActivity.java关于我们界面AccountSecurityActivity.java账户安全界面AccoutSetPayActivity.java初次设置支付密码界面AddBindBankCardActivity.java绑定银行卡界面（暂未使用）AddMyEvaluationActivity.java添加充电订单评价界面BankCardRecordActivity.java银行卡列表界面（暂未使用）BillingActivity.java充电计费中等待界面BindBankCardActivity.java绑定银行卡界面（暂未使用）ChargeHelperActivity.java充电帮助界面CollectionActivity.java我的收藏界面CollectionConditionActivity.java从收藏预约设置条件界面CollectionStakeListActivity.java桩站详情界面（暂未使用）MessageDetailActivity.java消息详情界面MessageNotificationActivity.java消息通知列表界面MyAccountCharge.java账户充值界面MyAllowanceActivity.java充电卡补贴额度界面MyAppointDetail.java我的预约详情界面MyBind_Step1.java解绑充电-输入支付密码验证界面MyCarActivity.java我的车辆类别界面MyCarAddActivity.java添加车辆界面MyCarAuthentActivity.java车辆认证界面MyChargeActivity.java我的充电列表界面MyChargeCardActivity.java我的充电卡列表界面MyChargeCardBindActivity.java绑定充点卡界面MyChargeDetailActivity.java我的充电详情界面MyFragment.java我的fragment界面MyInfoActivity.java我的资料界面MyInfoAeraSelect.java我的资料-弹框选择所在地界面MyReservationActivity.java我的预约列表界面MyTransactionRecordsActivity.java我的交易记录列表界面NoticeActivity.java消息提醒界面（暂未使用）ResetLoginPwdActivity.java重置登录密码界面ResetPayPwdActivity.java重置支付密码界面SelectAeraActivity.java弹框选择地区界面SelectDistrictActivity.javaSelectDrivePicActivity.java驾驶证示例弹框界面SelectFilterActivity.java我的预约筛选弹框界面SelectPicActivity.java选择图片弹框界面SelectSexActivity.java选择性别弹框界面SettingActivity.java设置界面SettingNewLoginPwdActivity.java设置新登录密码界面SettingPayPwdActivity.java设置新支付密码界面ShowMyEvaluationActivity.java展示充电订单评价界面UnionPayActivity.java银联在线支付界面UpdateLoginPwdActivity.java修改登录密码界面UpdatePayPwdActivity.java修改支付密码界面扫码充电模块界面代码CaptureActivity.java扫描电桩编号/二维码界面ChargingActivity.java充电中监控界面ChargingEndActivity.java充电结束提示界面ChargingModeActivity.java选择充电方式界面InputCodeEncodingActivity.java手动输入电桩编号界面InsertChargingGunActivity.java等待插枪充电界面PayActivity.java充电支付界面PayResultsActivity.java支付结果界面PostStationActivity.java确认充电桩界面ScanFragment.java扫码充电fragment界面（暂未使用）

3详细设计注：此处主要列举预约及充电流程涉及的代码逻辑，其余基本列表查看逻辑不一一说明，详细可参照代码中注释。预约流程详细设计拖动地图搜索出指定范围内的充电站，或以列表形式查看附近充电站，点击充电站点信息中的预约按钮，进入预约等待分配界面；得到分配的充电桩后，进入充电桩预约确认界面，可选择确认与取消预约；预约成功后，在我的预约列表出会有一条预约中状态的订单。地图模式筛选充电站（HomeFragment.java）mHandlerConstr.HANDLER_NAV：程序通知处理导航事件，可按实际调用百度sdk或高德sdk提供的导航服务Constr.HANDLER_APPOINT：程序通知处理预约申请事件，通过checkLoginstate方法判断登录是否已登录，最后构造接口json参数，调用预约申请接口Constr.HANDLER_COLL：程序通知处理收藏站点事件，通过checkLoginstate方法判断登录是否已登录，最后构造接口json参数，调用收藏某指定充电站接口Constr.HANDLER_COLL_OK：收藏成功回调，更新站点的是否收藏的图标Constr.HANDLER_UNCOLL：程序通知处理取消收藏站点事件，通过checkLoginstate方法判断登录是否已登录，最后构造接口json参数，调用收藏某指定充电站接口Constr.HANDLER_UNCOLL_OK：取消收藏成功回调，更新站点的是否收藏的图标Constr.HANDLER_FEE：程序通知调用打开电费详情界面Constr.MSG_STATIONCOUNT_GET：程序通知获取充电站数量统计成功回调Nou：程序通知进行按钮波浪效果动画NouStop：程序通知结束动画，并跳转到预约设置条件界面EmptyLayout.NETWORK_ERROR:程序通知网络出现异常，站点列表模式下出现异常界面EmptyLayout.NETWORK_LOADING:程序通知加载中，站点列表模式下出现加载中界面EmptyLayout.NODATA_ENABLE_CLICK:程序通知无数据，站点列表模式下出现无数据界面EmptyLayout.HIDE_LAYOUT:程序通知加载成功，站点列表模式下正常界面LOADDATA:程序通知，重新加载充电站数据，调用查询充电站接口reloaddata函数构造请求参数，请求查询充电站列表信息接口checkLoginstate函数检查用户是否已登录状态，若未登录则跳转登录界面onActivityResult函数此处分两种情况界面从站点搜索返回过来，则按条件重新加载充电站数据界面从设置条件返回过来，则按条件重新加载充电站数据initUI函数初始化界面上的UI控件及注册控件的监听器。regRecevier函数注册广播，实现预约和导航功能的异步回调initMap函数初始化百度地图sdk,并注册基础事件initMappoint函数初始化地图站点，APP重新打开时判断条件站点是否需要重新加载addStationsOverlay，addStationsOverlaywithpara函数请求站点数据后，加载地图的标注点addInfosOverlay函数将获取的站点数据，以经纬度形式逐个添加到地图上，并自动缩放到一定的等级，使得需要的站点都显示在地图上。autoSize函数利用算法获取距离所有站点中点最远的距离，用于确定地图的缩放等级loadListView函数站点数据以当前位置的距离排序后填充进入列表。initMarkerClickEvent函数对地图标注点的点击事件处理，通知例如预约及导航，收藏的回调rqServer，rqServerwithpara函数构造站点列表数据请求的参数jsonStstionCallBack函数请求列表数据的http异步回调，实现添加标注点及填充列表数据。rqApplyServer函数构造预约申请接口请求的json参数showFilterPopupWindow函数列表形式的筛选下拉框的UI初始化showpointFilterPopupWindow函数地图形式的筛选下拉框UI初始化Maplistener函数监听百度地图的状态发生变化，实现拖动实时查询充电站列表预约后等待分配充电站界面（AppointAllotingActivity.java）initView函数初始化UI控件，并通过传入intent检测预约条件参数，然后获取系统时间并进入倒数的状态。iniCountDown函数通过去系统时间和等待分配结束时间对比，产生时间差，以实现倒计时功能。另倒计时中，每隔10s查询一次最新的分配信息。预约确认界面（AppointConfirmActivity.java）progressCancel函数处理取消预约的操作函数，二次确认后请求取消预约接口。progressSubmit函数处理确认预约的操作函数，请求确认预约接口。rqOrderServer函数构造查询预约订单详情的接口json参数ApplyconfirmCallBack函数查询预约订单详情的回调函数，获取订单详情内容，并展示到界面中iniCountDown函数通过对比系统时间与订单详情中的确认超时时间，实现倒计时功能，并在倒计时结束时处理一些UI。预约列表界面（MyReservationActivity.java）rqServer函数构造预约列表请求接口json参数。submitCallBack函数预约列表接口http回调，获取到数据后，填充列表，并利用系统时间与预约中的数据项中超时时间对比，实现倒计时。rqOrdercancelServer函数构造预约取消接口的请求json参数ApplyCancelCallBack函数预约取消的接口回调，提示用户预约取消成功充电流程详细设计进入扫码或手动输入二维码，进入站点确认信息，然后选择充电方式后，发起充电申请并进入等待插枪界面，当监控到充电状态发生变化，会实时跳转到充电中监控界面并定时查询最新状态，最后充电完成后可以到充电列表中查看历史数据。二维码扫码界面（CaptureActivity.java）、手动输入二维码（InputCodeEncodingActivity）rqServer函数构造充电