阅读 93

零基础学SpringBoot(一)--初识SpringBoot

这是我参与更文挑战的第1天,活动详情查看: 更文挑战

1. SpringBoot简介

SpringBoot 是Spring家族中的一个全新的框架,它用来简化Spring应用程序的创建和开发过程,也可以说Spring Boot能简化我们之前采用SSM(SpringMVC + Spring + MyBatis)框架进行开发的过程。

以前我们采用SSM框架进行开发的时候,搭建和整合三大框架,我们需要做很多工作,例如配置web.xml,配置Spring,配置MyBatis,并将它们整合在一起等,而Spring Boot框架对此开发过程进行了革命性的颠覆,完全抛弃了繁琐的xml配置过程,采用大量的默认配置简化开发过程。

所以采用Spring Boot可以非常容易和快速地创建基于Spring框架的应用程序,它让编码变得简单了,部署变简单了,监控变简单了。

2. SpringBoot的特性

  • 能够快速创建基于Spring的应程序
  • 能够直接使用Java main方法启动内嵌的Tomcat服务器运行Spring Boot程序,不需要部署war包文件
  • 提供约定的starter POM来简化Maven配置, 让Maven的配置变得简单
  • 自动化配置,根据项目的Maven依赖配置,SpringBoot 自动配置Spring、SpringMVC等
  • 提供了程序的健康检查等功能
  • 基本可以不使用XML配置文件,采用注解配置

3. 我的第一个SpringBoot项目

3.1 创建一个Project, 选择类型为 Spring Initializr 快速构建

image-20210611150216727.png

3.2 选择Spring Boot版本及依赖,创建Spring Web工程

image-20210611150447422.png

3.3 点击Finish,如果是第一次创建,在右下角会提示正在下载相关依赖,项目创建完毕:

image-20210615141441361.png

3.4 项目目录结构以及说明

image-20210615141551851.png

  • main.java.com.xxx: 存放Java代码
  • main.resources
    • static: 存放静态资源,如图片、CSS、JavaScript等
    • templates: 存放Web页面的模版文件
    • application.properties/application.yml:用于存放程序的各种依赖模块的配置信息,比如服务端口、数据库连接配置等
3.4.1 对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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <!--继承 SpringBoot 框架的一个父项目,所有自己开发的 Spring Boot 都必须的继承-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.1</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <!--当前项目的 GAV 坐标-->
    <groupId>com.mufeng</groupId>
    <artifactId>springboot-001</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <!--maven 项目名称,可以删除-->
    <name>springboot-001</name>
    <!--maven 项目描述,可以删除-->
    <description>Demo project for Spring Boot</description>

    <!--maven 属性配置,可以在其它地方通过${}方式进行引用-->
    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>

        <!--SpringBoot 框架 web 项目起步依赖,通过该依赖自动关联其它依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!--SpringBoot 框架的测试起步依赖,例如:junit 测试,如果不需要的话可以删除-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!--SpringBoot 提供的打包编译等插件-->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

复制代码
3.4.2 项目结构说明
  • .mvn|mvnw|mvnw.cmd:使用脚本操作执行Maven相关命令

  • .gitignore:使用版本控制工具 git 的时候,设置一些忽略提交的内容

  • static|templates:页面模板存放文件的目录

  • application.properties:SpringBoot 的配置文件,很多集成的配置都可以在该文件中

    进行配置,例如:Spring、springMVC、Mybatis、Redis 等。

  • Application.java:SpringBoot 程序执行的入口,执行该程序中的 main 方法,SpringBoot

    就启动了

3.5 创建一个Spring MVC 的Spring Boot Controller

创建SpringBootController.java

package com.mufeng.springboot;

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

@Controller
public class SpringBootController {

    @RequestMapping(value = "/springBoot/index")
    @ResponseBody
    public String index(){
        return "Hello World!";
    }

}
复制代码

注意:先创建的类一定要位于Application同级目录或下级目录,否则SpringBoot加载不到

3.6 运行Application类

image-20210615143553155.png

或者在Application类中右键,运行main方法。

通过在控制台的输出,可以看到启动SpringBoot框架,会启动一个内嵌的tomcat,端口号默认为8080,上下文根为空:

image-20210615143858120.png

3.7 在浏览器输入 http://localhost:8080/springBoot/index 访问,显示以下内容,说明配置成功了

image-20210615144010800.png

