net.rim.pushsdk.acknowledgement
Interface AcknowledgementService

All Known Implementing Classes:

AcknowledgementServiceImpl

public interface AcknowledgementService

Business logic relating to the handling of acknowledgements.

Author:

dstrelbytsky

Method Summary
List<String>	requestNotification(List<String> pushIds) Requests notification for the given push ids.
void	setNotificationProcessorService(NotificationProcessorService notificationProcessorService) Support for dependency injection.
void	setPapService(PapService papService) Support for dependency injection.
void	setPushApplicationService(PushApplicationService pushApplicationService) Support for dependency injection.
void	setPushCountService(PushCountService pushCountService) Support for dependency injection.
void	setPushRequestDetailService(PushRequestDetailService pushRequestDetailService) Support for dependency injection.
void	setPushSDKProperties(PushSDKProperties pushSDKProperties) Support for dependency injection.

Method Detail

requestNotification

List<String> requestNotification(List<String> pushIds)
                                 throws PushSDKException

Requests notification for the given push ids. Used in the case where result notifications may have been lost.

Note: The push requests corresponding to the ids must have previously been persisted by the SDK (i.e. for applications with the 'storePushRequests' property set to true).

Parameters:

pushIds - a list of push ids to request notifications for

Returns:

list of invalid pushIds for which there are no pending requests

Throws:

PushSDKException - if any errors occur

setPapService

void setPapService(PapService papService)

Support for dependency injection. Inject an implementation of a PapService collaborating object - this is used to send the PAP messages to the PPG.

Parameters:

papService - an instance of a PapService implementation (must be thread safe)

setPushSDKProperties

void setPushSDKProperties(PushSDKProperties pushSDKProperties)

Support for dependency injection. Inject an implementation of a PushSDKProperties collaborating object - this is used to read global configuration properties.

Parameters:

pushSDKProperties - an instance of a PushSDKProperties implementation (must be thread safe)

setPushApplicationService

void setPushApplicationService(PushApplicationService pushApplicationService)

Support for dependency injection. Inject an implementation of a PushApplicationService collaborating object - this is used to interface with the business service that manages push applications.

Parameters:

pushApplicationService - an instance of a PushApplicationService implementation (must be thread safe)

setPushCountService

void setPushCountService(PushCountService pushCountService)

Support for dependency injection. Inject an implementation of a PushCountService collaborating object - this is used to interface with the business service that manages tracking pushes that are complete.

Parameters:

pushCountService - an instance of a PushCountService implementation (must be thread safe)

setPushRequestDetailService

void setPushRequestDetailService(PushRequestDetailService pushRequestDetailService)

Support for dependency injection. Inject an implementation of a PushRequestDetailService collaborating object - this is used to interface with the business service that manages push request details.

Parameters:

pushRequestDetailService - an instance of a PushRequestDetailService implementation (must be thread safe)

setNotificationProcessorService

void setNotificationProcessorService(NotificationProcessorService notificationProcessorService)

Support for dependency injection. Inject an implementation of a NotificationProcessorService collaborating object - this is used to interface with the business service that processes result notifications.

Parameters:

notificationProcessorService - an instance of a NotificationProcessorService implementation (must be thread safe)