#90: `DataTransferAreaPagesRest.kt`

plugins/org.projectforge.plugins.datatransfer/src/main/kotlin/org/projectforge/plugins/datatransfer/rest/DataTransferAreaPagesRest.kt

· REST API Controller · 425 lines · 367 code · 34 comments · 24 blank

Part of the Data Transfer plugin. REST API Controller.

Kotlin REST Endpoint implementing DataTransferAreaPagesRest.

Structure

DataTransferAreaPagesRest — class : AbstractDTOPagesRest<DataTransferAreaDO, DataTransferArea, DataTransferAreaDao>(.

Key dependencies: jakarta.annotation.PostConstruct, jakarta.servlet.http.HttpServletRequest, jakarta.validation.Valid, org.projectforge.common.FormatterUtils, org.projectforge.framework.configuration.ConfigurationChecker, org.projectforge.framework.i18n.translate, org.projectforge.framework.i18n.translateMsg, org.projectforge.framework.persistence.api.MagicFilter

Design Decisions

Spring @RestController with typed DTOs. Endpoints use @RequestParam for filtering, sorting, pagination, and multi-select operations.

Gotchas & Pitfalls

Returning JPA entities in REST responses triggers lazy-loading of all associations. Always map to dedicated DTOs before returning.

Git History

Commit	Description
`868d6abb7`	2025 -> 2026 (minor edit, license header update)
`63081666f`	Source file headers: 2024-> 2025. (minor edit, license header update)
`4942c854d`	Migration stuff in progress... (major refactor, updated imports)
`067a4cbb1`	Migration stuff in progress... (minor edit, updated imports)
`77bade6df`	javax.* -> jakarta.* (minor edit, updated imports)
`b6092df09`	Copyright 2023 -> 2024
`ab45d51fa`	Copyright 2001-2022 -> 2001-2023.
`b950cb62f`	Bugfix: half days on vacation entries. Handling of layout uids while calling watchFields fixed.
`44dcb895b`	AbstractPagesRest.createListLayout(...) refactored.
`a81c7e68b`	DataTransferArea.externalPassword is now set to null as default.

#90: DataTransferAreaPagesRest.kt

Structure

Design Decisions

Gotchas & Pitfalls

Git History

#90: `DataTransferAreaPagesRest.kt`