Adjust for Removed Deprecations

Update your implementation to address removed deprecations when upgrading from brXM 16.x to 17.y.

Removed Jackrabbit RMI References

Bloomreach Content 17 uses Jackrabbit 2.22.2, which no longer includes RMI support. For more information, see JCR-4972.

If your project connects to the repository using RMI, migrate to a supported connection method before upgrading.

Removed RGB Autoconversion Option

Prior to version 16.7, images uploaded with CMYK or YCCK color models were automatically converted to RGB. Starting with 16.7, this conversion was disabled due to image quality issues. In 17.0, the configuration option to re-enable the previous behavior has been removed.

The following items have been removed:

  1. Configuration node: /hippo:configuration/hippo:frontend/cms/cms-services/galleryProcessorService/convertToRGB
  2. Method: org.hippoecm.frontend.plugins.gallery.imageutil.ImageUtils#convertToRGB

Additionally, org.hippoecm.frontend.plugins.gallery.imageutil.ImageBinary now provides only a single constructor.

If your project references the convertToRGB configuration or calls ImageUtils#convertToRGB, remove these references before upgrading.

HippoWorkflowEvent — Removed Deprecated Event Keys

Code that listens to the event bus and accesses workflow events by key name will now receive null for removed keys. Three deprecated event property keys and their associated getter/setter methods have been removed from the underlying HippoEvent map.

Removed methodRemoved JCR log keyUse instead
methodName() / methodName(String)"methodName"action() / action(String)
handleUuid() / handleUuid(String)"handleUuid"subjectId() / subjectId(String)
documentPath() / documentPath(String)"documentPath"subjectPath() / subjectPath(String)

Impact on persisted event data:
WorkflowLogger no longer writes the methodName, handleUuid, or documentPath keys to JCR workflow log nodes under /hippo:log. Update any queries (such as Groovy scripts or custom dashboards) that reference these properties to use action, subjectId, or subjectPath instead.

List of Removed Deprecated Classes and Methods

The following deprecated classes and methods have been removed.

Community Module

