SmartMVC

All documentation

This is the complete map of the SmartMVC documentation. You do not need to read everything at once. If SmartMVC is new to you, begin with “Getting started” and follow the chapters in order. If you are already using it, go directly to the feature you need. Later chapters become more detailed and are useful while implementing or troubleshooting an application.

Getting started

Learn what SmartMVC is for, add it to an application, and see where it participates in a request.

  1. What is SmartMVC?
    Understand SmartMVC’s responsibilities, the capabilities it provides, and its relationship with Spring MVC.
  2. Quick start
    Declare the application dependencies, add SmartMVC, and run your first endpoint without extra startup configuration.
  3. How a request moves through SmartMVC
    Follow a request from arrival to response and see how the enhancement layers work together.

Core features

Learn the response, exception, time, and logging features that most web applications use directly.

  1. Consistent responses
    Use a stable success envelope, pagination model, and response-wrapping rules.
  2. Exceptions and request validation
    Return business errors, HTTP errors, and field validation details in a clear, predictable format.
  3. Date and time
    Keep date-time input, output, time zones, and missing-part completion consistent.
  4. Request logging
    Record the request path, status, duration, and controller source, with a configurable log level.

Authentication and authorization

Start with the authentication model, then connect your own users, roles, permissions, and token handling.

  1. Authentication and authorization
    Understand full authentication, annotation-based authentication, anonymous access, and excluded paths.
  2. Custom authentication and the current user
    Implement the authentication handler and safely access the current user and permissions in application code.

Complete example

  1. Sign-in and authorization example
    Put sign-in, token parsing, the current user, and endpoint authorization together in one complete flow.

Reference

Use these pages when you need to confirm a specific option, type, or method.

  1. Configuration reference
    Find every spring.smart.mvc.* property, its default value, and guidance for using it.
  2. API reference
    Look up common annotations, response models, exception types, authentication interfaces, and current-session APIs.