Storing Data
This is the manual for older MicroStream versions (Version < 5.0).
The new documentation (Version >= 5.0) is located at:
MicroStream is designed to work with object graphs. Thus, storing data means to store an object graph. This includes the object's value fields and references to other objects. Storing an object will also store all instances referenced by this objects that have not been stored before. While storing your data most of the work MicroStream performs for you. You only need to call the store method on the correct object. The rule is: "The Object that has been modified has to be stored!".
Storing objects that are not part of an object graph is most likely pointless.
Storing Root Instances
To store the registered root instance just call the
storeRoot() method of a EmbeddedStorageManager instance.1
// Init storage manager
2
final EmbeddedStorageManager storageManager = EmbeddedStorage.start(root);
3
4
// Store the root object
5
storageManager.storeRoot();
Copied!
Storing New Objects
To store a newly created object, store the "owner" of the object. In the example below a new object is created and added to the
myObjects list of the root object. Then the modified list gets stored. This will also store the new object.1
// Add a new data object to the list in root
2
MyData dataItem = new MyData("Alice");
3
root.myObjects.add(dataItem);
4
5
// Store the modified list
6
storageManager.store(root.myObjects);
Copied!
Storing Modified Objects
Before storing a modified object keep in your mind that the modified object needs to be stored.
In case of a value types, like
int, it is the object that has the int field as a member:1
// Modify a value type memeber and store it
2
dataItem.setIntValue(100);
3
storageManager.store(dataItem);
Copied!
Don't forget immutable objects
Immutable objects like
String cannot be modified. Assigning a new value to a String does not modify the String object. Instead a new String instance is created and the reference is changed!
1
// Change a string object and store it
2
dataItem.setName("Bob");
3
storageManager.store(dataItem);
Copied!
​
​
Last modified 10mo ago
Export as PDF
Copy link