The memory add-on allows to store and retrieve values to respectively from the memory.
Memory Scope
By default, the memory is in scope of the service composite (server process), but it is also possible to store values in a request session context. Basically, the memory adapter is a thread-safe hash list allowing to
- share objects among requests (service scope, also called global scope)
To store objects in service scope and to share them between requests to the same service, set scope to global on the Memory adapter. In this case, you need to propagate the memory key between requests, or use a static key. - keep data for one request (session scope)
To keep data within the request, set scope to session on the Memory adapter. At the end of the request session, the memory will be cleared.
Storing Data to Memory
To store data to memory, provide the Memory adapter with the following:
- the data in parameter value
- a key, that can be used to access the data in memory
- the Memory Adapter action store
Figure: Storing a Data to memory
Retrieving Data From Memory
To retrieve data that has been stored to memory, provide the Memory adapter with the following:
- the key that has been used to store the data to memory
- the Memory Adapter action retrieve
Figure: Retrieving Data from Memory
If no data with the given key can be found, the Memory adapter throws an error.
Removing Stored Data
To remove data from memory, provide the Memory adapter with the following:
- the key that has been used to store the data to memory
- the Memory Adapter action remove
Figure: Removing Data from Memory
If no data with the given key can be found, the Memory adapter throws an error.
Clearing the Memory
To clear the complete used memory, provide the Memory adapter with the following: Figure: Clearing the Memory