Upgrade to Microstream 08.01.02-MS-GA and the integration with Eclipse Store 1.2.0

Author: hrstoyanov

THIRD_PARTY_LICENSES.txt

@@ -31,7 +31,7 @@ Fourth Party Runtime Dependencies
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 CDI-API  RedHat, Inc., JBoss community
 Apache 2.0
-Used by: [helidon-health-checks, helidon-integrations-cdi-datasource, helidon-integrations-cdi-datasource-hikaricp, helidon-integrations-cdi-datasource-ucp, helidon-integrations-cdi-delegates, helidon-integrations-cdi-eclipselink, helidon-integrations-cdi-hibernate, helidon-integrations-cdi-jpa, helidon-integrations-cdi-jta, helidon-integrations-cdi-jta-weld, helidon-integrations-cdi-reference-counted-context, helidon-integrations-micrometer-cdi, helidon-integrations-micronaut-cdi, helidon-integrations-micronaut-data, helidon-integrations-microstream-cdi, helidon-integrations-oci-sdk-cdi, helidon-integrations-vault-cdi, helidon-jersey-client, helidon-messaging-aq, helidon-messaging-jms, helidon-messaging-kafka, helidon-messaging-mock, helidon-messaging-wls-jms, helidon-microprofile-config, helidon-microprofile-cors, helidon-microprofile-fault-tolerance, helidon-microprofile-metrics, helidon-microprofile-server, helidon-microprofile-service-common, helidon-microprofile-telemetry, helidon-microprofile-tracing, helidon-microprofile-websocket, weld-se-core]
+Used by: [helidon-health-checks, helidon-integrations-cdi-datasource, helidon-integrations-cdi-datasource-hikaricp, helidon-integrations-cdi-datasource-ucp, helidon-integrations-cdi-delegates, helidon-integrations-cdi-eclipselink, helidon-integrations-cdi-hibernate, helidon-integrations-cdi-jpa, helidon-integrations-cdi-jta, helidon-integrations-cdi-jta-weld, helidon-integrations-cdi-reference-counted-context, helidon-integrations-micrometer-cdi, helidon-integrations-micronaut-cdi, helidon-integrations-micronaut-data,  helidon-integrations-microstream-cdi, helidon-integrations-eclipsestore-cdi, helidon-integrations-oci-sdk-cdi, helidon-integrations-vault-cdi, helidon-jersey-client, helidon-messaging-aq, helidon-messaging-jms, helidon-messaging-kafka, helidon-messaging-mock, helidon-messaging-wls-jms, helidon-microprofile-config, helidon-microprofile-cors, helidon-microprofile-fault-tolerance, helidon-microprofile-metrics, helidon-microprofile-server, helidon-microprofile-service-common, helidon-microprofile-telemetry, helidon-microprofile-tracing, helidon-microprofile-websocket, weld-se-core]
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 Jakarta CDI API (jakarta.enterprise:jakarta.enterprise.cdi-api)
   Copyright 2010, 2016, Red Hat, Inc., and individual contributors
@@ -1069,7 +1069,7 @@ See full text at the bottom of this document for license: Apache-2.0
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 Jakarta Annotations API  Eclipse Foundation
 Eclipse Public License 2.0 + GPL v.2 with CPE
