Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[4208] Improve performance of details view rendering on selection change #4209

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

AresEkb
Copy link
Contributor

@AresEkb AresEkb commented Nov 17, 2024

Bug: #4208

Pull request template

General purpose

What is the main goal of this pull request?

  • Bug fixes
  • New features
  • Documentation
  • Cleanup
  • Tests
  • Build / releng

Project management

  • Has the pull request been added to the relevant project and milestone? (Only if you know that your work is part of a specific iteration such as the current one)
  • Have the priority: and pr: labels been added to the pull request? (In case of doubt, start with the labels priority: low and pr: to review later)
  • Have the relevant issues been added to the pull request?
  • Have the relevant labels been added to the issues? (area:, difficulty:, type:)
  • Have the relevant issues been added to the same project and milestone as the pull request?
  • Has the CHANGELOG.adoc been updated to reference the relevant issues?
  • Have the relevant API breaks been described in the CHANGELOG.adoc? (Including changes in the GraphQL API)
  • In case of a change with a visual impact, are there any screenshots in the CHANGELOG.adoc? For example in doc/screenshots/2022.5.0-my-new-feature.png

Architectural decision records (ADR)

  • Does the title of the commit contributing the ADR start with [doc]?
  • Are the ADRs mentioned in the relevant section of the CHANGELOG.adoc?

Dependencies

  • Are the new / upgraded dependencies mentioned in the relevant section of the CHANGELOG.adoc?
  • Are the new dependencies justified in the CHANGELOG.adoc?

Frontend

This section is not relevant if your contribution does not come with changes to the frontend.

General purpose

  • Is the code properly tested? (Plain old JavaScript tests for business code and tests based on React Testing Library for the components)

Typing

We need to improve the typing of our code, as such, we require every contribution to come with proper TypeScript typing for both changes contributing new files and those modifying existing files.
Please ensure that the following statements are true for each file created or modified (this may require you to improve code outside of your contribution).

  • Variables have a proper type
  • Functions’ arguments have a proper type
  • Functions’ return type are specified
  • Hooks are properly typed:
    • useMutation<DATA_TYPE, VARIABLE_TYPE>(…)
    • useQuery<DATA_TYPE, VARIABLE_TYPE>(…)
    • useSubscription<DATA_TYPE, VARIABLE_TYPE>(…)
    • useMachine<CONTEXT_TYPE, EVENTS_TYPE>(…)
    • useState<STATE_TYPE>(…)
  • All components have a proper typing for their props
  • No useless optional chaining with ?. (if the GraphQL API specifies that a field cannot be null, do not treat it has potentially null for example)
  • Nullable values have a proper type (for example let diagram: Diagram | null = null;)

Backend

This section is not relevant if your contribution does not come with changes to the backend.

General purpose

  • Are all the event handlers tested?
  • Are the event processor tested?
  • Is the business code (services) tested?
  • Are diagram layout changes tested?

Architecture

  • Are data structure classes properly separated from behavioral classes?
  • Are all the relevant fields final?
  • Is any data structure mutable? If so, please write a comment indicating why
  • Are behavioral classes either stateless or side effect free?

Review

How to test this PR?

Please describe here the various use cases to test this pull request

  • Has the Kiwi TCMS test suite been updated with tests for this contribution?

@AresEkb AresEkb marked this pull request as draft November 17, 2024 21:33
@AresEkb
Copy link
Contributor Author

AresEkb commented Nov 17, 2024

When you select an object in a model, the FormBasedView is rendered 8 times. It works slow for complicated forms

I added memoization to FormBasedView

And also removed useState and useEffect from DetailsView. I think they only decrease performance, causes extra renderings. It worked as follows:

  1. Selection is changed. So DetailsView is rendered
  2. 1st useEffect compares current selection stored in state and new selection stored in context. And if they differ updates the state. I think there is no reason to store selection twice: in context and in state - context is enough. And also changing the state causes one more DetailsView rendering
  3. On the next render objectIds will have a new value based on new selection. And useDetailsViewSubscription requests the new form
  4. When the form payload is updated the 2nd useEffect is called and updates the state causing rerender
  5. At last DetailsView is rendered with new state

I think that useSelection and useDetailsViewSubscription are enough to store the context/state. And local state is not required. Also useEffect combined with setState complicates logic and causes rerenderings

@AresEkb AresEkb marked this pull request as ready for review November 17, 2024 22:08
@@ -81,7 +48,7 @@ export const DetailsView = ({ editingContextId, readOnly }: WorkbenchViewCompone
value={{
payload: payload,
}}>
<FormBasedView editingContextId={editingContextId} form={state.form} readOnly={readOnly} />
<FormBasedView editingContextId={editingContextId} form={payload.form} readOnly={readOnly} />
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unfortunately this improvement cannot be done, not all payload are or will be FormRefreshedEventPayload and as a result, we need to store the latest form in a state. If a new payload XXX is emitted by the backend, the form will become blank.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! I reverted the change

What do you think about currentSelection stored in local state? Should I revert it as well? I think it's not required, bacause useSelection() is just enough. We can get rid of some extra renderings removing currentSelection and corresponding useEffect() comparing selections

@AresEkb AresEkb force-pushed the den/fix/details-render-performance branch 2 times, most recently from 2d57078 to 6105ee0 Compare November 22, 2024 18:22
@AresEkb AresEkb force-pushed the den/fix/details-render-performance branch from 6105ee0 to e95f325 Compare November 27, 2024 17:10
@AresEkb AresEkb force-pushed the den/fix/details-render-performance branch from e95f325 to 9317ec3 Compare December 14, 2024 06:16
@AresEkb AresEkb force-pushed the den/fix/details-render-performance branch from 9317ec3 to b49d077 Compare December 21, 2024 21:36
@AresEkb AresEkb force-pushed the den/fix/details-render-performance branch 2 times, most recently from 16bfdf5 to f6a86fa Compare January 7, 2025 20:22
@AresEkb AresEkb force-pushed the den/fix/details-render-performance branch from f6a86fa to 31d13dd Compare January 15, 2025 05:24
@AresEkb AresEkb force-pushed the den/fix/details-render-performance branch from 31d13dd to 8ed7537 Compare February 6, 2025 19:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants