SpringBoot入门

最新推荐文章于 2024-03-21 20:32:31 发布

callmexinshou

最新推荐文章于 2024-03-21 20:32:31 发布

阅读量550

点赞数

本文链接：https://blog.csdn.net/callmexinshou/article/details/125948171

版权

1.什么是SpringBoot

SpringBoot是一种框架，可以帮你简化spring（这里需要注意，简化的是spring的搭建，而Mybatis等内容的搭建仍需要手动操作）的搭建，并且快速创建一个spring的应用程序。该框架使用了特定的方式来进行配置，从而使开发人员不再需要定义样板化的配置

2.SpringBoot的特点

（1）可以创建独立的Spring应用程序，并且基于其Maven或Gradle插件，可以创建可执行的JARs和WARs；
（2）内嵌Tomcat或Jetty等Servlet容器；
（3）提供自动配置的“starter”项目对象模型（POMS）以简化Maven配置；
（4）尽可能自动配置Spring容器；
（5）提供准备好的特性，如指标、健康检查和外部化配置；
（6）绝对没有代码生成，不需要XML配置

3.使用SpringBoot创建工程

3.1搭建要求

JDK1.8及以上
Spring的jar包要求5.0以上
maven仓库的版本要求3.3及以上

3.2 开始搭建

1.新建Spring项目

2.选择依赖，并点击finish完成项目创建

3. 创建完成后的项目目录

4.修改SpringBoot版本（使用稍微低一些的版本，可以减少一些些bug）

4.SpringBoot中的一些配置文件

【1】pom.xml

<parent>标签，代表着SpringBoot父级，如果一个maven项目想成为SpringBoot项目，就需要继承父级SpringBoot依赖

该依赖是web的启动依赖把spring中常见的jar都集成到该依赖中,集成了springmvc的启动配置类

【2】properties文件与yml文件

这两种文件都是springBoot的配置文件，二者单独使用的情况下没有什么区别，只是语法格式上有些不同，但是当二者同时存在时，相同的配置内容，properties文件的优先级更高，不同的地方二者共存。

但是不论是哪种配置文件，其文件名都必须是application

分别来看一下两种文件的语法格式：

properties文件：

yml文件

当二者同时存在时，该项目的端口号为8081

【3】profiles文件

profiles文件也是配置文件，可以理解为，profiles文件是properties文件的子配置文件

profiles文件存在的意义在于，不同的开发阶段使用不同的配置文件，只需要在properties文件中指定使用哪一阶段的配置文件即可

在properties文件中通过该配置激活对应配置，只需要指定后缀名即可

5.SpringBoot注册web三大组件

web三大组件为Servlet、Filter、Linstener（监听器）

注册三大组件的原因在于集成第三方框架

注册Servlet，首先就需要一个Servlet类（注意需要继承HttpServlet类）

public class MyServlet extends HttpServlet {
    @Override
    public void init() throws ServletException {
        System.out.println("自定义servlet");
    }
}

第二新建一个配置类，配置Servlet，配置类需要使用@Configuration注解表名该类为配置类

@Configuration
public class MyConfig{
    @Bean
    public ServletRegistrationBean<Servlet> registrationBean(){
        ServletRegistrationBean<Servlet> servletServletRegistrationBean = new ServletRegistrationBean<>();
        servletServletRegistrationBean.setName("my");
        servletServletRegistrationBean.setServlet(new MyServlet());
        servletServletRegistrationBean.addUrlMappings("/my");
        return servletServletRegistrationBean;
    }
}

此时一自定义的Servlet就注册完成了

注册Filter与之同理

6.SpringBoot自动装配的原理

何为自动装配：顾名思义就是运行所需要的一些配置无需手动加载，由springboot自动完成，就是自动装配。

举个例子：

我们之前在使用SSM时，需要在配置文件中手动加载DispatcherServlet.但是我们在使用springboot之后并没有手动去加载该类

，就是因为springboot帮我们进行了自动装配。那么springboot是如何实现自动装配的？

我们从启动类点击进入@SpringBootApplication的源码

进入@SpringBootApplication源码后可以看到有一个@EnableAutoConfiguration注解

再次进入@EnableAutoConfiguration源码，可以看到@Import注解，该注解就是开启帮我们实现自动装配的注解

进入AutoConfigurationImportSelector类我们可以看到此方法，该方法就实现了自动装配

7.SpringBoot整合数据源

数据源，顾名思义就是数据源头，springboot整合数据源说白了就是链接数据库

我是用的是mysql数据库，因此需要引入mysql依赖和jdbc连接池依赖

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

我们以前使用ssm时实在spring配置文件中配置的数据库链接信息，并手动编写了JDBC连接池

在SpringBoot中我们只需要在properties文件中配置数据源信息即可直接使用连接池

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=Asia/Shanghai
spring.datasource.username=你的mysql用户名
spring.datasource.password=mysql的密码

该配置所使用的连接池是springboot默认的连接池，也可以使用第三方的连接池（例如：druid）

引入druid依赖

<dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.2.8</version>
        </dependency>

编写配置文件

spring.datasource.druid.url=jdbc:mysql://localhost:3306/mybaties?serverTimezone=Asia/Shanghai
spring.datasource.druid.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.druid.username=你的mysql用户名
spring.datasource.druid.password=mysql的密码
#初始化的个数
spring.datasource.druid.initial-size=5
# 最大活跃数
spring.datasource.druid.max-active=10
# 最大等待时间
spring.datasource.druid.max-wait=3000
# 最小的闲置个数
spring.datasource.druid.min-idle=5

8.springboot整合Mybatis

引入mybatis依赖

<dependency>
   <groupId>org.mybatis.spring.boot</groupId>
   <artifactId>mybatis-spring-boot-starter</artifactId>
   <version>2.2.2</version>
