Server-side library components

Commons component

The newly added Constants class has the PUSH_ALL field that replaces the PUSH_ALL field in the control.AddressList class of the PAP component.

In the PushSDKProperties interface and the PushSDKPropertiesImpl class, the following functional changes have been made.

  • The setUsingXmlParserDtdValidation(boolean) and isUsingXmlParserDtdValidation() methods are deprecated.
  • The setPpgAddress(String) method is deprecated and replaced with the setPublicPpgAddress(String) and setEnterprisePpgAddress(String) methods. Similarly, the getPpgAddress() method is deprecated and replaced with the getPublicPpgAddress() and getEnterprisePpgAddress() methods.

PAP component

In the control subpackage, in the AddressList class, the PUSH_ALL field is deprecated and replaced with the PUSH_ALL field in the commons.Constants class of the Commons component.

In the <*>MessageControl classes (for example, PushMessageControl), the following functional changes have been made:

  • The default constructor is deprecated and replaced with a parameterized constructor that takes a boolean argument.
  • The setAddresses(AddressList) and AddressList getAddresses() methods are deprecated. They are replaced respectively with the setAddressList(List<String>) and List<String> getAddressList() methods.

Core component

This section lists functional changes in the push, pushappmgmt, and subscription packages of the Core-pushsdk component.

push package

  • The newly added FailedPushResult class represents the result of a push request to a subscriber ID in a push request message, when a PPG rejects the push request message or a PPG fails to validate or process the push request message.
  • In the PushResult class, the setFailedPushResults(Set<FailedPushResult>) and the Set<FailedPushResult> getFailedPushResults() methods are available (to set and get the value of the new field that holds a set of FailedPushResult objects).
  • In the PushOutcome class, the boolean isApplicationReliable() method is deprecated and replaced with the Boolean isAppReliable() method to allow a null return value when application-level reliability is unknown.

In the request subpackage the following functional changes have been made:

  • In the PushRequestDetail class, the setSubscriberType(SubscriberType) and SubscriberType getSubscriberType() methods are available (to set and get the value of the new field that holds the subscriber type, represented by an enum constant of the SubscriberType enum).
  • In the PushRequest class, the field that holds StatusCode and the field that holds description of StatusCode are no longer supported. So the setStatusCode(StatusCode) and StatusCode getStatusCode() methods as well as the setStatusDesc(String) and String getStatusDesc() methods are deprecated.

    Similarly, in the PushRequestMemoryDAOImpl and PushRequestRDBMSDAOImpl classes, the updatePushRequest(PushRequest) and List<PushRequest> findByStatusCode(StatusCode) methods are deprecated.

  • In the PushRequest class, the setNotifyUrl(String) method is deprecated and replaced with the setPublicNotifyUrl(String) and setEnterpriseNotifyUrl(String) methods.

    Similarly, the String getNotifyUrl() method is deprecated and replaced with the String getPublicNotifyUrl() and String getEnterpriseNotifyUrl() methods.

pushappmgmt package

The newly added enum PushApplicationType has enum constants to represent the different types of Push Initiators (public, enterprise, public and enterprise).

In the PushApplication class, the following functional changes have been made:
  • The setConsecutiveFailedPushThreshold(Integer) and Integer getConsecutiveFailedPushThreshold() methods are no longer available.
  • The setPassword(String) method is deprecated and replaced with the setPublicPassword(String) and setEnterprisePassword(String) methods.

    Similarly, the String getPassword() method is deprecated and replaced with the String getPublicPassword() and String getEnterprisePassword() methods.

  • The setNotifyUrl(String) method is deprecated and replaced with the setPublicNotifyUrl(String) and setEnterpriseNotifyUrl(String) methods.

    Similarly, the String getNotifyUrl() method is deprecated and replaced with the String getPublicNotifyUrl() and String getEnterpriseNotifyUrl() methods.

In the PushApplicationService interface and the PushApplicationServiceImpl class, the following functional changes have been made.
  • The updatePushApplication(PushApplication) method has been updated to allow updating the status of a push-enabled application.
  • The changePushApplicationCredentials method is deprecated and replaced with the changePushApplicationPublicCredentials and changePushApplicationEnterpriseCredentials methods.
  • The newly added changePushApplicationTypeFromEnterpriseToPublicAndEnterprise, changePushApplicationTypeFromPublicToPublicAndEnterprise, and the List<PushApplication> findByType(PushApplicationType) methods are available.

subscription package

  • The newly added enum SubscriberType has enum constants to represent the different types of subscribers (public, enterprise).
  • In the SubscriberPartial class, the newly added type field and the associated setType(SubscriberType) and getType() methods support the new enum SubscriberType.
  • In the SubscriptionService interface and the SubscriptionServiceImpl class, the syncSubscribersWithPPG(String,String) and syncSubscribersWithPPGByStatus(String, SubscriberStatus,String) methods are deprecated and replaced with the syncSubscribersWithPPGForStatus(String,SubscriberStatus,int,int,String) method.
In the SubscriptionService interface and the SubscriptionServiceImpl class as well as the SubscriptionDAO interface and the SubMemoryDAOImpl and SubRDBMSDAOImpl classes, the following new methods are available:
  • The List<SubscriberPartial> findByAppIdAndType(String pushApplicationId, SubscriberType type, int startIndex, int endIndex) method finds a list of subscribers with the specified push-enabled application ID and type of the subscribers.
  • The int getSizeByAppIdAndType(String pushApplicationId, SubscriberType type) method gets a count of all the subscribers in the storage with the specified push-enabled application ID and type of the subscribers.
  • The List<SubscriberPartial> findByAppIdAndTypeAndStatus(String pushApplicationId, SubscriberType type, SubscriberStatus status, int startIndex, int endIndex) method finds a list of subscribers with the specified push-enabled application ID, type of the subscribers, and status of the subscribers.
  • The int getSizeByAppIdAndTypeAndStatus(String pushApplicationId, SubscriberType type, SubscriberStatus status) method gets a count of all the subscribers in the storage with the specified push-enabled application ID, type of the subscribers, and status of the subscribers.
In the web subpackage, the following new items are available.
  • In the UnsubscribeRequest class, the newly added boolean isNotifyPPG() method enables you to specify if the Push Service SDK should be notified of the unsubscribe request.
  • In the enum SubscriptionStatusCode, the newly added enum constant INVALID_TYPE indicates when the type of a subscriber is not available (null or empty).
Previous topic: Database scripts

Was this information helpful? Send us your comments.