Spring Boot 项目中使用JSP

时间 2019-11-21

标签 spring boot 项目使用 jsp 栏目 Spring 繁體版

原文原文链接

1 第2-2课：Spring Boot 项目中使用JSP

JSP（Java Server Pages，Java 服务器页面）是一个简化的 Servlet 设计，它是由 Sun Microsystems 公司倡导、许多公司参与一块儿创建的一种动态网页技术标准。JSP 技术相似 ASP 技术，它是在传统的网页 HTML（标准通用标记语言的子集）文件（.html）中插入 Java 程序段（Scriptlet）和 JSP 标记（tag），从而造成 JSP 文件，后缀名为（*.jsp）。用 JSP 开发的 Web 应用是跨平台的，既能在 Linux 下运行，也能在其余操做系统上运行。html

JSP 其实就是 Java 为了支持 Web 开发而推出的类前端 Servlet，能够在 JSP 中写 Java 或者 Html 语法等，后端根据 JSP 语法渲染后返回到前端显示，在没有模板引擎以前 JSP 是 Java 程序员开发人员的首选，到如今仍然有不少公司使用 JSP 开发后台管理系统。本课内容将介绍如何在 Spring Boot 项目中使用 JSP。前端

1.1 快速上手

1.1.1 项目结构

首先看一下添加 JSP 支持后的项目结构：java

spring-boot-jsp

-src+

-main    +

-java         +

-resources         +

-webapp         +

-WEB-INF              +

-jsp                 +

-welcome.jsp                    +

-test    +

-pom.xml+

对比之前的项目结构 main 目录下多了 webapp 目录，用来存放目录 jsp 文件。程序员

1.1.2 配置文件

须要在配置文件中指定 jsp 的位置和后缀。web

spring.mvc.view.prefix: /WEB-INF/jsp/

spring.mvc.view.suffix: .jsp

spring.mvc.view.prefix 指明 jsp 文件在 webapp 下的哪一个目录
spring.mvc.view.suffix 指明 jsp 以什么样的后缀结尾

1.1.3 引入依赖包

<dependency>

<groupId></groupId>   org.springframework.boot

<artifactId></artifactId>   spring-boot-starter-web

</dependency>

<dependency>

<groupId></groupId>   javax.servlet

<artifactId></artifactId>   jstl

</dependency>

<dependency>

<groupId></groupId>   org.apache.tomcat.embed

<artifactId></artifactId>   tomcat-embed-jasper

</dependency>

spring-boot-starter-web 包依赖了 spring-boot-starter-tomcat 不须要再单独配置。引入 jstl 和内嵌的 tomcat，jstl 是一个 JSP 标签集合，它封装了 JSP 应用的通用核心功能。tomcat-embed-jasper 主要用来支持 JSP 的解析和运行。spring

1.1.4 编写页面

简单写一个页面：apache

<!DOCTYPE html>

<html lang="en">

<body>

    Time:  ${time}

<br>

    Message: ${message}

</body>

</html>

很简单的一个页面，展现后端传到页面的时间和消息。后端

1.1.5 后端程序

@Controller

