Skip to content

Add migration tutorials for Minimal API, MVC, and middleware filters#2422

Merged
jeremydmiller merged 3 commits intomainfrom
2409-filter-migration-tutorial
Apr 3, 2026
Merged

Add migration tutorials for Minimal API, MVC, and middleware filters#2422
jeremydmiller merged 3 commits intomainfrom
2409-filter-migration-tutorial

Conversation

@jeremydmiller
Copy link
Copy Markdown
Member

Summary

Closes #2409

  • Middleware Migration Tutorial (docs/tutorials/middleware-migration.md): Maps MVC IActionFilter, IEndpointFilter, IAuthorizationFilter, IResourceFilter, IResultFilter, and IExceptionFilter to Wolverine Before/After/Finally middleware conventions. Covers 4 ways to apply middleware (inline, [Middleware], Configure(HttpChain), IHttpPolicy).
  • Minimal API Migration Tutorial (docs/tutorials/from-minimal-api.md): Side-by-side before/after conversions covering GET/POST endpoints, parameter binding, form/file uploads, auth, route groups → IHttpPolicy, endpoint filters → Before methods, cascading messages, MapPostToWolverine shortcuts, and OpenAPI metadata.
  • MVC Controller Migration Tutorial (docs/tutorials/from-mvc.md): Side-by-side before/after conversions covering CRUD controllers, constructor → method injection, ActionResult<T> → direct returns, ModelState → Validate/FluentValidation, controller filters → [Middleware], and cascading messages.
  • AddMiddleware<T>() / AddPostprocessor<T>() extension methods on IChain for cleaner middleware registration in Configure(HttpChain) methods.
  • All three tutorials added to the docs sidebar and tutorials index page.

Test plan

  • Verify all three tutorial pages render correctly in VitePress
  • Verify sidebar navigation includes the new entries
  • Verify code samples in IChain extension methods compile
  • Review tutorial content for accuracy

🤖 Generated with Claude Code

jeremydmiller and others added 3 commits April 2, 2026 21:14
…helpers

New tutorial mapping MVC filters and Minimal API endpoint filters to
Wolverine.HTTP middleware equivalents, with side-by-side code examples
for Before/After/Finally methods, short-circuiting, data loading, and
per-endpoint middleware application.

Add AddMiddleware<T>() and AddPostprocessor<T>() extension methods on
IChain as syntactic sugar over manually constructing MethodCall frames
and adding them to chain.Middleware/Postprocessors collections.

Closes #2409

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Two new tutorials with side-by-side before/after code examples:

- from-minimal-api.md: Maps Minimal API patterns to Wolverine.HTTP
  equivalents covering endpoints, parameter binding, auth, route groups,
  endpoint filters, cascading messages, and MapPostToWolverine shortcuts

- from-mvc.md: Maps MVC controller patterns to Wolverine.HTTP including
  CRUD controllers, constructor vs method injection, ActionResult vs
  return types, ModelState vs Validate methods, and controller filters

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jeremydmiller jeremydmiller merged commit 5676b95 into main Apr 3, 2026
33 of 38 checks passed
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.

Documentation: MVC/Minimal API filter migration guide for Wolverine.HTTP middleware

1 participant