-Used by: [helidon-bundles-config, helidon-config, helidon-config-hocon, helidon-config-mp, helidon-config-tests-module-mappers-1-base, helidon-config-tests-module-mappers-2-override, helidon-config-tests-module-parsers-1-override, helidon-config-tests-test-bundle, helidon-config-yaml, helidon-config-yaml-mp, helidon-http-encoding, helidon-inject-api, helidon-inject-configdriven-runtime, helidon-inject-configdriven-tests-config, helidon-inject-configdriven-tests-configuredby, helidon-inject-configdriven-tests-configuredby-application, helidon-inject-maven-plugin, helidon-inject-runtime, helidon-inject-tests-interception, helidon-inject-tests-resources-inject, helidon-inject-tests-resources-plain, helidon-inject-tests-tck-jsr330, helidon-inject-tools, helidon-integrations-cdi-datasource, helidon-integrations-cdi-datasource-hikaricp, helidon-integrations-cdi-datasource-ucp, helidon-integrations-cdi-jpa, helidon-integrations-cdi-jta, helidon-integrations-micronaut-cdi-processor, helidon-integrations-micronaut-data, helidon-integrations-microstream-cdi, helidon-integrations-oci-sdk-cdi, helidon-integrations-oci-sdk-tests-test-application, helidon-integrations-oci-sdk-tests-test-module1, helidon-integrations-oci-sdk-tests-test-module2, helidon-integrations-oci-tls-certificates, helidon-jersey-client, helidon-messaging-mock, helidon-microprofile-fault-tolerance, helidon-microprofile-telemetry, weld-se-core]
+Used by: [helidon-bundles-config, helidon-config, helidon-config-hocon, helidon-config-mp, helidon-config-tests-module-mappers-1-base, helidon-config-tests-module-mappers-2-override, helidon-config-tests-module-parsers-1-override, helidon-config-tests-test-bundle, helidon-config-yaml, helidon-config-yaml-mp, helidon-http-encoding, helidon-inject-api, helidon-inject-configdriven-runtime, helidon-inject-configdriven-tests-config, helidon-inject-configdriven-tests-configuredby, helidon-inject-configdriven-tests-configuredby-application, helidon-inject-maven-plugin, helidon-inject-runtime, helidon-inject-tests-interception, helidon-inject-tests-resources-inject, helidon-inject-tests-resources-plain, helidon-inject-tests-tck-jsr330, helidon-inject-tools, helidon-integrations-cdi-datasource, helidon-integrations-cdi-datasource-hikaricp, helidon-integrations-cdi-datasource-ucp, helidon-integrations-cdi-jpa, helidon-integrations-cdi-jta, helidon-integrations-micronaut-cdi-processor, helidon-integrations-micronaut-data,  helidon-integrations-microstream-cdi, helidon-integrations-eclipsestore-cdi, helidon-integrations-oci-sdk-cdi, helidon-integrations-oci-sdk-tests-test-application, helidon-integrations-oci-sdk-tests-test-module1, helidon-integrations-oci-sdk-tests-test-module2, helidon-integrations-oci-tls-certificates, helidon-jersey-client, helidon-messaging-mock, helidon-microprofile-fault-tolerance, helidon-microprofile-telemetry, weld-se-core]
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 Jakarta Annotations API (jakarta.annotation:jakarta.annotation-api)
 Copyright (c) 2009, 2022 Oracle and/or its affiliates. All rights reserved.
@@ -8305,6 +8305,64 @@ Fourth Party Runtime Dependencies
   EPL-2.0
 -----------------------------------------
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+eclipsestore-storage-embedded-configuration  Microstream Software
+Eclipse Public License 2.0
+Used by: [helidon-integrations-eclipsestore]
+=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+1.  The following files are available in source code form under the Eclipse Public License at:
+    https://github.com/eclipsestore/store/
+    (The EPL license is reproduced below).
+2.  All past Contributors to the Eclipsestore project disclaim all warranties and
+    conditions, express and implied, including warranties or conditions of title and
+    non-infringement, and implied warranties or conditions of merchantability and
+    fitness for a particular purpose.  In addition, such Contributors are not liable
+    for any damages, including direct, indirect, special, incidental and consequential
+    damages, such as lost profits.  
+3.  Any provisions of the Oracle license agreement that differ from the Eclipse Public
+    License are offered by Oracle alone and not by any other party.
+_________________________________________________________
+
+Eclipsestore Embedded Storage Configuration (org.eclipse.store:eclipsestore-storage-embedded-configuration)
+  Copyright (C) 2024 MicroStream Software
+--------------------------------------------
+See full text at the bottom of this document for license: EPL-2.0
+--------------------------------------------
+Fourth Party Runtime Dependencies
+--------------------------------------------
+"Eclipsestore Embedded Storage" (org.eclipse.store:eclipsestore-storage-embedded)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+--------------------------------------------
+"Eclipsestore Storage" (org.eclipse.store:eclipsestore-storage)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+--------------------------------------------
+"Eclipsestore Abstract File System - Java NIO" (org.eclipse.store:eclipsestore-afs-nio)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+--------------------------------------------
+"Eclipsestore Abstract File System" (org.eclipse.store:eclipsestore-afs)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+--------------------------------------------
+"Eclipsestore Persistence Binary" (org.eclipse.store:eclipsestore-persistence-binary)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+--------------------------------------------
+"Eclipsestore Persistence" (org.eclipse.store:eclipsestore-persistence)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+--------------------------------------------
+"Eclipsestore Configuration" (org.eclipse.store:eclipsestore-configuration)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+--------------------------------------------
+"Eclipsestore Base" (org.eclipse.store:eclipsestore-base)
+  Copyright (C) 2024 MicroStream Software
+  EPL-2.0
+---------------------------------
+=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 microstream-storage-embedded-configuration  Microstream Software
 Eclipse Public License 2.0
 Used by: [helidon-integrations-microstream]