CMS (community/cms)

  • org.hippoecm.addon.workflow.AbstractWorkflowDialog — deprecated since 13.1; use org.hippoecm.addon.workflow.WorkflowDialog
  • org.hippoecm.frontend.editor.plugins.resource.ImageInfo — deprecated since 14.7.0; no replacement
  • org.hippoecm.frontend.plugins.standards.browse.BreadcrumbPlugin — deprecated since 10.0.x; use org.hippoecm.frontend.widgets.breadcrumb.NodeBreadcrumbWidget (included by default in LinkPickerDialog and AbstractBrowserDialog)
  • org.hippoecm.frontend.plugins.standards.list.resolvers.CssClass — deprecated; use org.hippoecm.frontend.attributes.ClassAttribute
  • org.hippoecm.frontend.editor.plugins.linkpicker.FacetSelectTemplatePlugin — deprecated; no replacement
  • org.hippoecm.frontend.plugins.login.BrowserCheckBehavior — deprecated since 15.2.3; server-side browser detection is no longer supported
  • org.hippoecm.frontend.plugins.cms.browse.model.BrowserSectionsModel — deprecated; no replacement
  • org.hippoecm.frontend.plugins.reviewedactions.dialogs.DatePickerComponent — deprecated since 16.3.0; use org.hippoecm.frontend.component.DatePickerComponent
  • org.hippoecm.addon.workflow.StdWorkflow constructors with String or StringResourceModel arguments — use constructors with explicit WorkflowDescriptorModel argument
  • org.hippoecm.frontend.validation.SvgValidator — deprecated since 16.7; use com.bloomreach.cms.services.mediavalidation.svg.SvgValidationService
  • org.hippoecm.frontend.validation.SvgValidationResult — deprecated since 16.7; use com.bloomreach.cms.services.mediavalidation.svg.SvgValidationResult
  • org.hippoecm.frontend.plugins.gallery.imageutil.ScalingParameters constructors — use ScalingParameters.Builder
  • org.hippoecm.frontend.plugins.gallery.imageutil.ScalingParameters#getUpscaling() — use isUpscaling()
  • org.hippoecm.frontend.plugins.gallery.imageutil.ScalingParameters#getCompressionQuality() — use getLossyCompressionQuality()
  • org.hippoecm.frontend.plugins.gallery.imageutil.ScaleImageOperation constructors — use ScalingParameters.Builder
  • org.hippoecm.frontend.plugins.gallery.imageutil.AbstractScaleImageOperation#getCompressionQuality() — use ScalingParameters#getLossyCompressionQuality()
  • org.hippoecm.frontend.plugins.gallery.imageutil.AbstractScaleImageOperation#getScaledData() — use ImageOperationResult#getData()
  • org.hippoecm.frontend.plugins.gallery.imageutil.AbstractScaleImageOperation#getScaledWidth() — use ImageOperationResult#getWidth()
  • org.hippoecm.frontend.plugins.gallery.imageutil.AbstractScaleImageOperation#getScaledHeight() — use ImageOperationResult#getHeight()
  • org.hippoecm.frontend.plugins.gallery.imageutil.AbstractScaleImageOperation#calculateResizeRatio(double, double, int, int) — use ImageUtils#determineResizeRatio(double, double, int, int)
  • org.hippoecm.frontend.plugins.gallery.imageutil.ImageUtils#writeImage(ImageWriter, BufferedImage) — use writeImage(ImageWriter, BufferedImage, float, float)
  • org.hippoecm.frontend.plugins.gallery.imageutil.ImageUtils#writeImage(ImageWriter, BufferedImage, float compressionQuality) — deprecated since 16.7.0; use writeImage(ImageWriter, BufferedImage, float, float)
  • org.hippoecm.frontend.plugins.gallery.imageutil.ImageUtils#scaleImage(BufferedImage, Rectangle, Dimension, Object hint, boolean) — use cropImage() and scaleImage(BufferedImage, int, int, ScalingStrategy)
  • org.hippoecm.frontend.plugins.gallery.imageutil.ImageUtils#scaleImage(BufferedImage, int xOff, int yOff, int srcW, int srcH, int tgtW, int tgtH, Object hint, boolean) — use cropImage() and scaleImage(BufferedImage, int, int, ScalingStrategy)
  • org.hippoecm.frontend.plugins.gallery.model.GalleryProcessor#isUpscalingEnabled(Node) — use ScalingParameters#isUpscaling()
  • org.hippoecm.frontend.plugins.gallery.model.GalleryProcessor#getScalingParametersMap() — use getScalingParameters(Node)
  • org.hippoecm.frontend.plugins.jquery.upload.AbstractFileUploadWidget(String id, IPluginConfig, FileUploadValidationService) — use the constructor with FileUploadPreProcessorService
  • org.hippoecm.frontend.plugins.jquery.upload.single.SingleFileUploadWidget(String, IPluginConfig, FileUploadValidationService, boolean) — deprecated since 16.7; use the constructor with FileUploadPreProcessorService
  • org.hippoecm.frontend.plugins.standards.DocumentListFilter(DocumentListFilter parent, String state) — deprecated since 15.7.1; use DocumentListFilter(IPluginConfig)
  • org.hippoecm.frontend.plugins.standards.DocumentListFilter#filter(Node current, NodeIterator) — deprecated since 15.7.1; use filter(NodeIterator)
  • org.hippoecm.frontend.model.PropertyValueProvider.EMPTY_DATE_VALUE — use org.onehippo.repository.util.DateConstants.EMPTY_DATE_VALUE
  • org.hippoecm.frontend.model.PropertyValueProvider.EMPTY_DATE — use org.onehippo.repository.util.DateConstants.EMPTY_DATE

CRISP Addon (community/crisp)

  • org.onehippo.cms7.crisp.core.resource.DefaultValueMap — deprecated; use org.onehippo.cms7.crisp.api.resource.DefaultValueMap
  • org.onehippo.cms7.crisp.api.exchange.ExchangeHint#getRequest() — use getRequestHeaders() and getRequestBody()
  • org.onehippo.cms7.crisp.api.exchange.ExchangeHintBuilder#request(Object) / #request() — use requestBody(Object) / requestHeaders(Map)
  • org.onehippo.cms7.crisp.hst.module.CrispHstServices.getModuleComponent(String name) — use getModuleComponent(HstServices.getComponentManager(), name)
  • org.onehippo.cms7.crisp.hst.module.CrispHstServices.getDefaultResourceServiceBroker() — use getDefaultResourceServiceBroker(HstServices.getComponentManager())
  • org.onehippo.cms7.crisp.core.resource.FileBinary — deprecated; use SpringResourceBinary, for example: new SpringResourceBinary(new FileSystemResource(file), true)

Essentials Components (community/essentials-components)

  • org.onehippo.cms7.essentials.components.utils.query.HstQueryBuilder — deprecated since 3.1.1; use org.hippoecm.hst.content.beans.query.builder.HstQueryBuilder
  • org.onehippo.cms7.essentials.components.utils.query.QueryBuilder — deprecated since 3.1.1; use org.hippoecm.hst.content.beans.query.builder.HstQueryBuilder
  • org.onehippo.cms7.essentials.components.utils.ComponentsUtils#getPublicRequestParameters(BaseHstComponent, HstRequest, String) — use BaseHstComponent#getPublicRequestParameters(HstRequest, String)
  • org.onehippo.cms7.essentials.components.EssentialsCarouselComponent#getCarouselItems(EssentialsCarouselComponentInfo) — use getCarouselItems(List)

Repository (community/repository)

  • org.hippoecm.repository.Log4j1LoggerLevelManager — deprecated; Log4j 1.x is no longer supported, use Log4j 2
  • org.onehippo.repository.events.HippoWorkflowEvent#methodName() / #methodName(String) — use action() / action(String)
  • org.onehippo.repository.events.HippoWorkflowEvent#handleUuid() / #handleUuid(String) — use subjectId() / subjectId(String)
  • org.onehippo.repository.events.HippoWorkflowEvent#documentPath() / #documentPath(String) — use subjectPath() / subjectPath(String)
  • org.hippoecm.repository.util.DateTools#getSupportedDateResolutions() — use getSupportedResolutions()
  • org.onehippo.repository.scheduling.RepositoryJobExecutionContext#getSession(Credentials) — use createSession(Credentials)
  • org.onehippo.repository.scheduling.RepositoryJobExecutionContext#getSystemSession() — use createSystemSession()
  • org.hippoecm.repository.standardworkflow.FolderWorkflow#list() — use hints().get("prototypes")
  • org.onehippo.repository.documentworkflow.DocumentWorkflow#requestPublication(Date publicationDate, Date depublicationDate) — use requestPublicationDepublication(Date, Date)
  • org.hippoecm.repository.PasswordHelper#getHashingAlogrithm() — typo variant; use getHashingAlgorithm()
  • org.hippoecm.repository.PasswordHelper#setHashingAlogrithm(String) — typo variant; use setHashingAlgorithm(String)
  • org.hippoecm.repository.gallery.GalleryWorkflow#createGalleryItem(String, String) — deprecated since 5.0 (CMS 12.0); use createGalleryItem(String, String, String)
  • org.hippoecm.repository.gallery.impl.GalleryWorkflowImpl(Session, Session, Node) — deprecated since 16.9.0; use GalleryWorkflowImpl(WorkflowContext, Session, Session, Node)
  • org.onehippo.repository.mock.MockNode#addMockNode(String, String) — use addNode(String, String)
  • org.onehippo.repository.mock.MockPropertyDefinition(String, boolean) — use MockPropertyDefinition(String, int, boolean)
  • org.hippoecm.repository.query.lucene.ServicingIndexingConfiguration#getSkipIndexName() — deprecated since 13.0.0; feature removed, no replacement
  • org.hippoecm.repository.query.lucene.StandardHippoAnalyzer.CJK_STOP_WORDS — deprecated since 5.0 (CMS 12.0); locale-specific stop words are no longer provided in the public API
  • org.hippoecm.repository.query.lucene.StandardHippoAnalyzer.SPANISH_STOP_WORDS — deprecated since 5.0 (CMS 12.0); locale-specific stop words are no longer provided in the public API

Search Service (community/search-service)

  • org.onehippo.cms7.services.search.query.constraint.SubQueryConstraint — deprecated since 16.5.0; use AppendQueryConstraint or PrependQueryConstraint
  • org.onehippo.cms7.services.search.query.Query#returnSubquery(String subqueryFilter) — deprecated since 16.5.0; use returnPrependQuery(String) or returnAppendQuery(String)

Selections Addon (community/selections)

  • org.onehippo.forge.selection.frontend.provider.IValueListProvider#getValueList(IPluginConfig) — use getValueList(String, Locale)
  • org.onehippo.forge.selection.frontend.provider.IValueListProvider#getValueList(String name) — use getValueList(String, Locale)

