Added documentation for configuration

Author: JohannesRabauer

CHANGELOG.md

@@ -1,3 +1,7 @@
+# 1.0.4
+
+* Added possibility to use multiple storages
+
 # 1.0.3
 
 * Added the EclipseStoreDataImporter to import data from JPA repositories.

README.md

@@ -55,12 +55,13 @@ instructions** are in the documentation](https://xdev-software.github.io/spring-
 
 ## Demo
 
-To see how easy it is to implement EclipseStore in your Spring project, take a look at the three
-[demos](./spring-data-eclipse-store-demo):<br/>
-A [simple](./spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/simple), a
-more [complex demo](./spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/complex)
-and
-a [demo with coexisting JPA](./spring-data-eclipse-store-jpa/src/main/java/software/xdev/spring/data/eclipse/store/jpa).
+To see how easy it is to implement EclipseStore in your Spring project, take a look at
+the [demos](./spring-data-eclipse-store-demo):
+
+* [Simple demo](https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/simple)
+* [Complex demo](https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/complex)
+* [Demo with coexisting JPA](https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-jpa/src/main/java/software/xdev/spring/data/eclipse/store/jpa)
+* [Dual storage demo](https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/dual/storage)
 
 > [!NOTE]  
 > Since the library is using reflection to copy data, the following JVM-Arguments may have to be set:
@@ -71,7 +72,6 @@ a [demo with coexisting JPA](./spring-data-eclipse-store-jpa/src/main/java/softw
 > --add-opens=java.base/java.time=ALL-UNNAMED 
 > ```
 
-
 ## Support
 
 If you need support as soon as possible, and you can't wait for any pull request, feel free to

docs/modules/ROOT/nav.adoc

@@ -1,5 +1,6 @@
 * xref:index.adoc[Home]
 * xref:installation.adoc[Installation]
+* xref:configuration.adoc[Configuration]
 * xref:working-copies.adoc[Working Copies]
 * xref:migration.adoc[Migration]
 * xref:known-issues.adoc[Known issues]

docs/modules/ROOT/pages/configuration.adoc

@@ -0,0 +1,30 @@
+= Configuration
+
+== EclipseStore Spring-Boot Configuration
+
+The simplest way to configure your storage is by using the key/value pairs in a configuration file as described in the https://docs.eclipsestore.io/manual/misc/integrations/spring-boot.html[EclipseStore documentation].
+
+== Detailed Configuration
+
+If you need more control or want to configure your storage in code, we provide a simple Configuration class which can be used as follows:
+
+[source,java,title="Demo configuration"]
+----
+import org.eclipse.store.storage.embedded.types.EmbeddedStorage;
+import org.eclipse.store.storage.embedded.types.EmbeddedStorageFoundation;
+import org.eclipse.store.storage.types.Storage;
+...
+@Configuration
+@EnableEclipseStoreRepositories(clientConfigurationClass = DemoConfiguration.class)
+public class DemoConfiguration extends EclipseStoreClientConfiguration
+{
+    @Override
+    public EmbeddedStorageFoundation<?> createEmbeddedStorageFoundation()
+    {
+            return EmbeddedStorage.Foundation(Storage.Configuration(Storage.FileProvider(Path.of("demo-storage"))));
+    }
+}
+----
+The method ``createEmbeddedStorageFoundation`` could return a much more complicated ``EmbeddedStorageFoundation`` as described here in the https://docs.eclipsestore.io/manual/storage/configuration/index.html[EclipseStore documentation about configuration and foundations].
+
+This also enables you to use multiple EclipseStore-Storages in one project. See the https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/dual/storage[Dual storages demo].

docs/modules/ROOT/pages/installation.adoc

@@ -38,8 +38,12 @@ Since the library is using reflection to copy data, the following JVM-Arguments
 
 == Demo
 
-To see how easy it is to implement EclipseStore in your Spring project, take a look at the three https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo[demos]:
-A https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/simple[simple], a more https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/complex[complex demo] and a https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-jpa/src/main/java/software/xdev/spring/data/eclipse/store/jpa[demo with coexisting JPA].
+To see how easy it is to implement EclipseStore in your Spring project, take a look at the https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo[demos]:
+
+* https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/simple[Simple demo]
+* https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/complex[Complex demo]
+* https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-jpa/src/main/java/software/xdev/spring/data/eclipse/store/jpa[Demo with coexisting JPA]
+* https://github.com/xdev-software/spring-data-eclipse-store/tree/develop/spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/dual/storage[Dual storage demo]
 
 == Drop in compatible [[drop-in-compatible]]
 

spring-data-eclipse-store-demo/src/main/java/software/xdev/spring/data/eclipse/store/demo/dual/storage/invoice/PersistenceInvoiceConfiguration.java

@@ -1,9 +1,8 @@
 package software.xdev.spring.data.eclipse.store.demo.dual.storage.invoice;
 
-import static org.eclipse.store.storage.embedded.types.EmbeddedStorage.Foundation;
-
 import java.nio.file.Path;
 
+import org.eclipse.store.storage.embedded.types.EmbeddedStorage;
 import org.eclipse.store.storage.embedded.types.EmbeddedStorageFoundation;
 import org.eclipse.store.storage.types.Storage;
 import org.springframework.context.annotation.Configuration;
@@ -22,6 +21,6 @@ public class PersistenceInvoiceConfiguration extends EclipseStoreClientConfigura
 	@Override
 	public EmbeddedStorageFoundation<?> createEmbeddedStorageFoundation()
 	{
-		return Foundation(Storage.Configuration(Storage.FileProvider(Path.of("storage-invoice"))));
+		return EmbeddedStorage.Foundation(Storage.Configuration(Storage.FileProvider(Path.of("storage-invoice"))));
 	}
 }