Skip to content

WW-5844 docs: describe httpMethod enforcement in the plugin stacks and annotation resolution - #372

Merged
lukaszlenart merged 1 commit into
mainfrom
WW-5844-http-method-docs
Nov 8, 2026
Merged

lukaszlenart merged 1 commit into
mainfrom
WW-5844-http-method-docs

Conversation

@lukaszlenart

Copy link
Copy Markdown
Member

Documents WW-5844 (apache/struts#2120) on the action-configuration, REST plugin and Bean Validation plugin pages.

Merge together with the 7.5.0 release — the pages describe behaviour of that version.

Changes

  • Action configuration, HTTP Methods: the enforcing-stacks list adds restDefaultStack and beanValidationDefaultStack; new paragraph with the annotation resolution rules (implicit execute(), invoked method first, then the same public instance method on superclasses and interfaces including super-interfaces, class-level annotations only when no method annotation applies); one line that the request method is compared as the container reports it, with a pointer to the REST page.
  • REST plugin: new "HTTP method restrictions in restDefaultStack" section: since 7.5.0 the stack contains httpMethod; _method only selects the mapped method, the request stays a POST, so update()/destroy() served by HTML forms need @HttpPost next to @HttpPut/@HttpDelete, with an example; XML http-method must include post likewise. One cross-reference sentence after the _method paragraph in the mapping section.
  • Bean Validation plugin: "Since 7.5.0" paragraph that beanValidationDefaultStack contains httpMethod, linking to the HTTP Methods section.

🤖 Generated with Claude Code

…d annotation resolution

restDefaultStack and beanValidationDefaultStack now contain the httpMethod
interceptor, so the action-configuration page lists them with the core
stacks and both plugin pages carry a "Since 7.5.0" paragraph.

The HTTP Methods section gains the resolution rules for method-level and
class-level annotations across the class and interface hierarchy, and the
REST page explains that the interceptor checks the request method itself,
so update() and destroy() reached from a POST form with _method need
@HttpPost as well.

Co-Authored-By: Claude Mythos 5.1 <noreply@anthropic.com>
@lukaszlenart
lukaszlenart marked this pull request as ready for review November 8, 2026 14:40
@lukaszlenart
lukaszlenart merged commit 23fb2d5 into main Nov 8, 2026
@lukaszlenart
lukaszlenart deleted the WW-5844-http-method-docs branch November 8, 2026 14:51
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