SpringMVC框架详解：中文翻译与关键特性

需积分: 35 36 浏览量更新于2024-07-20 收藏 2.1MB PDF 举报

SpringMVC中文翻译文档详细介绍了Spring框架的模型-视图-控制器（MVC）架构，该框架的核心是DispatcherServlet，它负责接收和处理HTTP请求，将其分发给相应的处理器。Spring MVC的设计理念强调“对扩展开放，对修改封闭”，这意味着开发者可以方便地添加新的功能，但同时保持代码的可维护性和模块化。在Spring 3.0之后，框架引入了@Controller注解，使得创建RESTful Web服务和应用程序变得更加容易。通过使用@Controller和@RequestMapping注解，可以明确指定哪些类和方法应该处理特定的HTTP请求。此外，Spring MVC还提供了像@PathVariable这样的注解，用于处理URL路径变量，简化了路由和参数传递。然而，Spring MVC的核心类库中有一些方法是final的，如AbstractController.setSynchronizeOnSession()，这是为了确保框架的稳定性和避免不必要的定制。尽管并非完全禁止对final方法进行修改，但在大多数情况下，这种做法并不推荐，因为它违反了“开闭原则”。作者建议查阅Seth Ladd等人的著作《深入解析SpringWebMVC与WebFlow》来了解详细的设计初衷和原因，或者参考Bob Martin的“开闭原则”概念。 Spring MVC的数据绑定机制十分灵活，允许开发者使用任意对象作为命令对象或表单返回对象，无需遵循特定的接口或基类规范。这种设计降低了耦合度，允许应用自定义数据验证策略。虽然这增加了开发者的灵活性，但也可能需要在处理字符串数据时格外小心，因为未经类型检查的字符串可能隐藏着类型转换错误，不利于业务逻辑的清晰表达。 Spring MVC是一个强大的Web开发工具，它提供了一种结构化的开发模式，使得代码易于扩展和维护，同时给予开发者高度的灵活性。然而，理解和遵循框架的最佳实践，特别是对于final方法和设计原则的运用，是提升开发效率和代码质量的关键。

16-12-26

Spring MVC中文翻译文档

7xvpsh.com1.z0.glb.clouddn.com

12/68

@RequestMapping(path="/owners/{ownerId}/pets/{petId}", method=RequestMethod.GET)

public String findPet(@PathVariable String ownerId, @PathVariable String petId, Model model) {

Owner owner = ownerService.findOwner(ownerId);

Pet pet = owner.getPet(petId);

model.addAttribute("pet", pet);

return "displayPet";

}

[Original] When a @PathVariable annotation is used on a Map<String, String> argument, the map is populated with all URI

template variables.

当 @PathVariable注解被应用于 Map<String, String>类型的参数上时，框架会使用所有URI模板变量来填充这个map。

[Original] A URI template can be assembled from type and path level @RequestMapping annotations. As a result the findPet()

method can be invoked with a URL such as /owners/42/pets/21.

URI模板可以从类级别和方法级别的 @RequestMapping 注解获取数据。因此，像这样的 findPet()方法可以被类似

于 /owners/42/pets/21这样的URL路由并调用到：

_@Controller_

@RequestMapping("/owners/{ownerId}")

