充電樁軟件設(shè)計文檔(android)

深圳充軟件設(shè)計說明書 2016-04-28 第頁，共SECTIONPAGES16頁深圳充軟件設(shè)計說明擬制康樹乾日期2016-4-28審核日期批準(zhǔn)日期修訂記錄日期修訂版本修訂描述作者2016-4-28V1.0創(chuàng)建康樹乾2016-5-3V1.0創(chuàng)建康樹乾目錄1簡介31.1目的31.2范圍31.2.1軟件名稱31.2.2軟件功能31.2.3軟件應(yīng)用32代碼設(shè)計42.1模塊設(shè)計描述42.1.1軟件模塊的劃分及定義42.1.2軟件源碼包名解釋及作用52.1.2界面級代碼類命名說明5非模塊性界面代碼5發(fā)現(xiàn)模塊界面代碼5主頁地圖模塊界面代碼6我的模塊界面代碼6掃碼充電模塊界面代碼82.2詳細(xì)設(shè)計102.2.1預(yù)約流程詳細(xì)設(shè)計地圖模式篩選充電站預(yù)約后等待分配充電站預(yù)約確認(rèn)界面預(yù)約列表界面142.2.2充電流程詳細(xì)設(shè)計二維碼及手動輸入界面確認(rèn)樁站信息界面選擇充電方式界面支付界面等待插槍界面充電監(jiān)控界面16

簡介目的該文檔主要用于項目交接的成員及項目交付的開發(fā)人員之間，使得項目得以無縫的交接完成。應(yīng)用人員為動企內(nèi)容開發(fā)人員及商連商用的項目交接人員。范圍軟件名稱深圳充項目軟件功能可參照設(shè)計原型圖軟件應(yīng)用軟件主要應(yīng)用于對深圳地區(qū)的充電樁站進(jìn)行預(yù)約與充電。

