初见 Spring MVC

编辑：016 时间：2020-02-11

为什么使用 Spring MVC

Spring helps development teams everywhere build simple, portable, fast and flexible JVM-based systems and applications.

BUILD ANYTHING
RUN ANYWHERE
REST ASSURED

以上内容摘自 Sping官网

并且重要的是，Spring MVC使用广泛，各大公司基本都有在用，掌握了它无疑可以更好地工作。

开始

以下文档将会指导你用Spring实现一个 “hello world” web 应用。

你将会创建

创建一个 HTTP GET 请求:

http://localhost:8080/greeting

然后回得到以下的响应:

{"id":1,"content":"Hello, World!"}

你也可以自定义可选参数 name 的值:

http://localhost:8080/greeting?name=User

该 name 的值将会覆盖默认的 “World”，并显示在页面上:

{"id":1,"content":"Hello, User!"}

你所需要具备的

创建 Maven 工程

官方提供了使用 Gradle 创建项目以及直接从 Git 下载源码的方式。

我们使用 Maven 创建项目。

官网提供的方法是自己创建对应的目录结构:

mkdir -p src/main/java/hello

而我们可以用 IDE 来创建一个 Maven 项目，这样会更快，也不容易出错。

依次选择 IDEA->File->NEW->Maven->Next
输入GroupId, ArtifactId，Version默认即可
输入 Project name，Finish

GroupId:

定义了项目属于哪个组，一般来说这个网网和公司或组织关联，比如说，你所在的公司为mycom.那就应该定义为com.mycom.mymaven，mymaven为项目名称

ArtifactId:

定义了当前Maven项目在组中的唯一id

然后我们需要更改 pom.xml 文件。

将以下 pom.xml 替换项目生成的 pom.xml

4.0.0org.springframeworkgs-serving-web-content0.1.0org.springframework.bootspring-boot-starter-parent1.4.0.RELEASEorg.springframework.bootspring-boot-starter-thymeleaforg.springframework.bootspring-boot-devtoolstrue1.8org.springframework.bootspring-boot-maven-plugin

然后执行:

mvn clean

mvn compile

就会将所依赖的 jar 下载下来（前提是需要安装好 Maven，Linux可以通过 yum install maven 进行安装，Mac 可以通过 brew install maven 进行安装）。

创建一个 web 服务器

Spring 创建的项目中，HTTP 请求是通过 controller 进行处理的。你可以很容易通过 @Controller 注解来识别这些请求。在下面的例子中，我们将以 JSON 的形式响应 /greeting 请求。如下所示:

{
    "id": 1,
    "content": "Hello, World!"
    }

首先创建 Greeting.java

package hello; public class Greeting { private final long id; private final String content; public Greeting(long id, String content) { this.id = id; this.content = content; } public long getId() { return id; } public String getContent() { return content; } }

然后创建 GreetingController.java

package hello;
import java.util.concurrent.atomic.AtomicLong;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
public class GreetingController {
    private static final String template = "Hello, %s!";
    private final AtomicLong counter = new AtomicLong();
    ("/greeting")
    public Greeting greeting(@RequestParam(value="name", defaultValue="World") String name) {
        return new Greeting(counter.incrementAndGet(),
                            String.format(template, name));
    }
    }

这个控制器很简洁，但是包含了大量的信息。

这个 @RequestMapping 注解确保了 HTTP 的 /greeting 请求映射到 greeting() 方法。

上面的例子没有区别 GET, PUT, POST 等等，因为 @RequestMapping 默认匹配所有的 HTTP 请求。如果想具体指明是哪种请求，可以使用 @RequestMapping(method=RequestMethod.GET)

@RequestParam 会将请求过来的查询字符串中的 name 绑定到 greeting() 方法中。该值并不是必须的，当没有传入值时，将会使用默认的 “World” 来代替。

传统的 MVC 控制器和 RESTful web service 控制器的一个主要区别是 RESTful web service 创建了 HTTP response body，对象可以直接以 JSON 的形式写入到 HTTP 响应体中，而不需要依赖模板引擎在服务器端渲染数据。

该 Greeting 对象必须转换成 JSON，Spring 会自动使用 Jackson 2 进行转换。

最后我们需要创建启动器，启动我们的 Web 服务。创建 Application.java

package hello;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
    }

@SpringBootApplication 是一个很方便的注解，它相当于添加了以下所有注解: