net.rim.pushsdk.push.request
Class PushRequestDetailServiceImpl

java.lang.Object
  net.rim.pushsdk.push.request.PushRequestDetailServiceImpl

All Implemented Interfaces:

PushRequestDetailService

public class PushRequestDetailServiceImpl
extends Object
implements PushRequestDetailService

Default implementation of the PushRequestDetailService defining operations to manage push request details.

Note: This implementation is thread safe as long as the collaborating objects are thread safe as well.

Dependencies that must be injected to properly initialize this object for use:
- pushRequestDetailDAO
- pushSDKProperties

Author:

dstrelbytsky

Constructor Summary

PushRequestDetailServiceImpl()

Method Summary
void	addPushRequestDetail(PushRequestDetail pushRequestDetail) Adds the specified push request detail to the persistent store.
void	addPushRequestDetails(List<PushRequestDetail> pushRequestDetails) Adds the specified push request details to the persistent store.
List<PushRequestDetail>	findByDateRange(Date fromDate, Date toDate, int startIndex, int endIndex) Finds all push request details by the specified created-date range.
List<PushRequestDetail>	findById(String id) Finds all the push request details for the specific push request.
PushRequestDetail	findByIdAndAddress(String id, String address) Finds a push request detail by the specified push request and address.
List<PushRequestDetail>	findByIdAndAddresses(String id, List<String> addresses) Finds push request details by the specified push request and addresses.
List<PushRequestDetail>	findByIdAndStates(String id, List<MessageState> states) Finds all the push request details for the specific push request and given states.
List<PushRequestDetail>	findByIdAndStatusCode(String id, StatusCode statusCode) Finds all the push request details with the given status code for a specific push request.
List<PushRequestDetail>	findByIdAndSubscriberIds(String id, List<String> subscriberIds) Finds push request details by the specified push request and subscriber ids.
Set<PushIdAndApplicationId>	findByIdsAndState(List<String> ids, MessageState state) Finds push ids and application ids for the specific push requests and given state.
List<PushRequestDetail>	findByStatusCode(StatusCode statusCode, int startIndex, int endIndex) Finds all the push request details by the specified status code.
List<PushRequestDetail>	findIncompleteByAppIdAndSubId(String applicationId, String subscriberId) Finds all push requests that are incomplete for a specific subscriber id and push application.
int	getSizeByDateRange(Date fromDate, Date toDate) Gets size of all push request details by the specified date range.
void	setPushRequestDetailDAO(PushRequestDetailDAO pushRequestDetailDAO) Support for dependency injection.
void	setPushSDKProperties(PushSDKProperties pushSDKProperties) Support for dependency injection.
void	updatePushRequestDetail(PushRequestDetail pushRequestDetail) Updates the specified push request detail in the persistent store.
void	updatePushRequestDetail(ResultNotification resultNotification) Updates the push request detail based on the specified resultNotification.
void	updatePushRequestDetails(List<ResultNotification> resultNotifications) Updates the push request details based on the specified list of resultNotifications.

Methods inherited from class java.lang.Object

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

Constructor Detail

PushRequestDetailServiceImpl

public PushRequestDetailServiceImpl()

Method Detail

setPushRequestDetailDAO

public void setPushRequestDetailDAO(PushRequestDetailDAO pushRequestDetailDAO)

Description copied from interface: PushRequestDetailService

Support for dependency injection. Sets the PushRequestDetailDAO,/code> to use.

Specified by:

setPushRequestDetailDAO in interface PushRequestDetailService

setPushSDKProperties

public void setPushSDKProperties(PushSDKProperties pushSDKProperties)

Description copied from interface: PushRequestDetailService

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

Specified by:

setPushSDKProperties in interface PushRequestDetailService

Parameters:

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

addPushRequestDetail

public void addPushRequestDetail(PushRequestDetail pushRequestDetail)
                          throws PushSDKException

Description copied from interface: PushRequestDetailService

Adds the specified push request detail to the persistent store.

