net.rim.pushsdk.pushappmgmt
Interface PushApplicationDAO

All Known Implementing Classes:
PushAppMemoryDAOImpl, PushAppRDBMSDAOImpl

public interface PushApplicationDAO

Interface defining data access methods needed to manage PushApplication objects in the store.

Author:
mdicesare

Method Summary
 void addPushApplication(PushApplication pushApplication)
          Adds the specified push application to the persistent store.
 void changePushApplicationBDSCredentials(String id, String newUsername, String newPassword, String modifiedBy)
          Change the BDS username and password of a push application that has a type of BDS Push, Public+BDS Push, Enterprise+BDS Push, or Public+Enterprise+BDS Push.
 void changePushApplicationEnterpriseCredentials(String id, String newUsername, String newPassword, String modifiedBy)
          Change the enterprise username and password of a push application that has a type of Enterprise Push, Public+Enterprise Push, Enterprise+BDS Push, or Public+Enterprise+BDS Push.
 void changePushApplicationPublicCredentials(String id, String newPassword, String modifiedBy)
          Change the public password of a push application that has a type of Public Push, Public+Enterprise Push, Public+BDS Push, or Public+Enterprise+BDS Push.
 void changePushApplicationTypeFromBDSToPublicAndBDS(String id, String publicPassword, String publicNotifyUrl, String modifiedBy)
          Changes the type of a push application from BDS Push to Public+BDS Push.
 void changePushApplicationTypeFromEnterpriseAndBDSToPublicAndEnterpriseAndBDS(String id, String publicPassword, String publicNotifyUrl, String modifiedBy)
          Changes the type of a push application from Enterprise+BDS Push to Public+Enterprise+BDS Push.
 void changePushApplicationTypeFromEnterpriseToEnterpriseAndBDS(String id, String bdsUsername, String bdsPassword, String bdsNotifyUrl, String modifiedBy)
          Changes the type of a push application from Enterprise Push to Enterprise+BDS Push.
 void changePushApplicationTypeFromEnterpriseToPublicAndEnterprise(String id, String publicPassword, String publicNotifyUrl, String modifiedBy)
          Changes the type of a push application from Enterprise Push to Public+Enterprise Push.
 void changePushApplicationTypeFromEnterpriseToPublicAndEnterpriseAndBDS(String id, String publicPassword, String publicNotifyUrl, String bdsUsername, String bdsPassword, String bdsNotifyUrl, String modifiedBy)
          Changes the type of a push application from Enterprise Push to Public+Enterprise+BDS Push.
 void changePushApplicationTypeFromPublicAndEnterpriseToPublicAndEnterpriseAndBDS(String id, String bdsUsername, String bdsPassword, String bdsNotifyUrl, String modifiedBy)
          Changes the type of a push application from Public+Enterprise Push to Public+Enterprise+BDS Push.
 void changePushApplicationTypeFromPublicToPublicAndBDS(String id, String bdsUsername, String bdsPassword, String bdsNotifyUrl, String modifiedBy)
          Changes the type of a push application from Public Push to Public+BDS Push.
 void changePushApplicationTypeFromPublicToPublicAndEnterprise(String id, String enterpriseUsername, String enterprisePassword, String enterpriseNotifyUrl, String modifiedBy)
          Changes the type of a push application from Public Push to Public+Enterprise Push.
 void changePushApplicationTypeFromPublicToPublicAndEnterpriseAndBDS(String id, String enterpriseUsername, String enterprisePassword, String enterpriseNotifyUrl, String bdsUsername, String bdsPassword, String bdsNotifyUrl, String modifiedBy)
          Changes the type of a push application from Public Push to Public+Enterprise+BDS Push.
 void deletePushApplication(String id, String deletedBy)
          Warning!
Removes a push application entirely and permanently from the store (and any related entities if a foreign key cascading relationship exists).
 void disablePushApplication(String id, String modifiedBy)
          Disables (sets to inactive) a push application.
 void enablePushApplication(String id, Date expiryDate, String modifiedBy)
          Enables (sets to active) a push application.
 void enablePushApplication(String id, String modifiedBy)
          Enables (sets to active) a push application.
 List<PushApplication> findAll()
          Finds a list of all the push applications in storage.
 PushApplication findById(String id)
          Finds the push application with the specified push application id.
 PushApplication findByName(String name)
          Finds the push application with the specified name.
 List<PushApplication> findByStatus(PushApplicationStatus status)
          Finds a list of push applications with the specified status.
 List<PushApplication> findByType(PushApplicationType type)
          Finds a list of push applications with the specified type.
 void updatePushApplication(PushApplication pushApplication)
          Updates the details of a push application.
 