publicclass WelcomeController {

@GetMapping"/"   ()

public String welcome(Map<String, Object> model)    {

"time"new        model.put(,Date());

"message""hello world"        model.put(,);

return"welcome"       ;

time 获取当前时间，message 赋值为 hello world。浏览器

1.1.6 测试

cmd 进入项目跟路径下：tomcat

cd...\spring-boot-jsp

执行如下命令启动：

mvncleanspring-boot:run

启动完成后，在浏览器中访问地址：http://localhost:8080/，返回信息以下：

TimeSatAug:26:35CST:11 132018

Messagehelloworld:

说明项目运行成功。

1.2 经常使用示例

页面中经常使用的展现后端传值、if 判断、循环等功能，可使用 jstl 语法处理，也能够直接写 Java 代码来实现这些逻辑，在 jsp 页面中这两种方式都支持。但不建议在 jsp 页面中编写大量的 Java 代码，从而致使前端业务复杂，可读性差等问题。下面经过一些小的示例来学习。

在 WelcomeController 类中定义一个 user() 的方法，设置一些值从后端传递到前端：

"/user"@GetMapping()

StringMapStringObjectpublicuser(<,> model, HttpServletRequest request) {

"username""neo"    model.put(,);

"salary"666    model.put(,);

"count"6    request.getSession().setAttribute(,);

return"user"   ;

将参数和值以键值对的方式存储在 Map 中，jsp 页面能够直接根据属性名来获取值，也能够经过 request 来传递后端属性和值，返回值会以键值对的方式传递到 user.jsp 页面。

在 user.jsp 文件头部添加两个标签：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %><html lang="en">

引入第一个标签是为了让页面支持中文展现，第二个标签引入表示页面使用 jstl 语法来处理页面逻辑。

1.2.1 Java 代码

能够直接在 jsp 页面中使用 Java 代码，若是是一行 Java 代码使用<%= %>的语法，若是是多行 Java 代码则使用<% %>的语法，示例以下：

<h3>一行Java代码</h3>

<p>

new   今天的日期是: <%=(java.util.Date())%>

</p>

<h3>多行Java代码</h3>

<p>

   你的IP地址是：

<%

out"Your IP address is ""</br>"   .println(+ request.getRemoteAddr()+);

out"一段代码 "   .println();

%>

</p>

For 循环是页面最经常使用的功能之一，通常用在循环展现表格、列表等。

<h3>For循环实例</h3>

<%

intint"count"   count = ()session.getAttribute();

forint1   (fontSize =; fontSize <=count; fontSize++){

%>

         纯洁的微笑

<br />

<%}%>

根据后端传递的 count 值来选择前端页面循环次数。

1.2.2 jstl 语法

页面经常会使用一些逻辑判断，使用 jstl 语法很容易实现这些功能。

<h3></h3>标签c:if

<c:if test="${username !=null}">

<p><p>用户名为：username

</c:if>

使用 jstl 标签的<c:if>来判断传递过来的 username 是否为空，若是不为空将 username 展现到页面。当有多条件判断时可使用 <c:choose>更方便。

<h3></h3>标签c:choose

<c:choose>

<c:when test="${salary <= 0}">

   太惨了。

</c:when>

<c:when test="${salary > 1000}">

   不错的薪水，还能生活。

</c:when>

<c:otherwise>

   什么都没有。

</c:otherwise>

</c:choose>

上述代码根据 salary 值的大小来输出不一样的内容。

jstl 语法能够支持常见的功能，这里只是列举最经常使用的两个做为示例。

1.2.3 页面布局

通常网站的每一个页面都拥有相同的页眉和页脚，这两部份内容通常不多发生变更，这部份内容特别适合将它提取出来，让每一个页面来重复利用。

JSP 能够经过 include 指令来实现此效果，include 指令用于在编译阶段包括一个文件，这个指令告诉容器在编译阶段，把其余外部文件的内容合并到当前 JSP 文件中，可在 JSP 页面的任何位置使用 include 指令进行编码。

include 有两种用法：<%@ include file="relative url"%>和<jsp:include page="relative url" flush=”true”/>。前者是在翻译阶段执行，后者是在请求处理阶段执行；前者叫做静态包含，后者叫做动态包含，会在执行时检查包含内容变化。二者使用语法没有太大区别，下面举一个简单示例。

新建一个 footer.jsp 内容以下：

<!DOCTYPE html>

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<body>

   我是页尾

</body>

</html>

在 user.jsp 页面中引入 footer.jsp：

<h3></h3>布局

<%@include file="footer.jsp"%>

这样在访问 user.jsp 时，会将 footer.jsp 内容展现到 user.jsp 页面引入的位置。

上述代码都完成后，总体看一下页面的效果，启动项目在浏览器中输入网址：http://localhost:8080/user，页面展现效果以下：

1.3 调试和部署

1.3.1 在 IDEA 中运行

若是像其余项目同样，直接在 IDEA 中经过 main 方法来启动项目，在访问测试的时候会出现 404 not found。

这是由于 Spring Boot JSP 项目须要额外进行一个设置：选择 Edit Configurations 选项，打开 Run/Debug Configurations：

设置 Working directory 的路径为项目根路径：

而后重启项目就能够正常的访问到页面内了。

1.3.2 在单独的 Tomcat 中运行

（1）在 pom.xml 里设置打包格式为 war。

<packaging></packaging>war

（2）排除内嵌的 Tomcat 依赖

打包时排除掉内嵌的 Tomcat 依赖，避免 jar 包冲突。

<dependency>

<groupId></groupId>   org.springframework.boot

<artifactId></artifactId>   spring-boot-starter-web

<!-- 排除内置容器，排除内置容器导出成 war 包可让外部容器运行spring-boot项目-->

<exclusions>

<exclusion>

<groupId></groupId>           org.springframework.boot

<artifactId></artifactId>           spring-boot-starter-tomcat

</exclusion>

</exclusions>

</dependency>

（3）Servlet 的支持

Spring Boot 项目必须实现 SpringBootServletInitializer 接口的 configure() 方法才能让外部容器运行 Spring Boot 项目，启动类同目录下建立 ServletInitializer 类：

publicclass ServletInitializer extends SpringBootServletInitializer {

@Override

protected SpringApplicationBuilder configure(SpringApplicationBuilder application)    {

return       application.sources(JspApplication.class);

（4）打包发布，在项目根目录执行 maven 命令：

packagemvn clean

（5）将 war 包发布到 Tomcat 便可。

1.4 总结

经过本课的学习咱们掌握了如何在 Spring Boot 项目中集成 JSP，Spring Boot 支持使用内嵌的 Tomcat 来运行 JSP，也支持将项目打包成 War 包部署到独立的 Tomcat 中。实际项目中推荐使用单独的 Tomcat 来部署使用 JSP 的项目，内嵌的 Tomcat 还不是很稳定，偶尔会出现访问迟缓的现象。