本文将带你体验利用Spring创建'Hello world'web站点的过程。
你将要构建的东西
你将构建一个在以下地址接受HTTP GET请求的服务:
http://localhost;8080/greeting
并将会以一个展示以下内容的web页面:
"Hello, World!"
你也可以使用一个name参数自定义greeting的结果:
http://localhost:8080/greeting?name=User
应答内容将会变成:
"Hello, User!"
你需要的东西
- 一个你最喜欢的IDE
- JDK1.8或者更新
- Maven 3.0+
如何完成这个计划
在IDE里面创建一个普通Maven工程,该工程将包含以下结构:
--src
-- main
--java
--hello
--resources
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.springframework</groupId>
<artifactId>gs-serving-web-content</artifactId>
<version>0.1.0</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.2.5.RELEASE</version>
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
</dependencies>
<properties>
<java.version>1.8</java.version>
</properties>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
<repositories>
<repository>
<id>spring-milestone</id>
<url>https://repo.spring.io/libs-release</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring-milestone</id>
<url>https://repo.spring.io/libs-release</url>
</pluginRepository>
</pluginRepositories>
</project>
Spring Boot Maven plugin提供许多便利的功能:
- 收集classpath中所有jar并构建一个单个的、可执行的jar
- 搜索public static void main方法来标记一个可运行的类
- 提供一个内置的依赖解析器
创建web controller
在Spring构建web站点的方法中,HTTP请求由controller处理。你可以简单的通过@Controller注解来标识这些请求。下面例子中,GreetingController通过返回一个View的名字从而为/greeting处理GET请求,View负责渲染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.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
@Controller
public class GreetingController {
@RequestMapping("/greeting")
public String greeting(@RequestParam(value="name", required=false, defaultValue="World") String name, Model model) {
model.addAttribute("name", name);
return "greeting";
}
}
这个控制器简单精炼,但是却做了很多事情,让我们来一步一步拆解他。
@RequestMapping注解确保到/greeting的HTTP请求被映射到了greeting()方法上
注意:上面例子并未指定GET\PUT\POST等等,因为@RequestMapping默认映射所有HTTP操作,用@RequestMapping(method=GET)来缩小映射范围。
@RequestParam绑定查询字符串参数name的值到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>
原文请参考:http://spring.io/guides/gs/serving-web-content/#scratch