专注于blackberry » push

故技重施：Blackberry Push API

Taigoo — Mon, 29 Jun 2009 11:46:20 +0000

大概是6月初，RIM以很强的声势推出一个新服务，名曰Blackberry Push API。在没有看文档前，我非常憧憬RIM能给我们带来惊喜。但是我看完之后，发现RIM仅仅把原来的技术重新包装了一遍。

从商业的角度讲，我非常赞成RIM的这种做法，现在的很多新概念有很多都是把N年以前的东西拿出来翻新一下，例如AJax，SaaS等，都取得了不错的效果。

但是从技术角度上讲，也确实没什么。

我将该服务总结为一句话，即将Blackberry最具特色的PUSH功能应用到客户的需求上。

即便如此，我还是将我N年以前使用过的技术重温一下，顺便也说说PUSH API 的应用。

应用背景：

先举个例子，未必是真实的。假如上海有家出租车公司小众（不是大众），要通知司机小张，有个客户在人民广场的来福士广场有个客户于14：00需要车，那么小众通过何种方式将这个信息传给小张呢?假如小众公司正在使用Blackberry的服务，那么可以通过Alert的方式来实现。

现在总结一下：

alert
新闻
财经
定单
文档
体育

服务不仅仅限于上面。

原理：

先看张图

简要解释一下：

先解释身份角色：

Push Initiator：相当于小众公司，后面见车简称PI

Blackberry Push Data Server：相当于部署在小众公司的Blackberry服务基础架构，后面简称BPIS

Mobile Client：司机小张的Blackberry终端，简称，MC

再解释一下流程：

PI发送一个push请求，即客户信息
BPIS给出一个返回给PI
BPIS就请求push给MC
MC收到后给出一个ACKnowledge，确认
BPIS给PI一个通知
PI收到后给BPIS一个返回

类似的机制和互联网的三次握手类似，就是Request/ACK/Response.目的就是为了保证大家都收到。

优点

很显然，省电，能够及时送达，安全，包括传送，以及安全送达。

实现

PAP
XML HTTP 请求
几种push，例如submit，cancel，query等，具体技术细节不讲，因为这些又可以单独拿出来了。

综合上述，如果您熟悉PUSH，是不是觉得似曾相识呢。

不管怎么说，从中，我们可以进一步，也更清晰了解Blackberry PUSH这个概念。这在以后的解决方案中提供不少思路。

尚邮（Shangmail)使用评论

Taigoo — Sun, 07 Sep 2008 14:22:24 +0000

我很少对一个软件做出特别详细的评论，但是尚邮Shangmail我想我有必要做一下评论，发表一下我的使用经验和建议。

尚邮Shangmail是国内在Blackberry平台上提供push mail的服务。由北京一家刚成立的巴别塔运营,老板是严天亦女士。很早了解尚邮shangmail是因为其下面的某位员工,通过他我才详细知道尚邮Shangmail这个产品。

现在，针对Blackberry的版本已经是4.3版本了。我使用了一下，感觉还可以。下面详细介绍一下我的使用经历。

安装和使用

下载Service Book

发送email，必须下载service book，这是每个稍有点Blackberry常识的人都知道的。可以到下面链接去下载。通过Blackberry Desktop Manager里的备份和恢复功能来安装Service Book。http://www.shangmail.com/servicebook.zip

下载Shangmail安装软件

下载Blackberry的shangmail版本。请到这里http://www.shangmail.com/download.html下载。如果直接是通过blackberry下载，请访问http://wap.shangmail.com来下载。确定你的手机型号啦。

配置你的邮箱

访问http://www.shangmail.com/register.html注册，如果已经有帐号的话直接登录。里面有个邮箱管理的选项，最多可以添加2个帐号。按理论上支持所有POP3和IMAP的邮箱都。如果你配置的邮箱有特殊之处，请点击下面的显示服务器的checkbox,然后开始配置邮箱。我配置的是SOHU和Gmail的邮箱。SOHU用起来真是不错，但是Gmail刚开始只能发不能收，昨天终于解决了。文章后面给出一些方法以及原理。

