SwayDB v0.16 Release Notes
Release Date: 2020-09-20 // over 3 years ago-
๐ This release was focused on
- ๐ MultiMap & Compaction performance improvements.
- Completing Java API.
- โ QA and Usability testing.
- ๐ Support for Boopickle serialisation.
- ๐ Resolving issues labeled Production release.
MultiMap and SetMap Java types
MultiMap
andSetMap
are now implemented for Java. Java API is now complete.MultiMap
allows creating deeply nestedMap
.//create a root mapMultiMap\<String, Integer, String, Void\> root =MemoryMultiMap.functionsOff( stringSerializer(), //nested Map key type intSerializer(), //key type stringSerializer() //value type ).get();//first child mapMultiMap\<String, Integer, String, Void\> child1 = root.child("first child"); child1.put(1, "child1's value 1");
๐
SetMap
providesMap
like API forSet
. Useful for application that always fetch the value with the key. It stores both key & value in the same location for faster seeks and reduced IOps.SetMap\<Integer, String\> setMap =MemorySetMap .config(intSerializer(), stringSerializer()) .get(); setMap.put(1, "one");
๐ Improved MultiMap performance and reduced storage cost
๐
MultiMap
previously stored parent key bytes within child key bytes. Now deeply nestedMap
do not have any extra storage cost over a root MultiMap. This also improved read and write performance.๐ Deeply nested
MultiMap
has constant performance regardless of the depth.Access to all nested child MultiMap nodes
//get all children of root mapStream\<MultiMap\<String, Integer, String, Void\>\> children = root.children();//get all children of root map and all it's grand children. Stream\<MultiMap\<String, Integer, String, Void\>\> child = root.childrenFlatten();
Functions
Shorter syntax for enabling functions
Java
Create functions without need to specify the return type. All java functions types are under
PureFunctionJava
.//function that appends "updated" to old valueOnValue\<Integer, String\> myFunction = (String value) -\>Apply.update(value + " updated");
Register the function as a
List
.Map\<Integer, String, PureFunction\<Integer, String, Apply.Map\<String\>\>\> map =PersistentMap .functionsOn( Paths.get("my\_map"), //directoryDefault.intSerializer(), //key serialiserDefault.stringSerializer(), //value serializwrArrays.asList(myFunction) //functions list ).get();
Scala
Syntax shortened for enabling functions -
PureFunction.Map[Int, String]
. All Scala function types are underPureFunctionScala
.val map = persistent.Map[Int, String, PureFunction.Map[Int, String], Bag.Less]("my\_map")
To register function supply
implicit
functions List.//sample function that appends "updated" to old valueval myFunction: OnValue[String] = (value: String) =\> Apply.Update(value + " updated")implicit val myFunctions = Functions[PureFunction.Map[Int, String]](myFunction)
โ Added new function types
OnKey
- reads the keyOnKeyDeadline
(Scala) &OnKeyExpiration
(Java) - reads the key and deadlineOnKeyValue
- reads the key and valueOnValue
- reads the valueOnValueDeadline
(Scala) &OnValueExpiration
(Java) - reads the value and deadlineOnKeyValueValueDeadline
(Scala) &OnKeyValueValueExpiration
(Java) - read the key, value and deadline.
๐ Improve Serialisers
Java
๐ Use
Slice<T>
to easily build custom serialisers.ByteOps.Java
removes the need to castjava.lang.Byte
toscala.Byte
.new Serializer\<String\>() { @Overridepublic Slice\<Byte\> write(String data) { return Slice.writeStringUTF8(data, ByteOps.Java()); } @Overridepublic String read(Slice\<Byte\> slice) { return slice.readStringUTF8(ByteOps.Java()); } };
Scala
Easily serialise
case class
es using Bookpickleimport swaydb.\_import boopickle.Default.\_case class MyClass(id: Int, value: String)implicit val serialiser = swaydb.serializers.BooPickle[MyClass]val set = memory.Set[MyClass, Nothing, Bag.Less]()
๐ Better Scala and Java interop
Scala functions can be shared with Java and vice versa. Scala instance can also be accessed from Java.
Set\<Integer, Void\> mySet =MemorySet .functionsOff(intSerializer()) .get(); mySet.asScala(); //get scala set
Validating missing functions
Missing applied functions reported on re-boot to ensure safe startups.
๐ป > swaydb.Exception$MissingFunctions: Missing 1 function. List("myFunction").
Flags for clearing applied functions
Functions that are applied can be cleared by setting the
clearAppliedFunctionsOnBoot
flag.Scala
val map = persistent.Set[Int, PureFunction.Set[Int], Bag.Less]("my\_set", clearAppliedFunctionsOnBoot = true)
Java
Set\<Integer, PureFunction\<Integer, Void, Apply.Set\<Void\>\>\> mySet =PersistentSet .functionsOn(Paths.get("my\_set"), intSerializer(), Arrays.asList()) .setClearAppliedFunctionsOnBoot(true) .get();
๐ Build Validator - Error reporting
Incompatible SwayDB version files get reported on boot-up.
Eg: Current v0.16 is incompatible with older versions so start v0.16 on older versions will result in the following error
Incompatible versions! SwayDB v0.16 is not compatible with files created by v0.15
Directories are type-checked. Eg: starting
Set
on aMap
directory will yieldInvalid data type Set for the directory of type Map.