Method Detail

addPushApplication

void addPushApplication(PushApplication pushApplication)
                        throws org.springframework.dao.DataAccessException
Adds the specified push application to the persistent store.

Parameters:
pushApplication - the push application to add
Throws:
org.springframework.dao.DataAccessException - if any errors occur

updatePushApplication

void updatePushApplication(PushApplication pushApplication)
                           throws org.springframework.dao.DataAccessException
Updates the details of a push application. Note: This method cannot be used to update a push application's status or to change the password of a push application.

Parameters:
pushApplication - the updated push application
Throws:
org.springframework.dao.DataAccessException - if any errors occur

changePushApplicationTypeFromPublicToPublicAndEnterprise

void changePushApplicationTypeFromPublicToPublicAndEnterprise(String id,
                                                              String enterpriseUsername,
                                                              String enterprisePassword,
                                                              String enterpriseNotifyUrl,
                                                              String modifiedBy)
                                                              throws org.springframework.dao.DataAccessException
Changes the type of a push application from Public Push to Public+Enterprise Push.

Parameters:
id - the id of the push application
enterpriseUsername - an optional username for enterprise (BES) pushes; null if not required
enterprisePassword - an optional password for enterprise (BES) pushes; null if not required
enterpriseNotifyUrl - a full notification URL for enterprise (BES) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.1

changePushApplicationTypeFromPublicToPublicAndBDS

void changePushApplicationTypeFromPublicToPublicAndBDS(String id,
                                                       String bdsUsername,
                                                       String bdsPassword,
                                                       String bdsNotifyUrl,
                                                       String modifiedBy)
                                                       throws org.springframework.dao.DataAccessException
Changes the type of a push application from Public Push to Public+BDS Push.

Parameters:
id - the id of the push application
bdsUsername - an optional username for enterprise (BDS) pushes; null if not required
bdsPassword - an optional password for enterprise (BDS) pushes; null if not required
bdsNotifyUrl - a full notification URL for enterprise (BDS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2

changePushApplicationTypeFromPublicToPublicAndEnterpriseAndBDS

void changePushApplicationTypeFromPublicToPublicAndEnterpriseAndBDS(String id,
                                                                    String enterpriseUsername,
                                                                    String enterprisePassword,
                                                                    String enterpriseNotifyUrl,
                                                                    String bdsUsername,
                                                                    String bdsPassword,
                                                                    String bdsNotifyUrl,
                                                                    String modifiedBy)
                                                                    throws org.springframework.dao.DataAccessException
Changes the type of a push application from Public Push to Public+Enterprise+BDS Push.

Parameters:
id - the id of the push application
enterpriseUsername - an optional username for enterprise (BES) pushes; null if not required
enterprisePassword - an optional password for enterprise (BES) pushes; null if not required
enterpriseNotifyUrl - a full notification URL for enterprise (BES) acknowledgements; null if using a service level of Push Essentials
bdsUsername - an optional username for enterprise (BDS) pushes; null if not required
bdsPassword - an optional password for enterprise (BDS) pushes; null if not required
bdsNotifyUrl - a full notification URL for enterprise (BDS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2

changePushApplicationTypeFromEnterpriseToPublicAndEnterprise

void changePushApplicationTypeFromEnterpriseToPublicAndEnterprise(String id,
                                                                  String publicPassword,
                                                                  String publicNotifyUrl,
                                                                  String modifiedBy)
                                                                  throws org.springframework.dao.DataAccessException
Changes the type of a push application from Enterprise Push to Public+Enterprise Push.

Parameters:
id - the id of the push application
publicPassword - a password for public (BIS) pushes
publicNotifyUrl - a notification URL fragment for public (BIS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.1

changePushApplicationTypeFromEnterpriseToEnterpriseAndBDS

void changePushApplicationTypeFromEnterpriseToEnterpriseAndBDS(String id,
                                                               String bdsUsername,
                                                               String bdsPassword,
                                                               String bdsNotifyUrl,
                                                               String modifiedBy)
                                                               throws org.springframework.dao.DataAccessException
Changes the type of a push application from Enterprise Push to Enterprise+BDS Push.

Parameters:
id - the id of the push application
bdsUsername - an optional username for enterprise (BDS) pushes; null if not required
bdsPassword - an optional password for enterprise (BDS) pushes; null if not required
bdsNotifyUrl - a full notification URL for enterprise (BDS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2

changePushApplicationTypeFromEnterpriseToPublicAndEnterpriseAndBDS

void changePushApplicationTypeFromEnterpriseToPublicAndEnterpriseAndBDS(String id,
                                                                        String publicPassword,
                                                                        String publicNotifyUrl,
                                                                        String bdsUsername,
                                                                        String bdsPassword,
                                                                        String bdsNotifyUrl,
                                                                        String modifiedBy)
                                                                        throws org.springframework.dao.DataAccessException
Changes the type of a push application from Enterprise Push to Public+Enterprise+BDS Push.

Parameters:
id - the id of the push application
publicPassword - a password for public (BIS) pushes
publicNotifyUrl - a notification URL fragment for public (BIS) acknowledgements; null if using a service level of Push Essentials
bdsUsername - an optional username for enterprise (BDS) pushes; null if not required
bdsPassword - an optional password for enterprise (BDS) pushes; null if not required
bdsNotifyUrl - a full notification URL for enterprise (BDS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2

changePushApplicationTypeFromBDSToPublicAndBDS

void changePushApplicationTypeFromBDSToPublicAndBDS(String id,
                                                    String publicPassword,
                                                    String publicNotifyUrl,
                                                    String modifiedBy)
                                                    throws org.springframework.dao.DataAccessException
Changes the type of a push application from BDS Push to Public+BDS Push.

Parameters:
id - the id of the push application
publicPassword - a password for public (BIS) pushes
publicNotifyUrl - a notification URL fragment for public (BIS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2

changePushApplicationTypeFromPublicAndEnterpriseToPublicAndEnterpriseAndBDS

void changePushApplicationTypeFromPublicAndEnterpriseToPublicAndEnterpriseAndBDS(String id,
                                                                                 String bdsUsername,
                                                                                 String bdsPassword,
                                                                                 String bdsNotifyUrl,
                                                                                 String modifiedBy)
                                                                                 throws org.springframework.dao.DataAccessException
Changes the type of a push application from Public+Enterprise Push to Public+Enterprise+BDS Push.

Parameters:
id - the id of the push application
bdsUsername - an optional username for enterprise (BDS) pushes; null if not required
bdsPassword - an optional password for enterprise (BDS) pushes; null if not required
bdsNotifyUrl - a full notification URL for enterprise (BDS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2

changePushApplicationTypeFromEnterpriseAndBDSToPublicAndEnterpriseAndBDS

void changePushApplicationTypeFromEnterpriseAndBDSToPublicAndEnterpriseAndBDS(String id,
                                                                              String publicPassword,
                                                                              String publicNotifyUrl,
                                                                              String modifiedBy)
                                                                              throws org.springframework.dao.DataAccessException
Changes the type of a push application from Enterprise+BDS Push to Public+Enterprise+BDS Push.

Parameters:
id - the id of the push application
publicPassword - a password for public (BIS) pushes
publicNotifyUrl - a notification URL fragment for public (BIS) acknowledgements; null if using a service level of Push Essentials
modifiedBy - the user that is changing the push application's type
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2

findById

PushApplication findById(String id)
                         throws org.springframework.dao.DataAccessException
Finds the push application with the specified push application id.

Parameters:
id - the id of the push application to lookup
Returns:
the push application; null if the push application is not found
Throws:
org.springframework.dao.DataAccessException - if any errors occur

findByName

PushApplication findByName(String name)
                           throws org.springframework.dao.DataAccessException
Finds the push application with the specified name.

Parameters:
name - the name of the push application to lookup
Returns:
the push application; null if the push application is not found
Throws:
org.springframework.dao.DataAccessException - if any errors occur

findByStatus

List<PushApplication> findByStatus(PushApplicationStatus status)
                                   throws org.springframework.dao.DataAccessException
Finds a list of push applications with the specified status.

Parameters:
status - the status of a push application
Returns:
a list of push applications; otherwise, an empty list, if no matches could be found
Throws:
org.springframework.dao.DataAccessException - if any errors occur

findByType

List<PushApplication> findByType(PushApplicationType type)
                                 throws org.springframework.dao.DataAccessException
Finds a list of push applications with the specified type.

Parameters:
type - the type of a push application
Returns:
a list of push applications; otherwise, an empty list, if no matches could be found
Throws:
org.springframework.dao.DataAccessException - if any errors occur

findAll

List<PushApplication> findAll()
                              throws org.springframework.dao.DataAccessException
Finds a list of all the push applications in storage.

Returns:
a list of push applications; otherwise, an empty list, if there are none in storage
Throws:
org.springframework.dao.DataAccessException - if any errors occur

disablePushApplication

void disablePushApplication(String id,
                            String modifiedBy)
                            throws org.springframework.dao.DataAccessException
Disables (sets to inactive) a push application.

Parameters:
id - the id of the push application
modifiedBy - the user that disabled the push application
Throws:
org.springframework.dao.DataAccessException - if any errors occur

enablePushApplication

void enablePushApplication(String id,
                           Date expiryDate,
                           String modifiedBy)
                           throws org.springframework.dao.DataAccessException
Enables (sets to active) a push application.

Parameters:
id - the id of the push application
expiryDate - the new expiry date for the push application
modifiedBy - the user that enabled the push application
Throws:
org.springframework.dao.DataAccessException - if any errors occur

enablePushApplication

void enablePushApplication(String id,
                           String modifiedBy)
                           throws org.springframework.dao.DataAccessException
Enables (sets to active) a push application. Expiry date will remain unchanged.

Parameters:
id - the id of the push application
modifiedBy - the user that enabled the push application
Throws:
org.springframework.dao.DataAccessException - if any errors occur

deletePushApplication

void deletePushApplication(String id,
                           String deletedBy)
                           throws org.springframework.dao.DataAccessException
Warning!
Removes a push application entirely and permanently from the store (and any related entities if a foreign key cascading relationship exists). Related entities may include any push messages sent to the push application and any subscriptions for the push application.

Parameters:
id - the id of the push application to remove entirely and permanently
deletedBy - an identifier that identifies the caller of this API. The deletedBy value will be placed into the log files at info level for audit purposes
Throws:
org.springframework.dao.DataAccessException - if any errors occur

changePushApplicationPublicCredentials

void changePushApplicationPublicCredentials(String id,
                                            String newPassword,
                                            String modifiedBy)
                                            throws org.springframework.dao.DataAccessException
Change the public password of a push application that has a type of Public Push, Public+Enterprise Push, Public+BDS Push, or Public+Enterprise+BDS Push.

Parameters:
id - the id of the push application
newPassword - the new password for the push application
modifiedBy - the user that is changing the push application's public credentials
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.1

changePushApplicationEnterpriseCredentials

void changePushApplicationEnterpriseCredentials(String id,
                                                String newUsername,
                                                String newPassword,
                                                String modifiedBy)
                                                throws org.springframework.dao.DataAccessException
Change the enterprise username and password of a push application that has a type of Enterprise Push, Public+Enterprise Push, Enterprise+BDS Push, or Public+Enterprise+BDS Push.

Parameters:
id - the id of the push application
newUsername - the new username for the push application (might be null)
newPassword - the new password for the push application (might be null)
modifiedBy - the user that is changing the push application's enterprise credentials
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.1

changePushApplicationBDSCredentials

void changePushApplicationBDSCredentials(String id,
                                         String newUsername,
                                         String newPassword,
                                         String modifiedBy)
                                         throws org.springframework.dao.DataAccessException
Change the BDS username and password of a push application that has a type of BDS Push, Public+BDS Push, Enterprise+BDS Push, or Public+Enterprise+BDS Push.

Parameters:
id - the id of the push application
newUsername - the new username for the push application (might be null)
newPassword - the new password for the push application (might be null)
modifiedBy - the user that is changing the push application's BDS credentials
Throws:
org.springframework.dao.DataAccessException - if any errors occur
Since:
1.2


Send feedback

Copyright © 2013 BlackBerry. All rights reserved.