How The Wap Push Library Implements Papthe Wap Push Library Is A Java Package That Encapsules All of the XML and
Multipart / Related Message-Building Functionality Into a Series of classes. when You
Use the Wap Push Library, The Implementation Details of Pap Are Hidden. you
Don't Need to Know How To Build A Push Submission or Any Other Pap Operation To
Use the wap push library. You do need to know how pap works so that you can
Construct Push Messages and Handle Responses from the PPG, But you don't need
To know the details of building or parsing the necessary XML or Multipart / Related
Documents.
System Configuration Requirements
Before you attempt to send content using the wap push library, make sure what
Your Corporate FireWall Allows you to send packets to the desired ports on the
PPGS you are using. The mechanisms for client addressing and the ports That the
PPG Listens On Are Implementation Specific. For Specific Information, Check with
The PPG Administrator At The Communication Service Provider You Intend To Use.
PAP Operations
Table 4-1 Lists The Wap Push Library Classes That
Table 4-1. Pap Operations and WAP Push Library Classes
PAP Operation WAP Push LibraryPush Submission PushMessageStatus QueryStatusQueryMessagePush Capabilities Query CCQMessage
Push Submission Content Types
As with PAP Operations, A WAP PUSH LIBRARY CLASS ENCAPSULATES EACH PUSH
Submission Content Type. Table 4-2 Lists the content type and the corresponding
WAP Push Library Classes.
For Descriptions of the Content Types, See "Push Submission Content Types" ON
Page 19.
Note OpenWave Is Developing New Push Submission Content Types. Check The
OpenWave Developer Web Site
Http://developer.openwave.com) for the lateinformation.
Table 4-1. Pap Operations and WAP Push Library Classes
PAP Operation WAP Push Library Class
Push Submission PushMessage
Status Query StatusQueryMessage
Push Cancellation CancelMessage
Client Capabilities Query CCQMessage
Table 4-2. Push Submission Content Types and WAP Push Library Classes
Content Type WAP Push Library ClassService IndicationService Indication Service LoadingServiceLoading Cache Operation CacheopertyCustom Content CustomContent
Extracting PPG and Client Addresses from PPG Headers
You can Extract The PPG and Client Addresses from The Http Headers Returnedwith Any Request from the PPG. You Can Use this Information Dynamically in WAP
Push Library Applications Or in Other Applications That Are Devoted to Building Lists
Of Users Who Visit Your Wap Sites. The Following
Http Headers Returned from theppg contain this information.
• X-Up-Subno The Address of The Client • X-Up-Uplink The Address of The OpenWave MAG, IF Connected • X-Up-Wap-Push-Secure Secure (HTTPS) PPG Address • X-Up-Wap-Push -Unsecure nonsecure (Standard HTTP) PPG Address
Secure Versus Nonsecure PPG Addresses
The PPG Infrastructure Supports Both Secure (HTTPS) and Nonsecure (Standard)
HTTP) Connections. The Wap Push Library Supports Both Connection Types
TRANSPARENTLY. The Only Difference Is The PPG Address Itself.
A Nonsecure Connection Is Ideally Suited for Initial Application Testing Because IT
Does Not Introduce Any Additional Complexity. a Secure Connection is offen
Desirable, But Does Impose Some Constraints in The Form of Server and Client
Certificate. There are two iesses to consider:
• The Server Certificate is not issued by A Well-KNown Certificate Authority (CA) .server certificates from Well-KNown Ca Do Not Generally Pose Any Diffulties.
CERTIFICATES ADDED to the list of trusted
Certificates on the client. this is generally true of ppg test installs.
To addthe server certificate to the list of trusted certificates on the client, follow thesesteps: 1 Copy the server certificate to the client machine2 Save the server certificate to a file3 Install the server certificate on the Java client • The PPG is configured to require client ( Application) Authentication, in which
Case ONLY CERTAIN PUSH INITORS HAVE Access To Secure Connections on The PPG.
In this case, the ppg is configured to request the client certificate during the
SSL Handshake Process, Something Not Normally Required During https
Communication Using A Web Browser. To satisfy The PPG Request, The Client
Must Have An Appropriate Client Certificate Installed to Access The PPG Using A
Secure connection.
• The PPG IS Configured to Require Client (Application) Authentication, in which
Case ONLY CERTAIN PUSH INITORS HAVE Access To Secure Connections on The PPG.
In this case, the ppg is configured to request the client certificate during the
SSL Handshake Process, Something Not Normally Required During https
Communication Using A Web Browser. To satisfy The PPG Request, The Client
Must Have An Appropriate Client Certificate Installed to Access The PPG Using A
Secure connection.
MultiCasting
The Wap Push Library Supports Delivery of a Single Push Submission To Multipleclient Add Multicasting, Saves Enormous Time and Efforts
WHENEVER You Want To Deliver a General Message To All Or Part of A Subscriber Base.Use T
PushMessage.addaddress method to build the desired List of recipients for a
Push Submission. The Push Submission Can Deliver Any of The Available Content
Types as itload.
