关于页面渲染
其实在工作中,一直都是前后端分离,也就是说,我的工作从来都是提供接口,而不写 html css js 之类的,所以在这方面也没有经验。
这里为了给大家介绍下模板引擎,我将会写个非常非常简单的页面,如果不好看,请见谅~
Spring Boot 官方推荐的模板引擎是 Thymeleaf ,点击可以进入其官网了解详情。
本章目标
- 让 Spring Boot 应用可以访问到静态资源文件
- 创建用户登录表单,并对用户名、密码进行校验
- 校验失败,将返回登录页,并展示错误信息
- 校验成功,重定向到苹果列表页面
快速开始
添加依赖文件
创建一个 quick-thymeleaf 项目,创建方式参见上一篇文章 Springboot 入门。
创建好之后,修改我们的 POM 文件,添加 Thymeleaf 依赖,这里我们同时用到了 lombok 注解。
org.springframework.boot spring-boot-starter-thymeleaf org.projectlombok lombok 1.12.6
创建 Model 类
依赖添加完毕后,创建需要用到的类,这里需要用到两个,一个 User 用于用户登录,一个 Apple 用于展示作用。
User.java
@Data @NoArgsConstructor @AllArgsConstructor public class User { @NotEmpty(message = "用户名不能为空") @Length(min = 5, message = "用户名长度不能小于5位") private String username; @NotEmpty(message = "密码不能为空") @Length(min = 6, message = "密码长度不能小于6位") private String password; /** * 校验是否合法用户 * * @param user * @return */ public static boolean isUserValid(User user) { return "admin".equals(user.getUsername()) && "123456".equals(user.getPassword()); } }
Apple.java
@Data @NoArgsConstructor @AllArgsConstructor public class Apple { private Float price; private String color; /** * 制造苹果,这里生成 9 只 * * @return */ public static ListgenerateApples() { List prices = Arrays.asList(2.5f, 1.3f, 3.2f); List colors = Arrays.asList("red", "green", "black"); return prices.stream().flatMap( p -> colors.stream().map(c -> new Apple(p, c))).collect(toList()); } }
java8 新特性
Apple类为我们提供一些苹果,在用户登录成功后展示。
其中 generateApples 方法用到了 Java8 的新特性 函数式编程,这样代码会少很多,看起来很舒服。
关于 Java8 函数式编程 ,有时间的话,我会专门开一个系列来和大家聊聊,敬请期待。
lombok 注解
简单说明一下 lombok 注解
@Data:为所有属性增加 getter setter 方法,并且自动重写 toString hashCode 方法,并且以所有非空的字段创建了构造方法。
@NoArgsConstructor:生成无参构造方法。
AllArgsConstructor:包含所有参数的构造方法。
该类中其他的注解大家应该常用就不说明了。
创建控制器
Model 创建完毕,接着创建一个UserController 控制器。
该控制器包含三个方法
- 在浏览器访问主页的时候,我们希望进入到登录页面,所以含有一个 toLoginForm 方法
- 用户在登录页面输入用户名、密码之后,需要进行登录操作,所以包含一个 login 方法
- 登录成功后,将跳转到苹果列表页面,需要一个 apples方法
UserController.java
@Controller @RequestMapping("/user") // 在类中定义,表示该类中的所有方法都将以这个路径作为前缀 public class UserController { @GetMapping // 4.3 版本后的新特性 public ModelAndView toLoginForm(@ModelAttribute("errorMsg") String errorMsg, @ModelAttribute("user") User user) { // 返回 templates/login.html 页面, html 可以省略 return new ModelAndView("/login"); } @PostMapping("/login") // 4.3 版本后的新特性 public ModelAndView login(HttpServletRequest request, @Valid User user, BindingResult result, RedirectAttributes redirect) { // 如果 user 的字段不符合要求,则返回到登录页面,并将 valid error 信息传入登录页面 if (result.hasErrors()) return new ModelAndView("/login", "formErrors", result.getAllErrors()); // 用户名或密码不正确 if (!User.isUserValid(user)) { // 添加错误消息,该消息将一起带到重定向后的页面, // 浏览器刷新后,该数据将消失 redirect.addFlashAttribute("errorMsg", "登录失败,用户名或密码错误"); // 重定向到 login.html 页面 return new ModelAndView("redirect:/user"); } // 将用户登录信息添加到 session 中 request.getSession().setAttribute("userLogin", true); return new ModelAndView("redirect:/user/apples"); } @GetMapping("/apples") public ModelAndView apples(HttpServletRequest request) { Boolean userLogin = (Boolean) request.getSession().getAttribute("userLogin"); if (userLogin != null && userLogin) { Listapples = Apple.generateApples(); // 登录成功,进入 apple 页面,并展示 apples ModelAndView modelAndView = new ModelAndView("/apple"); modelAndView.addObject("apples", apples); return modelAndView; } return new ModelAndView("redirect:/user"); } }
类中已作了简单的解释,所以不再赘述,如果有疑问的,可以自己搜索相关资料,或者留言。
创建并访问资源文件
在控制器中,我们的两个方法都响应了不同的页面,那么现在就需要创建对应的页面。
在 Spring Boot 中,应用的资源文件默认处于 resources 资源文件夹下,其中静态文件默认在 resources/static 目录下,模板文件在 resources/templates 目录下,我们创建对应的目录结构
按照图示创建好之后,再在对应的目录中添加 css、js 文件。
然后创建 HTML 文件,这里由于代码量太多,就不展示了,有兴趣的可以点击链接下载
apple.html
login.html
layout.html
接下来在 resources 根目录下创建 Spring Boot 的配置文件 application.yml
推荐使用 yml 格式作为配置文件格式,看上去很直观
application.yml
server: # 指定服务器端口号 port: 8088 spring: thymeleaf: # 禁止浏览器缓存 cache: false mode: HTML5
启动项目
一切准备就绪,接下来我们启动项目,和上一章不同的是,这次我们把启动类单独移出,以免和业务类混在一起。
在控制器所在包的上一层,我们创建
Application.java
@SpringBootApplication public class Application extends WebMvcConfigurerAdapter { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }
效果预览
运行 main 方法,在浏览器中访问
http://localhost:8088/user
当用户名少于 5 位,密码少于 6 位时
当用户名密码不正确时
最后,登录成功
至此,一个简单的 web 交互做好了,当然这里面肯定存在些问题,我也是第一次接触 Spring ,也是第一次以非 JSON 的格式传递数据,在实现这个的过程中,让我觉得还是提供接口简单方便点,哈哈。
接下来要了解的
本章我们快速了解了下 Spring Boot 创建 web 应用。
但是在我们实现的过程中,每当改了类或者资源文件的时候,要想看到效果,只得重新启动项目,这太麻烦了,下一节了解下 Spring Boot 热部署。
并且在本章中,对于用户的验证,我们是写死了的,下一章将整合 Mybatis。
代码已同步到 GitHub, 项目地址 github:sboot-learn,大家也可以通过本地进行下载,点击这里下载
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流,谢谢大家对脚本之家的支持。