Skip to content

Check the clients of a facade by KSP - #124

Open
reactivestudio wants to merge 1 commit into
facade-ksp-supertype-markersfrom
facade-ksp-client-rules
Open

reactivestudio wants to merge 1 commit into
facade-ksp-supertype-markersfrom
facade-ksp-client-rules

Conversation

@reactivestudio

@reactivestudio reactivestudio commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

Четвёртая часть процессора semantic-pattern-ksp: правила клиентов фасада. Стоит поверх #123.

  • Тип подсистемы в параметре, свойстве или результате называют только классы этой подсистемы или фасад, который её называет. Остальные получают ошибку: AdminFileController names FileStorageClient of @FileSubsystem past a facade.

  • Top-level функции и свойства не называют типы подсистем вовсе.

  • Класс подсистемы не берёт фасад своей подсистемы в параметре или свойстве. Вернуть его может: конфигурация отдаёт фасад из @Bean-метода.

  • Companion проверяется со своим классом, если сам не фасад: его метки — свои, не владельца.

  • Сгенерированные члены (свойства data class, члены делегата) пропускаются: они повторяют проверенные объявления.

  • Не проверяются тела функций и узкий интерфейс фасада: KSP не видит тел, у интерфейса нет аннотации. Оба ограничения записаны в README.

  • README: правило о своём фасаде уточнено, пример ошибки — AdminFileController, пункты о проверяемых объявлениях.

  • Правила проверяют SubsystemAccessThroughFacadeChecker (к типам подсистемы — только через фасад) и SubsystemIndependentOfFacadeChecker (класс подсистемы не зависит от своего фасада). FacadeSymbolProcessor теперь обходит и top-level функции и свойства.

После этой части в плане остаётся проверка Spring при старте приложения.

@reactivestudio
reactivestudio force-pushed the facade-ksp-client-rules branch from 3cd1ece to 8ce6c9b Compare November 16, 2026 11:52
@reactivestudio
reactivestudio force-pushed the facade-ksp-supertype-markers branch from 1fa0998 to 29f1887 Compare November 16, 2026 11:52
@reactivestudio
reactivestudio force-pushed the facade-ksp-client-rules branch from 8ce6c9b to a458759 Compare November 16, 2026 12:06
@reactivestudio
reactivestudio force-pushed the facade-ksp-supertype-markers branch 2 times, most recently from 8cf7d85 to cddb5d2 Compare November 16, 2026 12:07
@reactivestudio
reactivestudio force-pushed the facade-ksp-client-rules branch 2 times, most recently from 3464cd7 to f8d0551 Compare November 16, 2026 12:15
@reactivestudio
reactivestudio force-pushed the facade-ksp-supertype-markers branch 2 times, most recently from 9333d4a to 6432cfd Compare November 16, 2026 18:19
@reactivestudio
reactivestudio force-pushed the facade-ksp-client-rules branch from 7f46013 to 9676e43 Compare November 16, 2026 18:19
@reactivestudio
reactivestudio force-pushed the facade-ksp-supertype-markers branch from 6432cfd to 2acd9cd Compare November 16, 2026 18:36
@reactivestudio
reactivestudio force-pushed the facade-ksp-client-rules branch from 9676e43 to 9ff53d1 Compare November 16, 2026 18:36
@reactivestudio
reactivestudio force-pushed the facade-ksp-supertype-markers branch from 2acd9cd to 9f1ecad Compare November 16, 2026 18:48
@reactivestudio
reactivestudio force-pushed the facade-ksp-client-rules branch from 9ff53d1 to 1913226 Compare November 16, 2026 18:48
@reactivestudio
reactivestudio force-pushed the facade-ksp-supertype-markers branch from 9f1ecad to 374f7cb Compare November 16, 2026 19:07
@reactivestudio
reactivestudio force-pushed the facade-ksp-client-rules branch from 1913226 to cfa6e0f Compare November 16, 2026 19:07
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.

1 participant