打开Shangmail，出现如下界面。

然后打开菜单，出现如下界面:

这里我的已经是登录过的。

如果没有登录过的，会提示让你登录。

接收邮件和发送邮件

接收的邮件会自动放在消息里面，与短消息一起存放。

发送消息还是按照BB的发送操作一样，打开消息，打开菜单，选择Compose Email即可。

接收到的邮件如下：

编辑邮件如下：

发送成功后的邮件如下：

Setting

如下图

Accounts

Configure

Filters

Working Time

Setting

Pim Setting

Change Password

统计

统计流量，收发邮件数

其实蛮简单的啦。中间最难的是配置邮件。

经验

如何配置Gmail

网上关于配置Gmail的文章很多，但是我认为很多文章没有说到要点。

我关注shangmail很长时间了，而且一直试用。遗憾的是我真没有成功收到过gmail的邮件。昨天我决定将之解决掉。还是老办法配置gmail。遗憾的是仍未成功。

官方Gmail的配置方法如下（这是正确的,但不够详细）:

Gmail邮箱的添加同样是以开通pop功能为前提的: 在“设置”->“POP和转发”选项中开启Gmail的POP功能
开通pop后，配置信息如下：
pop: pop.gmail.com，端口是995，
smtp：smtp.gmail.com，端口是465。
PS: 发送/接收服务器端口都需要勾选SSL验证。

网上有网友成功过，既然别人能成功，为什么我不能成功呢？纳闷。看了shangmail的官方说明：

8.为什么有时候我的网易、QQ和Gmail邮箱收邮件很慢？
因为网易邮箱的特殊性，尚邮服务器放缓了访问频率；
QQ邮箱服务器与尚邮服务器是网通VS电信的关系，因此通讯速度非常慢，经常出现连接超时的情况。
Gmail邮箱因为是国外的服务器，而且需要建立SSL连接，再加上Gmail邮箱服务器对取信频率设了限，因此您可能会遇到通讯时间比较长有时甚至暂时性被封的情况。

我对此深表怀疑，理由如下：

既然Google推出了POP和IMAP服务，也就证明客户端例如outlook是可以用的，如果设置取信的频率，这是自己打自己嘴巴。
为什么国外的BIS一点问题也没有呢？也许是因为人家大公司和Gmail合作，才不会设置取信频率，但是这样有理由吗？目前我对Google的理解，应该不会吧。
在查找相关资料的时候，找到了另外一家小公司，也推出类似的服务，Consilient，既然人家收取gmail一点问题都没有，所以我相信这不是gmail的问题。因为如果Google真的有取信频率的问题，那么这家小公司怎么可能有特殊服务呢？即使和google有合作协议，这也是需要大把money的。何况google目前好像没有这方面的服务吧。（有没有，我真不太确定，但是我个人觉得没有

基于上面的分析，我觉得不是google的问题，很有可能是shangmail或我的问题。

我确认了一下gmail的配置，没错。我想应该是我的问题。我到Gmail的设置里看了一下，pop是对的呀。

偶然，我发现consilent说Gmail需要将POP打开，而且选择的是第二项，但我选择的是第一项。于是我选择了：

Enable POP for mail that arrives from now on

OMG，成功了。NND，为什么大家都不说清楚呢，怎么每篇文章都没有仔细介绍呢。

这里说明几个问题：

上面说的取信频率问题也许不对
gmail的pop的2种设置真有猫腻
shangmail的解释不太聪明。

PS，有网友说使用IMAP，说实话我也测试过，遗憾的是我没有成功。真是要请教高人了。

优点：

发送邮件相当迅速，而且稳定
能非常完美的和Blackberry的address book结合起来。可以智能的输入姓名然后得到email地址，另外可以显示邮件的联系人姓名。其实这是blackberry自己的功能，和shangmail无关，但是shangmail能和address book结合起来实现这些功能，已经就很不错了。
可以设置多个邮箱，类似BIS服务，很棒
可以设置工作时间，这个有些BIS就没有，比如AT&T
下载附件很棒
收发邮件看起来稳定，不过收邮件还得继续确认。

