All Superinterfaces:

PersistenceStoring

All Known Subinterfaces:

EmbeddedStorageManager

All Known Implementing Classes:

EmbeddedStorageManager.Default, StorageConnection.Default
```
public interface StorageConnection
extends PersistenceStoring
```
Ultra-thin delegatig type that connects a PersistenceManager instance (potentially exclusively created) to a storage instance.

Nested Class Summary

Nested Classes
Modifier and Type Interface Description

static class StorageConnection.Default

Method Summary

Modifier and Type	Method	Description
`default Storer`	`createEagerStorer()`
`default Storer`	`createLazyStorer()`
`StorageRawFileStatistics`	`createStorageStatistics()`
`default Storer`	`createStorer()`
`default void`	`exportChannels(StorageIoHandler fileHandler)`
`void`	`exportChannels(StorageIoHandler fileHandler, boolean performGarbageCollection)`
`default StorageEntityTypeExportStatistics`	`exportTypes(StorageEntityTypeExportFileProvider exportFileProvider)`
`StorageEntityTypeExportStatistics`	`exportTypes(StorageEntityTypeExportFileProvider exportFileProvider, Predicate<? super StorageEntityTypeHandler> isExportType)`
`void`	`importFiles(XGettingEnum<Path> importFiles)`
`default boolean`	`issueCacheCheck(long nanoTimeBudgetBound)`
`boolean`	`issueCacheCheck(long nanoTimeBudgetBound, StorageEntityCacheEvaluator entityEvaluator)`
`default boolean`	`issueFileCheck(long nanoTimeBudgetBound)`
`boolean`	`issueFileCheck(long nanoTimeBudgetBound, StorageDataFileDissolvingEvaluator fileDissolvingEvaluator)`
`default void`	`issueFullCacheCheck()`
`default void`	`issueFullCacheCheck(StorageEntityCacheEvaluator entityEvaluator)`
`default void`	`issueFullFileCheck()`
`default void`	`issueFullFileCheck(StorageDataFileDissolvingEvaluator fileDissolvingEvaluator)`
`default void`	`issueFullGarbageCollection()`	Issues a full garbage collection to be executed.
`boolean`	`issueGarbageCollection(long nanoTimeBudget)`
`PersistenceManager<Binary>`	`persistenceManager()`
`default long`	`store(Object instance)`	Stores the passed instance in any case and all referenced instances of persistable references recursively, but stores referenced instances only if they are newly encountered (e.g.
`default void`	`storeAll(Iterable<?> instances)`	Convenience method to `PersistenceStoring.store(Object)` all instances of an `Iterable` type, usually a collection. The passed instance itself is NOT stored. Note that this method does not return an array of objectIds, since the amount of instances supplied by the passed `Iterable` cannot be known until after all instances have been stored and the memory and performance overhead to collect them dynamically would not be worth it in most cases since the returned array is hardly ever needed.
`default long[]`	`storeAll(Object... instances)`	Convenience method to `PersistenceStoring.store(Object)` multiple instances.
`default void`	`storeSelfStoring(SelfStoring storing)`

- Method Detail
  - issueFullGarbageCollection
```
default void issueFullGarbageCollection()
```
    Issues a full garbage collection to be executed. Depending on the size of the database, the available cache, used hardware, etc., this can take any amount of time.
  - issueGarbageCollection
```
boolean issueGarbageCollection(long nanoTimeBudget)
```
  - issueFullFileCheck
```
default void issueFullFileCheck()
```
  - issueFullFileCheck
```
default void issueFullFileCheck(StorageDataFileDissolvingEvaluator fileDissolvingEvaluator)
```
  - issueFileCheck
```
default boolean issueFileCheck(long nanoTimeBudgetBound)
```
  - issueFileCheck
```
boolean issueFileCheck(long nanoTimeBudgetBound,
                       StorageDataFileDissolvingEvaluator fileDissolvingEvaluator)
```
  - issueFullCacheCheck
```
default void issueFullCacheCheck()
```
  - issueFullCacheCheck
```
default void issueFullCacheCheck(StorageEntityCacheEvaluator entityEvaluator)
```
  - issueCacheCheck
```
default boolean issueCacheCheck(long nanoTimeBudgetBound)
```
  - issueCacheCheck
```
boolean issueCacheCheck(long nanoTimeBudgetBound,
                        StorageEntityCacheEvaluator entityEvaluator)
```
  - createStorageStatistics
```
StorageRawFileStatistics createStorageStatistics()
```
  - exportChannels
```
void exportChannels(StorageIoHandler fileHandler,
                    boolean performGarbageCollection)
```
  - exportChannels
```
default void exportChannels(StorageIoHandler fileHandler)
```
  - exportTypes
```
default StorageEntityTypeExportStatistics exportTypes(StorageEntityTypeExportFileProvider exportFileProvider)
```
  - exportTypes
```
StorageEntityTypeExportStatistics exportTypes(StorageEntityTypeExportFileProvider exportFileProvider,
                                              Predicate<? super StorageEntityTypeHandler> isExportType)
```
  - importFiles
```
void importFiles(XGettingEnum<Path> importFiles)
```
  - persistenceManager
```
PersistenceManager<Binary> persistenceManager()
```
  - store
```
default long store(Object instance)
```
    Description copied from interface: PersistenceStoring
    
    Stores the passed instance in any case and all referenced instances of persistable references recursively, but stores referenced instances only if they are newly encountered (e.g. don't have an id associated with them in the object registry, yet and are therefore required to be handled). This is useful for the common case of just storing an updated instance and potentially newly created instances along with it while skipping all existing (and normally unchanged) referenced instances.
    
    Specified by:
    
    store in interface PersistenceStoring
    
    Parameters:
    
    instance - the root instance of the subgraph of required instances to be stored.
    
    Returns:
    
    the object id representing the passed instance.
  - storeAll
```
default long[] storeAll(Object... instances)
```
    Description copied from interface: PersistenceStoring
    
    Convenience method to PersistenceStoring.store(Object) multiple instances. The passed array (maybe implicitely created by the compiler) itself is NOT stored.
    
    Specified by:
    
    storeAll in interface PersistenceStoring
    
    Parameters:
    
    instances - multiple root instances of the subgraphs of required instances to be stored.
    
    Returns:
    
    an array containing the object ids representing the passed instances.
  - storeAll
```
default void storeAll(Iterable<?> instances)
```
    Description copied from interface: PersistenceStoring
    
    Convenience method to PersistenceStoring.store(Object) all instances of an Iterable type, usually a collection.
    The passed instance itself is NOT stored.
    Note that this method does not return an array of objectIds, since the amount of instances supplied by the passed Iterable cannot be known until after all instances have been stored and the memory and performance overhead to collect them dynamically would not be worth it in most cases since the returned array is hardly ever needed. If it should be needed, the desired behavior can be easily achieved with a tiny custom-made utility method.
    
    Specified by:
    
    storeAll in interface PersistenceStoring
    
    Parameters:
    
    instances - multiple root instances of the subgraphs of required instances to be stored.
  - storeSelfStoring
```
default void storeSelfStoring(SelfStoring storing)
```
    Specified by:
    
    storeSelfStoring in interface PersistenceStoring
  - createLazyStorer
```
default Storer createLazyStorer()
```
  - createStorer
```
default Storer createStorer()
```
  - createEagerStorer
```
default Storer createEagerStorer()
```

Interface StorageConnection

Nested Class Summary

Method Summary

Method Detail

issueFullGarbageCollection

issueGarbageCollection

issueFullFileCheck

issueFullFileCheck

issueFileCheck

issueFileCheck

issueFullCacheCheck

issueFullCacheCheck

issueCacheCheck

issueCacheCheck

createStorageStatistics

exportChannels

exportChannels

exportTypes

exportTypes

importFiles

persistenceManager

store

storeAll

storeAll

storeSelfStoring

createLazyStorer

createStorer

createEagerStorer