SpringBoot入门学习记录（一）

2022-05-08 21:44:46

　　　　最近，SpringBoot、SpringCloud、Dubbo等框架非常流行，作为Coder里的一名小学生，借着改革开放的东风，自然也是需要学习学习的，于是将学习经历记录于此，以备日后查看。

　　官网：https://start.spring.io/

　　可以在官网直接下载demo项目导入到开发工具中，在官网下载只能选择JDK8和JDK11（似乎2.0以上已经不支持1.7了），如果从官网下载项目而本地环境JDK版本是1.7，需要指定prom.xml里的版本，也可自行构建maven项目，因为初次学习，此处自行新建maven项目配置SpringBoot框架。

项目目录如下：

一、目录结构

如上图所示，Spring Boot的基础结构共三个文件:

l src/main/java 程序开发以及主程序入口

l src/main/resources 模板、js、css、图片、配置等静态文件

l src/test/java 测试程序

而在src/main/java 目录，主要程序结构是

----------com.hyblogs

　　　　-----Application.java

　　　　-----controller

　　　　　　-----------HyBlogsController.java

　　　 ------mode

　　　　　 -----------User.java

　　　 ------service

　　　　　 -----------GetUserService.java

　　　------dao

　　　------utils

------constant

Application.java 程序作为入口，所在的位置是在controller、model、service包的同一级，同一级，同一级，重要的事情说三遍。

①、Application.java 墙裂建议放到根目录下面,主要用于做一些框架配置

②、model目录主要用于实体

③、service 层主要是业务类代码

④、controller 负责页面访问控制

⑤、dao用于数据访问

⑥、constant用于存放常量

⑦、utils用于存放常用工具

这个目录结构让我想起世界上最好的语言PHP，真的好像ThinkPHP里的路由，有木有？既然是maven构建的项目，自然少不了porm.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 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <!--   

        spring-boot-starter-parent是Spring Boot的核心启动器，

        包含了自动配置、日志和YAML等大量默认的配置，大大简化了我们的开发。

        引入之后相关的starter引入就不需要添加maven 里jar包的 version配置，

           spring boot会自动选择最合适的版本进行添加。

   -->

    <parent>

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

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

        <version>1.5.4.RELEASE</version>

        <relativePath/> <!-- lookup parent from repository -->

    </parent>

    <!--项目的基本描述信息-->

    <groupId>com.hyblogs</groupId>

    <artifactId>SpringBooT</artifactId>

    <version>0.0.1-SNAPSHOT</version>

    <name>SpringBoot_1</name>

    <description>Hyblogs Spring Boot 1</description>

    <!--指定当前的jdk版本和字符编码，开发、编译jdk版本要一致  -->

    <properties>

        <java.version>1.7</java.version>

        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    </properties>

    <dependencies>

        <!--Springboot核心，通过starter来启动 核心模块，包括自动配置支持、日志和YAML -->

        <dependency>

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

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

        </dependency>

        <!-- 添加测试模块 ，包括JUnit、Hamcrest、Mockito-->

        <dependency>

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

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

            <scope>test</scope>

        </dependency>

        <!--包含了Spring Boot预定义的一些Web开发的常用依赖包如: spring-webmvc,Tomcat等 -->

        <dependency>

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

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

         </dependency>

         <!-- 热部署，修改代码后不需要手动重启tomcat -->

        <dependency>

            <groupId>org.springframework</groupId>

            <artifactId>springloaded</artifactId>

            <version>1.2.7.RELEASE</version><!--$NO-MVN-MAN-VER$-->

        </dependency>

        <!-- 应用支持热部署，提高开发者的开发效率，无需手动重启Spring Boot应用 -->

        <dependency>

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

            <artifactId>spring-boot-devtools</artifactId>

            <version>1.5.4.RELEASE</version><!--$NO-MVN-MAN-VER$-->

            </dependency>

        </dependencies>

    <build>

        <plugins>

            <!--在Maven中提供Spring Boot支持，允许打包可执行jar或war和运行应用程序  -->

            <plugin>

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

                <artifactId>spring-boot-maven-plugin</artifactId>

            </plugin>

        </plugins>

    </build>

