初识Spring Boot框架

时间  2019-12-22
标签 spring boot 框架 栏目 Spring 繁體版
原文   原文链接

前面的铺垫文章已经连着写了六篇了，主要是介绍了Spring和SpringMVC框架，小伙伴们在学习的过程当中大概也发现了这两个框架须要咱们手动配置的地方很是多，不过作JavaEE开发的小伙伴们确定也据说过“约定大于配置”这样一句话，就是说系统，类库，框架应该假定合理的默认值，而非要求提供没必要要的配置，但是使用Spring或者SpringMVC的话依然有许多这样的东西须要咱们进行配置，这样不只徒增工做量并且在跨平台部署时容易出问题。OK，因为这些已经存在的问题，Spring Boot应运而生，使用Spring Boot可让咱们快速建立一个基于Spring的项目，而让这个Spring项目跑起来咱们只须要不多的配置就能够了。Spring Boot主要有以下核心功能：java

1.独立运行的Spring项目git

Spring Boot能够以jar包的形式来运行，运行一个Spring Boot项目咱们只须要经过java -jar xx.jar类运行。很是方便。github

2.内嵌Servlet容器web

Spring Boot能够内嵌Tomcat，这样咱们无需以war包的形式部署项目。spring

3.提供starter简化Maven配置浏览器

使用Spring或者SpringMVC咱们须要添加大量的依赖，而这些依赖不少都是固定的，这里Spring Boot 经过starter可以帮助咱们简化Maven配置。tomcat

4.自动配置Spring 
5.准生产的应用监控 
6.无代码生成和xml配置安全

OK，关于SpringBoot更详细的优缺点小伙伴们也能够自行搜索，我这里再也不罗列，咱们仍是来看看代码。app

项目建立

初次接触，咱们先来看看如何建立一个Spring Boot项目，这里以IntelliJ IDEA为例，其余的IDE工具小伙伴们自行搜索建立方式:框架

首先建立一个项目，建立时选择Spring Initializr，而后Next，以下图：

这里写图片描述

填写项目信息，以下图：

这里写图片描述

填写项目使用到的技术，上面的Spring Boot版本建议选择最新的稳定版，下面勾选上Web就能够了，以下图：

这里写图片描述

最后一步，填写工程名字点击finish：

这里写图片描述 
OK，第一次建立时系统会去下载须要的依赖等，耗时稍长，之后每次都会很快建立好。 
OK，项目建立成功以后接下来咱们来看看这个东西要怎么样去运行。首先咱们看到在项目建立成功以后，在项目的根目录下会有一个artifactId+Application命名规则的入口类，以下图: 
这里写图片描述,就是这个Test19SpringBoot2Application类，这是咱们整个项目的入口类，这个类有一个@SpringBootApplication注解，这是整个Spring Boot的核心注解，它的目的就是开启Spring Boot的自动配置。OK，那么我在这个类上再添加一个@RestController注解，使之变为一个Controller，而后里边提供一个地址转换方法，以下：

@RestController
@SpringBootApplication
public class Test19SpringBoot2Application {

    public static void main(String[] args) {
        SpringApplication.run(Test19SpringBoot2Application.class, args);
    }

    @RequestMapping(value = "/",produces = "text/plain;charset=UTF-8")
    String index(){
        return "Hello Spring Boot!";
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

而后点击项目启动按钮运行，在IntelliJ中就是这个按钮： 
这里写图片描述 
启动成功以后咱们就能够直接在浏览器中访问了，以下： 
这里写图片描述 
OK，至此，咱们一个简单的Spring Boot工程已经建立出来了，而且成功的从浏览器中访问到了，可是为何它最终会跑起来呢？想必小伙伴们还有许多疑问，咱们来分析下。

入口类和@SpringBootApplication注解

上文说过，咱们新建一个Project系统都会帮咱们建立一个名为artifactId+Application的入口类，这个类中有一个main方法，这个main方法就是一个标准的Java应用程序的入口方法。而这里的@SpringBootApplication则是一个组合注解，咱们能够看看它的源码：

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
    excludeFilters = {@Filter(
    type = FilterType.CUSTOM,
    classes = {TypeExcludeFilter.class}
)}
)
public @interface SpringBootApplication {

}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15

咱们能够看到它组合了@SpringBootConfiguration、@EnableAutoConfiguration以及@ComponentScan，咱们在开发的过程当中若是不使用@SpringBootApplication，则能够组合使用这三个注解。这三个注解中，@SpringBootConfiguration实际上就是咱们前面几篇博客提到的@Configuration注解，代表这个类是一个配置类，@EnableAutoConfiguration则表示让Spring Boot根据类路径中的jar包依赖为当前项目进行自动配置，最后一个@ComponentScan的做用我也不赘述了，惟一要注意的是若是咱们使用了@SpringBootApplication注解的话，系统会去入口类的同级包以及下级包中去扫描实体类，所以咱们建议入口类的位置在groupId+arctifactID组合的包名下。

关闭特定的自动配置

在上面一小节中咱们看到@ComponentScan注解是有一个过滤器的，若是咱们只想要@SpringBootApplication去扫描特定的类而不是所有类，那么就能够关闭自动配置，以下：

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
  • 1

定制Banner

修改Banner

咱们在启动Spring Boot项目的时候，在控制台会默认输出一个启动图案，以下： 
这里写图片描述 
固然，这个图案若是你须要的话是能够本身修改的，修改方式很简单：

1.在src/main/resources下新建一个banner.txt文档 
2.经过http://patorjk.com/software/taag网站生成须要的字符，将字符拷贝到步骤1所建立的txt文档中，好比我这里为Hello Sang！生成字符，以下：

这里写图片描述 
点击左下角的选择和拷贝按钮，将这个字符拷贝到txt文档中，而后再启动项目，这个时候控制台输出的文本就会自动改变，以下： 
这里写图片描述

关闭Banner

能够修改固然也能够关闭，关闭Banner须要咱们稍微修改一下main方法中的代码，以下：

public static void main(String[] args) {
        SpringApplicationBuilder builder = new SpringApplicationBuilder(Test19SpringBoot2Application.class);
        //修改Banner的模式为OFF
        builder.bannerMode(Banner.Mode.OFF).run(args);
    }
  • 1
  • 2
  • 3
  • 4
  • 5

OK，如此修改以后当咱们再次启动Project的时候就看不到Banner了。

Spring Boot的配置文件

Spring Boot使用一个全局的配置文件application.properties或者application.yml，配置文件放在src/main/resources目录下。properties是咱们常见的一种配置文件，Spring Boot不只支持properties这种类型的配置文件，也支持yaml语言的配置文件，我这里以properties类型的配置文件为例来看几个案例。

1.修改Tomcat默认端口和默认访问路径

Tomcat默认端口是8080，我将之改成8081，默认访问路径是http://localhost:8080，我将之改成http://localhost:8081/helloboot,咱们来看看这两个需求要怎么样经过简单的配置来实现。 
很简单，在application.properties文件中添加以下代码：

server.context-path=/helloboot
server.port=8081
  • 1
  • 2

而后再启动Project，在浏览器中就得这样来访问了： 
这里写图片描述

常规属性配置

在前面的博客( Spring经常使用配置 )中咱们介绍了如何在使用Spring容器框架下注入properties文件里的值。若是咱们使用了Spring Boot，这项工做将会变得更加简单，咱们只须要在application.properties中定义属性，而后在代码中直接使用@Value注入便可。 
以下：

book.author=罗贯中
book.name=三国演义
book.pinyin=sanguoyanyi
  • 1
  • 2
  • 3

我这里专门设置了中文，由于中文不作特殊处理会乱码，处理方式为继续在application.properties中添加以下代码：

server.tomcat.uri-encoding=UTF-8
spring.http.encoding.charset=UTF-8
spring.http.encoding.enabled=true
spring.http.encoding.force=true
spring.messages.encoding=UTF-8
  • 1
  • 2
  • 3
  • 4
  • 5

而后 在IntelliJ IDEA中依次点击File -> Settings -> Editor -> File Encodings 
将Properties Files (*.properties)下的Default encoding for properties files设置为UTF-8，将Transparent native-to-ascii conversion前的勾选上。（参考【Springboot 之 解决IDEA读取properties配置文件的中文乱码问题】【Springboot 之 解决IDEA读取properties配置文件的中文乱码问题】）。 
而后在变量中经过@Value直接注入就好了，以下：

@Value(value = "${book.author}")
    private String bookAuthor;
    @Value("${book.name}")
    private String bookName;
    @Value("${book.pinyin}")
    private String bookPinYin;
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

修改index方法，使之返回这些值：

@RequestMapping(value = "/",produces = "text/plain;charset=UTF-8")
    String index(){
        return "Hello Spring Boot! The BookName is "+bookName+";and Book Author is "+bookAuthor+";and Book PinYin is "+bookPinYin;
    }
  • 1
  • 2
  • 3
  • 4

而后在浏览器中访问，结果以下： 
这里写图片描述

很简单吧。

类型安全的配置

刚刚说的这种方式咱们在实际项目中使用的时候工做量略大，由于每一个项目要注入的变量的值太多了，这种时候咱们可使用基于类型安全的配置方式，就是将properties属性和一个Bean关联在一块儿，这样使用起来会更加方便。我么来看看这种方式怎么实现。

1.在src/main/resources文件夹下建立文件book.properties

文件内容以下：

book.name=红楼梦
book.author=曹雪芹
book.price=28
  • 1
  • 2
  • 3

2.建立Book Bean,并注入properties文件中的值

代码以下：

@Component
@ConfigurationProperties(prefix = "book",locations = "classpath:book.properties")
public class BookBean {
    private String name;
    private String author;
    private String price;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getAuthor() {
        return author;
    }