3.8 项目分析

  • spring-boot-starter-parent是一个SpringBoot的父级依赖,开发SpringBoot程序需要继承该父级项目,它用来提供相关的Maven默认依赖

  • 要知道Spring Boot提供了哪些默认jar包的依赖,可查看该父级依赖的pom文件

  • 如果不想使用某个默认的依赖版本,可以通过 pom.xml 文件的属性配置覆盖各个

    依赖项,比如覆盖 Spring 版本

    <properties>
        <spring-framework.version>5.0.0.RELEASE</ spring-framework.version >
    </properties>
    复制代码
  • @SpringBootApplication 注解是SpringBoot项目的核心注解,主要作用是开启Spring自动配置,如果在Application类上去掉该注解,那么不会启动SpringBoot程序

  • main方法作为项目启动运行的入口

  • @Controller 以及 @ResponseBody依然是之前的SpringMVC,SpringBoot的里面依然是使用的SSM等框架

3.9 Spring Boot 的核心配置文件

3.9.1 核心配置格式
1. .properties文件(默认采用该文件)

通过修改application.properties配置文件,在修改默认tomcat端口号以及项目上下文根

键值对的properties属性文件配置方式

# 设置内嵌Tomcat端口号
server.port=8888

# 配置项目上下文根
server.servlet.context-path=/app
复制代码

配置成功后重新启动

image-20210615150216504.png

更改页面访问路径,重新访问

image-20210615150333871.png

2. .yml文件格式

yml是一种yaml格式的配置文件,主要采用一定的空格、换行等格式排版进行配置。

yaml是一种直观的能够被计算机识别的数据序列化格式,容易被人阅读,yaml类似于xml,但是语法比xml简介很多,值与前面的冒号配置必须要有一个空格,yml后缀也可以使用yaml后缀

# 设置内嵌Tomcat端口号
server:
  port: 8888
  servlet:
    # 设置上下文根
    context-path: /app
复制代码

注意:当两种格式配置文件同时存在,使用的是.properties配置文件,为了演示yml,可以将其改名,并重新运行Application查看端口和上下文根

image-20210615151148945.png

3.9.2 多环境配置

在实际开发中,项目会经历很多的阶段(开发-测试-上线),每个阶段的配置也会不同,例如端口、上下文根、数据库等,那么这个时候为了方便在不同的环境之间切换,SpringBoot提供了多环境配置

1. 为每个环境创建一个配置文件命名必须以application-环境标识.properties|yml

image-20210615152257415.png

application-dev.properties

# 开发环境

# 设置内嵌Tomcat端口号
server.port=8081

# 配置项目上下文根
server.servlet.context-path=/dev
复制代码

application-test.properties

# 测试环境

# 设置内嵌Tomcat端口号
server.port=8082

# 配置项目上下文根
server.servlet.context-path=/test
复制代码

application-product.properties

# 生产环境

# 设置内嵌Tomcat端口号
server.port=8888

# 配置项目上下文根
server.servlet.context-path=/product
复制代码

在总配置文件 application.properties 进行环境的激活

#SpringBoot 的总配置文件#激活开发环境
spring.profiles.active=dev
#激活测试环境
#spring.profiles.active=test
#激活生产环境
#spring.profiles.active=product
复制代码

等号右边的值和配置文件的环境标识名一致,可以更改总配置文件的配置,重新运行 Application,查看启动的端口及上下文根

yml格式也是同样的写法

3.9.3 SpringBoot 自定义配置读取

在 SpringBoot 的核心配置文件中,除了使用内置的配置项之外,我们还可以在自定义配置,然后采用如下注解去读取配置的属性值

1. @Value注解

此注解用于逐个读取application.properties中的配置

  • 在核心配置文件application.properties中,添加两个自定义配置项user.name和user.url。在IDEA中可以看到这两个属性不能被SpringBoot识别
# 设置内嵌Tomcat端口号
server.port=8081
# 配置项目上下文根
server.servlet.context-path=/dev

user.nickName=MuFeng
user.url=www.baidu.com
复制代码
  • 在SpringBootController中定义属性,并使用@Value注解获得自定义配置值,并测试
package com.mufeng.springboot;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controllerpublic 
class SpringBootController {   
    @Value("${user.nickName}")    
    private String userName;    
    
    @Value("${user.url}")   
    private String userUrl;   
    