</project>

建议将maven的远程仓库改为阿里云，第一次下载jar包的速度会快很多，下载完jar包，新建目录，SpringBoot的基本结构就完成了。

二、入口程序Application.java

　　执行Application中的main()方法，启动SpringBoot程序。

　　@SpringBootApplication:表明这个是SpringBoot的入口文件，这是SpringBoot的启动程序。

　　@RunWith(SpringRunner.class) @RunWith是指定运行器，而（SpringRunner.class）是Spring的运行器，指定用Spring容器的方式来运行。

 package com.hyblogs;

 import org.junit.runner.RunWith;

 import org.springframework.boot.SpringApplication;

 import org.springframework.boot.autoconfigure.SpringBootApplication;

 import org.springframework.test.context.junit4.SpringRunner;

 @SpringBootApplication

 @RunWith(SpringRunner.class)

 public class Application {

     public static void main(String[] args) {

         SpringApplication.run(Application.class, args);

     }

 }

三、Controller层

　　在com.hyblogs.controller包下创建HyBlogsController.java

　　此处说一下这两个Controller的区别

　　@RestController:表明此控制器内的方法的返回值会以json格式显示，返回的内容就是return 里的内容

　　@Controller：表明此控制器的的返回值会映射一个页面，浏览器会转到return里的页面中。如果要返回json，不跳转到返回的页面中，需要在方法上添加@ResponseBody。

　　@RequestMapping()：指定请求的路径

 package com.hyblogs.controller;

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

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

 import com.hyblogs.model.User;

 @RestController

 public class HyBlogsController {

         @RequestMapping("/hello")

         public String index() {

             return "Hello World";

         }

         @RequestMapping("/hyblogs")

         public String  hi() {

             return "hyblogs 666";

         }     }

由于还没有编写jsp和html页面，就先使用@RestController来体验一把SpringBoot的威力，直接运行入口文件Application.java。

根本没有部署程序到Tomcat，Tomcat已经成功加载程序并运行了。在浏览器地址栏输入：http://127.0.0.1:8080/hello

结果出来的，真的方便，不用部署，不用配置xml,不用启动Tomcat，有了SpringBoot简直美滋滋。既然配置了@RestController控制器，自然也要体验一把json的效果。

在com.hyblogs.model包下新建一个User.java

 package com.hyblogs.model;

 public class User {

     private String userName;

     private String passWord;

     public String getUserName() {

         return userName;

     }

     public void setUserName(String userName) {

         this.userName = userName;

     }

     public String getPassWord() {

         return passWord;

     }

     public void setPassWord(String passWord) {

         this.passWord = passWord;

     }

 }

HyBlogsController.java中添加

 package com.hyblogs.controller;

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

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

 import com.hyblogs.model.User;

 @RestController

 public class HyBlogsController {

         @RequestMapping("/hello")

         public String index() {

             return "Hello World";

         }

         @RequestMapping("/hyblogs")

         public String  hi() {

             return "hyblogs 666";

         }

         @RequestMapping("/getUser")

         public User getUser() {

             User user=new User();

             user.setUserName("小明你还记得我吗");

             user.setPassWord("7890");

             return user;

         }

     }

将对象属性转为json数据，在保存的那一刻，控制台显示Tomcat自动restart。在地址栏输入：http://127.0.0.1:8080/getUser

SpringBoot配置JSP

　　体验了@RestController的效果，再来看看@Controller，使用@Controller返回一个jsp页面。在Spring MVC里面也可以很方便的将JSP与一个View关联起来，返回一个字符串，就能对应上jsp页面。但是SpringBoot官方不推荐使用JSP，推荐使用模板Thymeleaf，对jsp的使用不太友好，所以这一点拿出来单独纪录，坑有几个，踩上就是404，得花时间调试一会。先来分析一下SpringBoot的资源目录：