all/pom.xml

@@ -826,6 +826,28 @@
             <artifactId>helidon-integrations-microstream-cache</artifactId>
         </dependency>
 
+        <dependency>
+            <groupId>io.helidon.integrations.eclipsestore</groupId>
+            <artifactId>helidon-integrations-eclipsestore</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.helidon.integrations.eclipsestore</groupId>
+            <artifactId>helidon-integrations-eclipsestore-cdi</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.helidon.integrations.eclipsestore</groupId>
+            <artifactId>helidon-integrations-eclipsestore-health</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.helidon.integrations.eclipsestore</groupId>
+            <artifactId>helidon-integrations-eclipsestore-metrics</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.helidon.integrations.eclipsestore</groupId>
+            <artifactId>helidon-integrations-eclipsestore-cache</artifactId>
+        </dependency>
+        
+        
         <dependency>
             <groupId>io.helidon.http</groupId>
             <artifactId>helidon-http</artifactId>

bom/pom.xml

@@ -1091,7 +1091,32 @@
                 <artifactId>helidon-integrations-microstream-cache</artifactId>
                 <version>${helidon.version}</version>
             </dependency>
-
+            <!-- Eclipse Store -->
+            <dependency>
+                <groupId>io.helidon.integrations.eclipsestore</groupId>
+                <artifactId>helidon-integrations-eclipsestore</artifactId>
+                <version>${helidon.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.helidon.integrations.eclipsestore</groupId>
+                <artifactId>helidon-integrations-eclipsestore-cdi</artifactId>
+                <version>${helidon.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.helidon.integrations.eclipsestore</groupId>
+                <artifactId>helidon-integrations-eclipsestore-health</artifactId>
+                <version>${helidon.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.helidon.integrations.eclipsestore</groupId>
+                <artifactId>helidon-integrations-eclipsestore-metrics</artifactId>
+                <version>${helidon.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.helidon.integrations.eclipsestore</groupId>
+                <artifactId>helidon-integrations-eclipsestore-cache</artifactId>
+                <version>${helidon.version}</version>
+            </dependency>
             <dependency>
                 <groupId>io.helidon.http</groupId>
                 <artifactId>helidon-http</artifactId>

dependencies/pom.xml

@@ -119,7 +119,9 @@
         <version.lib.microprofile-telemetry-tck>1.0</version.lib.microprofile-telemetry-tck>
         <version.lib.microprofile-tracing>3.0</version.lib.microprofile-tracing>
         <version.lib.microprofile-lra-api>2.0</version.lib.microprofile-lra-api>
-        <version.lib.microstream>08.01.01-MS-GA</version.lib.microstream>
+        <version.lib.microstream>08.01.02-MS-GA</version.lib.microstream>
+        <version.lib.eclipse-store>1.2.0</version.lib.eclipse-store>
+        <version.lib.eclipse-serializer>1.2.0</version.lib.eclipse-serializer>
         <version.lib.mongodb>4.10.2</version.lib.mongodb>
         <version.lib.mssql-jdbc>8.4.1.jre8</version.lib.mssql-jdbc>
         <version.lib.mysql-connector-j>8.2.0</version.lib.mysql-connector-j>
@@ -796,6 +798,29 @@
                 <version>${version.lib.microstream}</version>
             </dependency>
 
+            <!-- Eclipse Store related -->
+            <dependency>
+                <groupId>org.eclipse.store</groupId>
+                <artifactId>storage-embedded</artifactId>
+                <version>${version.lib.eclipse-store}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.eclipse.store</groupId>
+                <artifactId>storage-embedded-configuration</artifactId>
+                <version>${version.lib.eclipse-store}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.eclipse.store</groupId>
+                <artifactId>cache</artifactId>
+                <version>${version.lib.eclipse-store}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.eclipse.serializer</groupId>
+                <artifactId>persistence-binary-jdk17</artifactId>
+                <version>${version.lib.eclipse-serializer}</version>
+            </dependency>
+
+            
             <!-- Integrations related -->
             <dependency>
                 <groupId>jakarta.persistence</groupId>

integrations/eclipsestore/README.md

@@ -0,0 +1,156 @@
+# Eclipse Store integration with Helidon
+
+This projects adds [Eclipse Store](https://https://eclipsestore.io/) support to Helidon.
+
+[Eclipse Store](https://eclipsestore.io/) is the successor of [Microstream](https://microstream.one), both of which are integrated into Helidon as
+extensions now, enabling smooth transition.
+
+The official [Eclipse Store documentation](https://docs.eclipsestore.io) can be found here.
+
+## helidon-integrations-eclipsestore
+
+Adds basic support for Eclipse Store
+
+### Prerequisites
+
+Use the following maven dependency
+
+```
+<dependency>
+	<groupId>io.helidon.integrations.eclipsestore</groupId>
+	<artifactId>helidon-integrations-eclipsestore</artifactId>
+</dependency>
+```
+
+### API
+
+Use the EmbeddedStorageManagerBuilder to create a Eclipse Store instance:
+
+```
+EmbeddedStorageManager embeddedStorageManager = EmbeddedStorageManagerBuilder
+		.builder()
+		.build();
+```
+
+Configuration can either be done by the builders methods or by supplying a helidon configuration node
+
+```
+Config config = Config.create();
+
+EmbeddedStorageManager embeddedStorageManager = EmbeddedStorageManagerBuilder
+	.builder()
+	.config(config)
+	.build();
+```
+
+for a list of all possible properties
+see [Eclipse Store configuration properties](https://docs.eclipsestore.io/manual/storage/configuration/properties.html)
+
+### CDI extension for Eclipse Store
+
+the example below shows how to create a Eclipse Store instance using a provided configuration.
+
+```
+private EmbeddedStorageManager storage;
+
+@Inject
+public YourConstructor(@EclipseStoreStorage(configNode = "org.eclipse.store.storage.greetings")EmbeddedStorageManager storage) {
+		super();
+		this.storage = storage;
+}
+```
+
+## helidon-integrations-eclipsestore-cache
+
+Adds basic support for the Eclipse Store JCache implementation
+
+### Prerequisites
+
+Use the following maven dependency
+
+```
+<dependency>         
+	<groupId>io.helidon.integrations.eclipsestore</groupId>
+	<artifactId>helidon-integrations-eclipsestore-cache</artifactId>
+</dependency>
+```
+
+### API
+
+Use the CacheBuilder to create Eclipse Store JCache instance:
+
+Create a CacheConfiguration first
+
+```
+CacheConfiguration<Integer, String> cacheConfig = EclipseStoreCacheConfigurationBuilder
+	.builder(config.get("cache"), Integer.class, String.class).build();
+```
+
+Then build the cache
+
+```
+Cache<Integer, String> cache = CacheBuilder.builder(cacheConfig, Integer.class, String.class).build("myCache");
+```
+
+Configuration can either be done by the EclipseStoreCacheConfigurationBuilder or by supplying a helidon configuration node
+
+```
+Config config = Config.create();
+
+Cache<Integer, String> cache = CacheBuilder.create("myCache", config, Integer.class, String.class);
+
+```
+
+for a list of all possible properties
+see [Eclipse Store Cache configuration properties](https://docs.eclipsestore.io)
+
+### CDI extension for Eclipse Store
+
+the example below shows how to create a Eclipse Store Cache instance using a provided configuration.
+
+```
+private Cache<Integer, String> cache;
+
+@Inject
+public YourConstructor(@EclipseStoreCache(configNode = "org.eclipse.store.cache", name = "myCache") Cache<Integer, String> cache) {
+	this.cache = cache;
+}
+```
+
+## helidon-integrations-eclipsestore-health
+
+This module provides helpers to create basic health checks for Eclipse Store
+
+### Prerequisites
+
+Use the following maven dependency
+
+```
+<dependency>
+	<groupId>io.helidon.integrations.eclipsestore</groupId>
+	<artifactId>helidon-integrations-eclipsestore-health</artifactId>
+</dependency>
+```
+
+### Usage
+
+Register an instance of EclipseStoreHealthCheck to your server to provide a HealthCheck for a specific eclipse store instance.
+
+## helidon-integrations-eclipsestore-metrics
+
+This module provides helpers to create a set of default metrics for Eclipse Store
+
+### Prerequisites
+
+Use the following maven dependency
+
+```
+<dependency>
+	<groupId>io.helidon.integrations.eclipsestore</groupId>
+	<artifactId>helidon-integrations-eclipsestore-metrics</artifactId>
+</dependency>
+```
+
+### Usage
+
+The EclipseStoreMetricsSupport class provides a set of default metrics