Broadleaf Microservices
  • v1.0.0-latest-prod

Asset Release Notes for 2.0.1-GA

Important Updates

Spring Boot Upgrade

  • As of Broadleaf Release Train 2.0.0-GA, all microservices have been upgraded to Spring Boot 3.

  • This version includes all changes up to 1.7.12 Release Notes

Enhancements

  • Added a generic attributes map to Asset entities to allow for custom attributes to be added to assets

  • When an image is uploaded to the admin, the image’s dimensions are now stored in the attribute map for the asset

    • asset.attributes['width'] and asset.attributes['height'] are now available for images

  • Refine StorageProvider-related interfaces to better support stream-based approaches.

    • The StorageProvider interface was refactored to work with InputStream instead of java.io.File to read and store the asset resources to allow easier integration with third party storage services.

    • Introduced a new Spring Resource wrapper class ResourceWithMetadata, that contains the additional resource metadata like fileName, contentType etc. It is used by StorageProvider to allow populate the metadata of the stored resource.

    • Introduced a new GoogleCloudStorageProvider implementation for the StorageProvider that uses Google Cloud storage to store the files. This is disabled by default.

Configuration Properties

Added Properties

  • broadleaf.asset.internal.storage-provider.implementation

    • Description: The name of the storage provider implementation. By default, supports FILESYSTEM for the FilesystemStorageProvider implementation or GCS for the GoogleCloudStorageProvider

    • Default value: FILESYSTEM

  • broadleaf.asset.internal.storage-provider.google-cloud-storage.bucket-name

    • Description: The bucket name

  • broadleaf.asset.internal.storage-provider.google-cloud-storage.project-id

    • Description: The project ID

  • broadleaf.asset.internal.storage-provider.google-cloud-storage.path-prefix-in-bucket

    • Description: Optional path in the bucket where assets will be uploaded

    • Default value: blc_assets

  • broadleaf.asset.internal.storage-provider.google-cloud-storage.max-generated-directory-depth

    • Description: Sets the maximum generated directory depth on the filesystem based on the MD5 hash of the filename. Note: values greater than 3 are not supported

    • Default value: 2