[Spring入门学习笔记][创建网站URL]

时间:2024-01-09 12:10:14

设计网站的URL

现代的Web站点都会设计一套拥有明确意义,方便用户记忆的URL,不论是域名还是路径,以天码营为例:

在HTML和CSS的学习中,我们创建了个人博客网站的基本页面,如果需要将他们放在Internet中让其他人可以访问,就必须为它们设计一套URL,现在假设我们的网站通过http://localhost:8080/可以访问:

定义URL处理方法

在Spring WebMVC框架中,使用@RequestMapping注解可以将URL与处理方法绑定起来,例如:

@Controller
public class IndexController { @RequestMapping("/")
@ResponseBody
public String index() {
return "index";
} @RequestMapping("/hello")
@ResponseBody
public String hello() {
return "hello";
}
}

IndexController类中的两个方法都被@RequestMapping注解,当应用程序运行后,在浏览器中访问http://localhost:8080/,请求会被Spring MVC框架分发到index()方法进行处理。同理,http://localhost:8080/hello会交给hello()方法进行处理。

@ResponseBody注解表示处理函数直接将函数的返回值传回到浏览器端显示。同时,不要忘记给IndexController类加上@Controller注解。

@RequestMapping注解同样可以加在类上:

@Controller
@RequestMapping("/posts")
public class AppController { @RequestMapping("/create")
public String create() {
return "mapping url is /posts/create";
}
}

create()绑定的URL路径是/posts/create。

URL变量

在Web应用中URL通常不是一成不变的,例如微博两个不同用户的个人主页对应两个不同的URL: http://weibo.com/user1http://weibo.com/user2。我们不可能对于每一个用户都编写一个被@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)。

返回HTML

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

@RequestMapping("/posts/{id}")
public String post(@PathVariable("id") int id) {
return "<html><head><title>Title</title></head><body><h2>This is a Post</h2><p>This is content of the post."</p></body></html>;
}

显然,这样做的问题在于——一个复杂的页面HTML代码往往也非常复杂,并且嵌入在Java代码中十分不利于维护。

更好的做法是将页面的HTML代码写在模板文件中,然后读取该文件并返回。Spring天然支持这种非常常见的场景,需要先在pom.xml引入Thymeleaf依赖(接下来的学习中会重点讲到):

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

将HTML文本保存在src/main/resources/templates/post.html下:

<html>
<head>
<title>Title</title>
</head>
<body>
<h1>This is title</h1>
<p> This is Content</h2>
</body>
</html

Controller中可以去掉@ResponseBody注解,并将URL处理函数的返回值设为刚刚保存在templates/文件夹中的文件名(不需要扩展名):

@RequestMapping("/posts/{id}")
public String post(@PathVariable("id") int id) {
return "post";
}

Spring框架在发现返回值是"post"后,就会去src/main/resources/templates/目录下读取post.html文件并将它的内容返回给浏览器。