Interface StorageConnection

    • 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()
      • issueFileCheck

        default boolean issueFileCheck​(long nanoTimeBudgetBound)
      • issueFullCacheCheck

        default void issueFullCacheCheck()
      • issueCacheCheck

        default boolean issueCacheCheck​(long nanoTimeBudgetBound)
      • exportChannels

        void exportChannels​(StorageIoHandler fileHandler,
                            boolean performGarbageCollection)
      • exportChannels

        default void exportChannels​(StorageIoHandler fileHandler)
      • 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
        Specified by:
        store in interface Persister
        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
        Specified by:
        storeAll in interface Persister
        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
        Specified by:
        storeAll in interface Persister
        Parameters:
        instances - multiple root instances of the subgraphs of required instances to be stored.