Broadleaf Microservices
  • v1.0.0-latest-prod

Upgrade to 2.1.4

View as single page

April 16, 2025

Tip
 The 2.x versions are Spring Boot 3 compatible.
Tip
 If coming from a version prior to 2.0.0-GA, then see the 2.0.0 upgrade guide.

Requirements

  • Java 17 is required since 2.0.0-GA.

Notable Changes

Feature/Notable Change Impacted Services Links

Support for Flash Sale

CartOperationServices, PricingServices, Import, ScheduledJobServices

Please refer to Flash Sale for more information.

Support to view Scheduled Job Execution Details

ScheduledJobServices, MicroMessagingCommon

Please refer to Scheduled Job Release Notes for 2.1.4-GA for more information.

AssetServices Storage Provider Path Changes

AssetServices

There is an important change made to the storage path new assets will be stored at in AssetServices. Please review the AssetServices 2.0.3 release notes describing the change

Added new Audit Microservice

AuditServices, AuditCommon

Added new Workflow Microservice

WorkflowServices, WorkflowClient

Improved service-to-service calls within a single flex package to skip overhead of external calls.

MicroExtensionCommon

See details and configuration in the Micro Extension Common Release Notes for 2.0.5

Added support for receiving updated transaction results through the webhook.

PaymentGatewayCommon, PaymentTransactionServices, Adyen

Remember-Me Login

AuthenticationServices, AuthSDK, AdminWeb, NextJS Starter

Introduced new Product & Category Membership Bulk Operations

CatalogServices, BulkOperationsServices, SandboxServices

Updated discriminated properties to be case insensitive

Across all Microservices that utilize DiscriminatedProperties

See individual release notes for a full list of updated services & classes.

Mitigation of Sandbox NotificationState buildup

SandboxServices

Overriding Manifest Properties via ENV properties

Project Initializer Manifest

Additional documentation has been added regarding our manifest environment setup & the ability to override manifest properties.

Security

To review the security related content, see 2.1.4 notes.

Tip

You will need your login credentials originally provided for accessing the Broadleaf nexus. Security fixes often involve dependency updates to remediate issues being tracked in external OSS components. It is worth considering adopting releases with security fixes (even Broadleaf Severity LOW) to avoid any possibility of transitive exposure in your codebase.

Frontend Compatibility and Release Notes

Microservices release 2.1.4 is congruent with:

Service-level Release Notes

Services

New

Existing

Tax Provider Libraries

Payment Integration Libraries

Common Libraries