译：7.使用Spring MVC服务Web内容

时间 2019-11-06

标签使用 spring mvc 服务 web 内容栏目 Spring 繁體版

原文原文链接

本指南向您介绍了使用Spring建立“hello world”网站的过程。阅读原文：Serving Web Content with Spring MVChtml

1. 你将会构建什么？

您将构建一个具备静态主页的应用程序，而且还将在如下位置接受HTTP GET请求：java

http://localhost:8080/greeting

并用显示HTML的网页进行响应。 HTML的主体包含一个问候语：git

"Hello, World!"github

您可使用查询字符串中的可选名称参数来自定义问候语：web

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

名称参数值覆盖“World”的默认值，并反映在响应中：

"Hello, User!"

2. 你须要准备什么？

大约十五分钟spring
一个喜欢的文本编辑器或者IDEapache
JDK 1.8 或者更高浏览器
Gradle 4+ 或者 Maven 3.2+缓存
你也能够导入Code到你的IDE中服务器
- Spring Tool Suite (STS)
- IntelliJ IDEA

3. 如何实现这个指南?

像大多数Spring入门指南同样，您能够从头开始并完成每一个步骤，也能够绕过已熟悉的基本设置步骤。不管哪一种方式，你最终获得工做代码。

1. 打开STS,New ————> Import Spring Getting Started Content

2. 输入servi ,搜索找到Serving Web Content

Tips: Build Type 选择Maven, Code Sets 所有勾选，由于这样能够同时生成完成后的点和空的项目，方便咱们学习。

3. 建立一个Web Controller

在Spring构建网站的方法中，HTTP请求由控制器处理。

您能够经过@Controller注释轻松识别这些请求。在如下示例中，GreetingController经过返回View的名称（在本例中为“greeting”）来处理/ greeting的GET请求。视图负责呈现HTML内容：

src/main/java/hello/GreetingController.java

package hello;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class GreetingController {

    @GetMapping("/greeting")
    public String greeting(@RequestParam(name="name", required=false, defaultValue="World") String name, Model model) {
        model.addAttribute("name", name);
        return "greeting";
    }

}

这个控制器简洁明了，但有不少事情要作。让咱们一步一步分解它。

@GetMapping注释可确保将/ GET的HTTP GET请求映射到greeting（）方法。

@RequestParam将查询字符串参数名称的值绑定到greeting（）方法的name参数中。此查询字符串参数不是必需的; 若是请求中缺失，则使用“World”的缺省值。 name参数的值被添加到Model对象，最终使其能够被视图模板访问。

方法体的实现依赖于视图技术，在这种状况下是Thymeleaf，执行HTML的服务器端呈现。 Thymeleaf解析下面的greeting.html模板并评估th：text表达式来呈如今控制器中设置的$ {name}参数的值。

src/main/resources/templates/greeting.html

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Getting Started: Serving Web Content</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
    <p th:text="'Hello, ' + ${name} + '!'" />
</body>
</html>

4.开发Web应用程序

开发Web应用程序的一个常见功能是对变动进行编码，从新启动应用程序，并刷新浏览器以查看更改。整个过程可能会耗费不少时间。为了加速事情的循环，Spring Boot附带了一个称为spring-boot-devtools的方便模块。

启用热交换

切换模板引擎以禁用缓存

使LiveReload可以自动刷新浏览器

其余基于开发而非生产的合理违约

5. 使应用程序变得可执行

虽然能够将此服务做为传统WAR文件打包以部署到外部应用程序服务器，但下面演示的更简单的方法会建立独立应用程序。您将全部内容打包到一个单独的，可执行的JAR文件中，由一个良好的旧Java main（）方法驱动。一路上，您使用Spring的支持将Tomcat servlet容器做为HTTP运行时嵌入，而不是部署到外部实例。

src/main/java/hello/Application.java

package hello;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

}

@SpringBootApplication是一个方便的注释，它增长了如下全部内容：

@Configuration将类标记为应用程序上下文的bean定义的来源。
@EnableAutoConfiguration通知Spring Boot根据类路径设置，其余bean和各类属性设置开始添加bean。
一般你会为Spring MVC应用程序添加@EnableWebMvc，但Spring Boot在类路径中看到spring-webmvc时会自动添加。这将该应用程序标记为Web应用程序并激活关键行为，例如设置DispatcherServlet。
@ComponentScan告诉Spring在hello包中查找其余组件，配置和服务，以便找到控制器。

main（）方法使用Spring Boot的SpringApplication.run（）方法启动应用程序。你有没有注意到没有一行XML？没有web.xml文件。这个Web应用程序是100％纯Java，您没必要处理配置任何管道或基础设施。

6. 编译出一个可执行的Jar

您可使用Gradle或Maven从命令行运行应用程序。或者您能够构建一个包含全部必需的依赖项，类和资源的可执行JAR文件，并运行该文件。这使得在整个开发生命周期内跨越不一样环境等，将服务做为应用程序发布，版本化和部署变得很是容易。

若是您正在使用Gradle，则可使用./gradlew bootRun运行该应用程序。或者您可使用./gradlew构建构建JAR文件。而后你能够运行JAR文件：

java -jar build/libs/gs-serving-web-content-0.1.0.jar

若是您使用的是Maven，则可使用./mvn spring-boot：run来运行该应用程序。或者您可使用./mvn clean包构建JAR文件。而后你能够运行JAR文件：

java -jar target/gs-serving-web-content-0.1.0.jar

上述过程将建立一个可运行的JAR。您也能够选择构建经典的WAR文件。

7.测试这个App

如今该网站正在运行，请访问 http://localhost:8080/greeting ，您会看到：

"Hello, World!"
如图所示:

提供一个name查询字符串参数经过 http://localhost:8080/greeting?name=User.

如今你注意到这个消息已经由 "Hello, World!" 改变成了 "Hello, User!"

"Hello, User!"

此更改演示了GreetingController中的@RequestParam排列按预期工做。 name参数已被赋予默认值“World”，但始终能够经过查询字符串显式覆盖。

添加一个Home 页面

像HTML或JavaScript或CSS这样的静态资源能够很容易地从Spring Boot应用程序中提供，只需将它们放在源代码的正确位置便可。默认状况下，Spring Boot以“/ static”（或“/ public”）的类路径中的资源提供静态内容。 index.html资源是特殊的，由于它用做“欢迎页面”（若是它存在），这意味着它将做为根资源提供，即在咱们的示例中为http：// localhost：8080 /。因此建立这个文件：

src/main/resources/static/index.html

<!DOCTYPE HTML>
<html>
<head>
    <title>Getting Started: Serving Web Content</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
    <p>Get your greeting <a href="/greeting">here</a></p>
</body>
</html>

而后当你重启你的App你将会看到这个页面在这个网址 http://localhost:8080/

恭喜！ 你刚刚用Spring开发了一个网页。
源码: 点击查看