Spring MVC快速入门-白红宇

Spring MVC快速入门

阅读量：4091 次

发布时间：2019-05-25

本文共 5000 字，大约阅读时间需要 16 分钟。

快速入门由发表在

今天给大家介绍一下Spring MVC，让我们学习一下如何利用Spring MVC快速的搭建一个简单的web应用。

环境准备

一个称手的文本编辑器（例如Vim、Emacs、Sublime Text）或者IDE（Eclipse、Idea Intellij）

Java环境（JDK 1.7或以上版本）

Maven 3.0+（Eclipse和Idea IntelliJ内置，如果使用IDE并且不使用命令行工具可以不安装）

一个最简单的Web应用

使用Spring Boot框架可以大大加速Web应用的开发过程，首先在Maven项目依赖中引入spring-boot-starter-web：

pom.xml


   
     
    
     4.0.0
      
    
     com.tianmaying
      
    
     spring-web-demo
      
    
     0.0.1-SNAPSHOT
      
    
     jar
      
    
     spring-web-demo
      
    
     Demo project for Spring WebMvc
      
        
     
      org.springframework.boot
         
     
      spring-boot-starter-parent
         
     
      1.2.5.RELEASE
         
       
      
        
     
      UTF-8
         
     
      1.8
       
      
        
           
      
       org.springframework.boot
            
      
       spring-boot-starter-web
          
       
      
        
           
              
       
        org.springframework.boot
               
       
        spring-boot-maven-plugin

接下来创建src/main/java/Application.java:

import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;@SpringBootApplication@RestControllerpublic class Application {    @RequestMapping("/")    public String greeting() {        return "Hello World!";    }    public static void main(String[] args) {        SpringApplication.run(Application.class, args);    }}

运行应用：mvn spring-boot:run或在IDE中运行main()方法，在浏览器中访问，Hello World!就出现在了页面中。只用了区区十几行Java代码，一个Hello World应用就可以正确运行了，那么这段代码究竟做了什么呢？我们从程序的入口SpringApplication.run(Application.class, args);开始分析：

SpringApplication是Spring Boot框架中描述Spring应用的类，它的run()方法会创建一个Spring应用上下文（Application Context）。另一方面它会扫描当前应用类路径上的依赖，例如本例中发现spring-webmvc（由 spring-boot-starter-web传递引入）在类路径中，那么Spring Boot会判断这是一个Web应用，并启动一个内嵌的Servlet容器（默认是Tomcat）用于处理HTTP请求。

Spring WebMvc框架会将Servlet容器里收到的HTTP请求根据路径分发给对应的@Controller类进行处理，@RestController是一类特殊的@Controller，它的返回值直接作为HTTP Response的Body部分返回给浏览器。

@RequestMapping注解表明该方法处理那些URL对应的HTTP请求，也就是我们常说的URL路由（routing)，请求的分发工作是有Spring完成的。例如上面的代码中[]()根路径就被路由至greeting()方法进行处理。如果访问[]()，则会出现404 Not Found错误，因为我们并没有编写任何方法来处理/hello请求。

使用`@Controller`实现URL路由

现代Web应用往往包括很多页面，不同的页面也对应着不同的URL。对于不同的URL，通常需要不同的方法进行处理并返回不同的内容。

匹配多个URL

@RestControllerpublic class Application {    @RequestMapping("/")    public String index() {        return "Index Page";    }    @RequestMapping("/hello")    public String hello() {        return "Hello World!";    }}

@RequestMapping可以注解@Controller类：

@RestController@RequestMapping("/classPath")public class Application {    @RequestMapping("/methodPath")    public String method() {        return "mapping url is /classPath/methodPath";    }}

method方法匹配的URL是/classPath/methodPath"。

提示

可以定义多个@Controller将不同URL的处理方法分散在不同的类中

URL中的变量——PathVariable

在Web应用中URL通常不是一成不变的，例如微博两个不同用户的个人主页对应两个不同的URL: []()，[]()。我们不可能对于每一个用户都编写一个被@RequestMapping注解的方法来处理其请求，Spring MVC提供了一套机制来处理这种情况：

@RequestMapping("/users/{username}")public String userProfile(@PathVariable("username") String username) {    return String.format("user %s", username);}@RequestMapping("/posts/{id}")public String post(@PathVariable("id") int id) {    return String.format("post %d", id);}

在上述例子中，URL中的变量可以用{variableName}来表示，同时在方法的参数中加上@PathVariable("variableName")，那么当请求被转发给该方法处理时，对应的URL中的变量会被自动赋值给被@PathVariable注解的参数（能够自动根据参数类型赋值，例如上例中的int）。

支持HTTP方法

对于HTTP请求除了其URL，还需要注意它的方法（Method）。例如我们在浏览器中访问一个页面通常是GET方法，而表单的提交一般是POST方法。@Controller中的方法同样需要对其进行区分：

@RequestMapping(value = "/login", method = RequestMethod.GET)public String loginGet() {    return "Login Page";}@RequestMapping(value = "/login", method = RequestMethod.POST)public String loginPost() {    return "Login Post Request";}

模板渲染

在之前所有的@RequestMapping注解的方法中，返回值字符串都被直接传送到浏览器端并显示给用户。但是为了能够呈现更加丰富、美观的页面，我们需要将HTML代码返回给浏览器，浏览器再进行页面的渲染、显示。

一种很直观的方法是在处理请求的方法中，直接返回HTML代码，但是这样做的问题在于——一个复杂的页面HTML代码往往也非常复杂，并且嵌入在Java代码中十分不利于维护。更好的做法是将页面的HTML代码写在模板文件中，渲染后再返回给用户。为了能够进行模板渲染，需要将@RestController改成@Controller：

import org.springframework.ui.Model;@Controllerpublic class HelloController {    @RequestMapping("/hello/{name}")    public String hello(@PathVariable("name") String name, Model model) {        model.addAttribute("name", name);        return "hello"    }}

在上述例子中，返回值"hello"并非直接将字符串返回给浏览器，而是寻找名字为hello的模板进行渲染，我们使用模板引擎进行模板渲染，需要引入依赖：


     
    
     org.springframework.boot
      
    
     spring-boot-starter-thymeleaf

接下来需要在默认的模板文件夹src/main/resources/templates/目录下添加一个模板文件hello.html：

Getting Started: Serving Web Content

th:text="'Hello, ' + ${name} + '!'"也就是将我们之前在@Controller方法里添加至Model的属性name进行渲染，并放入<p>标签中（因为th:text是<p>标签的属性）。模板渲染还有更多的用法，请参考。

处理静态文件

浏览器页面使用HTML作为描述语言，那么必然也脱离不了CSS以及JavaScript。为了能够浏览器能够正确加载类似/css/style.css, /js/main.js等资源，默认情况下我们只需要在src/main/resources/static目录下添加css/style.css和js/main.js文件后，Spring MVC能够自动将他们发布，通过访问/css/style.css, /js/main.js也就可以正确加载这些资源。

更多文章请访问

你可能感兴趣的文章