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)

Reply via email to