概要設(shè)計模塊設(shè)計描述軟件模塊的劃分及定義：以底部菜單欄功能劃分模塊，分別主頁，掃碼充電，發(fā)現(xiàn)及我的模塊軟件源碼包名解釋及作用注：以下源碼包名前綴省略com.dongqi.chargepile源碼包名功能劃分common.config全局性app連接配置信息common.exceptionapp異常捕獲后的統(tǒng)一處理邏輯configapp需使用全局常量controller.activity非模塊性的界面代碼（如登錄，注冊頁等）controller.activity.discovery發(fā)現(xiàn)模塊的界面代碼controller.activity.home主頁地圖模塊的界面代碼controller.activity.my我的模塊界面代碼controller.activity.scan掃碼充電模塊界面代碼controller.core全局服務(wù)，監(jiān)聽器及程序級Applicationmodel.adapter數(shù)據(jù)填充適配器model.beanJavabeanmodel.bitmap圖片緩存處理model.cacheApp緩存處理model.camera程序照相機(jī)處理model.decode加解密處理model.httphttp連接處理model.receiver網(wǎng)絡(luò)連接監(jiān)聽器model.task代理及mqtt推送處理model.upgrade程序更新處理utils程序使用工具類utils.baidu百度地圖協(xié)助工具monbiz請求數(shù)據(jù)接口業(yè)務(wù)處理及回調(diào)utils.roundedimageview圓形圖片處理widget程序使用自定義控件widget.ptr上下拖拽刷新控件集widget.pulltorefresh上下拖拽刷新協(xié)助類widget.spinner自定義下拉框控件widget.swipemenulistview自定義滑動刪除控件widget.viewbadger自定義右上角標(biāo)記控件widget.wheel自定義滾輪選擇控件界面級代碼類命名說明非模塊性的界面代碼GuideActivity.java初次安裝引導(dǎo)界面InitActivity.java初始化logo界面LoginActivity.java登錄界面MainActivity.java主界面包含4個FragmentRegeditActivity.java注冊界面發(fā)現(xiàn)模塊的界面代碼DiscoveryFragment.java發(fā)現(xiàn)fragment界面InformationActivity.java資訊界面InformationDetailActivity.java資訊詳情界面OperatorPhoneActivity.java運營商電話界面RepairActivity.java維修界面RescueActivity.java救援界面SearchMostActivity.java列表選擇充電站界面SuggestionActivity.java投訴及建議界面主頁地圖模塊的界面代碼AppointAllotingActivity.java預(yù)約等待分配中界面AppointConditionActivity.java設(shè)置條件界面AppointConfirmActivity.java預(yù)約確認(rèn)界面AppointNofoundActivity.java找不到合適充電站提示界面FeeDetailActivity.java電費詳情界面GetDataHelper.java構(gòu)造請求參數(shù)協(xié)助類HomeFragment.java主頁fragment界面MyOrientationListener.java地圖方向傳感監(jiān)控管理類PileActivity.java充電樁詳情界面（暫未使用）StationSearch.java站點搜索界面我的模塊界面代碼AboutUsActivity.java關(guān)于我們界面AccountSecurityActivity.java賬戶安全界面AccoutSetPayActivity.java初次設(shè)置支付密碼界面AddBindBankCardActivity.java綁定銀行卡界面（暫未使用）AddMyEvaluationActivity.java添加充電訂單評價界面BankCardRecordActivity.java銀行卡列表界面（暫未使用）BillingActivity.java充電計費中等待界面BindBankCardActivity.java綁定銀行卡界面（暫未使用）ChargeHelperActivity.java充電幫助界面CollectionActivity.java我的收藏界面CollectionConditionActivity.java從收藏預(yù)約設(shè)置條件界面CollectionStakeListActivity.java樁站詳情界面（暫未使用）MessageDetailActivity.java消息詳情界面MessageNotificationActivity.java消息通知列表界面MyAccountCharge.java賬戶充值界面MyAllowanceActivity.java充電卡補貼額度界面MyAppointDetail.java我的預(yù)約詳情界面MyBind_Step1.java解綁充電-輸入支付密碼驗證界面MyCarActivity.java我的車輛類別界面MyCarAddActivity.java添加車輛界面MyCarAuthentActivity.java車輛認(rèn)證界面MyChargeActivity.java我的充電列表界面MyChargeCardActivity.java我的充電卡列表界面MyChargeCardBindActivity.java綁定充點卡界面MyChargeDetailActivity.java我的充電詳情界面MyFragment.java我的fragment界面MyInfoActivity.java我的資料界面MyInfoAeraSelect.java我的資料-彈框選擇所在地界面MyReservationActivity.java我的預(yù)約列表界面MyTransactionRecordsActivity.java我的交易記錄列表界面NoticeActivity.java消息提醒界面（暫未使用）ResetLoginPwdActivity.java重置登錄密碼界面ResetPayPwdActivity.java重置支付密碼界面SelectAeraActivity.java彈框選擇地區(qū)界面SelectDistrictActivity.javaSelectDrivePicActivity.java駕駛證示例彈框界面SelectFilterActivity.java我的預(yù)約篩選彈框界面SelectPicActivity.java選擇圖片彈框界面SelectSexActivity.java選擇性別彈框界面SettingActivity.java設(shè)置界面SettingNewLoginPwdActivity.java設(shè)置新登錄密碼界面SettingPayPwdActivity.java設(shè)置新支付密碼界面ShowMyEvaluationActivity.java展示充電訂單評價界面UnionPayActivity.java銀聯(lián)在線支付界面UpdateLoginPwdActivity.java修改登錄密碼界面UpdatePayPwdActivity.java修改支付密碼界面掃碼充電模塊界面代碼CaptureActivity.java掃描電樁編號/二維碼界面ChargingActivity.java充電中監(jiān)控界面ChargingEndActivity.java充電結(jié)束提示界面ChargingModeActivity.java選擇充電方式界面InputCodeEncodingActivity.java手動輸入電樁編號界面InsertChargingGunActivity.java等待插槍充電界面PayActivity.java充電支付界面PayResultsActivity.java支付結(jié)果界面PostStationActivity.java確認(rèn)充電樁界面ScanFragment.java掃碼充電fragment界面（暫未使用）

