Release Notes / Middle Tier: Removal of Deprecated API

Upgrade Steps:

The following deprecated API has been removed and may require adapting usages:

Module bpbase-cae-api:

com.coremedia.blueprint.base.cae.web.taglib.ImageFunctions
The overloaded frontend ImageFunctions#getImageLinkForAspectRatio methods have been removed. Use ImageFunctions#getImageLinkForAspectRatio(Blob, String, Map, boolean, String, HttpServletRequest, HttpServletResponse, boolean) instead.
The implementation of com.coremedia.blueprint.cae.web.taglib.BlueprintFreemarkerFacade#transformedImageUrl got adapted accordingly.

Module bpbase-lc-common:

com.coremedia.blueprint.base.livecontext.ecommerce.common.CommercePropertyHelper:
- The method replaceTokens(String, Map<String,Object>, boolean):String has been removed.
  Use AbstractPropertyResolver#resolvePlaceholders(String):String instead using the PropertySourcesPropertyResolver provided by CommercePropertyHelper#propertySourcesPropertyResolver.

Module bpbase-pagegrid-api:

com.coremedia.blueprint.base.pagegrid.PageGridContentKeywords
- Removed constants LEGACY_LINK_PROPERTY_NAME (original value: "LinkPropertyName") and LEGACY_LINK_LIST_PROPERTY_NAME (original value "LinkListPropertyName") that were only required to deal with legacy content items. While corresponding legacy content items continue to work, if they define these properties, new page grids should use the values of PageGridContentKeywords#SECTION_PROPERTY_NAME for the former and PageGridContentKeywords#ITEMS_PROPERTY_NAME for the latter.

Module bpbase-sfmc:

com.coremedia.blueprint.base.sfmc.libservices.dataextensions.SFMCDataExtensionService
The method pushToDataExtension(SFMCContext, String, List<DataExtensionEntry>) has been removed. Use instead: pushToDataExtension(SFMCContext, SFMCDataExtensionContext, String, List<DataExtensionEntry>) of the same interface.

Module cae-contentbeanservices:

com.coremedia.objectserver.blob.BeanPropertyBlob
- Aligned with deprecation removal Blob.getSize():int in common tier, removed method getSize():int. Use getSizeLong():long instead.

Module cap-feeder-api:

com.coremedia.cap.feeder.FeedableWeightHelper
- Removed method weighElement(FeedableElement):int. Use weighElementLong(FeedableElement):long instead.
- Removed method weighFeedable(Feedable):int. Use method weighFeedableLong(Feedable):long instead.

Module cap-rest-service:

Module cap-transform:

com.coremedia.cap.transform.ExtractDimensionCacheKey
- Removed 5-arg constructor (with additional MIME-Type and size) as the additional parameters were ignored and the 3-arg constructor (signature: ExtractDimensionCacheKey(ContentRepository, ImageDimensionsExtractor, String)) should be used instead.
com.coremedia.cap.transform.ImageVariantSetting
- Removed methods setGamma(Double):void and getGamma():Double without replacement. They showed misaligned and thus hardly predictable behavior for different types of images.
com.coremedia.cap.transform.TransformImageService:
- The method getTransformationString has been removed without replacement (accidentally made it to public API).

Module cap-unified-api-util:

com.coremedia.cap.util.ObjectCacheKey
- Class removed. Use com.coremedia.cache.util.ObjectCacheKey instead (module: coremedia-cache).
com.coremedia.cap.util.PairCacheKey
- Class removed. Use com.coremedia.cache.util.PairCacheKey instead (module: coremedia-cache).
com.coremedia.cap.util.StructUtil
Methods removed. Use alternatives in com.coremedia.cap.util.CapStructUtil instead:
- findString(Struct, String):Optional<String>
- getBoolean(Struct, String):boolean
- getInteger(Struct, String):Integer
- getLink(Struct, String):Content
- getLinks(Struct, String):List<Content>
- getLong(Struct, String):Long
- getString(Struct, String):String
- getStrings(Struct, String):List<String>
- getSubstruct(Struct, String):Struct
- getSubstructs(Struct, String):List<Struct>
- hasPropertyDescriptor(Struct, String):boolean

Module coremedia-transform:

com.coremedia.transform.image.ImageOperations
- Removed method crop(ImageTransformerState<Image>, int, int, int, int, String):void from the interface. Method to use and implement instead: crop(ImageTransformerState<Image>, int, int, int, int, String):void.
- Removed method gamma(ImageTransformerState<Image>, double):void without replacement aligned with removed getGamma and setGamma in ImageVariantSetting.
  **Note on image transformations: With this change the image transformation operation gamma (alias g) is not available anymore (raises an UnsupportedOperationException if still part of the transformation string). The section “Image Operations” in section “Image Transformation API” in CAE Developer Manual got adapted accordingly.
- Replaced method unsharpMask(ImageTransformerState<Image>, float, float, int):void by its no-parameter variant unsharpMask(ImageTransformerState<Image>):void, which is aligned with the deprecation notice, that any other than the default parameters (amount=0.15, radius=2, threshold=10) should not be used.
com.coremedia.transform.image.java2d.Java2DImageOperations
- Adapted according to changes in ImageOperations (removed one of the implemented crop methods, method gamma).
- Updated implementation of unsharpMask to align with the signature change applying the defaults for amount, radius, and threshold as described above.

Module middle.cap-validation:

com.coremedia.rest.cap.validation.ContentTypeValidatorBase
- Class removed. Use com.coremedia.rest.cap.validation.AbstractContentTypeValidator instead (same module).
com.coremedia.rest.cap.validation.PredicateAwareValidatorBase
- Class removed. Implement com.coremedia.rest.cap.validation.CapTypeValidator directly instead (same module).
com.coremedia.rest.cap.validators.CrossSiteLinkValidator
- Removed method setSeverity(Severity):void. Use setDefaultSeverity(Severity):void instead.

Module middle.coremedia-validation:

com.coremedia.rest.validation.ObjectPropertyValidatorBase
- Class removed. Use com.coremedia.rest.validation.AbstractPropertyValidator instead (same module).
com.coremedia.rest.validation.PropertyValidatorBase
- Class removed. Use com.coremedia.rest.validation.AbstractPropertyValidator instead (same module)

(CMS-27564)

Search Results