</dependency>

我们之前在使用mybatis时，需要指定映射路径，在springboot同样需要指定映射文件路径，在application.properties文件中添加如下配置

#指定映射文件的路径
mybatis.mapper-locations=classpath:mapper/*.xml

并且需要指定springboot扫描的包

在主启动类上添加@MapperScan(basePackages = "com.zjw.controller")注解，指定扫描的包

测试

@Autowired
    private UserMapper userMapper;
    @Test
    public void test02(){
        PageHelper.startPage(1,2);
        List<User> all = userMapper.findAll();
        PageInfo<User> pageInfo = new PageInfo<>(all);
        System.out.println(pageInfo.getList());
    }

9.springboot整合PageHelper分页插件

引入分页依赖

 <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper-spring-boot-starter</artifactId>
            <version>1.4.2</version>
        </dependency>

测试

@Autowired
    private UserMapper userMapper;
    @Test
    public void test02(){
        PageHelper.startPage(1,2);
        List<User> all = userMapper.findAll();
        PageInfo<User> pageInfo = new PageInfo<>(all);
        System.out.println(pageInfo.getList());
    }

10.springboot整合swagger2API文档生成器

Swagger2是一款用于前后端分离交流的API接口文档

【1】引入swagger2依赖

<dependency>
            <groupId>com.spring4all</groupId>
            <artifactId>swagger-spring-boot-starter</artifactId>
            <version>1.9.1.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>swagger-bootstrap-ui</artifactId>
            <version>1.7.8</version>
        </dependency>

【2】创建swagger配置类（该配置类虽然可以和Servlet以及Filter的配置类放在一起，但是不建议这样做，有利于降低代码的耦合度）

@Configuration
public class SwaggerConfig {
    //swagger中所有的功能都封装再Docket类中。
    @Bean
    public Docket docket(){
        Docket docket = new Docket(DocumentationType.SWAGGER_2)
                //设置api文档信息
                .apiInfo(apiInfo())
                .select()
                //指定为那个包生成api文档
                .apis(RequestHandlerSelectors.basePackage("com.zjw.controller"))
                .build();
        return docket;
    }
    //定义自己接口文档信息
    private ApiInfo apiInfo(){
        Contact DEFAULT_CONTACT = new Contact("张嘉伟", "http://www.4399.com", "1515529665@qq.com");
        ApiInfo apiInfo = new ApiInfo("用户增删改查功能接口文档", "小趴菜的第一个api文档", "V2.0", "http://www.7k7k.com",
                DEFAULT_CONTACT, "张嘉伟小组", "https://blog.csdn.net/callmexinshou?spm=1011.2266.3001.5343", new ArrayList<VendorExtension>());
        return  apiInfo;
    }
}

【3】使用swagger注解

常用注解介绍：

@Api 接口类的注解---接口类上 tag属性
@ApiOperation 接口方法的注解---接口方法上 value:
@ApiImplicitParams( 接口参数的说明
{
ApiImplicitParam() //单个参数的说明
}
)

@ApiModel---- 实体类接口注解
@ApiModelProperty---->实体类属性的说明

具体使用

@RestController
@Api(tags = "User控制层")
public class UserController {

    @Autowired
    private UserMapper userMapper;
    /*查询所有*/
    @GetMapping("/getAll")
    //@ApiOperation是具体接口的描述注解
    @ApiOperation(value = "获取所有用户信息接口",notes = "可以获取所有用户接口信息，返回一组数据")
    public CommonResult getAll(){
        PageHelper.startPage(1,2);
        List<User> userList = userMapper.findAll();
        userList.stream().forEach(System.out::println);
        if(userList.size()<0){
            return new CommonResult(5000,"查询失败",null);
        }
        PageInfo<User> userPageInfo = new PageInfo<>(userList);
        return new CommonResult(2000,"查询成功",userPageInfo);
    }
    /*根据id查询用户*/
    @GetMapping("/getById")
    @ApiOperation(value = "根据传入的用户id查询用户信息",notes = "可以更具用户id获取用户信息")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "id",value = "需要查询的用户的id",required = true)
    })
    public CommonResult getById(Integer id){
        User user = userMapper.findById(id);
        if (user==null){
            return new CommonResult(5000,"查询失败",null);
        }
        return new CommonResult(2000,"查询成功",user);
    }

    /*根据id删除用户*/
    @PostMapping("/deleteByid")
    @ApiOperation(value = "根据传入的用户id删除用户信息",notes = "根据用户id删除用户信息")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "id",value = "需要删除的用户的id",required = true)
    })
    public CommonResult deleteById(Integer id){
        int i = userMapper.deleteById(id);
        if (i<0){
            return new CommonResult(5000,"删除失败",null);
        }
        return new CommonResult(2000,"删除成功",i);
    }
    /*添加用户*/
    @PostMapping("/insert")
    @ApiOperation(value = "根据所传入的用户信息，新增一条用户信息记录",notes = "根据传入的用户信息，新增一条用户信息记录")
    public CommonResult insert(@RequestBody User user){
        int insert = userMapper.insert(user);
        if (insert<0){
            return new CommonResult(5000,"添加失败",null);
        }
        return new CommonResult(2000,"添加成功",insert);
    }

    /*根据用户id修改用户信息*/
    @PostMapping("/update")
    @ApiOperation(value = "根据所传入的用户信息，更新用户信息记录",notes = "根据传入的新的用户信息更新用户现有信息")
    public CommonResult update(@RequestBody User user){
        int update = userMapper.update(user);
        if (update<0){
            return new CommonResult(5000,"修改失败",null);
        }
        return new CommonResult(2000,"修改成功",update);
    }
}

【4】访问，有两种访问方式，访问的是两种不同的页面

1.通过路径+swagger-ui.html访问