目錄
Part I: 目录与翻译注记(Table of contents and
Notes)
Introduction
目录
翻译注记
Part II: 文档内容(Documentation contents)
Spring Web MVC框架简介
Spring Web MVC的新特性
允许其他MVC实现
DispatcherServlet
WebApplicationContext中特殊的Bean类型
默认的DispatcherServlet配置
DispatcherServlet的处理流程
控制器的实现
使用@Controller注解定义一个控制器
使用@RequestMapping注解映射请求路径
定义@RequestMapping注解的处理方法
异步请求的处理
对控制器测试
处理器映射
使用HandlerInterceptor拦截请求
视图解析
使用ViewResolver接口解析视图
视图链
视图重定向
内容协商解析器ContentNegotiatingViewResolver
使用闪存属性FlashAttributes
1.1
1.2
1.3
2.1
2.1.1
2.1.2
2.2
2.2.1
2.2.2
2.2.3
2.3
2.3.1
2.3.2
2.3.3
2.3.4
2.3.5
2.4
2.4.1
2.5
2.5.1
2.5.2
2.5.3
2.5.4
2.6
1
URI构造
为控制器和方法指定URI
在视图中为控制器和方法指定URI
地区信息
获取时区信息
Accept请求头解析器AcceptHeaderLocaleResolver
Cookie解析器CookieLocaleResolver
Session解析器SessionLocaleResolver
地区更改拦截器LocaleChangeInterceptor
主题 themes
关于主题:概览
定义主题
主题解析器
Spring的multipart(文件上传)支持
概述
使用MultipartResolver与Commons FileUpload传输文件
Servlet 3.0下的MultipartResolver
处理表单中的文件上传
处理客户端发起的文件上传请求
异常处理
处理器异常解析器HandlerExceptionHandler
@ExceptionHandler注解
处理一般的Spring MVC异常
使用@ResponseStatus注解业务异常
Servlet默认容器错误页面的定制化
Web安全
"约定优于配置"的支持
控制器类名-处理器映射ControllerClassNameHandlerMapping
模型ModelMap(ModelAndView)
视图-请求与视图名的映射
HTTP缓存支持
HTTP请求头Cache-Control
对静态资源的HTTP缓存支持
在控制器中设置Cache-Control、ETag和Last-Modified响应头
2.7
2.7.1
2.7.2
2.8
2.8.1
2.8.2
2.8.3
2.8.4
2.8.5
2.9
2.9.1
2.9.2
2.9.3
2.10
2.10.1
2.10.2
2.10.3
2.10.4
2.10.5
2.11
2.11.1
2.11.2
2.11.3
2.11.4
2.11.5
2.12
2.13
2.13.1
2.13.2
2.13.3
2.14
2.14.1
2.14.2
2.14.3
2
弱ETag
基于代码的Servlet容器初始化
配置Spring MVC
启用MVC Java编程配置或MVC命名空间
默认配置的定制化
转换与格式化
验证
拦截器
内容协商
视图控制器
视图解析器
资源的服务
回到默认的Servlet来进行资源服务
路径匹配
消息转换器
使用MVC Java编程进行高级定制
使用MVC命名空间进行高级定制
2.14.4
2.15
2.16
2.16.1
2.16.2
2.16.3
2.16.4
2.16.5
2.16.6
2.16.7
2.16.8
2.16.9
2.16.10
2.16.11
2.16.12
2.16.13
2.16.14
3
Introduction
Spring MVC 4.2.4.RELEASE 中文文档
本项目翻译的是Spring MVC官方4.2.4.RELEASE版本的文档,包含原文档第21章Spring
MVC部分的全部内容。译文尽力于准确传达原意,其次兼顾译文的流畅自然。至于风格和质
感,则仍在努力。希望它能为读者带来查阅、学习的价值,自己时不时翻之,仍有收获。
目前多数章节的翻译已完成,剩余部分章节仍在进行。文档仍在维护状态,主要还有译文细
化、术语定义、翻译规范、内容、主页修缮、自动化部署等工作可做,issues这里有一些有意
思的idea。翻译过程中遇到值得探讨的翻译问题、取舍及最终解决方案,读者可见翻译注记。
本翻译初始只是自我学习需要,逐渐完善后才有坚持完成的执念。陈丹青在《木心谈木心》
的后记中,讲到他犹豫于出版木心先生这本私房话的心境。为本译文做推广、宣传伊始,我
也开始面对我的读者,读之,感觉真挚感动。不敢自比木心,我在我的风中等消息。
——2016年6月28 交房租日,8月28日 完成自动化部署后补稿
中文文档地址
主站:mvc.linesh.tw(速度和稳定性更好,样式也与原文档一致)
国外Gitbook原站
原文地址
Spring MVC 4.2.4.RELEASE Documentation
其他相关翻译项目
4
Introduction
为了对目前Spring MVC部分文档翻译现状有个大致的了解,可以“Spring MVC 中文 文档 翻
译”作为关键词,浏览其在google和baidu上前6页的搜索结果。其中以下项目值得留意,前两
个均或完全或部分地翻译了Spring MVC部的内容,可供参考;后面三个项目未涉及Spring
MVC部分的翻译。
项目
作者
项目
Github
描述
Spring框架
参考文档
一个团队
Github
满江红机构
-
该项目规模较大、参与人数较多。翻译内容是
Spring 4.1.3.RELEASE版本全部文档,其中
MVC部分的文档也翻译了一大半。其项目主页
保留了与原生Spring文档较一致的样式,很不
错
感谢dsliu在gitbook上给我提供此版译本链接。
译本是整个MVC 2.5.2版的全部文档,其中
MVC的部分同样齐全
Spring
Framework
2.5翻译计
划
Spring
Framework
4.x参考文
档
Spring
Framework
4.x中文翻
译
waylau
Github 翻译了Spring文档的简介、新特性和容器IOC
部分
sunrh
Github 翻译了Spring文档的简介、新特性和容器IOC
部分
Spring 中
文文档3.1
wizardforcel
-
主页已标记废弃的项目。楼主BIO是专注单身
二十年,言语间竟有一种大学宿友不是说我的
宿友的即视感
友情链接
这个译本我在国内的多个站点均发表过一篇相同的推广文章,如OSC/CSDN/Iteye/博客园/掘
金/v2ex/segmentfault/Githuber等。除了交付的译文本身外,还聊瞎扯了一些其他的东西。同
时,关于这个翻译文档的创始、管理及自动化部署等方面,我也已将其总结成为文章。此二
篇文章是对这个项目的完整记录,均发布在我的博客上,有兴趣的读者可以前往阅读。后来
我又做了一些主页样式上的迁移、自动化了一些构建前文档预处理的工作,还有一些代码的
重构。这部分未做记录,但代码和部署构架方面我十分满意,其精华在 package.json 和构建
脚本中。
Spring MVC官方文档翻译稿发布
我是如何进行Spring MVC文档翻译项目的环境搭建、项目管理及自动化构建工作的
联系方式
5
Introduction
阅读过程中的任何想法、建议、吐槽、强迫症不给译者狂点100个赞就浑身不舒服、觉得赞、
觉得不赞,无论关于翻译、技术、样式等,对我来说很有意义啊我这文风竟有一种安妮宝贝
般的性冷淡感!你可以通过以下的方式联系作者我:
来Github点赞 被消费一个
在Gitbook讨论里 给我留言
给这个项目提 issue
给这个项目提 pull request
邮箱:linesh.simpcity@gmail.com
License
MIT License
贡献者 Contributor
感谢那些让这个项目变得更好的人们。
吕立青
Sun
SongWang
易枭寒
xcatliu
HeartUnchange
6
目录
目录
Spring Web MVC框架简介
Spring Web MVC的新特性
允许其他MVC实现
DispatcherServlet
WebApplicationContext中特殊的Bean类型
默认的DispatcherServlet配置
DispatcherServlet的处理流程
控制器的实现
使用@Controller注解定义一个控制器
使用@RequestMapping注解映射请求路径
定义@RequestMapping注解的处理方法
异步请求的处理
对控制器测试
处理器映射
使用HandlerInterceptor拦截请求
视图解析
使用ViewResolver接口解析视图
视图链
视图重定向
内容协商解析器ContentNegotiatingViewResolver
使用闪存属性FlashAttributes
URI构造
为控制器和方法指定URI
在视图中为控制器和方法指定URI
地区信息
获取时区信息
Accept请求头解析器AcceptHeaderLocaleResolver
Cookie解析器CookieLocaleResolver
Session解析器SessionLocaleResolver
地区更改拦截器LocaleChangeInterceptor
主题 themes
关于主题:概览
定义主题
主题解析器
Spring的multipart(文件上传)支持
概述
7
目录
使用MultipartResolver与Commons FileUpload传输文件
Servlet 3.0下的MultipartResolver
处理表单中的文件上传
处理客户端发起的文件上传请求
异常处理
处理器异常解析器HandlerExceptionHandler
@ExceptionHandler注解
处理一般的Spring MVC异常
使用@ResponseStatus注解业务异常
Servlet默认容器错误页面的定制化
Web安全
"约定优于配置"的支持
控制器类名-处理器映射ControllerClassNameHandlerMapping
模型ModelMap(ModelAndView)
视图-请求与视图名的映射
HTTP缓存支持
HTTP请求头Cache-Control
对静态资源的HTTP缓存支持
在控制器中设置Cache-Control、ETag和Last-Modified响应头
弱ETag
基于代码的Servlet容器初始化
配置Spring MVC
启用MVC Java编程配置或MVC命名空间
默认配置的定制化
转换与格式化
验证
拦截器
内容协商
视图控制器
视图解析器
资源的服务
回到默认的Servlet来进行资源服务
路径匹配
消息转换器
使用MVC Java编程进行高级定制
使用MVC命名空间进行高级定制
8