    public void setAuthor(String author) {
        this.author = author;
    }

    public String getPrice() {
        return price;
    }

    public void setPrice(String price) {
        this.price = price;
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31

prefix是指前缀，location指定要注入文件的位置。

3.添加路径映射

在Controller中添加以下代码注入Bean：

@Autowired
    private BookBean bookBean;
  • 1
  • 2

添加路径映射：

@RequestMapping("/book")
    public String book() {
        return "Hello Spring Boot! The BookName is "+bookBean.getName()+";and Book Author is "+bookBean.getAuthor()+";and Book price is "+bookBean.getPrice();
    }
  • 1
  • 2
  • 3
  • 4

运行效果以下： 

日志配置

默认状况下Spring Boot使用Logback做为日志框架，也就是咱们前面几篇博客中用到的打印日志方式，固然若是有须要咱们能够手动配置日志级别以及日志输出位置，相比于咱们在Spring容器中写的日志输出代码，这里的配置简直就是小儿科了，只须要在application.properties中添加以下代码：

logging.file=/home/sang/workspace/log.log
logging.level.org.springframework.web=debug
  • 1
  • 2

上面表示配置日志输出位置，下面配置日志级别。

Profile配置问题

在 Spring经常使用配置 这篇文章中，咱们已经介绍了Profile的做用，已经如何在Spring框架下使用Profile，可是当时小伙伴们看到了仍是稍微有点麻烦，在Spring Boot 中系统提供了更为简洁的方式。全局Profile配置咱们使用application-{profile}.properties来定义，而后在application.properties中经过spring.profiles.active来指定使用哪一个Profile。OK，那么接下来咱们来看一个简单的案例。

1.在src/main/resources文件夹下定义不一样环境下的Profile配置文件，文件名分别为application-prod.properties和application-dev.properties，这两个前者表示生产环境下的配置，后者表示开发环境下的配置，以下：

这里写图片描述

application-prod.properties:

server.port=8081
  • 1

application-dev.properties:

server.port=8080
  • 1

而后在application.properties中进行简单配置，以下：

spring.profiles.active=dev
  • 1

这个表示使用开发环境下的配置。而后运行项目，咱们得经过8080端口才能够访问： 
这里写图片描述 
若是想换为生产环境，只须要把spring.profiles.active=dev改成spring.profiles.active=prod便可，固然访问端口这是也变为8081了，以下： 
这里写图片描述

本案例下载地址： 
本项目GitHub地址

以上。

参考资料：  《JavaEE开发的颠覆者 Spring Boot实战》第五章、第六章

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程