javapns.notification

Class Payload

java.lang.Object

javapns.notification.Payload

Direct Known Subclasses:

NewsstandNotificationPayload, PushNotificationPayload

public abstract class Payload
extends Object

Abstract class representing a payload that can be transmitted to Apple.

By default, this class has no payload content at all. Subclasses are responsible for imposing specific content based on the specifications they are intended to implement (such as the 'aps' dictionnary for APS payloads).

Author:

Sylvain Pedneault

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Payload() Construct a Payload object with a blank root JSONObject

Method Summary

Modifier and Type	Method and Description
void	addCustomDictionary(String name, int value) Add a custom dictionnary with a int value
void	addCustomDictionary(String name, List values) Add a custom dictionnary with multiple values
void	addCustomDictionary(String name, Object value) Add a custom dictionnary with object
void	addCustomDictionary(String name, String value) Add a custom dictionnary with a string value
Payload	asSimulationOnly() Enables a special simulation mode which causes the library to behave as usual *except* that at the precise point where the payload would actually be streamed out to Apple, it is not.
String	getCharacterEncoding() Returns the character encoding that will be used by getPayloadAsBytes().
int	getExpiry() Return the number of seconds after which this payload should expire.
org.json.JSONObject	getPayload() Get the actual JSON object backing this payload.
byte[]	getPayloadAsBytes() Get this payload as a byte array using the preconfigured character encoding.
int	getPayloadSize() Get the number of bytes that the payload will occupy when streamed.
boolean	isEstimatedPayloadSizeAllowedAfterAdding(String propertyName, Object propertyValue) Validate if the estimated payload size after adding a given property will be allowed.
boolean	isPayloadSizeEstimatedWhenAdding() Indicates if payload size is estimated and controlled when adding properties (default is false).
void	setCharacterEncoding(String characterEncoding) Changes the character encoding for streaming the payload.
void	setPayloadSizeEstimatedWhenAdding(boolean checked) Indicate if payload size should be estimated and controlled when adding properties (default is false).
String	toString() Get the string representation

Methods inherited from class java.lang.Object

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

Constructor Detail

Payload

protected Payload()

Construct a Payload object with a blank root JSONObject

Method Detail

getPayload

public org.json.JSONObject getPayload()

Get the actual JSON object backing this payload.

Returns:

a JSONObject

addCustomDictionary

public void addCustomDictionary(String name,
                                String value)
                         throws org.json.JSONException

Add a custom dictionnary with a string value

Parameters:

name -

value -

Throws:

org.json.JSONException

addCustomDictionary

public void addCustomDictionary(String name,
                                int value)
                         throws org.json.JSONException

Add a custom dictionnary with a int value

Parameters:

name -

value -

Throws:

org.json.JSONException

addCustomDictionary

public void addCustomDictionary(String name,
                                List values)
                         throws org.json.JSONException

Add a custom dictionnary with multiple values

Parameters:

name -

values -

Throws:

org.json.JSONException

addCustomDictionary

public void addCustomDictionary(String name,
                                Object value)
                         throws org.json.JSONException

Add a custom dictionnary with object

Parameters:

name -

value -

Throws:

org.json.JSONException

toString

public String toString()

Get the string representation

Overrides:

toString in class Object

getPayloadAsBytes

public byte[] getPayloadAsBytes()
                         throws Exception

Get this payload as a byte array using the preconfigured character encoding.

Returns:

byte[] bytes ready to be streamed directly to Apple servers

Throws:

Exception

getPayloadSize

public int getPayloadSize()
                   throws Exception

Get the number of bytes that the payload will occupy when streamed.

Returns:

a number of bytes

Throws:

Exception

isEstimatedPayloadSizeAllowedAfterAdding

public boolean isEstimatedPayloadSizeAllowedAfterAdding(String propertyName,
                                                        Object propertyValue)

Validate if the estimated payload size after adding a given property will be allowed. For performance reasons, this estimate is not as reliable as actually adding the property and checking the payload size afterwards.

Parameters:

propertyName - the name of the property to use for calculating the estimation

propertyValue - the value of the property to use for calculating the estimation

Returns:

true if the payload size is not expected to exceed the maximum allowed, false if it might be too big

isPayloadSizeEstimatedWhenAdding

public boolean isPayloadSizeEstimatedWhenAdding()

Indicates if payload size is estimated and controlled when adding properties (default is false).

Returns:

true to throw an exception if the estimated size is too big when adding a property, false otherwise

setPayloadSizeEstimatedWhenAdding

public void setPayloadSizeEstimatedWhenAdding(boolean checked)

Indicate if payload size should be estimated and controlled when adding properties (default is false).

Parameters:

checked - true to throw an exception if the estimated size is too big when adding a property, false otherwise

getCharacterEncoding

public String getCharacterEncoding()

Returns the character encoding that will be used by getPayloadAsBytes(). Default is UTF-8, as per Apple documentation.

Returns:

a character encoding

setCharacterEncoding

public void setCharacterEncoding(String characterEncoding)

Changes the character encoding for streaming the payload. Character encoding is preset to UTF-8, as Apple documentation specifies. Therefore, unless you are working on a special project, you should leave it as is.

Parameters:

characterEncoding - a valid character encoding that String.getBytes(encoding) will accept

getExpiry

public int getExpiry()

Return the number of seconds after which this payload should expire.

Returns:

a number of seconds

asSimulationOnly

public Payload asSimulationOnly()

Enables a special simulation mode which causes the library to behave as usual *except* that at the precise point where the payload would actually be streamed out to Apple, it is not.

Returns:

the same payload