在resource目录中新建了config、static、templates三个文件。

　　config里存放的各种配置文件，注意：如果在config里有一个配置文件，在resource目录下也有一个配置文件，那么会以config下的为准，会覆盖掉外层的配置；

　　static里有css,js,images的目录，这无需多言，而HTML作为静态文件，也是放在这里的，通过地址栏可以直接访问到的；

　 templates 里主要放动态文件，Thymeleaf模板文件就在这里。

既然如此，就需要给jsp安排地方了，在resources同级目录，新建一个webapp目录，在webapp里新建一个WEB-INF目录，WEB-INF中建一个jsp目录，把jsp文件放在这里。

MyJsp.jsp

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

  <head>

    <title>My JSP </title>

  </head>

  <body>

    测试jsp的页面内容</br>

  <hr>

  不建议使用jsp

  </body>

</html>

现在创建一个Controller，并返回指向MyJsp.jsp的页面（使用@Controller注解，而非RestController注解，返回的地址写webapp地址的全路径）：

TestController.java

package com.hyblogs.controller;

import org.springframework.stereotype.Controller;

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

@Controller

public class TestController {

    @RequestMapping("/testControl")

    public String testControl(){

        System.out.println("!!!!!");

        return "/WEB-INF/jsp/MyJsp.jsp";

    }

}

运行发现出现404：

原因是还没配置jsp的支持，于是在pom.xml中添加jsp的jar包支持：

<dependency>

    <groupId>javax.servlet</groupId>

    <artifactId>javax.servlet-api</artifactId>

</dependency>

<dependency>

    <groupId>javax.servlet</groupId>

    <artifactId>jstl</artifactId>

</dependency>

<!-- tomcat的支持.-->

<dependency>

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

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

</dependency>

配置后，再次运行：

此时已经成功运行处jsp页面了，当然也可以使用配置文件，配置Controller返回的前缀和后缀，这样就可以省去每次写jsp路径和".jsp"。

打开src.main.resources.config中的application.properties

添加2行

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

spring.mvc.view.suffix=.jsp

prefix是前缀，后面跟webapp后的每一层目录，suffix是后缀，后面跟.jsp

配置完前缀和后缀，在Controller里返回就不用带上目录和文件后追了，直接返回文件名字的字符串就可以，改成如下：

package com.hyblogs.controller;

import org.springframework.stereotype.Controller;

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

@Controller

public class TestController {

    @RequestMapping("/testControl")

    public String testControl(){

        System.out.println("!!!!!");

        return "MyJsp";

    }

}

运行：

总结几点：

　　1、SpringBoot的目录按照MVC的思想进行分离，但需要注意Application.Java这个入口文件的位置。

　　2、如果需要返回JSP页面，①配置文件后面不能有空格、tab等字符，②路径要对应，③pom.xml里不能同时存在jsp和Thymeleaf，默认会在templates中找模板文件；

　 3、使用@Controller 注解，在对应的方法上，视图解析器可以解析return 的jsp,html页面，并且跳转到相应页面若返回json等内容到页面，则需要加@ResponseBody注解，而 @RestController相当于@Controller+@ResponseBody两个注解的结合，返回json数据不需要在方法前面加@ResponseBody注解了，但使用@RestController这个注解，就不能返回jsp,html页面，视图解析器无法解析jsp,html页面。

　 4、SpringBoot不推荐使用JSP，Thymeleaf模板确实是比JSP效率高，对前后端的分离做的更好，推荐使用。

Thymeleaf模板内容较多，且到下文分解---------------------------------------------------------------------------

码农公寓

一、目录结构

二、入口程序Application.java

三、Controller层

SpringBoot配置JSP

总结几点：

相关文章