第 3 章

转换文件

本章介绍了 Content Delivery Server 从版本 5.0 到 5.1，其 API 以及桌面和设备 Subscriber Portal 所发生的变更。

相关变更项目下面说明了从版本 5.0 PU1 到 5.1 所发生的变更。

在版本 5.1 中，以下 Content Delivery Server API 发生了转换：

内容管理 API 的变更

内容验证 API 的变更

订户 API 的变更

用户配置文件 API 的变更

WAP 网关 API 的变更

内容管理 API 的变更

从版本 5.0 到 5.1，新版本中的内容管理 API 所发生的变更和添加的内容如下所示：

向内容管理 API 中添加了以下类：

ContentPreview.java

MimeType.java

Model.java

添加了 Popularity.java 接口。

此新接口用于计算内容项的相对受欢迎程度值。

ContentConstants.java 具有以下新字段：

public static final java.lang.String KEY_CONTENT_PREVIEWS

public static final java.lang.String TARGET_INTERFACE_WAP

public static final java.lang.String TARGET_INTERFACE_WEB

ContentInfo.java 具有以下新方法：

public void setValue(java.lang.String key, java.lang.Object value)

public java.lang.Object getValue(java.lang.String key)

从 ContentInfo.java 中删除了以下方法：
protected void set(java.lang.String key, java.lang.Object value)。

内容验证 API 的变更

新版本中的内容验证 API 所发生的变更和添加的内容如下所示：

向 ValidationContent.java 中添加了以下字段：
public static java.lang.String KEY_AUTO_PUBLISH

向 ValidationContent.java 中添加了以下方法：

getCategories(java.lang.String delimiter)

getContentPreviews()

getContentType()

getDeveloperContentId()

getDeveloperName()

getDeveloperPlans()

getDeveloperUsername()

getDisplayName()

getEditionName()

getLocationType()

getMatchedModels()

在 Validationcontent.java 中，发生了以下参数变更：

ValidationContent 构造函数的 java.util.Map 变更为 java.util.Map<java.lang.String,byte[]>。

setCapabilityMap 方法的 java.util.Map 变更为 java.util.Map<java.lang.String,java.lang.String[]>。

setMimeBytesMap 方法的 java.util.Map 变更为 java.util.Map<java.lang.String,byte[]>。

在 Validationcontent.java 中，发生了以下返回类型变更：

getCapabilityMap 方法的 java.util.Map 变更为 java.util.Map<java.lang.String,java.lang.String[]>。

getMimeBytesMap 方法的 java.util.Map 变更为 java.util.Map<java.lang.String,byte[]>。

订户 API 的变更

新版本中的订户 API 所发生的变更和添加的内容如下所示：

向订户 API 中添加了以下接口：

IContentPreview

ICustomField

IMimeType

IStreamingService

添加了 ApiContextFactory.java 的以下方法：

createAnonymousApiContext(java.lang.String localeCode, long modelId, boolean expires)

isAuthKeyValid(java.lang.String authKey)

removeApiContext(java.lang.String authKey)

添加了 ApiUtil.java 的以下方法：
isContentExpired(long contentId)

添加了 CDSException.java 的以下字段：

public static final java.lang.String CDS_EX_DOWNLOAD_BEFORE_START_DATE_NOT_ALLOWED

在版本 5.0 PU1 中添加了该字段。

public static final java.lang.String CDS_EX_INVALID_AUTH_KEY

删除了 CDSException.java 的以下字段：
public static final java.lang.String CDS_EX_INVALID_URL_TICKET

向 IApiContext.java 中添加了以下方法：getAuthKey()

向 ICategory.java 中添加了以下方法：getSortingQuery()

在 ICategoryService.java 中，以下方法的参数 java.util.Collection 变更为 java.util.Collection<ICategory>：

hideCategory()

moveCategoryDown()

moveCategoryUp()

showCategory()

在 ICategoryService.java 中，以下方法的返回类型 java.util.Collection 变更为 java.util.Collection<ICategory>：

getNotEmptySubCategories()

getSubCategories()

hideCategory()

moveCategoryDown()

moveCategoryUp()

showCategory()

添加了 IContentDetails.java 的以下方法：

getUserGuideBinary()

getSmallIconBinary()

java.util.Collection<IContentPreview> getPreviews(int target)

java.util.Collection<IContentPreview> getPreviews()

getLargeIconBinary()

getDeviceIconBinary()

IContentDetails.java 的以下方法已过时：

getPreviewUrl()

改用 getPreviews(int)。

getScreenShot1Url()

改用 getPreviews(int)。

getScreenShot2Url()

改用 getPreviews(int)。

isPreviewEnabled()

删除了 IContentDetails.java 的以下方法：

getContentClassId()

在版本 5.0 PU1 中删除了该方法。

getContentKeyword()

在版本 5.0 PU1 中删除了该方法。

getContentType()

在版本 5.0 PU1 中删除了该方法。

getDeveloperName()

在版本 5.0 PU1 中删除了该方法。

getLongDescription()

getSizeInKB()

