构建第一个 Spring Boot 工程

时间:2021-03-28 16:27:57

Spring Boot概述

什么是Spring Boot

随着动态语言的流行,java的开发显得格外笨重,繁多的配置文件编写,低下的开发效率,复杂的部署流程以及第三方技术集成难度大。

在上述环境下Spring Boot应运而生,Spring Boot设计的目的是用来简化Spring应用的搭建开发调试部署等一系列问题,我们在使用Spring开发应用的时候能够明显感到配置的繁杂,Spring Boot充分利用了JavaConfig的配置模式以及"约定优于配置"的理念,能够极大的简化基于Spring MVC的Web应用和REST服务开发,更简单快捷地构建Spring应用。

Spring Boot的核心特点

  • 可以以jar包的形式独立运行,运行一个SpringBoot项目只需要通过java -jar xx.jar来运行。
  • 内置Servlet容器,Spring Boot可以选择Tomcat,Jetty,这样我们无需以war包的形式部署项目
  • 简化Maven配置,Spring Boot提供了一系列的starter pom来简化Maven的依赖加载。
  • Spring Boot会根据在类路径中的jar包,类,为jar包中的类自动配置bean.这样就极大的减少我们要使用的配置。
  • Spring Boot提供了基于http,ssh,telnet对运行时的项目进行监控。
  • 不借助于代码生成来实现,而是通过条件注解来实现。这也是Spring 4.x的新特性。不需要任何的xml配置就可以实现Spring的所有配置。  

Spring Boot项目搭建

通过 Spring Boot创建新的Spring应用变得非常容易,只需要简单的几个步骤就可以创建出一个应用。

创建项目的时候使用Spring Initializr(IDEA),创建完成的的项目结构如下

- src
-main
-java
-package
#启动类
-SpringbootApplication
-resouces
#存放静态资源如 js/css/images 等
- statics
#存放 html 模板文件
- templates
#主要的配置文件,SpringBoot启动时候会自动加载application.yml/application.properties
- application.yml
#测试文件存放目录
-test
# pom.xml文件是Maven构建的基础,里面包含了我们所依赖JAR和Plugin的信息
- pom.xml

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
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion> <name>spring-boot-web</name>
<description>Demo project for Spring Boot</description> <parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.1.RELEASE</version>
<relativePath/>
</parent> <groupId>com.winner</groupId>
<artifactId>spring-boot-web</artifactId>
<version>1.0</version>
<packaging>jar</packaging> <properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties> <dependencies>
<!--默认内嵌Tomcat容器,可以根据需要进行替换-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency> <dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!--用来进行热部署的插件-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<optional>true</optional>
</dependency> </dependencies> <build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<fork>true</fork>
</configuration>
</plugin>
</plugins>
</build> </project>

主函数入口

一个项目中切记不要出现多个main函数,否则在打包的时候spring-boot-maven-plugin将找不到主函数!

package com.winner;

import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.Bean; import java.util.Arrays; /**
* 主函数启动类
* @author winner_0715
* @date 2018/11/28
*/
@SpringBootApplication
public class Application { public static void main(String[] args) {
System.out.println(" springApplication run !");
SpringApplication.run(Application.class, args);
} @Bean
public CommandLineRunner commandLineRunner(ApplicationContext ctx) {
return args -> {
System.out.println("SpringBoot默认为我们提供的Bean:");
String[] beanNames = ctx.getBeanDefinitionNames();
Arrays.sort(beanNames);
Arrays.stream(beanNames).forEach(System.out::println);
};
}
}

编写我们的Controller

package com.winner.web;

import com.winner.domain.User;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController; /**
* @author winner_0715
* @description HelloController
* @date 2018/11/28
*/
@RestController
public class HelloController { @RequestMapping("/hello/string")
public String helloString(){
return "hello world";
} /**
* 因为使用了@RestController
* 所以不需要加@ResponseBody注解
* @RestController=@Controller+@ResponseBody
* @return
*/
@RequestMapping("/hello/model")
public User helloModel(){
return new User.Builder()
.userName("name")
.email("email")
.build();
}
}

直接运行启动类,或者可以通过"mvn spring-boot:run"在命令行启动该应用。会启动一个内嵌的 Tomcat 服务器运行在 8080 端口。访问http://localhost:8080可以看到页面上显示"Hello World!"。

此外,在 POM 文件添加插件。

<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>

在添加了插件后,当运行"mvn clean package"进行打包时,会打包成一个可以直接运行的jar包,使用"java -jar"命令就可以直接运行。

认识Spring Boot主配置文件

application.properties

从启动日志中可以发现,SpringBoot默认的端口是8080,如果端口被占用我们可以通过修改配置文件来解决!

Tomcat started on port(s): 8080 (http) with context path ''

修改默认的配置(还带提示的,很给力,配置了热部署的话修改配置文件就会重启生效)

构建第一个 Spring Boot 工程

# 修改默认的端口8080
server.port=8888
# 定义上下文路径
server.servlet.context-path=/spring-boot-web

看下此时控制台的输出

Tomcat started on port(s): 8888 (http) with context path '/spring-boot-web'

这样的话访问就需要带上项目名了!

相关知识

Spring Boot的spring-boot-starter

Spring Boot提供了很多"开箱即用"的依赖模块,这些模块都是按照spring-boot-starter-{xx}的方式命名的。下面列举一些常用的模块。

  • spring-boot-starter-logging :使用Spring Boot默认的日志框架logback。
  • spring-boot-starter-log4j :添加 log4j 的支持。
  • spring-boot-starter-web :支持 Web 应用开发,包含 Tomcat 和 spring-mvc。
  • spring-boot-starter-tomcat :使用 Spring Boot 默认的 Tomcat 作为应用服务器。
  • spring-boot-starter-jetty :使用 Jetty作为应用服务器。
  • spring-boot-starter-test :包含常用的测试所需的依赖,如 JUnit、Hamcrest、Mockito 和 spring-test 等。
  • spring-boot-starter-aop :包含 spring-aop 和 AspectJ 来支持面向切面编程(AOP)。
  • spring-boot-starter-security :包含 spring-security。
  • spring-boot-starter-jdbc :支持使用 JDBC 访问数据库。
  • spring-boot-starter-redis :支持使用 Redis。
  • spring-boot-starter-data-mongodb :包含 spring-data-mongodb 来支持 MongoDB。
  • spring-boot-starter-data-jpa :包含 spring-data-jpa、spring-orm 和 Hibernate 来支持 JPA。
  • spring-boot-starter-amqp :通过 spring-rabbit 支持 AMQP。
  • spring-boot-starter-actuator : 添加适用于生产环境的功能,如性能指标和监测等功能。

Java Config 自动配置

Spring Boot推荐采用基于Java Config(也就是注解)的配置方式,而不是传统的XML。例如,@Configuration、@Bean、@EnableAutoConfiguration、@CompomentScan、@PropertySource、@Repository、@Service、@RestController等。