3詳細(xì)設(shè)計注：此處主要列舉預(yù)約及充電流程涉及的代碼邏輯，其余基本列表查看邏輯不一一說明，詳細(xì)可參照代碼中注釋。預(yù)約流程詳細(xì)設(shè)計拖動地圖搜索出指定范圍內(nèi)的充電站，或以列表形式查看附近充電站，點擊充電站點信息中的預(yù)約按鈕，進(jìn)入預(yù)約等待分配界面；得到分配的充電樁后，進(jìn)入充電樁預(yù)約確認(rèn)界面，可選擇確認(rèn)與取消預(yù)約；預(yù)約成功后，在我的預(yù)約列表出會有一條預(yù)約中狀態(tài)的訂單。地圖模式篩選充電站（HomeFragment.java）mHandlerConstr.HANDLER_NAV：程序通知處理導(dǎo)航事件，可按實際調(diào)用百度sdk或高德sdk提供的導(dǎo)航服務(wù)Constr.HANDLER_APPOINT：程序通知處理預(yù)約申請事件，通過checkLoginstate方法判斷登錄是否已登錄，最后構(gòu)造接口json參數(shù)，調(diào)用預(yù)約申請接口Constr.HANDLER_COLL：程序通知處理收藏站點事件，通過checkLoginstate方法判斷登錄是否已登錄，最后構(gòu)造接口json參數(shù)，調(diào)用收藏某指定充電站接口Constr.HANDLER_COLL_OK：收藏成功回調(diào)，更新站點的是否收藏的圖標(biāo)Constr.HANDLER_UNCOLL：程序通知處理取消收藏站點事件，通過checkLoginstate方法判斷登錄是否已登錄，最后構(gòu)造接口json參數(shù)，調(diào)用收藏某指定充電站接口Constr.HANDLER_UNCOLL_OK：取消收藏成功回調(diào)，更新站點的是否收藏的圖標(biāo)Constr.HANDLER_FEE：程序通知調(diào)用打開電費詳情界面Constr.MSG_STATIONCOUNT_GET：程序通知獲取充電站數(shù)量統(tǒng)計成功回調(diào)Nou：程序通知進(jìn)行按鈕波浪效果動畫NouStop：程序通知結(jié)束動畫，并跳轉(zhuǎn)到預(yù)約設(shè)置條件界面EmptyLayout.NETWORK_ERROR:程序通知網(wǎng)絡(luò)出現(xiàn)異常，站點列表模式下出現(xiàn)異常界面EmptyLayout.NETWORK_LOADING:程序通知加載中，站點列表模式下出現(xiàn)加載中界面EmptyLayout.NODATA_ENABLE_CLICK:程序通知無數(shù)據(jù)，站點列表模式下出現(xiàn)無數(shù)據(jù)界面EmptyLayout.HIDE_LAYOUT:程序通知加載成功，站點列表模式下正常界面LOADDATA:程序通知，重新加載充電站數(shù)據(jù)，調(diào)用查詢充電站接口reloaddata函數(shù)構(gòu)造請求參數(shù)，請求查詢充電站列表信息接口checkLoginstate函數(shù)檢查用戶是否已登錄狀態(tài)，若未登錄則跳轉(zhuǎn)登錄界面onActivityResult函數(shù)此處分兩種情況界面從站點搜索返回過來，則按條件重新加載充電站數(shù)據(jù)界面從設(shè)置條件返回過來，則按條件重新加載充電站數(shù)據(jù)initUI函數(shù)初始化界面上的UI控件及注冊控件的監(jiān)聽器。regRecevier函數(shù)注冊廣播，實現(xiàn)預(yù)約和導(dǎo)航功能的異步回調(diào)initMap函數(shù)初始化百度地圖sdk,并注冊基礎(chǔ)事件initMappoint函數(shù)初始化地圖站點，APP重新打開時判斷條件站點是否需要重新加載addStationsOverlay，addStationsOverlaywithpara函數(shù)請求站點數(shù)據(jù)后，加載地圖的標(biāo)注點addInfosOverlay函數(shù)將獲取的站點數(shù)據(jù)，以經(jīng)緯度形式逐個添加到地圖上，并自動縮放到一定的等級，使得需要的站點都顯示在地圖上。autoSize函數(shù)利用算法獲取距離所有站點中點最遠(yuǎn)的距離，用于確定地圖的縮放等級loadListView函數(shù)站點數(shù)據(jù)以當(dāng)前位置的距離排序后填充進(jìn)入列表。initMarkerClickEvent函數(shù)對地圖標(biāo)注點的點擊事件處理，通知例如預(yù)約及導(dǎo)航，收藏的回調(diào)rqServer，rqServerwithpara函數(shù)構(gòu)造站點列表數(shù)據(jù)請求的參數(shù)jsonStstionCallBack函數(shù)請求列表數(shù)據(jù)的http異步回調(diào)，實現(xiàn)添加標(biāo)注點及填充列表數(shù)據(jù)。rqApplyServer函數(shù)構(gòu)造預(yù)約申請接口請求的json參數(shù)showFilterPopupWindow函數(shù)列表形式的篩選下拉框的UI初始化showpointFilterPopupWindow函數(shù)地圖形式的篩選下拉框UI初始化Maplistener函數(shù)監(jiān)聽百度地圖的狀態(tài)發(fā)生變化，實現(xiàn)拖動實時查詢充電站列表預(yù)約后等待分配充電站界面（AppointAllotingActivity.java）initView函數(shù)初始化UI控件，并通過傳入intent檢測預(yù)約條件參數(shù)，然后獲取系統(tǒng)時間并進(jìn)入倒數(shù)的狀態(tài)。iniCountDown函數(shù)通過去系統(tǒng)時間和等待分配結(jié)束時間對比，產(chǎn)生時間差，以實現(xiàn)倒計時功能。另倒計時中，每隔10s查詢一次最新的分配信息。預(yù)約確認(rèn)界面（AppointConfirmActivity.java）progressCancel函數(shù)處理取消預(yù)約的操作函數(shù)，二次確認(rèn)后請求取消預(yù)約接口。progressSubmit函數(shù)處理確認(rèn)預(yù)約的操作函數(shù)，請求確認(rèn)預(yù)約接口。rqOrderServer函數(shù)構(gòu)造查詢預(yù)約訂單詳情的接口json參數(shù)ApplyconfirmCallBack函數(shù)查詢預(yù)約訂單詳情的回調(diào)函數(shù)，獲取訂單詳情內(nèi)容，并展示到界面中iniCountDown函數(shù)通過對比系統(tǒng)時間與訂單詳情中的確認(rèn)超時時間，實現(xiàn)倒計時功能，并在倒計時結(jié)束時處理一些UI。預(yù)約列表界面（MyReservationActivity.java）rqServer函數(shù)構(gòu)造預(yù)約列表請求接口json參數(shù)。submitCallBack函數(shù)預(yù)約列表接口http回調(diào)，獲取到數(shù)據(jù)后，填充列表，并利用系統(tǒng)時間與預(yù)約中的數(shù)據(jù)項中超時時間對比，實現(xiàn)倒計時。rqOrdercancelServer函數(shù)構(gòu)造預(yù)約取消接口的請求json參數(shù)ApplyCancelCallBack函數(shù)預(yù)約取消的接口回調(diào)，提示用戶預(yù)約取消成功充電流程詳細(xì)設(shè)計進(jìn)入掃碼或手動輸入二維碼，進(jìn)入站點確認(rèn)信息，然后選擇充電方式后，發(fā)起充電申請并進(jìn)入等待插槍界面，當(dāng)監(jiān)控到充電狀態(tài)發(fā)生變化，會實時跳轉(zhuǎn)到充電中監(jiān)控界面并定時查詢最新狀態(tài)，最后充電完成后可以到充電列表中查看歷史數(shù)據(jù)。二維碼掃碼界面（CaptureActivity.java）、手動輸入二維碼（InputCodeEncodingActivity）rqServer函數(shù)構(gòu)造充電