第8章 网络预付费水电管理.pptVIP

8.1 预付费接口概述　　本章仍以江南大学的应用为例。其网络预付费水电管理接口以网络预付费水电管理系统(以下简称CPES系统)为基础，针对高级用户需求定制一套第三方应用接入解决方案。它在原有CPES系统上，设计了灵活而又开放的网络预付费水电管理机制，并为用户提供高强度安全可靠的应用接入开发接口，使用户能够在享受强大安全性的同时，可以根据自己需要更加灵活地实现预付费水电管理相关查询、买电(水)、退电(水)等服务。　　网络预付费水电接口具有如下功能特点。 　　1．高效灵活的应用接入　　网络预付费水电管理接口采用XML方式进行用户信息查询，以及采用Web Service方式进行预付费水电业务操作。为用户提供的基于HTTP通讯的应用开发接口，在适应各类开发平台的接入上高效而又灵活。利用这个接口业务系统可以与CPES系统进行以SSL安全通讯为基础的身份验证，认证通过后建立安全连接并进行业务操作。图8-1是网络预付费水电管理接口的应用框架图。 　　2．多应用平台支持　　网络预付费水电管理接口能同时支持C/S及B/S的应用开发。支持包括?.Net平台、J2EE平台、Apache + PHP、IIS + ASP等。同时对于未知平台的客户端开发，予以充分配合和支持。 　　3．全方位安全性保障　　网络预付费水电管理接口在三个方面提供了安全性保障：　　(1) 采用2048位加密处理的SSL安全通讯，保证了用户的数据的安全和私密；　　(2) 使用绑定IP地址的专用预付费账户进行接口访问的HTTP认证；　　(3) 详细记录网络预付费水电管理接口业务操作的审计日志，以便分析业务是否存在异常，追溯业务操作。 8.2 网络预付费水电管理接口说明　　网络预付费水电管理接口主要分两部分：XML接口和WebService接口。　　XML接口提供了根据学(工)号检索CPES系统中所属电(水)表位置信息及开户号信息的功能，为实现第三方网络预付费水电管理的基础。　　WebService接口提供了根据开户号操作CPES系统中所属电(水)表的功能，为实现第三方网络预付费水电管理的业务整合。　　XML接口与WebService接口的关系如图8-2所示。 　　1．XML接口　　1) 接口访问路径　　访问路径为　　http[s]:// +实际系统IP地址+/project/CPES/fwp/soap/accountList.fwps?stuno=学(工)号 　　2) 接口返回格式　　接口返回XML如下：　　?xml version=‘1.0’ encoding=‘UTF-8’ standalone=‘no’?　　AccountList　　 Item　　 AccountID1001/AccountID　　 FullNodeName学生公寓.15栋.101室/FullNodeName　　 /Item　　 Item　　 AccountID1002/AccountID　　 FullNodeName学生公寓.15栋.102室/FullNodeName　　　　 /Item　　/AccountList 　　上述结果表明该学工号所属电(水)表有两个房间。其中，“学生公寓.15栋.101室”对应的电(水)表开户号为“1001”；“学生公寓.15栋.102室”对应的电(水)表开户号为“1002”。 　　2. ?WebService接口　　1) 接口访问路径　　WSDL路径为　　http[s]://+实际系统IP地址+/project/CPES/fwp/soap/CPES.wsdl　　2) 接口操作方法　　(1) 查询当前累计电(水)量。　　接口函数：double GetTotal(int AccountID)；　　参数说明：AccountID(输入)为电(水)表对应的开户号；　　返回结果：当前累计电(水)量。 　　(2) 查询当前剩余电(水)量。　　接口函数：double GetBalance(int AccountID)；　　参数说明：AccountID(输入)为电(水)表对应的开户号；　　返回结果：当前剩余电(水)量。　　(3) 买入电(水)量。　　接口函数：int DoBuy(int AccountID，double Money)；　　参数说明：AccountID(输入)为电(水)表对应的开户号；　　 Money(输入)为买入电(水)量对应的金额；　　返回结果：0—表示成功，1表示失败，返回具体错误代码。 　　(4) 退还电(水)量。　　接口函数：int DoSell(int AccountID， double Money)；　　参数说明：AccountID