javapns.notification

Class PushNotificationPayload

java.lang.Object

javapns.notification.Payload

javapns.notification.PushNotificationPayload

Direct Known Subclasses:

PushNotificationBigPayload

public class PushNotificationPayload
extends Payload

A payload compatible with the Apple Push Notification Service.

Author:

Maxime Peron, Sylvain Pedneault

Constructor Summary

Constructors

Constructor and Description
PushNotificationPayload(String alert, int badge, String sound) Create a payload and immediately add an alert message, a badge and a sound.

Method Summary

Modifier and Type	Method and Description
void	addAlert(String alertMessage) Add a simple alert message.
void	addBadge(int badge) Add a badge.
void	addCustomAlertActionLocKey(String actionLocKey) Create a custom alert (if none exist) and add a custom text for the right button of the popup.
void	addCustomAlertBody(String body) Create a custom alert (if none exist) and add a body to the custom alert.
void	addCustomAlertLocArgs(List args) Create a custom alert (if none exist) and add sub-parameters for the loc-key parameter.
void	addCustomAlertLocKey(String locKey) Create a custom alert (if none exist) and add a loc-key parameter.
void	addSound(String sound) Add a sound.
static PushNotificationPayload	alert(String message) Create a pre-defined payload with a simple alert message.
static PushNotificationPayload	badge(int badge) Create a pre-defined payload with a badge.
static PushNotificationPayload	combined(String message, int badge, String sound) Create a pre-defined payload with a simple alert message, a badge and a sound.
static PushNotificationPayload	complex() Create an empty payload which you can configure later.
static PushNotificationPayload	fromJSON(String rawJSON) Create a PushNotificationPayload object from a preformatted JSON payload.
int	getMaximumPayloadSize() Return the maximum payload size in bytes.
void	setContentAvailable(boolean available) Sets the content available.
static PushNotificationPayload	sound(String sound) Create a pre-defined payload with a sound name.
static PushNotificationPayload	test() Create a special payload with a useful debugging alert message.

Methods inherited from class javapns.notification.Payload

addCustomDictionary, addCustomDictionary, addCustomDictionary, addCustomDictionary, asSimulationOnly, getCharacterEncoding, getExpiry, getPayload, getPayloadAsBytes, getPayloadSize, isEstimatedPayloadSizeAllowedAfterAdding, isPayloadSizeEstimatedWhenAdding, setCharacterEncoding, setPayloadSizeEstimatedWhenAdding, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PushNotificationPayload

public PushNotificationPayload(String alert,
                               int badge,
                               String sound)
                        throws org.json.JSONException

Create a payload and immediately add an alert message, a badge and a sound.

Parameters:

alert - the alert message

badge - the badge

sound - the name of the sound

Throws:

org.json.JSONException

Method Detail

alert

public static PushNotificationPayload alert(String message)

Create a pre-defined payload with a simple alert message.

Parameters:

message - the alert's message

Returns:

a ready-to-send payload

badge

public static PushNotificationPayload badge(int badge)

Create a pre-defined payload with a badge.

Parameters:

badge - the badge

Returns:

a ready-to-send payload

sound

public static PushNotificationPayload sound(String sound)

Create a pre-defined payload with a sound name.

Parameters:

sound - the name of the sound

Returns:

a ready-to-send payload

combined

public static PushNotificationPayload combined(String message,
                                               int badge,
                                               String sound)

Create a pre-defined payload with a simple alert message, a badge and a sound.

Parameters:

message - the alert message

badge - the badge

sound - the name of the sound

Returns:

a ready-to-send payload

test

public static PushNotificationPayload test()

Create a special payload with a useful debugging alert message.

Returns:

a ready-to-send payload

complex

public static PushNotificationPayload complex()

Create an empty payload which you can configure later. This method is usually used to create complex or custom payloads. Note: the payload actually contains the default "aps" dictionary required by APNS.

Returns:

a blank payload that can be customized

fromJSON

public static PushNotificationPayload fromJSON(String rawJSON)
                                        throws org.json.JSONException

Create a PushNotificationPayload object from a preformatted JSON payload.

Parameters:

rawJSON - a JSON-formatted string representing a payload (ex: {"aps":{"alert":"Hello World!"}} )

Returns:

a ready-to-send payload

Throws:

org.json.JSONException - if any exception occurs parsing the JSON string

addBadge

public void addBadge(int badge)
              throws org.json.JSONException

Add a badge.

Parameters:

badge - a badge number

Throws:

org.json.JSONException

addSound

public void addSound(String sound)
              throws org.json.JSONException

Add a sound.

Parameters:

sound - the name of a sound

Throws:

org.json.JSONException

addAlert

public void addAlert(String alertMessage)
              throws org.json.JSONException

Add a simple alert message. Note: you cannot add a simple and a custom alert in the same payload.

Parameters:

alertMessage - the alert's message

Throws:

org.json.JSONException

addCustomAlertBody

public void addCustomAlertBody(String body)
                        throws org.json.JSONException

Create a custom alert (if none exist) and add a body to the custom alert.

Parameters:

body - the body of the alert

Throws:

org.json.JSONException - if the custom alert cannot be added because a simple alert already exists

addCustomAlertActionLocKey

public void addCustomAlertActionLocKey(String actionLocKey)
                                throws org.json.JSONException

Create a custom alert (if none exist) and add a custom text for the right button of the popup.

Parameters:

actionLocKey - the title of the alert's right button, or null to remove the button

Throws:

org.json.JSONException - if the custom alert cannot be added because a simple alert already exists

addCustomAlertLocKey

public void addCustomAlertLocKey(String locKey)
                          throws org.json.JSONException

Create a custom alert (if none exist) and add a loc-key parameter.

Parameters:

locKey -

Throws:

org.json.JSONException - if the custom alert cannot be added because a simple alert already exists

addCustomAlertLocArgs

public void addCustomAlertLocArgs(List args)
                           throws org.json.JSONException

Create a custom alert (if none exist) and add sub-parameters for the loc-key parameter.

Parameters:

args -

Throws:

org.json.JSONException - if the custom alert cannot be added because a simple alert already exists

setContentAvailable

public void setContentAvailable(boolean available)
                         throws org.json.JSONException

Sets the content available.

Parameters:

available -

Throws:

org.json.JSONException

getMaximumPayloadSize

public int getMaximumPayloadSize()

Return the maximum payload size in bytes. For APNS payloads, this method returns 256.

Returns:

the maximum payload size in bytes (256)