Specified by:

addPushRequestDetail in interface PushRequestDetailService

Parameters:

pushRequestDetail - the push request detail to create

Throws:

PushSDKException - if any errors occur

addPushRequestDetails

public void addPushRequestDetails(List<PushRequestDetail> pushRequestDetails)
                           throws PushSDKException

Description copied from interface: PushRequestDetailService

Adds the specified push request details to the persistent store.

Specified by:

addPushRequestDetails in interface PushRequestDetailService

Parameters:

pushRequestDetails - the list of push request details to create

Throws:

PushSDKException - if any errors occur

findByDateRange

public List<PushRequestDetail> findByDateRange(Date fromDate,
                                               Date toDate,
                                               int startIndex,
                                               int endIndex)
                                        throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds all push request details by the specified created-date range.

Specified by:

findByDateRange in interface PushRequestDetailService

Parameters:

fromDate - inclusive 'from' value for the created date of push request details

toDate - inclusive 'to' value for the created date of push requests details

startIndex - inclusive, zero-based start index

endIndex - inclusive, zero-based end index

Returns:

list of pushRequestDetails, empty if not found

Throws:

PushSDKException - if any errors occur

getSizeByDateRange

public int getSizeByDateRange(Date fromDate,
                              Date toDate)
                       throws PushSDKException

Description copied from interface: PushRequestDetailService

Gets size of all push request details by the specified date range.

Specified by:

getSizeByDateRange in interface PushRequestDetailService

Parameters:

fromDate - inclusive from date parameter of the range

toDate - inclusive to date parameter of the range

Returns:

number of push request details in the date range

Throws:

PushSDKException - if any errors occur

findById

public List<PushRequestDetail> findById(String id)
                                 throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds all the push request details for the specific push request.

Specified by:

findById in interface PushRequestDetailService

Parameters:

id - id of the push request

Returns:

list of pushRequestDetails, empty if not found

Throws:

PushSDKException - if any errors occur

findByIdAndStates

public List<PushRequestDetail> findByIdAndStates(String id,
                                                 List<MessageState> states)
                                          throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds all the push request details for the specific push request and given states.

Specified by:

findByIdAndStates in interface PushRequestDetailService

Parameters:

id - id of the push request

states - a list of message states

Returns:

list of pushRequestDetails, empty if not found

Throws:

PushSDKException - if any errors occur

findByIdAndAddress

public PushRequestDetail findByIdAndAddress(String id,
                                            String address)
                                     throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds a push request detail by the specified push request and address.

Specified by:

findByIdAndAddress in interface PushRequestDetailService

Parameters:

id - id of the push request

address - address for the device the push was made to

Returns:

the pushRequestDetail, null if not found

Throws:

PushSDKException - if any errors occur

findByStatusCode

public List<PushRequestDetail> findByStatusCode(StatusCode statusCode,
                                                int startIndex,
                                                int endIndex)
                                         throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds all the push request details by the specified status code.

Specified by:

findByStatusCode in interface PushRequestDetailService

Parameters:

statusCode - status code of the push request details to look up

startIndex - the index of the first entry to be retrieved

endIndex - the index of the last entry to be retrieved

Returns:

list of pushRequestDetails, empty if not found

Throws:

PushSDKException - if any errors occur

findByIdAndStatusCode

public List<PushRequestDetail> findByIdAndStatusCode(String id,
                                                     StatusCode statusCode)
                                              throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds all the push request details with the given status code for a specific push request.

Specified by:

findByIdAndStatusCode in interface PushRequestDetailService

Parameters:

id - id of the push request

statusCode - status code of the push request details to look up

Returns:

list of pushRequestDetails, empty if not found

Throws:

PushSDKException - if any errors occur

updatePushRequestDetail

public void updatePushRequestDetail(PushRequestDetail pushRequestDetail)
                             throws PushSDKException

Description copied from interface: PushRequestDetailService