public class RelativePathUriTemplateController {

@RequestMapping("/pets/{petId}")

public void findPet(_@PathVariable_ String ownerId, _@PathVariable_ String petId, Model model) {

// 方法实现体这里忽略

}

[Original] A @PathVariable argument can be of any simple type such as int, long, Date, etc. Spring automatically converts to the

appropriate type or throws a TypeMismatchException if it fails to do so. You can also register support for parsing additional data types.

See the section called "Method Parameters And Type Conversion" and the section called "Customizing WebDataBinder initialization".

@PathVariable可以被应用于所有简单类型的参数上，比如int、long、Date等类型。Spring会自动地帮你把参数转化成合适的类

型，如果转换失败，就抛出一个 TypeMismatchException。如果你需要处理其他数据类型的转换，也可以注册自己的类。若需要

更详细的信息可以参考“方法参数与类型转换”一节和“定制WebDataBinder初始化过程”一节

带正则表达式的URI模板

[Original] Sometimes you need more precision in defining URI template variables. Consider the URL

"/spring-web/spring-web-3.0.5.jar". How do you break it down into multiple parts?

有时候你可能需要更准确地描述一个URI模板的变量，比如说这个URL： "/spring-web/spring-web-3.0.5.jar。你要怎么把它

分解成几个有意义的部分呢？

[Original] The @RequestMapping annotation supports the use of regular expressions in URI template variables. The syntax is

{varName:regex} where the first part defines the variable name and the second - the regular expression.For example:

@RequestMapping注解支持你在URI模板变量中使用正则表达式。语法是 {varName:regex}，其中第一部分定义了变量名，第二

部分就是你所要应用的正则表达式。比如下面的代码样例：

@RequestMapping("/spring-web/{symbolicName:[a-z-]+}-{version:\\d\\.\\d\\.\\d}{extension:\\.[a-z]+}")

public void handle(@PathVariable String version, @PathVariable String extension) {

16-12-26

Spring MVC中文翻译文档

7xvpsh.com1.z0.glb.clouddn.com

13/68

// 代码部分省略...

}

Path Patterns（不好翻，容易掉韵味）

[Original] In addition to URI templates, the @RequestMapping annotation also supports Ant-style path patterns (for example,

/myPath/*.do). A combination of URI template variables and Ant-style globs is also supported (e.g. /owners/*/pets/{petId}).

除了URI模板外， @RequestMapping注解还支持Ant风格的路径模式（如 /myPath/*.do等）。不仅如此，还可以把URI模板变量和

Ant风格的glob组合起来使用（比如 /owners/*/pets/{petId}这样的用法等）。

路径样式的匹配(Path Pattern Comparison)

[Original] When a URL matches multiple patterns, a sort is used to find the most specific match.

当一个URL同时匹配多个模板（pattern）时，我们将需要一个算法来决定其中最匹配的一个。

[Original] A pattern with a lower count of URI variables and wild cards is considered more specific. For example /hotels/{hotel}/*

has 1 URI variable and 1 wild card and is considered more specific than /hotels/{hotel}/** which as 1 URI variable and 2 wild

cards.

URI模板变量的数目和通配符数量的总和最少的那个路径模板更准确。举个例子， /hotels/{hotel}/*这个路径拥有一个URI变量

和一个通配符，而 /hotels/{hotel}/**这个路径则拥有一个URI变量和两个通配符，因此，我们认为前者是更准确的路径模板。

[Original] If two patterns have the same count, the one that is longer is considered more specific. For example /foo/bar* is longer and

considered more specific than /foo/*.

如果两个模板的URI模板数量和通配符数量总和一致，则路径更长的那个模板更准确。举个例子， /foo/bar*就被认为比 /foo/*更

准确，因为前者的路径更长。

[Original] When two patterns have the same count and length, the pattern with fewer wild cards is considered more specific. For example

/hotels/{hotel} is more specific than /hotels/*.

如果两个模板的数量和长度均一致，则那个具有更少通配符的模板是更加准确的。比如， /hotels/{hotel}就比 /hotels/*更精

确。

[Original] There are also some additional special rules:

除此之外，还有一些其他的规则：

[Original] The default mapping pattern `/* is less specific than any other pattern. For example/api/{a}/{b}/{c}` is more

specific.

[Original] A prefix pattern such as

`/public/* is less specific than any other pattern that doesn't contain double wildcards. For example/public/path3/{a}/{b}/{c}`

is more specific.

默认的通配模式 /**比其他所有的模式都更“不准确”。比方说， /api/{a}/{b}/{c}就比默认的通配模式 /**要更准确

前缀通配（比如 /public/**)被认为比其他任何不包括双通配符的模式更不准确。比如说， /public/path3/{a}/{b}/{c}

就比 /public/**更准确

16-12-26

Spring MVC中文翻译文档

7xvpsh.com1.z0.glb.clouddn.com

14/68

[Original] For the full details see AntPatternComparator in AntPathMatcher. Note that the PathMatcher can be customized (see

Section 21.16.11, "Path Matching" in the section on configuring Spring MVC).

更多的细节请参考这两个类： AntPatternComparator和 AntPathMatcher。值得一提的是，PathMatcher类是可以配置的（见“配

置Spring MVC”一节中的21.16.11 路径的匹配一节)。

带占位符的路径模式（path patterns）

[Original] Patterns in @RequestMapping annotations support ${…} placeholders against local properties and/or system properties and

environment variables. This may be useful in cases where the path a controller is mapped to may need to be customized through

configuration. For more information on placeholders, see the javadocs of the PropertyPlaceholderConfigurer class.

@RequestMapping注解支持在路径中使用占位符，以取得一些本地配置、系统配置、环境变量等。这个特性有时很有用，比如说控

制器的映射路径需要通过配置来定制的场景。如果想了解更多关于占位符的信息，可以参考 PropertyPlaceholderConfigurer这

个类的文档。

Suffix Pattern Matching

后缀模式匹配

[Original] By default Spring MVC performs ".*" suffix pattern matching so that a controller mapped to /person is also implicitly

mapped to /person.*. This makes it easy to request different representations of a resource through the URL path (e.g. /person.pdf,

/person.xml).

Spring MVC默认采用 ".*"的后缀模式匹配来进行路径匹配，因此，一个映射到 /person路径的控制器也会隐式地被映射

到 /person.*。这使得通过URL来请求同一资源文件的不同格式变得更简单（比如 /person.pdf， /person.xml）。

[Original] Suffix pattern matching can be turned off or restricted to a set of path extensions explicitly registered for content negotiation

purposes. This is generally recommended to minimize ambiguity with common request mappings such as /person/{id} where a dot

might not represent a file extension, e.g. /person/joe@email.com vs /person/joe@email.com.json). Furthermore as explained in

the note below suffix pattern matching as well as content negotiation may be used in some circumstances to attempt malicious attacks

and there are good reasons to restrict them meaningfully.

你可以关闭默认的后缀模式匹配，或者显式地将路径后缀限定到一些特定格式上for content negotiation purpose。我们推荐这样做，

这样可以减少映射请求时可以带来的一些二义性，比如请求以下路径 /person/{id}时，路径中的点号后面带的可能不是描述内容

格式，比如 /person/joe@email.com vs /person/joe@email.com.json。而且正如下面马上要提到的，后缀模式通配以及内容

协商有时可能会被黑客用来进行攻击，因此，对后缀通配进行有意义的限定是有好处的。

[Original] See Section 21.16.11, "Path Matching" for suffix pattern matching configuration and also Section 21.16.6, "Content Negotiation"

for content negotiation configuration.

关于后缀模式匹配的配置问题，可以参考第21.16.11小节 "路径匹配"；关于内容协商的配置问题，可以参考第21.16.6小节 "内容协

商"的内容。

后缀模式匹配与RFD

[Original] Reflected file download (RFD) attack was first described in a paper by Trustwave in 2014. The attack is similar to XSS in that it

relies on input (e.g. query parameter, URI variable) being reflected in the response. However instead of inserting JavaScript into HTML, an

RFD attack relies on the browser switching to perform a download and treating the response as an executable script if double-clicked

based on the file extension (e.g. .bat, .cmd).

RFD(Reflected file download)攻击最先是2014年在Trustwave的一篇论文中被提出的。它与XSS攻击有些相似，因为这种攻击方式也

依赖于某些特征，即需要你的输入（比如查询参数，URI变量等）等也在输出（response）中以某种形式出现。不同的是，RFD攻击

剩余67页未读，继续阅读

flourishLi

粉丝: 6

SpringMVC框架详解：中文翻译与关键特性

springmvc中文学习文档

Springmvc中文手册下载

spring-webmvc-5.3.10-API文档-中文版.zip

springMvc中文文档

SpringMVC中文文档：Web MVC模型解析

SpringMVC完整文档PDF

SpringMVC官方文档翻译与解读

springmvc中文官方文档

springmvc4.2中文文档

springMVC4.2.4中文文档

最新资源