缺点：

每个人都喜欢挑刺，我也不例外：

不喜欢在Home界面上多个图标，直接放在Options里面，据我的经验，还真有点小麻烦，但这不是问题
这个停止和重新启动服务感觉不太方便
收邮件服务不太稳定
有时会重新获取同一邮件几次
耗电量太多
LED flash有时候还有问题
有时重新reboot机器，配置消失
邮件加密。也许是技术原因吧。据我说了解，BES采取的是3DES和AES加密算法。
提供直接退出的功能。这个家伙只要一进来，就没法退出了，当然直接删除是可以的。
强烈建议优化程序，减少占用资源。
用户体验有待改进。动不动来个Operation Done，或者Protocal Error的pop up dialog。
Server端用户中心的邮箱管理，使用ssl验证始终是否，bug！！！！。

优点和缺点就这么多。总体感觉不错，打70分吧。

Shangmail不是真正上的push mail

Shangmail不是真正上的push mail，按照常规理解，一般都是把RIM的那套解决方案作为PUSH MAIL的权威。但是它那套实现起来还真有点费大力气，一是自己提供的服务，例如BES，或者BIS。二是需要移动运营商的大力配合。第一个相比之下好解决一些，第二个恐怕不是大公司，人家都懒得甩你。打个比方说，你跟移动说，“哥们，我今天想跟你合作推出xxx服务”，移动回答”，你是谁呀？“，开个玩笑啦。

至于shangmail为什么不是真正意义上的push mail，只是实现了push mail的表面现象？我在以后的文章中详细介绍。因为那可是一门高深的学问，而且关系到很多方面。

Shangmail的客服

我曾经在Shangmail的论坛上发个几个帖子，不得不说人家客服回答很及时，我很欣赏，也很感动。

可能因为各方面的原因吧，有些问题就是不能有效解决。其实我们也很理解，毕竟有些连开发人员都不清楚,客服不能解决也在常理之中。总的来说，客服基本上可以解决大部分问题，只有极少数不能解答，这已经非常棒了，而且人家服务态度很不错了。所以，感谢他们啦，例如VickyWu。不知道VickyWu是不是shangmail的员工，要是不是我真是丑大了，:)

更新：

使用感言

经过1个礼拜的试用，收发email都不错，一般在2分钟之内搞定。赞一个。

BlackBerry 应用程序开发者指南第一卷：基础–第10章创建Client/Server Push应用程序

Taigoo — Tue, 22 Apr 2008 22:44:14 +0000

第10章创建Client/Server Push应用程序

Push应用程序

Client/Server push请求

编写一个客户端push应用程序

编写一个服务器端push应用程序

Push应用程序疑难解答

Push应用程序

注：Push应用程序需要3.5以及后续版本的Microsoft Exchange BES，或2.0以及后续版本的IBM Lotus Domino BES，它们需启用BlackBerry MDS服务。

Push应用程序将新的web内容和alert发送到指定的用户。用户不必请求下载数据，因为当信息可用时push应用程序递送这个信息。

有2种push应用程序：

1. 浏览器 push应用程序：将Web内容发送到BlackBerry设备上。BlackBerry 浏览器配置支持MDS服务push应用程序。WAP浏览器配置支持WAP push应用程序。Internet浏览器配置不支持push应用程序。参看BlackBerry浏览器开发指南获取更多关于编写一个浏览器push 应用程序的信息。

2. Client/Server push应用程序：将数据push到一个BlackBerry设备上的客户Java应用程序。Client/Server push应用程序由一个BlackBerry设备上的客户Client应用程序和一个push内容给它的服务器端应用程序组成。和浏览器push应用程序相比，这种方法对这种你可以发送出去的内容以及数据是如何处理并且显示在BlackBerry设备上提供了更多的控制。

Client/Server push请求

应用程序可以使用下面的2种方法将内容push到BlackBerry设备：

