Package co.crystaldev.alpinecore.framework.storage.driver

Class MySqlDriver<K,D>

java.lang.Object
co.crystaldev.alpinecore.framework.storage.driver.AlpineDriver<K,D>
co.crystaldev.alpinecore.framework.storage.driver.MySqlDriver<K,D>
@Experimental public class MySqlDriver<K,D> extends AlpineDriver<K,D>
Since:
0.1.2

  • Method Details

    • persistEntry

      public boolean persistEntry(@NotNull K key, @NotNull D data)
      Description copied from class: AlpineDriver
      Save data under a given key.

      Any exceptions generated by this method are swallowed.

      Specified by:
      persistEntry in class AlpineDriver<K,D>
      Parameters:
      key - The key
      data - The data to save
      Returns:
      Whether the operation was successful

    • persistEntries

      public boolean persistEntries(@NotNull @NotNull Map<K,D> entries)
      Description copied from class: AlpineDriver
      Save multiple data entries under their respective keys.

      This method allows you to save multiple data entries at once by providing a map of key-value pairs. It iterates through the map and calls the AlpineDriver.persistEntry(Object, Object) method for each entry. Any exceptions generated during the saving process are swallowed for individual entries.

      Overrides:
      persistEntries in class AlpineDriver<K,D>
      Parameters:
      entries - A map containing key-value pairs to be saved.

    • deleteEntry

      public boolean deleteEntry(@NotNull K key)
      Description copied from class: AlpineDriver
      Delete data under a given key.
      Specified by:
      deleteEntry in class AlpineDriver<K,D>
      Parameters:
      key - The key
      Returns:
      Whether the operation was successful

    • hasEntry

      public boolean hasEntry(@NotNull K key)
      Description copied from class: AlpineDriver
      Check if a key has any saved data.

      Any exceptions generated by this method are swallowed.

      Specified by:
      hasEntry in class AlpineDriver<K,D>
      Parameters:
      key - The key
      Returns:
      Whether there is an entry for they key

    • retrieveEntry

      @NotNull public D retrieveEntry(@NotNull K key) throws Exception
      Description copied from class: AlpineDriver
      Retrieve data for a given key.

      Due to limitations of the caching layer, this method must never return null.

      Always use AlpineDriver.hasEntry(Object) before attempting to retrieve an entry.

      Any exceptions generated by this method are NOT swallowed.

      Specified by:
      retrieveEntry in class AlpineDriver<K,D>
      Parameters:
      key - The key
      Returns:
      The data associated with the key
      Throws:
      Exception

    • getAllEntries

      @NotNull public @NotNull Collection<D> getAllEntries() throws Exception
      Description copied from class: AlpineDriver
      Retrieve all stored values in the data storage.

      This method retrieves all values stored in the data storage and returns them as a collection. It is a blocking task, and it may take some time to complete depending on the size of the data storage. If the data storage is empty, an empty collection is returned.

      Any exceptions generated by this method are NOT swallowed.

      Specified by:
      getAllEntries in class AlpineDriver<K,D>
      Returns:
      A collection containing all stored values.
      Throws:
      Exception - If an exception occurs while retrieving the values.

    • getAllEntries

      @NotNull public @NotNull Collection<D> getAllEntries(@Nullable @Nullable Consumer<Exception> exceptionConsumer)
      Description copied from class: AlpineDriver
      Retrieve all stored values in the data storage.

      This method retrieves all values stored in the data storage and returns them as a collection. It is a blocking task, and it may take some time to complete depending on the size of the data storage. If the data storage is empty, an empty collection is returned.

      Specified by:
      getAllEntries in class AlpineDriver<K,D>
      Parameters:
      exceptionConsumer - A function for handling errors.
      Returns:
      A collection containing all stored values.

    • shutdown

      public void shutdown()
      Description copied from class: AlpineDriver
      Shut down the data storage system.

      This method gracefully shuts down the data storage system, ensuring that all pending write operations are completed and any resources held by the storage system are properly released.

      Overrides:
      shutdown in class AlpineDriver<K,D>

    • builder

      @NotNull public static <K, D> @NotNull MySqlDriver.Builder<K,D> builder()
      Helper method to return a new builder instance.
      Returns:
      New builder for this class
      See Also: