Spring Boot - 整合Jsp/FreeMarker

头像
刘忠旭
    阅读 7 分钟
    4

    Spring Boot - 初识 Hello World

    索引

    1. Spring Boot - 初识 Hello World
    2. Spring Boot - Servlet、过滤器、监听器、拦截器
    3. Spring Boot - 静态资源处理、启动加载、日志处理
    4. Spring Boot - 数据库配置
    5. Spring Boot - 部署Deploy

    准备

    1. Jdk8
    2. Ide intelliJ IDEA 或者 eclipse
    3. Maven 3

    返回Json格式数据

    修改pom依赖
    <?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>com.wanye</groupId>
    <artifactId>com.wanye.springboot</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.1.RELEASE</version>
    </parent>

    <dependencies>

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


    </dependencies>

</project>
    创建启动类
    package com.wanye;

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

/**
 * Created by wanye on 2017/5/20.
 */
@SpringBootApplication
public class Start {

    public static void main(String[] args) {
        SpringApplication.run(Start.class, args);
    }
}
    创建Controller
    package com.wanye.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;

/**
 * Created by wanye on 2017/5/20.
 */
@RestController // @Controller + @ResponseBody
public class HelloController {

    @RequestMapping("/hello")
    public Map<String, String> hello(){
        Map<String, String> hello = new HashMap<String, String>();
        hello.put("data", "hello 小红");
        hello.put("status", "SUCCESS");
        return hello;
    }
}
    启动方式
    通过main()方法来启动
    验证

    访问http://localhost:8080/hello 我们可以看到页面返回了数据，并且自动转换成JSON格式，接下来我们讲解刚刚用到的注解

    整合JSP/FreeMarker

    在整合JSP/FreeMarker之前，我们先了解一下spring boot对于controller的支持

    1. 模版引擎：spring boot支持FreeMarker 、Groovy 、Thymeleaf （Spring 官⽹网使⽤用这个）、Velocity 、JSP
    2. 接收参数：@RequestBody、@RequestParam、@ModelAttribute、JSONObject、HttpEntity 等
    通过JSP模板引擎渲染
    修改pom依赖
    <?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>com.wanye</groupId>
    <artifactId>com.wanye.springboot</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.1.RELEASE</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- 整合jsp -->
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
        </dependency>
        <!-- 整合jsp -->
    </dependencies>

</project>
    添加JSP文件
    1. 增加⽬目录“src/main/webapp/WEB-INF/jsp/”，将jsp⽂文件放⼊入这个⽬目录中，示例home.jsp代码（只用来验证是否访问到该文件）
    <html>
<head>
    <title>jsp</title>
</head>
<body>
hello jsp
</body>
</html>
    1. 在⽬目录“resources”中，增加application.properties配置⽂文件
    # 页面默认前缀目录
spring.mvc.view.prefix=/WEB-INF/jsp/
# 响应页面默认后缀
spring.mvc.view.suffix=.jsp
    1. 创建JSPController
    package com.wanye.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * Created by wanye on 2017/5/20.
 */
@Controller
public class JSPController {

    @RequestMapping("/jsp/home")
    public String home() {
        return "home";
    }
}
    启动方式
    #必须⽤用sping-boot:run启动
mvn clean spring-boot:run
    验证

    访问http://localhost:8080/jsp/home 页面返回”hello jsp”，说明整合JSP成功，该请求能够访问到home.jsp这个文件

    通过FreeMarker模板引擎渲染
    修改pom文件

    删除刚刚jsp的pom配置，并修改spring boot 启动依赖的jar

    <?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>com.wanye</groupId>
    <artifactId>com.wanye.springboot</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.1.RELEASE</version>
    </parent>

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

</project>
    添加.ftl模板文件
    1. 在resources下创建templates文件夹，将.ftl文件放⼊
    2. application.properties文件中无需配置（删除jsp配置）
    3. home.ftl文件
    <html>
<head>
    <title></title>
</head>
<body>
hello freemarker. ${time?string("yyyy-MM-dd hh:mm:ss")}
</body>
</html>
    1. 创建FreemarkerController
    package com.wanye.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import java.util.Date;

/**
 * Created by wanye on 2017/5/20.
 */
@Controller
public class FreemarkerController {

    @RequestMapping("/ftl/home1")
    public String home1(Model model) {
        model.addAttribute("time", new Date(System.currentTimeMillis()));
        return "home";
    }

    @RequestMapping("/ftl/home2")
    public ModelAndView home2() {
        ModelAndView res = new ModelAndView("home");
        res.addObject("time", new Date(System.currentTimeMillis()));
        return res;
    }
}

    这里通过两种方式，向页面传递参数“time”。大家自己了解一下Model, ModelAndView的使用方法，我这里就不进行详细的讲述了。

    启动方式
    两种方式都可以：主函数main()启动或者spring-boot:run
    验证

    访问http://localhost:8080/ftl/home1 页面，验证是否输出了当前时间。关于FreeMarker语法，大家自己了解一下，不是本文关注的重点

    总结

    本文讲述了（json,jsp,freemarker)配置及整合方法，并针对web开发常用的注解的概念及功能进行了介绍，留下了一个疑问：为什么整合jsp后必须通过spring-boot:run方式启动？欢迎大家留言讨论。

    注解含义

    1. @SpringBootApplication 等价于 @Configuration + @ComponentScan + @EnableAutoConfiguration

      1. @Configuration （可以理解为spring的xml配置） +
      2. @ComponentScan （进行组件扫描，如果扫描到有@Component、@Controller、@Service等这些注解的类，并注册为Bean，可以自动收集所有的Spring组件，包括@Configuration类） +
      3. @EnableAutoConfiguration （开启自动配置，这个注解告诉Spring Boot根据添加的jar依赖猜测你想如何配置Spring，建议标记在启动类上）
    2. @RestController 等价于 @Controller + @ResponseBody 返回json数据格式（springboot默认使用jackson组件进行转换）
    3. @RequestMapping 提供路由信息，注册访问路径

    最后

    若本文对你有帮助，望点赞。为了提高大家学习效果，录制了同步的视频课程，还望大家支持视频课程

    图片描述

    freemarkerjspspringbootjava
    刘忠旭
    441 声望500 粉丝

    致力于最实用的技术

    下一篇 »
    Spring Boot - Servlet、过滤器、监听器、拦截器

    引用和评论

    被 11 篇内容引用
    推荐阅读
    头像
    Spring Boot - 多模块多环境配置，大厂必备技能

    刘忠旭赞 11阅读 13.3k评论 2

    头像
    在Java程序中监听mysql的binlog

    huan1993赞 11阅读 2k

    头像
    Jerry和您聊聊Chrome开发者工具

    注销赞 9阅读 4.5k评论 3

    头像
    Bitmap 和 布隆过滤器傻傻分不清？你这不应该啊

    程序员小富赞 8阅读 1.7k评论 1

    头像
    Just for fun——迅速写完快速排序

    ufdf赞 3阅读 2.6k

    头像
    Spring 实现 3 种异步流式接口，干掉接口超时烦恼

    程序员小富赞 5阅读 1.7k

    头像
    状态码 406， Not Acceptable, (Spring Boot)

    zZ_jie赞 4阅读 747

    0 条评论
    得票最新