getVersion()

isBundle()

在 IContentList.java 中，getContentSummaries 方法的 java.util.Collection 返回类型变更为 java.util.Collection<IContentSummary>。

添加了 IContentService.java 的以下字段：

public static final java.lang.String DETAILS_INCLUDE_CUSTOM_FIELDS

public static final java.lang.String DETAILS_INCLUDE_RESOURCE_BINARIES

public static final java.lang.String TARGET_INTERFACE_WAP

public static final java.lang.String TARGET_INTERFACE_WEB

IContentService.java 发生了以下变更：

添加了方法 searchContent(java.lang.String searchQuery,
long categoryId, java.util.Map<java.lang.String,java.lang.Boolean> sortKeyMap, int numberToReturn, int startIndex)。

方法 IContentList searchContent(long categoryId, java.lang.String searchStr, long[] contentTypeIds, int numberToReturn, int startIndex) 已过时。

改用 searchContent(String, long, Map, int, int)。

在 IContentService.java 中，方法 getContentDetails(java.util.Collection<IContentSummary> contentSummaries, IContentDetailsCriteria criteria) 的 java.util.Collection 参数变更为 java.util.Collection<IContentSummary>。

在 IContentService.java 中，以下已过时方法的 java.util.Collection 参数变更为 java.util.Collection<IContentSummary>：

getContentDetails(java.util.Collection<IContentSummary> contentSummaries, java.util.BitSet filter, long campaignId, long bundleId, boolean isSkipTrial)

getContentDetails(java.util.Collection<IContentSummary> contentSummaries, java.util.BitSet filter, long campaignId, long bundleId, boolean retailPrice, boolean isSkipTrial)

在 IContentService.java 中，所有 getContentDetails 方法的 java.util.Collection 返回类型都变更为 java.util.Collection<IContentDetails>。

在 IContentService.java 中，getPurchases 方法的 java.util.Collection 返回类型变更为 java.util.Collection<IPurchaseDetails>。

在 IContentService.java 中，getSupportedModels 方法的 java.util.Collection 返回类型变更为 java.util.Collection<IModel>。

在 IContentService.java 中，getBookmarks 方法的 java.util.Collection 返回类型变更为 java.util.Collection<IContentSummary>。

在 IContentService.java 中，getCampaigns 方法的 java.util.Collection 返回类型变更为 java.util.Collection<ICampaign>。

添加了 IContentType.java 的以下方法：

getContentClassId()

getContentKeyword()

getContentType()

getCustomFields()

getDeveloperName()

getLongDescription()

getSizeInKB()

getVersion()

isBundle()

在 IDownloadService.java 中，以下方法的 java.util.Map 参数变更为 java.util.Map<java.lang.String,java.lang.Object>：

pushSMSContent(java.lang.String mobileId, byte[] contentBinary, java.lang.String mimeType, java.lang.String contentType, java.util.Map<java.lang.String,java.lang.Object> params)

pushSMSContent(java.lang.String ticket, java.util.Map<java.lang.String,java.lang.Object> params)

向 IGiftingService.java 中添加了以下方法：
giftContent(long contentId, long campaignId, IApiContext recipientCtx, java.lang.String message, int giftedDownloads, int giftedSubscriptions, java.util.Map<java.lang.String,java.lang.String> billingParams)

在 IGiftingService.java 中，以下方法的 java.util.Collection 返回类型变更为 java.util.Collection<IGifting>：

getGiftingsByGifter()

getGiftingsByRecipient()

在 ISystemService.java 中，getContentTypes() 方法的 java.util.Collection 返回类型变更为 java.util.Collection<IContentType>。

在 ISystemService.java 中，getCountries() 方法的 java.util.Collection 返回类型变更为 java.util.Collection<ICountry>。

在 ISystemService.java 中，getLocales() 方法的 java.util.Collection 返回类型变更为 java.util.Collection<ILocale>。

在 ISystemService.java 中，以下方法的 java.util.Collection 返回类型变更为 java.util.Collection<IModel>：

getModels()

getModels(java.lang.String manufacturer)

IUserService.java 的以下方法已过时：

getCategoryService(IApiContext context)

改用 getCategoryService(String)。

getCategoryService(java.lang.String authKey)

getContentService(IApiContext context)

改用 getContentService(String)。

getContentService(java.lang.String authKey)

getDownloadService(IApiContext context)

改用 getDownloadService(String)。

getDownloadService(java.lang.String authKey)

getGiftingService(IApiContext context)

改用 getGiftingService(String)。

getGiftingService(java.lang.String authKey)

getMessageService(IApiContext context)

改用 getMessageService(String)。

getMessageService(java.lang.String authKey)

getStreamingService(IApiContext context)

改用 getStreamingService(String)。

getStreamingService(java.lang.String authKey)

getSystemService(IApiContext context)

改用 getSystemService(String)。

getSystemService(java.lang.String authKey)

getUserService(IApiContext context)

改用 getUserService(String)。

getUserService(java.lang.String authKey)

