搜索
诺基亚论坛WAPPush业务入门版本1.022001年12月12日DN0172295版本1.02版权©诺基亚移动电话2001年12月1(19)本文内容可未经通知而修改，且所说明的只是本文中规定的产品。本文旨在为诺基亚网络公司的客户使用，且只适用于本文须遵守的协议，未经诺基亚网络公司的事先书面许可，不得以任何形式或手段复制或传播本文的任何内容。本文为专业及受过适当培训的人员使用而备，使用时，客户承担一切责任。诺基亚网络公司欢迎客户提出意见，以助于本文得以继续发展和改进。关于提到的硬件或软件产品的适用性、能力或性能方面，本文中所述的信息或说明不具约束力，但应在诺基亚网络公司与客户所签协议中有规定。诺基亚网络公司已尽其昀大的努力来保证本文所述的说明准确且无实质性错误和疏忽。但是，如有必要，诺基亚网络公司可对本文中可能未涉及的问题加以解释。对于本文中的任何错误，诺基亚网络公司的责任只限于对其进行更正。诺基亚网络公司在任何情况下都不对本文中的错误或任何损坏、附带事件或后果（包括货币损失）负责任，尽管这些情况可能是因为使用本文件或其中信息而引起。根据相关法律，本文及其中介绍的产品受版权保护。诺基亚标志是诺基亚公司的注册商标。本文中提到的其它产品名称可能是其相应公司的商标，提到其产品的目的只为进行识别。版权©诺基亚公司2001。版权所有。2(19)版权©诺基亚移动电话DN0172295版本1.02目录1读者与范围....................................................................................42如何提交WAPPush业务提示(SI)...............................................52.1提交的内容是多段文件..................................................................72.2内容类型.......................................................................................72.3Puh-id...........................................................................................72.4源引用属性....................................................................................72.5业务提示参数................................................................................82.6回应...............................................................................................82.7PPG通知......................................................................................83库的使用.....................................................................................10参考文献11附录A.发送业务提示的简单servlet13附录B.发送业务提示的Stylesheet17版权©诺基亚移动电话3(19)1读者与范围本文是为致力开发移动业务的应用程序开发者编写的，并且这些移动业务采用了诺基亚ActivAlert和/或诺基亚Artuse网关来发送WAPPush业务提示。本文涉及的范围包括提供与向WAPPush代理网关提交Push请求有关的基本信息。本文不会替代任何其他的WAPPush资料或使这些资料被人遗忘。4(19)版权©诺基亚移动电话DN0172295版本1.022如何提交WAPPush业务提示(SI)需要发送WAPPush业务提示（SI）的业务应用程序应该首先向WAPPush网关（PPG）发送HTTPPOST。应用程序开发者应该注意：a.请求的正文格式：它必须遵从WAP规定的格式。b.鉴权：WAPPPG可能强行加入一些接入控制功能，并且对发往用户的SI的实际发送进行控制。c.PPG对通知的可能处理。下面将给出一个关于请求和通知的范例，并且将其中的关键部分加黑。下图给出了Push消息是如何从应用程序发送到PPG和终端的过程。版权©诺基亚移动电话5(19)7.应用程序服务器向WAP网关发送带有内容(WML网页)的1.应用程序发送WAPPush消息(XML)至Push代短信中心WAP网关应用程序服务器、L短信负荷IP负荷2.Push代理服务器网关发送WAPPush通知至SMSC3.SMSC发送通知至终端5.终端通过CSD/HSCSD/GPRS与WAP网6.WAP网关用Push通知消息向应用程序服务器发送带有URL的HTTP请8.WAP网关将内容(WML网4.终端收到通知并请求用户开始下载需要的内容下面是一个从应用程序到PPG之间提交业务提示的范例：POST/PGW/HTTP/1.1Authorization:Basicxyzabc123Content-type:multipart/related;boundary=multipart-boundaryUser-Agent:Java1.3.1Host:195.255.249.57:5080Accept:*/*Connection:keep-aliveContent-length:971--multipart-boundaryContent-type:application/xml?xmlversion=1.0?!DOCTYPEpapPUBLIC-//WAPFORUM//DTDPAP1.0//EN=NokiaPushInitiatorpush-messagepush-id=SomePushApp1013753552819source-reference=SomePushAppprogress-notes-requested=falseppg-notify-requested-to==WAPPUSH=+358454410926/TYPE=PLMN@null/quality-of-servicebearer-required=falsenetwork-required=falsedelivery-method=notspecifiedpriority=low//push-message/pap--multipart-boundaryContent-Type:text/vnd.wap.si?xmlversion=1.0encoding=ISO-8859-1?!DOCTYPEsiPUBLIC-//WAPFORUM//DTDSI1.0//EN==SomePushApp1013753552819action=signal-highcreated=2002-02-15T08:12:32ZSomePushApplication/indication/si--multipart-boundary--6(19)版权©诺基亚移动电话DN0172295版本1.022.1提交的内容是多段文件由于提交的SI是以多段文件形式呈现的，HTTPPOST的内容类型必须设置为相关的多段类型。其分界应该是不能在其它内容部分出现的线段。提交内容的每部分是以两个破折号加一段定义的分界线开始的。因此这部分的内容类型头（Header）紧跟在这部分的分隔符（Separator）之后。提交内容的昀后部分是以一个分隔符结束的，此分隔符为在分界线前后各有两个破折号。2.2内容类型必须注意提交内容的开始部分是“application/xml”类型，但实际的业务提示却是“text/vnd.wap.si”内容类型。2.3Puh-id应用程序能够产生一个push-id，此push-id可以用来唯一地识别提交内容。Push-id可以为任意字符串。应用程序产生的push-id可以基于应用程序的名称、日期和时间以及连续数字等。此相同的数字也可以用作SI的si-id。2.4源引用属性源引用属性可以用作识别应用程序过滤功能的方法。运营商和昀终用户能够禁止某些业务中的push消息。因此，必须与PPG的运营商协商确定此属性的内容。注意有些PPG要求应用程序在发送HTTP请求时，授予自己一个授权头（Authorizationheader）。此授权头包含了PPG运营商认可的应用程序或帐号的名称和密码。例如，可以用Java将授权头设置如下：URLConnectionconnection=_pgw.openConnection();connection.setRequestProperty(Authorization,Basicxyzabc123);版权©诺基亚移动电话7(19)2.5业务提示参数业务提示请求的实际参数如下列蓝色部分所示。这些通常是从一个请求变成另一个请求时的参数。提示接收者的MSISDN号码+358454410926是在pap请求之中。实际的SI包含一个具有URLahref属性的indication单元，例如。其它属性也不能忽视。终端用户能够看到indicationelement的文本文字，这些文字描述了什么内容将被SI下载，例如：SomePushApplication。2.6回应从PPG至提交的回应如下所示：HTTP/1.1202UnknownreasonServer:Netscape-Enterprise/4.1Date:Fri,15Feb200206:12:07GMTContent-type:application/xmlTransfer-Encoding:chunked?xmlversion=1.0?!DOCTYPEpapPUBLIC-//WAPFORUM//DTDPAP1.0//EN=NokiaActivAlertPushSubsystempush-responsepush-id=SomePushApp1013753552819reply-time=2002-02-15T06:12:08UTCresponse-resultcode=1001desc=Acceptedforprocessing/response-result/push-response/pap2.7PPG通知提交Push请求的应用程序可以要求PPG来通报Push消息的生命状态。这是通过设置一个URL的ppg-notify-requested-to属性来实现的，此URL指向一个能够处理通知的脚本语言程序（script）。实际的通知如下所示：8(19)版权©诺基亚移动电话DN0172295版本1.02?xmlversion=1