Nutz.Mvc 概述

优质
小牛编辑
129浏览
2023-12-01

Nutz.Mvc 是要和一个 Web 服务器 (比如 Tomcat)一起工作的,它存在的意义就是要把一个标准的 HTTP 请求,转发到某一个 Java 函数中

它的特点是:

  • 帮你做参数的解析 (当然你自己可以随意扩展
  • 如果你愿意,你可以不用 View 来渲染 HTTP 输出流
  • 提供几个基本的渲染方式 (比如 JSP, JSON)
  • 除此以外,不内置更多的功能

每一种 HTTP 请求,标识就是一个 URL,而每一个 Java 函数怎样和一个 URL 关联呢? 最直接的办法就是在函数上声明一个
注解,这个注解,在 Nutz.Mvc 中,叫 @At

你如果想快速开始,来一个 Hellow World, 那么请看 Hello World 一节

图解 Nutz.Mvc

为了能让你更快速直观的了解 Nutz.Mvc 的工作方式,我提供下面两张图:

每一次请求,都经过如下流程

Nutz.Mvc 根据 @At 注解,将一个 HTTP 请求映射到了一个函数,函数只有一个参数,会被路径参数 (1045) 填充。

  • Nutz.Mvc 最基本的想法,就是通过注解 @At 将一个HTTP请求路径同一个 Java 函数关联起来。
  • 并且,@At 支持你写多个路径

更详细的流程

  • 声明了 @At 的函数被称为 入口函数
  • 任何一个请求,都会经过四道工序
    1. A - 过滤: 你通过 @Filters 注解可以为你的入口函数定义任意多的过滤器
    2. B - 适配: 这个过程将 HTTP 输入流转换成入口函数的参数数组
      • 默认的,它认为输入流是传统的名值对方式
      • 更多的适配方式请参看 关于适配器
      • 文件上传也是一种适配方式,请参看 UploadAdptor
    3. C - 调用: 调用入口函数,你在里面需要调用相关的业务层代码。
      • 如果你的业务比较复杂,为了解耦合,你可能需要 Ioc 容器的帮助,请参看 同 Ioc 容器一起工作 一节
    4. D - 渲染: 根据入口函数的返回,渲染 HTTP Response。
      • 如果返回是个 View,则用这个 View 来渲染 null (null? 是的,你没看错,这种情况 View 接口第三个参数会是 null)
        • 你可以用 org.nutz.mvc.view.ViewWrapper 将你的返回对象以及要返回的视图组合在一起返回,ViewWrapper 也是一个 View
      • 否则用函数的 @Ok 注解声明的 View 来渲染入口函数的返回对象
      • 如果你的函数处理过程中抛出了异常,用 @Fail 注解声明的 View 来渲染异常对象
      • 返回值会保存在request的attr中,名字是obj

进阶阅读

  • 如何配置 web.xml
  • Nutz.Mvc 的配置语法