Updates the specified push request detail in the persistent store.

Note: Not all fields are updated, only the following fields are: messageState, statusCode, statusDesc, senderName, senderAddress and completedDate.

Specified by:

updatePushRequestDetail in interface PushRequestDetailService

Parameters:

pushRequestDetail - the push request detail to update (note that the wildcard address "*" is supported by deferring to the updatePushRequestDetails(List resultNotifications) method)

Throws:

PushSDKException - if any errors occur

updatePushRequestDetail

public void updatePushRequestDetail(ResultNotification resultNotification)
                             throws PushSDKException

Description copied from interface: PushRequestDetailService

Updates the push request detail based on the specified resultNotification.

Note: Not all fields are updated, only the following fields are: messageState, statusCode, statusDesc, senderName, senderAddress and completedDate.

Specified by:

updatePushRequestDetail in interface PushRequestDetailService

Parameters:

resultNotification - the result notification to update the push request detail (note that the wildcard address "*" is not supported)

Throws:

PushSDKException - if any errors occur

updatePushRequestDetails

public void updatePushRequestDetails(List<ResultNotification> resultNotifications)
                              throws PushSDKException

Description copied from interface: PushRequestDetailService

Updates the push request details based on the specified list of resultNotifications.

Note: Not all fields are updated, only the following fields are: messageState, statusCode, statusDesc, senderName, senderAddress and completedDate.

Specified by:

updatePushRequestDetails in interface PushRequestDetailService

Parameters:

resultNotifications - the list of result notifications to update the corresponding push request details (note that the wildcard address "*" is supported)

Throws:

PushSDKException - if any errors occur

findByIdAndAddresses

public List<PushRequestDetail> findByIdAndAddresses(String id,
                                                    List<String> addresses)
                                             throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds push request details by the specified push request and addresses.

Specified by:

findByIdAndAddresses in interface PushRequestDetailService

Parameters:

id - id of the push request

addresses - addresses for the device the push was made to

Returns:

list of pushRequestDetails, empty if not found

Throws:

PushSDKException - if any errors occur

findByIdAndSubscriberIds

public List<PushRequestDetail> findByIdAndSubscriberIds(String id,
                                                        List<String> subscriberIds)
                                                 throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds push request details by the specified push request and subscriber ids.

Specified by:

findByIdAndSubscriberIds in interface PushRequestDetailService

Parameters:

id - id of the push request

subscriberIds - subscriberIds for the device the push was made to

Returns:

list of pushRequestDetails, empty if not found

Throws:

PushSDKException - if any errors occur

findByIdsAndState

public Set<PushIdAndApplicationId> findByIdsAndState(List<String> ids,
                                                     MessageState state)
                                              throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds push ids and application ids for the specific push requests and given state.

Specified by:

findByIdsAndState in interface PushRequestDetailService

Parameters:

ids - ids of the push requests

state - a message state

Returns:

list of PushIdAndApplicationId, empty if not found

Throws:

PushSDKException - if any errors occur

findIncompleteByAppIdAndSubId

public List<PushRequestDetail> findIncompleteByAppIdAndSubId(String applicationId,
                                                             String subscriberId)
                                                      throws PushSDKException

Description copied from interface: PushRequestDetailService

Finds all push requests that are incomplete for a specific subscriber id and push application. In other words, finds all push requests for a given subscriber for a given push application that is still in a pending state.

Note: This method will only return push request details where the push application is of type 'Push Plus' and has its 'storePushRequests' flag set to 'true'.

If the original push request was not accepted by the PPG, there will be no details to return.

Note: A large number of push request/push request details in the persistent store may make this query take a long time to complete.

Specified by:

findIncompleteByAppIdAndSubId in interface PushRequestDetailService

Parameters:

applicationId - application for which to find the incomplete pushes

subscriberId - the subscriber id for which to find incomplete pushes

Returns:

list of incomplete push request details

Throws:

PushSDKException - if any errors occur