C H A P T E R 3

Transitioning Files

This chapter describes the changes for APIs and for the Desktop and Device Subscriber Portals from version 2004Q1PU1 to version 2005Q4 of the Content Delivery Server.

3.1 Changes to Billing APIs

The new version features the following changes and additions to the Billing APIs:

BillingManager.confirm now returns BillingInfo instead of void.

The new event type, gift_refunded, is added.

BillingInfo has the following new methods:

public long getSubscriptionCount()

public void setSubscriptionCount(long subscriptionCount)

public String getLimitedTimePrice()

public void setLimitedTimePrice(String inLimitedTimePrice)

public Date getLimitedTimeStartDate()

public void setLimitedTimeStartDate (Date limitedTimeStartDate)

public Date getLimitedTimeEndDate()

public void setLimitedTimeEndDate(Date limitedTimeEndDate)

public boolean isFree()

The class, CDSAbstractBillingSubscriber, is deprecated.

The field, com.sun.content.server.billing.BillingConstants.NUMBER_BILLING_STATUS is deprecated.

The following methods for BillingInfo are deprecated:

getPreviousBillingStatus()

setPreviousBillingStatus(int)

For a complete list of deprecated billing classes and methods, see the deprecated-list.html file in $CDS_HOME/javadoc/cdsapi directory.

3.2 Changes to Messaging APIs

The new version features the following changes and additions to the Messaging APIs:

The following constants are added to the PushConstants class:

public static final String NSM_SMS_DELIVERY_TYPE = "NSM"

public static final String EMS_SMS_DELIVERY_TYPE = "EMS"

public static final String KEY_SMS_DELIVERY_TYPE = "sms_delivery_type"

public static final String KEY_SUBJECT = "subject"

public static final String KEY_URL = "url"

public static final String KEY_FROM_ADDRESS = "from_address"

public static final long PUSH_OMA_DRM_10_RIGHTS_CATEGORY = 10"oma_drm_10_rights"

PushMessage is the base class for all types of push message generated by Content Delivery Server.

The following methods in PushMessage are changed from protected to public:

public void setAttribute(String attributeName, Object attributeVal)

public Object getAttribute(String attributeName)

The new event type, sms_content_push_sent, is added.

PushMessage has the following new methods:

public Object getContentBinary()

public String getContentType()

public String getMimeType()

public void setContentBinary(byte[] content)

public void setContentType(String contentType)

public void setMimeType(String mimeType)

These methods were formerly part of SMSMessage.

The following classes are deprecated:

SMSHTTPMessageDataSMSMessage

SMSMessage

SMTPMessage

WapPushMessage

The interface, SMSURLEncoder, is deleted.

Use PushMsgSender interface instead.

The following methods for PushMessage are deprecated:

getJMSMessageId()

Use getMessageId() instead.

setJMSMessageId(String)

Use setMessageId(String msgId) instead.

The following methods for SMSMessage are deprecated:

getContentName()

Use getAttribute(String attributeName) as defined in PushMessage instead.

getDownloadURL()

Use getAttribute(String attributeName) as defined in PushMessage instead.

setContentName(String)

Use setAttribute(String attributeName, Object attributeVal) as defined in PushMessage instead.

setDownloadURL(String)

Use setAttribute(String attributeName, Object attributeVal) as defined in PushMessage instead.

The following methods for SMTPMessage are deprecated:

getOverrideFrom()

Use getAttribute(String attributeName) as defined in PushMessage instead.

getSubject()

Use getAttribute(String attributeName) as defined in PushMessage instead.

setOverrideFrom(String)

Use setAttribute(String attributeName, Object attributeVal) as defined in PushMessage instead.

setSubject(String)

Use setAttribute(String attributeName, Object attributeVal) as defined in PushMessage instead.

The following methods for WapPushMessage are deprecated:

getDownloadURL()

Use getAttribute(String attributeName) as defined in PushMessage instead.

setDownloadURL(String)

Use setAttribute(String attributeName, Object attributeVal) as defined in PushMessage instead.

For a complete list of deprecated messaging classes and methods, see the deprecated-list.html file in $CDS_HOME/javadoc/cdsapi directory.

3.3 Changes to Subscriber APIs

ContentHandler has the following new methods:

getContentByClassId

getContentByKeyword

getTicket

isSMSCapable

The new event type, subscriber_api_event, is added.

DownloadHandler has the following new methods:

pushExternalSMSContentBinary

pushMMSContentByTicket

pushSMSContentByTicket

The following methods are added to IContentDetails:

public long getContentClassId()

public String getContentKeyword()

The following methods are added to IContentService:

public boolean isSMSCapable (long contentId)

public long getContentByClassId (long contentClassId)

public long getContentByKeyword (String keyword)

public String getTicket(long contentId, long bundleId)

public boolean requestContent (long contentId, Map parameters, int maxNumberToSend)

The method, public void pushSMSContent(String ticket, Map params), is added to IDownloadService.

The following fields are deprecated:

ISystemService.EVENT_TYPE_SMS_REQUEST_FOR_CAMPAIGN

ISystemService.EVENT_TYPE_SMS_REQUEST_FOR_CONTENT

The following methods are deprecated:

IContentService.getBundledItems(long)

Use IContentService.getBundledItems(long, IContentDetailsCriteria) with IContentService.DETAILS_INLCUDE_RETAIL_PRICE filter set instead.

IContentService.getContentDetails(Collection, BitSet, long, long, boolean)

Use IContentService.getContentDetails(Collection, IContentDetailsCriteria)instead.

IContentService.getContentDetails(Collection, BitSet, long, long, boolean, boolean)

Use IContentService.getContentDetails(Collection, IContentDetailsCriteria)with IContentService.DETAILS_INCLUDE_RETAIL_PRICE filter set instead.

IContentService.getContentDetails(long, BitSet, long, long, boolean)

Use IContentService.getContentDetails(long, IContentDetailsCriteria)instead.

IContentService.getContentDetails(long, BitSet, long, long, boolean, boolean)

Use IContentService.getContentDetails(long, IContentDetailsCriteria) with IContentService.DETAILS_INCLUDE_RETAIL_PRICE filter set instead.

IContentService.purchaseContent(long, long, boolean)

Use IContentService.purchaseContent(long, long, boolean, Map)

IDownloadService.pushMMSContent(long)

Use IDownloadService.pushMMSContent(String ticket) instead.

ISystemService.sendEvent(String, long)

This method is handled in the API. It does not need to be called from portals.

For a complete list of deprecated subscriber classes and methods, see the deprecated-list.html file in $CDS_HOME/javadoc/subscriberapi directory.