Services API (community/services-api)

  • org.onehippo.cms7.services.googleanalytics.GoogleAnalyticsService — deprecated; Google Universal Analytics is decommissioned, migrate to GA4
  • org.onehippo.cms7.services.HippoServiceRegistry.registerService(T, Class<T>) — deprecated since v13.0; use register(T, Class<T>)
  • org.onehippo.cms7.services.HippoServiceRegistry.unregisterService(T, Class<T>) — deprecated since v13.0; use unregister(T, Class<T>)
  • org.onehippo.cms7.services.project.Project#getLastModificationDate() / #setLastModificationDate(long) — use getLastModifiedAt()
  • org.onehippo.cms7.services.project.Project#getStartRunningAt() / #setStartRunningAt(Long) — use getStartRunningFrom() / setStartRunningFrom(Calendar)
  • org.onehippo.cms7.services.project.Project#getStopRunningAt() / #setStopRunningAt(Long) — use getStopRunningAfter() / setStopRunningAfter(Calendar)

HST API (community/site-toolkit)

  • org.hippoecm.hst.core.jcr.RuntimeRepositoryException — deprecated; use org.hippoecm.repository.api.RuntimeRepositoryException
  • org.hippoecm.hst.environment.EnvironmentParameters — deprecated since 13.3.0; no replacement
  • org.hippoecm.hst.platform.configuration.environment.EnvironmentUtils — deprecated since 13.3.0; no replacement
  • org.hippoecm.hst.platform.configuration.environment.HostConfigListener — deprecated since 13.3.0; no replacement
  • org.hippoecm.hst.platform.configuration.environment.HostConfigPublisher — deprecated since 13.3.0; no replacement
  • org.hippoecm.hst.platform.configuration.environment.OptionalEnvironmentEventListenerItemImpl — deprecated since 13.3.0; no replacement
  • org.hippoecm.hst.core.sitemapitemhandler.HstSiteMapItemHandler#destroy() — deprecated since 13.0.0; not invoked, no replacement
  • org.hippoecm.hst.core.sitemapitemhandler.AbstractHstSiteMapItemHandler#destroy() — deprecated since 13.0.0; not invoked, no replacement
  • org.hippoecm.hst.core.jcr.SessionSecurityDelegation#getOrCreateLiveSecurityDelegate(Credentials, String key) — deprecated since 13.0.1; use createLiveSecurityDelegate(Credentials, boolean)
  • org.hippoecm.hst.core.jcr.SessionSecurityDelegation#getOrCreatePreviewSecurityDelegate(Credentials, String key) — deprecated since 13.0.1; use createPreviewSecurityDelegate(Credentials, boolean)
  • org.hippoecm.hst.pagecomposer.jaxrs.api.PageCopyEvent#getPageCopyContext() — use getPageActionContext()
  • org.hippoecm.hst.core.channelmanager.ChannelManagerConstants.HST_PAGE_EDITABLE — deprecated since 14.x Experience Pages; no replacement
  • org.hippoecm.hst.core.parameters.@Parameter#description() annotation element — value was never used; configure hints in the ParametersInfo class resource bundle
  • org.hippoecm.hst.servlet.utils.HeaderUtils#setExpiresHeaders(HttpServletResponse, BinaryPage) — use setExpiresHeaders(HttpServletResponse, BinaryPage, long)

Taxonomy (community/taxonomy)

  • org.onehippo.taxonomy.plugin.model.JcrCategoryInfo(IModel<Node> categoryInfoModel, boolean editable) — deprecated; use the no-argument or other available constructor

Utilities (community/utilities)

  • org.hippoecm.hst.servlet.ResourceServlet — deprecated; use org.onehippo.cms7.utilities.servlet.ResourceServlet

Enterprise Module

Reporting Dashboard (enterprise/reporting-dashboard)

  • com.onehippo.cms7.reports.plugins.chart.AbstractChartStore(Component component) — deprecated; use the constructor that includes a report name
  • com.onehippo.cms7.search.frontend.engine.model.QueryResultModel(IModel<Query> queryModel) — deprecated; does not include a limit parameter; use the other constructor

Enterprise Services API (enterprise/services-api)

  • com.onehippo.cms7.services.wpm.project.Project — deprecated since 16.3.0; use org.onehippo.cms7.services.project.Project
  • com.onehippo.cms7.services.wpm.project.ProjectService — deprecated since 16.3.0; use org.onehippo.cms7.services.project.ProjectService
  • com.onehippo.cms7.services.wpm.project.ProjectState — deprecated since 16.3.0; use org.onehippo.cms7.services.project.ProjectState
Share Feedback
Page: /about/upgrade-guides/upgrade-to-brxm-17/adjust-for-removed-deprecations
Section: About
Category *