    @RequestMapping(value = "/springBoot/index")    
    @ResponseBody    
    public String index() {        
        return "userName= " + userName + "-------userUrl= " + userUrl; 
    }
}
复制代码

重新运行Application,在浏览器中进行测试

image-20210615154445407.png

2. @ConfigurationProperties

将整个文件映射成一个对象,用于自定义配置项比较多的情况

  • 创建UserInfo类,并未该类加上Component和ConfigurationProperties注解,并在ConfigurationProperties注解中添加属性prefix,作用可以区分同名配置
package com.mufeng.springboot;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "user")
public class UserInfo {    
    private String nickName;    
    
    private String url;    
    
    public String getNickName() {        
        return nickName;    
    }    
    
    public void setNickName(String nickName) {  
        this.nickName = nickName;  
    }   
    
    public String getUrl() {      
        return url;  
    }   
    
    public void setUrl(String url) {   
        this.url = url;   
    }
    
}
复制代码
  • 在SpringBootController中注入UserInfo配置类
    @Autowired    
    private UserInfo userInfo;
复制代码
  • 修改SpringBootController类中的测试方法
  @RequestMapping(value = "/springBoot/index") 
  @ResponseBody    
  public String index() {   
      return "userName= " + userInfo.getNickName() + "-------userUrl= " + userInfo.getUrl();  
  }
复制代码
  • 重新运行Application,在浏览器中进行测试

image-20210615155509067.png

3.10 SpringBoot 前端使用JSP

3.10.1 在pom.xml文件配置以下依赖项
        <!--引入 Spring Boot 内嵌的 Tomcat 对 JSP 的解析包,不加解析不了 jsp 页面-->  
        <!--如果只是使用 JSP 页面,可以只添加该依赖-->        
        <dependency>           
            <groupId>org.apache.tomcat.embed</groupId>  
            <artifactId>tomcat-embed-jasper</artifactId>  
        </dependency>
复制代码
3.10.2 在pom.xml的build标签中要配置以下信息

SpringBoot 要求 jsp 文件必须编译到指定的 META-INF/resources 目录下才能访问,否则访问不到。其实官方已经更建议使用模板技术

        <!--SpringBoot 要求 jsp 文件必须编译到指定的 META-INF/resources 目录下才能访问,否则访问不到。其它官方已经建议使用模版技术-->       
        <resources>           
            <resource>               
                <!--源文件位置-->              
                <directory>src/main/webapp</directory>     
                <!--指定编译到 META-INF/resources,该目录不能随便写-->   
                <targetPath>META-INF/resources</targetPath>            
                <!--指定要把哪些文件编译进去,**表示 webapp 目录及子目录,*.*表示所有文件-->   
                <includes>                   
                    <include>**/*.*</include>     
                </includes>           
            </resource>          
        
            <resource>              
                <directory>src/main/resources</directory>  
                <includes>                  
                    <include>**/*.*</include>    
                </includes>           
            </resource>        
        </resources>
复制代码
3.10.3 在application.properties文件配置SpringMVC的视图展示为jsp,这里相当于SpringMVC的配置
# 配置SpringMVC视图解析器
# 其中: /表示目录为src/main/webapp

spring.mvc.view.prefix=/
spring.mvc.view.suffix=.jsp
复制代码
3.10.4 创建JspController类并编写代码
package com.mufeng.springboot;

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

@Controllerpublic 
class JspController {   
    @RequestMapping(value = "/springBoot/jsp") 
    public String jsp(Model model){  
        model.addAttribute("data", "SpringBoot 使用JSP页面");    
        return "index";  
    }
}
复制代码
3.10.5 在src/main 下创建一个webapp目录,然后在该目录下新建index.jsp页面
<%--  Created by IntelliJ IDEA. 
User: a  
Date: 2021/6/15  Time: 4:23 下午  
To change this template use File | Settings | File Templates.--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>   
        <title>Title</title>
    </head>
    <body>
    </body>
</html>
复制代码
3.10.6 在jsp页面中获取Controller传递过来的数据
<%--  Created by IntelliJ IDEA.  User: a  Date: 2021/6/15  Time: 4:23 下午  To change this template use File | Settings | File Templates.--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>  
        <title>Title</title>
    </head>
    <body>  
        ${data}
    </body>
</html>
复制代码
3.10.7 重新运行Application,通过浏览器访问

image-20210615163754472.png

文章分类
后端
文章标签