Skip to content

Commit 501b496

Browse files
committed
Add new info on state handling
1 parent e48fdb1 commit 501b496

2 files changed

Lines changed: 24 additions & 0 deletions

File tree

content/en/docs/refguide/runtime/mendix-client.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,18 @@ This communicates the current state of the app (held in the object cache) to the
9898

9999
To avoid performance issues, the Mendix Client does not send the entire state to the runtime. State handling decides which parts of the state should be sent by analyzing the model during the deployment of the applications.
100100

101+
Determining which parts of the state should be send to the runtime consists of two parts.
102+
103+
During deployment, all microflows “reachable” from the client are analysed, such as:
104+
105+
- Event handler of entities
106+
- Microflows called from a nanoflows
107+
- Microflows called from the page
108+
109+
This analysis is done based on the microflow parameters and their usages throughout the microflow. Any time an association is used in the microflow, the association is marked, and will also be sent along in the request if needed. In some cases, such as Java actions, the analysis is not done as it would be too performance heavy. In that case, all objects associated to the microflow parameters will be sent along.
110+
111+
For other (non-microflow) actions, such as committing or deleting objects, a more simple analysis is performed on the client-side to determine which associations should be sent along.
112+
101113
For more detailed information about state, see this blog: [https://www.mendix.com/blog/the-art-of-state-part-1-introduction-to-the-client-state/](https://www.mendix.com/blog/the-art-of-state-part-1-introduction-to-the-client-state/). This also includes a worked example where you can see, and duplicate for yourself, how state is passed to the Runtime Server.
102114

103115
State handling is also responsible for garbage collection. If you want to know more about this aspect, see this blog: [https://www.mendix.com/blog/the-art-of-state-part-2-garbage-collection/](https://www.mendix.com/blog/the-art-of-state-part-2-garbage-collection/).

content/en/docs/refguide9/runtime/mendix-client.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,18 @@ This communicates the current state of the app (held in the object cache) to the
100100

101101
To avoid performance issues, the Mendix Client does not send the entire state to the runtime. State handling decides which parts of the state should be sent by analyzing the model during the deployment of the applications.
102102

103+
Determining which parts of the state should be send to the runtime consists of two parts.
104+
105+
During deployment, all microflows “reachable” from the client are analysed, such as:
106+
107+
- Event handler of entities
108+
- Microflows called from a nanoflows
109+
- Microflows called from the page
110+
111+
This analysis is done based on the microflow parameters and their usages throughout the microflow. Any time an association is used in the microflow, the association is marked, and will also be sent along in the request if needed. In some cases, such as Java actions, the analysis is not done as it would be too performance heavy. In that case, all objects associated to the microflow parameters will be sent along.
112+
113+
For other (non-microflow) actions, such as committing or deleting objects, a more simple analysis is performed on the client-side to determine which associations should be sent along.
114+
103115
For more detailed information about state, see this blog: [https://www.mendix.com/blog/the-art-of-state-part-1-introduction-to-the-client-state/](https://www.mendix.com/blog/the-art-of-state-part-1-introduction-to-the-client-state/). This also includes a worked example where you can see, and duplicate for yourself, how state is passed to the Runtime Server.
104116

105117
State handling is also responsible for garbage collection. If you want to know more about this aspect, see this blog: [https://www.mendix.com/blog/the-art-of-state-part-2-garbage-collection/](https://www.mendix.com/blog/the-art-of-state-part-2-garbage-collection/).

0 commit comments

Comments
 (0)