在 IUserService.java 中，setUserPreferences() 方法的 java.util.Map 参数变更为 java.util.Map<java.lang.String,java.lang.Object>。

在 IUserService.java 中，setUserProperties() 方法的 java.util.Map 参数变更为 java.util.Map<java.lang.String,java.lang.Object>。

在 IUserService.java 中，signup() 方法的 java.util.Map 参数变更为 java.util.Map<java.lang.String,java.lang.String>。

在 IUserService.java 中，getUserPreferences() 方法的 java.util.Map 返回类型变更为 java.util.Map<java.lang.String,java.lang.Object>。

在 IUserService.java 中，以下方法的 java.util.Map 返回类型变更为 java.util.Map<java.lang.String,java.lang.String>：

getUserProperties()

getUserProperties(long subscriberId)

getUserProperties(java.lang.String userName)

用户配置文件 API 的变更

新版本中的用户配置文件 API 所发生的变更和添加的内容如下所示：

添加了接口 UserDeviceModel.java。

User.java 的以下方法已过时：

getAttributes()

getAttribute(java.lang.String name)

getAttribute(java.lang.String name, java.lang.Object defaultValue)

getCreateDate()

getLastLogin()

hasLoggedIn()

isConfirmed()

setAttribute(java.lang.String name, java.lang.Object value)

setAttributes(java.util.Hashtable attributes)

setCreateDate(java.util.Date date)

setHasLoggedIn(boolean value)

updateLastLogin()

UserManager.java 具有以下新字段：

public static final long DEVICE_MODEL_IGNORE

public static final long DEVICE_MODEL_UNKNOWN

UserManager.java 的以下字段已过时：

public static final int ID

public static final int LAST_NAME

public static final int FIRST_NAME

public static final int LOGIN_NAME

public static final int STATUS

public static final int KEY

UserManager.java 的以下方法已过时：

accountExists(java.lang.String userId)

disableUser(java.lang.String userId)

改用 disableUser(User)。

doAccountExists(java.lang.String userId)

doEnableUser(java.lang.String userId)

改用 doEnableUser(User)。

doGetAllLikeInOrder(java.lang.String[] columns, java.lang.String[] values, java.lang.String[] orders, boolean isDescending, int pageNum, int recPerPage, java.lang.String role)

doGetAllUsers(java.lang.String role)

doGetAllUsersContainingFirstName(java.lang.String firstName, java.lang.String role)

doGetAllUsersContainingId(java.lang.String userId, java.lang.String role)

doGetAllUsersContainingLastName(java.lang.String lastName, java.lang.String role)

doGetAllUsersContainingName(java.lang.String name, java.lang.String role)

doGetAnonymousUser()

doGetFieldName(int fieldConstant, java.lang.String role)

doGetUser(java.lang.String userId)

改用 doGetUserByLoginId(String)。

doIsActive(java.lang.String userId)

doIsAuthenticated(java.lang.String inUserId, java.lang.String inPassword)

改用 doAuthenticatePassword(User, String)。

doRemoveUser(java.lang.String userId)

改用 doRemoveUser(User)。

enableUser(java.lang.String userId)

改用 enableUser(User)。

getAllLikeInOrder(java.lang.String[] columns, java.lang.String[] values, java.lang.String[] orders, boolean isDescending, int pageNum, int recPerPage)

getAllLikeInOrder(java.lang.String[] columns, java.lang.String[] values, java.lang.String[] orders, boolean isDescending, int pageNum, int recPerPage, java.lang.String role)

getAllUsers()

getAllUsers(java.lang.String role)

getAllUsersContainingFirstName(java.lang.String firstName)

getAllUsersContainingFirstName(java.lang.String firstName, java.lang.String role)

getAllUsersContainingId(java.lang.String userId)

getAllUsersContainingId(java.lang.String userId, java.lang.String role)

getAllUsersContainingLastName(java.lang.String lastName)

getAllUsersContainingLastName(java.lang.String lastName, java.lang.String role)

getAllUsersContainingName(java.lang.String name)

getAllUsersContainingName(java.lang.String nameLike, java.lang.String role)

getAnonymousUser()

getFieldName(int fieldConstant)

getFieldName(int fieldConstant, java.lang.String role)

getUser(java.lang.String userId)

改用 getUserByLoginId(String)。

isActive(java.lang.String userId)

isAuthenticated(java.lang.String inUserId, java.lang.String inPassword)

改用 authenticatePassword(User, String)。

removeUser(java.lang.String userId)

改用 removeUser(User)。

有关已过时安全方法的完整列表，请参见 $CDS_HOME/javadoc/cdsapi 目录中的 deprecated-list.html 文件。

WAP 网关 API 的变更

新版本中的 WAP 网关 API 发生了变更并添加了内容。向 WAPGatewayAdapter.java 中添加了以下字段：

public static final java.lang.String HANDLE_MSISDN

public static final java.lang.String HANDLE_MSISDN_MAP

public static final java.lang.String HANDLE_UNIQUE_ID

public static final java.lang.String HANDLE_UNIQUE_ID_MAP