C# BlackBerry(tm) Push Service SDK

Terminology

Introduction
There are a number of terms used throughout the SDK – this section will try to explain what they all mean – it is also recommended that you refer to the RIM Push Service SDK documentation at https://developer.blackberry.com/services/push/

Push Initiator

The Push Initiator is the application that creates request messages (push request, cancel request, status-query request) and response messages (result-notification response) using the server-side library and submits them to the Push Proxy Gateway (PPG). Using the server-side library, the Push Initiator also processes subscription- related requests (subscribe, unsubscribe, suspend, resume) that it receives from the push-enabled application on the BlackBerry device.

Server-side library

The C# BlackBerry™ Push Service SDK contains the server-side library. The server-side library provides the APIs that the Push Initiator uses to facilitate all interactions with the PPG. The Push Initiator uses the server-side library to create push messages, status-query messages, and result-notification response messages in PAP XML format for delivery to the PPG. The Push Initiator uses the server-side library to process result- notification messages and status-query response messages that it receives from the PPG. The Push Initiator also uses the server-side library to process subscription- related requests, such as subscribe, unsubscribe, suspend, and resume requests, that it receives from the push-enabled application on the BlackBerry device.

Push Proxy Gateway (PPG)

The Push Proxy Gateway processes push request messages and status-query messages that it receives from the Push Initiator. Upon processing a push request message, the PPG sends a response message which communicates the overall outcome of the push message. The response message contains a result code or a PAP error code. The PPG can be the BlackBerry® Infrastructure or the BlackBerry® Enterprise Server.

Client-side library

The BlackBerry® Java® Development Environment 5.0 and later contains the client- side library. The client-side library provides the APIs that the push-enabled application uses to register or deregister with the PPG. The client-side library listens in the background for content received from the PPG. When content arrives from the PPG, the client-side library starts the push-enabled application if the application is not running.

Push-enabled application

The push-enabled application on the BlackBerry device sends subscription-related requests, such as subscribe, unsubscribe, suspend, and resume requests, to the Push Initiator. The push-enabled application uses the client-side library to register with the PPG and to listen for content, received from the PPG, in the background.

Last edited Jun 22, 2012 at 1:34 AM by DementedDevil, version 2

Comments

No comments yet.