1. Push Access Protocol（PAP，push访问协议），它是WAP 2.0里的一部分。

2. RIM push。

注：MDS服务仅支持1000个 push请求，包括了RIM和PAP push请求。如果它接收超过1000个请求，MDS服务回应服务器一个错误。

这2种push服务的实现都支持下面的任务：

发送一个服务器端push提交（submission）。
为push提交指定一个信任的模式。
为push提交指定一个传递前（deliver-before）的时间戳。
请求一个push提交的结果通知。

PAP的实现还支持下面额外的任务：

为push提交指定一个传递后（deliver-after）时间戳。
取消一个push请求提交。
查询一个push请求提交的状态。

存储push

PAP push存储在数据库中，但是RIM push则存储在RAM中。如果服务器重启，没有递送的RIM push可能会丢失。

代码转换（Transcoding）

如果可用，BlackBerry MDS Data Optimization（BlackBerry MDS数据优化）根据它的代码转换器规则将一个代码转换应用到push请求。

Push请求可以覆写这些规则并使用transfer-encoding头来请求一个指定的代码转换器转化。例如，如果设置了HTTP头transfer-encoding：vnd.wap.wml，那么在它把数据push到BlackBerry设备之前，MDS数据优化服务运行wml代码转换器。

参看190页的“代码转换器”获得更多信息。

信任模式

描述

透明层信任模式

当push到达BlackBerry设备时，BlackBerry MDS连接服务启动一个push请求指定的URL连接来通知传送的服务器。手持设备软件3.6或以后版本支持透明层确认。

应用程序级信任模式

当push到达BlackBerry设备时，应用程序确认内容。MDS连接服务启动一个push请求时指定的URL连接来通知传送的服务器。如果遇到错误，MDN连接服务发送一个错误消息到服务器。手持设备软件4.0或以后版本支持应用程序级确认

RIM push提供一个优先应用程序（Application-preferred）的选项,在手持设备软件4.0或以后版本中，它使用应用程序级确认，否则就是透明层确认。

注:3.8以及更早版本的MDS 服务不可以为BlackBerry设备特征查询BES。为了得到BlackBerry设备的特征，MDS连接服务必须在它接收到一个push请求之前接收到一个HTTP请求。

为了提供必要的请求，使用BlackBerry浏览器和一个MDS服务浏览器配置浏览一个web页面。

发送一个RIM push请求

为了使用RIM push将数据push到BlackBerry设备上，使用下面的格式发送一个HTTP POST请求，在这里是目的PIN或者internet消息地址，是目的端口，是发送到BlackBerry的URI，是字节流：

/push?DESTINATION=&PORT=&REQUESTURI=

对于RIM push请求，下列的头是有效的：

HTTP头	描述
X-RIM-Push-ID	这个头指定了一个唯一的消息ID，它可以用来取消或检查消息的状态。典型地，以一个值组合指定URL，例如123@blackberry.com.如果忽略这个头，MDS服务生成一个唯一的消息ID. 注:Push标识符不得以@ppg.rim.com结束。
X-RIM-Push-NotifyURL	这个头指定一个URL来发送一个结果通知。这个结果通知包含了指定的消息ID的X-RIM-Push-ID头，以及指定HTTP响应代码的X-RIM-Push-Status头。
X-RIM-Push-Reliability-Mode	这个头指定了内容透明级(TRANSPORT),应用程序级(APPLICATION)或优先应用程序（APPLICATION-PREFERRED）的传送信任模式。
X-RIM-Push-Deliver-Before	这个头指定将内容传送给BlackBerry设备的日期和时间。在这个时间之前没有传送的内容不会被传送。
X-RIM-Push-Priority	这个头指定了频道push消息的优先级。允许的字符串有none(缺省)，low,medium，以及high.如果优先级为low,medium或high,用户接收频道更新的通知。如果优先级为high，一个状态对话框会伴随着通知。

发送一个PAP push请求

为了使用PAP将数据push到BlackBerry设备，使用下面的格式发送一个HTTP POST请求：

