You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
Configure Session Manager
The Session Manager can be configured by placing a property in application.properties file. The following values may be used for this property:
Memory
The default implementation, which stores IAquimaSessions on the HTTP session.
blueriq.session.session-manager=memory
If the property is missing, this implementation is used by default.
External
An implementation which stores IAquimaSessions in a key-value store using the available IKeyValueStore implementation.
blueriq.session.session-manager=external
An Key-Value Store Component must be available/enabled in runtime. Documentation how this can be done can be found here.
Best practices for custom code
When adding custom code that is stored inside the AquimaSession, it is best to keep in mind some best practices:
- chain passivation and activation (an object may reference other objects that must also be passivated and activated)
- when activation occurs it is best to restore the internal state of an object first and then call activate(ActivationContext) to restore its dependencies
- always store the needed data only - AquimaSession is passivated and activated peer request, a high amount of data can impact performance
- must be possible to restore the dependencies by calling getters in the ActivationContext parameter
Activate/passivate pattern
Activate/passivate pattern was introduced as a means of enabling the Session Manager to store its AquimaSessions instances in an external key-value store in order to run the runtime in a clustered environment.
The main pattern used is inspired by Enterprise Java Beans. Before the object is serialized, it is notified of this fact by calling its passivate() method. The object then has a chance to do any cleanup before serialization. After the object is deserialized its activate(ActivationContext) method is called. The object then has the chance to restore its dependencies.
passivation |
|
activation |
|
Custom Session Manager
Custom implementations of session manager is possible by implementing the IAquimaSessionsMap interface. First, set the blueriq.session.session-manager property to a new value:
blueriq.session.session-manager=example
Then, expose your IAquimaSessionsMap as a conditional bean in the application context:
@Bean @ConditionalOnProperty(name = BlueriqSessionProperties.SESSION_MANAGER, havingValue = "example") public IAquimaSessionsMap exampleSessionManager() { return new ExampleSessionManager() }
Blueriq Runtime will automatically disable the other session manager implementations and plug in the new session manager.
Previous: 4. Cluster configuration
Next: 6. Temporary files