Lukasz Lenart created WW-5863:
---------------------------------
Summary: Deprecate the scope interceptor
Key: WW-5863
URL: https://issues.apache.org/jira/browse/WW-5863
Project: Struts 2
Issue Type: Task
Components: Core Interceptors
Reporter: Lukasz Lenart
Fix For: 7.7.0
h2. Goal
Announce the removal planned in WW-5862 (8.0.0) one release ahead. WW-5850
(7.6.0) adds declarative multi-step flows with a dedicated {{flow}}
interceptor, which covers the wizard-style use the {{scope}} interceptor was
written for.
A usage poll on the user list (2026-10-09) showed the interceptor is still used
for multi-page forms, so it is deprecated with a replacement in place and not
removed outright.
h2. Scope
* Add {{@Deprecated(since = "7.7.0", forRemoval = true)}} and a Javadoc
deprecation note pointing to the flow interceptor on {{ScopeInterceptor}} and
{{ScopeInterceptorCacheDestroyable}}
* Log a warning when the interceptor is initialised, so applications that use
it see the deprecation at startup
* Mark the scope interceptor page on the site as deprecated and link the flow
interceptor
* Add a 7.7.0 migration note describing how a {{scope}} configuration maps to a
flow
h2. Known limitation, documented and not fixed
The Javadoc and the site page state that the interceptor uses session-level
locking and that each action execution is atomic at the session level. This
does not hold:
* the lock is taken on the session map of the action context, and a new session
map is created for every request, so two requests of the same HTTP session
never wait for each other
* the lock is released three times per invocation (before the result, after the
invocation and in the final cleanup) without checking which invocation holds it
The locking is not reworked, since the interceptor is going away. As part of
this ticket the locking statement is removed from the Javadoc and the site
page, and the migration note says that concurrent requests of one session were
never serialised.
Related: WW-5862, WW-5850, WW-5826
--
This message was sent by Atlassian Jira
(v10.3.26#10030026)