/pap

这个请求是一个MIME多部分（multipart）的消息，它由下面的项组成：

一个指定控制实体（entity）XML文档。
push内容。

例如，控制实体可能包含BlackBerry设备地址，消息ID，以及传送时间戳信息。

使用PAP DTD(Document Type Definition)指定下面的属性：

XML控制实体属性	描述	实例
X-Wap-Application-Id	这个实体属性指定了RIM push的REQUEST URI HTTP同等体。	“/”
push-id	指定唯一的消息ID.另外，这个控制实体属性可以用来取消或检查消息的状态。建议你在一个值的组合里使用一个URL，例如，123@BlackBerry.com.	123@wapforum.org
ppg-notify-requested-to	指定发送结果通知的URL.	http://wapforum:8080/ ReceivePAPNotification.
deliver-before-timestamp	指定日期和时间，通过它将内容传送到BlackBerry设备。这个时间之前的没有发送的内容将会丢失。以UTC格式显示时间: YYYY-MM-DDThh:mm:ssZ 在这里： YYYY是4个数字的年份。 MM是2个数字的月份。 DD是2个数字的日期。 hh是2个数字的24小时制式的小时。 mm是2个数字的分 ss是2个数字的秒 Z描述了时间是UTC格式。	2004-01-20T22:35:00Z
deliver-after-timestamp	指定日期和时间，在这个时间之后的内容发送到BlackBerry设备。这个时间前的内容不会被传送。以UTC格式显示日期与时间.	2004-01-20T21:35:00Z
address-value	指定将PUSH内容发送到BlackBerry设备的地址。destination是目的internet 消息地址或PIN.	WAPPUSH=destionation%3Aport1/ TYPE=USER@blackberry.com
Delivery-method	指定内容，透明级，或应用程序级的传送信任模式	Confirmed;uncomfirmed

参看Push Access Protocol(WAP-247-PAP-20010429-a)文档获取更多关于使用PAP编写服务器端push用用程序。参看PAP 2.0 DTD得到关于WAP Push DTD的信息。

例: PAP push request

Content-Type: multipart/related; type="application/xml"; boundary=asdlfkjiurwghasf

X-Wap-Application-Id: /

–asdlfkjiurwghasf

Content-Type: application/xml

<pap>

<push-message push-id="a_push_id" ppg-notify-requested-to="http://foo.rim.net/ReceiveNotify">

<quality-of-service delivery-method="unconfirmed"/>

push-message>

pap>

–asdlfkjiurwghasf

Content-Type: text/html

<html><body>Hello, PAP world!body>html>

–asdlfkjiurwghasf–

发送PAP push取消请求

使用下面的头取消一个已经发送到MDS 服务的push提交。

头

描述

实例

cancel-message push-id

取消前面提交的push消息。

123@wapforum.org>

address address-value

指定push消息提交的地址。这个标记是

必需的。

rry.com%3A7874/TYPE=UER@rim.net/>

例：PAP push取消请求

Content-Type: application/xml

"http://www.wapforum.org/DTD/pap_2.0.dtd">

<pap>

<cancel-message push-id=“a_push_id">

<address address-value=

“WAPPUSH=aisha.wahl%40blackberry.com%3A7874/TYPE=USER@rim.net“/>

cancel-message>

pap>

发送一个PAP push查询请求

为了查询已经发送到MDS服务的push提交的状态，使用下面的头：

XML控制实体属性

描述

实例

statusquery-message push-id

指定push消息的哪个状态是需要的。

返回的响应是下面消息状态之一：delivered,pending,undelivered,expired,rejected,timeout,cancelled,aborted或unknown.你必须在请求里包含地址属性。

123@wapforum.org>

address ddress-vue

指定一个提交的push消息地址。这个标记是必需的。

net”/>

Content-Type: application/xml

"http://www.wapforum.org/DTD/pap_2.0.dtd">

<pap>

<statusquery-message push-id="a_push_id">

statusquery-message>

pap>

决定BlackBerry设备是否在push覆盖范围内

为了从MDS服务接收某个特定BlackBerry设备的网络覆盖信息，指定下面的头：

XML控制实体属性

描述

实例

x-rim-use-coverage

设置true来接收网络覆盖信息，push消息的状态是必要的。

注：这个头典型用来决定网络覆盖，优先于发送一个push请求。

address address-value

指定BlackBerry设备的地址来决定网络覆盖。

%3A7874/TYPE=USER@rim>net”/>

例:RIM网络状态查询请求

Content-Type: application/xml

"http://www.wapforum.org/DTD/pap_2.0.dtd">

<pap>

<rim-push-use-coverage="true" push-id="a_push_id" \>

pap>

例:RIM网络状态查询响应

Content-Type: application/xml

"http://www.wapforum.org/DTD/pap_2.0.dtd">

<pap>

<x-rim-device-state="true">

a response of true means the device is in network coverage –>

rim-push-use-coverage>

pap>

编写一个客户端push应用程序

创建一个监听线程

在独立线程上发送和接收数据，这样你不会在主事件线程上阻塞。

打开一个输入连接

调用Connector.open(String),并让http://作为协议，选择大端口号。将返回的对象转化为一个StreamConnectionNotifier。

打开连接一次，并保持其连接状态为打开。仅当IOException发生时，重新打开连接。每次push的数据接收到时，不要关闭和重新打开连接，因为在前一个push后，如果再调用Connector.open()之前数据就到达了，push的数据会丢失。

为避免和其他程序冲突，选择一个大的端口号，端口号必须是1到65535。端口7874为BlackBerry浏览器保留。

StreamConnectionNotifier _notify =

(StreamConnectionNotifier)Connector.open("http://:6234");

// open a server-side socket connection

StreamConnection stream = _notify.acceptAndOpen();

// open an input stream for the connection

InputStream input = stream.openInputStream();

关闭流连接通知

调用流连接通知上的close()方法.

_notify.close();

代码实例

HTTPPushDemo.java实例描述了如何编写一个应用程序监听来自服务器的进入数据。创建一个监听线程监听指定端口的图像数据，当数据到达时，然后显示它。

例: HTTPPushDemo.java

/**

* HTTPPushDemo.java

package com.rim.samples.docs.httppush;

import java.io.*;

import javax.microedition.io.*;

import net.rim.device.api.ui.*;

import net.rim.device.api.ui.component.*;

import net.rim.device.api.ui.container.*;

import net.rim.device.api.i18n.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import com.rim.samples.docs.baseapp.*;

public class HTTPPushDemo extends BaseApp {

// Constants.

private static final String URL = "http://:6234";

private static final int CHUNK_SIZE = 256;

// Fields.

private ListeningThread _listeningThread;

private MainScreen _mainScreen;

private RichTextField _infoField;

private BitmapField _imageField;

public static void main(String[] args) {

HTTPPushDemo theApp = new HTTPPushDemo();

theApp.enterEventDispatcher();

}

/**

* * Create a separate listening thread so that you do not

* * block the application’s main event thread.

* */

private class ListeningThread extends Thread {

private boolean _stop = false;

private StreamConnectionNotifier _notify;

public synchronized void stop() {

_stop = true;

try {

_notify.close(); // Close the connection so thread returns.

}

catch (IOException e) {

System.err.println(e.toString());

}

catch (NullPointerException e) {

// The notify object likely failed to open, due to an IOException.

}

public void run() {

StreamConnection stream = null;

InputStream input = null;

try {

synchronized(this)

{

// Open the connection once or re-open after an IOException.

_notify = (StreamConnectionNotifier)Connector.open(URL);

}

while (!_stop) {

// NOTE: This method blocks until data is received.

stream = _notify.acceptAndOpen();

input = stream.openInputStream();

// Extract the data from the input stream.

DataBuffer db = new DataBuffer();

byte[] data = new byte[CHUNK_SIZE];

int chunk = 0;

while ( -1 != (chunk = input.read(data)) ) {

db.write(data, 0, chunk);

}

input.close();

data = db.getArray();

updateBitmap(data);

}

catch (IOException e) {

System.err.println(e.toString()); // It is likely the stream was closed.

}

// Constructor.

public HTTPPushDemo() {

_mainScreen = new MainScreen();

_mainScreen.setTitle(new LabelField(“Latest Logos”, LabelField.USE_ALL_WIDTH));

_infoField = new RichTextField();

_mainScreen.add(_infoField);

_mainScreen.add(new SeparatorField());

_imageField = new BitmapField(null, BitmapField.HCENTER|BitmapField.TOP);

_mainScreen.add(_imageField);

_mainScreen.addKeyListener(this);

_mainScreen.addTrackwheelListener(this);

_listeningThread = new ListeningThread();

_listeningThread.start();

_infoField.setText("Application is listening…");

pushScreen(_mainScreen);

}

private void updateBitmap(final byte[] data) {

Application.getApplication().invokeLater(new Runnable() {

public void run() {

// Query the user to load the received image.

String[] choices = {"OK", "CANCEL"};

if ( 0 != Dialog.ask("Do you want to display latest logo?",choices, 0) )

{

return;

}

_infoField.setText("Image received. Size:"+ data.length);

_imageField.setBitmap(Bitmap.createBitmapFromPNG(data, 0,data.length));

}

});

}

protected void onExit() {

// Stop the listening thread.

_listeningThread.stop();

try {

_listeningThread.join();

}

catch (InterruptedException e) {

System.err.println(e.toString());

}

编写一个服务器端push应用程序

任何能够建立HTTP连接的编程语言都可以用来创建一个push应用程序。下面章节使用标准Java来描述一个服务器端的push应用程序。

构造push URL

像下面格式化RIM push请求:

/push?DESTINATION=&PORT=&REQUESTURI=

参看139页的“发送一个RIM push请求”获得更多关于构造RIM push请求的URL.

如下构造PAP push请求:

/pap

参看139页的“发送一个RIM push请求”获得更多关于构造PAP push请求的URL.

连接BES

在push URL上调用openConnection()，然后将返回的对象转化为一个HttpURLConnection.一个HttpURLConnection代表了一个远程对象的连接。

HttpURLConnection conn =(HttpURLConnection)url.openConnection();

为HTTP POST请求设置属性

服务器端push应用程序使用一个POST请求方法。

conn.setRequestMethod("POST"); // Post to the BlackBerry Enterprise Server.

为了接收确认，设置doInput(Boolean)为true，这描述了应用程序打算从URL连接读取数据。

conn.setDoInput(true).

为了发送数据，设置doOutput(Boolean)为true，这描述了应用程序打算发送数据到URL连接。

conn.setDoOutput(true).

写数据到服务器连接

调用getOutputStream()来访问一个输出流。写数据到输出流上，然后关闭它。

OutputStream out = conn.getOutputStream();

out.write(data);

out.close();

读取服务器响应

调用getInputStream()来访问一个输入流。决定内容的大小，如果它是非零，打开一个数据输入流，然后读取内容。

InputStream ins = conn.getInputStream();

int contentLength = conn.getContentLength();

if (contentLength > 0) {

byte[] someArray = new byte [contentLength];

DataInputStream dins = new DataInputStream(ins);

dins.readFully(someArray);

System.out.println(new String(someArray));

}

ins.close();

断开连接

调用disconnect()，它描述了应用程序对服务器不会再有请求。

conn.disconnect().

代码实例

HTTPPush.java实例，它由标准Java编写，发送单个.png图像到一个BlackBerry设备上的监听客户端程序。应用程序push基于一个internet消息地址的数据。为了用模拟器测试push应用程序，定义一个internet消息地址和模拟器PIN（2100000A）之间的映射。

下面的代码使用J2SE 1..4.2编译:

例: HTTPPush.java

* HttpPushServer.java

package com.rim.docs.samples.httppush;

import java.io.*;

import java.net.*;

import java.util.*;

public class HTTPPushServer {

//constants

private static final String HANDHELD_EMAIL = "scott.tooke@rim.com";

private static final String HANDHELD_PORT = "6234";

private static final String BES_HOST = "localhost";

private static final int BES_PORT = 8080;

private static final String CONTENT = "com/rim/docs/samples/httppush/logo.png";

//constructor

public HTTPPushServer() {

}

private static URL getPushURL(String HandheldEmail) {

URL _pushURL = null;

try {

if ((HandheldEmail == null) || (HandheldEmail.length() == 0)) {

HandheldEmail = HANDHELD_EMAIL;

}

_pushURL = new URL("http", BES_HOST, BES_PORT,

"/push?DESTINATION="+ HandheldEmail+"&PORT="

+HANDHELD_PORT+"&REQUESTURI=/");

}

catch (MalformedURLException e) {

System.err.println(e.toString());

}

return _pushURL;

}

public static void postData(byte[] data) {

try {

URL url = getPushURL(HANDHELD_EMAIL);

System.out.println(“Sending to” + url.toString());

HttpURLConnection conn = (HttpURLConnection)url.openConnection();

conn.setDoInput(true); //for receiving the confirmation

conn.setDoOutput(true); //for sending the data

conn.setRequestMethod(“POST”); //post the data to the BES

OutputStream out = conn.getOutputStream();

out.write(data); //write the data

out.close();

InputStream ins = conn.getInputStream();

int contentLength = conn.getContentLength();

System.out.println("Content length:"+ contentLength);

if (contentLength > 0) {

byte[] someArray = new byte [contentLength];

DataInputStream dins = new DataInputStream(ins);

dins.readFully(someArray);

System.out.println(new String(someArray));

}

ins.close();

conn.disconnect();

}

catch (IOException e) {

System.err.println(e);

}

public static void main (String args[]) {

try {

File f = new File(CONTENT);

if ( f == null ) {

throw new RuntimeException("Unable to Open File");

}

FileInputStream fi = new FileInputStream(f);

if ( null == fi ) {

throw new RuntimeException("Unable to open file");

}

int size = fi.available();

byte[] imageData = new byte[size];

int bytesRead = fi.read(imageData);

fi.close();

postData(imageData);

}

catch (IOException e) {

System.err.println(e.toString());

}

Push应用程序疑难解答

注：下面的情况适用于Microsoft Exchange BES.

Push应用程序对基于internet消息地址的BlackBerry设备进行标识，当用户换到另外一台不同的BlackBerry设备时，如果用户停止接收一个push应用程序的数据，

可能意味着用户internet消息地址和BlackBerry设备PIN之间的映射已经过期了。验证BES是否正确运行。

Microsoft Exchange BES的MDS服务特征使用了一个数据库一致工具（Database Consistency tool）,dbconsistency.exe，进行维护internet消息地址和BlackBerry设备PIN之间的映射。管理员可以配置这个工具运行的频率，并且也可以手动运行它。为获得更多信息，参看Microsoft Exchange BES维护指南。

Last Updated:2007年1月12日
Last Updated:2006年4月28日 created

专注于blackberry » push

故技重施：Blackberry Push API

尚邮（Shangmail)使用评论

安装和使用

经验

评论

Shangmail不是真正上的push mail

Shangmail的客服

使用感言

BlackBerry 应用程序开发者指南 第一卷：基础–第10章 创建Client/Server Push应用程序

第10章 创建Client/Server Push应用程序

Push应用程序

Client/Server push请求

存储push

代码转换（Transcoding）

发送一个RIM push请求

发送一个PAP push请求

发送PAP push取消请求

发送一个PAP push查询请求

决定BlackBerry设备是否在push覆盖范围内

编写一个客户端push应用程序

编写一个服务器端push应用程序

构造push URL

连接BES

为HTTP POST请求设置属性

Push应用程序疑难解答

BlackBerry 应用程序开发者指南第一卷：基础–第10章创建Client/Server Push应用程序

第10章创建Client/Server Push应用程序