启动方式

方式1:在main方法中执行SpringApplication.run()这种方式来启动我们的工程

// 方式一
@SpringBootApplication
public class Application { public static void main(String[] args) {
SpringApplication.run(Application.class, args);
} }

方式二:SpringApplication.run()的底层其实就是new了一个SpringApplication的对象

// 方式二
public static void main(String[] args) {
SpringApplication app = new SpringApplication(MySpringConfiguration.class);
app.run(args);
}

方式三:SpringApplicationBuilder

// 方式三
public static void main(String[] args) {
new SpringApplicationBuilder()
.sources(Parent.class)
.child(Application.class)
.run(args);
}

有时我们需要创建多层次的ApplicationContext (例如,父子关系的Spring的ApplicationContext 和SpringMVC),这时我们可以使用官方提供的另外一种“平滑”的API调用方式来启动工程,即使用SpringApplicationBuilder讲多个方法调用串起来,通过parent() 和 child()来创建多层次的ApplicationContext。如果查看底层代码,可以看到除了调用child()方法略有不同,其他的和前两种方法几乎一样。

启动失败

如果你的应用程序启动失败,注册的FailureAnalyzers将有机会提供专用的错误消息和解决问题的具体操作。例如,如果你在端口8080上启动web应用程序,并且该端口已经在使用,你应该会看到类似于以下消息的内容:

***************************
APPLICATION FAILED TO START
*************************** Description: Embedded servlet container failed to start. Port 8080 was already in use. Action: Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.

Spring Boot提供了大量的FailureAnalyzer实现,你也可以添加自己的。

如果没有故障分析器能够处理的异常,你仍然可以显示完整的情况报告,以便更好地理解错误,要做到这一点,你需要为org.springframework.boot.autoconfigure.logging.ConditionEvaluationReportLoggingListener启用debug属性启用DEBUG日志记录

例如,如果你正在使用java -jar运行你的应用程序,你可以使启用debug属性如下:

$ java -jar myproject-0.0.1-SNAPSHOT.jar --debug

23.2 自定义横幅

在启动时打印的横幅可以通过添加banner.txt文件到你的类路径或设置spring.banner.location属性指向该文件的位置。如果文件的编码不是UTF-8,那么可以设置spring.banner.charset。除了一个文本文件,你还可以添加一个banner.gifbanner.jpgbanner.png图像文件到你的类路径或设置spring.banner.image.location属性。图像被转换成ASCII艺术表示,并打印在任何文本标题之上。

在你的banner.txt文件,你可以使用以下任何一个占位符:

表23.1. Banner变量

变量 描述
${application.version} MANIFEST.MF中声明的应用程序的版本号,例如,Implementation-Version:1.0被打印为1.0
${application.formatted-version} 应用程序的版本号,如在MANIFEST.MF中声明并格式化以供显示(包含了括号和前缀v),例如(v1.0)
${spring-boot.version} 你正在使用的Spring Boot版本,例如2.0.5.RELEASE
${spring-boot.formatted-version} 你正在使用的Spring Boot版本,格式化用于显示(用括号括起来,并以v为前缀),例如(v2.0.5.RELEASE)
${Ansi.NAME}${AnsiColor.NAME} NAME是ANSI转义代码的名称,有关详细信息,请参阅AnsiPropertySource
${application.title} 你的应用程序的标题,如声明的那样,在MANIFEST.MF中,例如,Implementation-Title:MyApp被打印为MyApp

如果你想以编程的方式生成横幅,则可以使用SpringApplication.setBanner(…)方法,使用org.springframework.boot.Banner接口和实现你自己的printBanner()方法。

示例:

           // 启动颜色格式化
// 这不是唯一启动颜色格式的方式,有兴趣的同学可以查看源码
/**
* 1. AnsiOutput.setEnabled(AnsiOutput.Enabled.ALWAYS);
* 2. 在`src/main/resources`目录下新建文件`application.properties`,
* 内容为:`spring.output.ansi.enabled=always`
*
* 重要:如果配置第二种方式,第一种方式就不会起作用
*/
AnsiOutput.setEnabled(AnsiOutput.Enabled.ALWAYS);
new SpringApplicationBuilder(ConfigServer.class)//
.main(SpringVersion.class) // 这个是为了可以加载 Spring 版本
.bannerMode(org.springframework.boot.Banner.Mode.CONSOLE)// 控制台打印
.run(args);

resources目录,增加一个banner.txt文件

你也可以用spring.main.banner-mode属性确定横幅是否必须打印在系统上System.out(console),发送到已配置的日志记录器(log),或根本没有生成(off)。

在以下名称中,打印的横幅被注册为一个单例bean:springBootBanner

YAML映射offfalse,所以如果你想要禁用应用程序中的banner,请确保添加引号,如下例所示:

spring:
main:
banner-mode: "off"

23.3 定制SpringApplication

如果SpringApplication的默认值不符合你的喜好,你可以创建一个本地实例并自定义它,例如,要关闭横幅,你可以写:

public static void main(String[] args) {
SpringApplication app = new
SpringApplication(MySpringConfiguration.class);
app.setBannerMode(Banner.Mode.OFF);
app.run(args);
}

传递给SpringApplication的构造函数参数是Spring bean的配置源,在大多数情况下,这些都是对@Configuration类的引用,但是它们也可以是对XML配置的引用,或者对应该被扫描的包的引用。

还可以使用application.properties配置SpringApplication,详见第24节,外部化配置

有关配置选项的完整列表,请参见SpringApplication Javadoc

23.4 Fluent构建器API

如果你需要构建ApplicationContext层次结构(包含parentchild关系的多个上下文),或者你更喜欢使用“fluent”构建器API,那么你可以使用SpringApplicationBuilder

SpringApplicationBuilder允许你将多个方法调用链接在一起,并包含让你创建层次结构的父类和子方法,如下例所示:

new SpringApplicationBuilder()
.sources(Parent.class)
.child(Application.class)
.bannerMode(Banner.Mode.OFF)
.run(args);

在创建ApplicationContext层次结构时,有一些限制,例如,Web组件必须包含在子上下文内,并且在父类和子上下文环境中都使用相同的Environment,请参阅SpringApplicationBuilder Javadoc了解详细信息。

23.5 应用程序事件和监听

除了通常的Spring框架事件,比如ContextRefreshedEvent之外,SpringApplication还会发送一些附加的应用程序事件。

在创建ApplicationContext之前,实际上触发了一些事件,因此不能将侦听器注册为@Bean。你可以使用SpringApplication.addListeners(...) 方法或SpringApplicationBuilder.listeners(...)方法注册它们。如果你希望这些监听器自动注册,不管应用程序是如何创建的,你都可以添加一个META-INF/spring.factories文件到你的项目,并通过使用org.springframework.context.ApplicationListener key来引用你的监听器,如下例所示:

org.springframework.context.ApplicationListener=com.example.project.MyListener

应用程序事件按以下顺序发送:

  1. 一个ApplicationStartingEvent是在运行开始时发送的,但是在任何处理之前,除了侦听器和初始化器的注册之外。
  2. 在创建上下文之前,当Environment在上下文中被使用时,就会发送一个ApplicationEnvironmentPreparedEvent
  3. 一个ApplicationPreparedEvent是在刷新开始之前发送的,但是在加载了bean定义之后。
  4. 在调用上下文之后发送一个ApplicationStartedEvent,但是在调用任何应用程序和命令行运行程序之前。
  5. 在调用任何应用程序和命令行运行程序后,将发送一个ApplicationReadyEvent,它表明应用程序已经准备好服务请求。
  6. 如果启动时出现异常,则发送ApplicationFailedEvent

你通常不需要使用应用程序事件,但是知道它们的存在是很方便的。在内部,Spring Boot使用事件来处理各种任务。

使用Spring Framework的事件发布机制发送应用程序事件,该机制的一部分确保在子环境中发布给侦听器的事件也会在任何祖先上下文中被发布给监听器。因此,如果你的应用程序使用了SpringApplication实例的层次结构,那么侦听器可能会接收到相同类型的应用程序事件的多个实例。

为了让你的侦听器区分事件的上下文和派生上下文的事件,它应该请求将其应用程序上下文注入,然后将注入的上下文与事件上下文进行比较,可以通过实现ApplicationContextAware或如果侦听器是bean,通过使用@Autowired来注入上下文。

23.6 Web环境

SpringApplication试图为你创建合适的ApplicationContext类型,用于确定WebEnvironmentType的算法相当简单:

  • 如果Spring MVC存在,则使用AnnotationConfigServletWebServerApplicationContext
  • 如果Spring MVC不存在,Spring WebFlux是存在的,那么就使用一个AnnotationConfigReactiveWebServerApplicationContext
  • 否则,AnnotationConfigApplicationContext被使用。

这意味着如果你使用Spring MVC和来自Spring WebFlux的新WebClient在相同的应用程序中,Spring MVC将在默认情况下使用,你可以通过调用setWebApplicationType(WebApplicationType)来轻松覆盖它。

还可以调用setApplicationContextClass(…)完全控制所使用的ApplicationContext类型。

在JUnit测试中使用SpringApplication时,通常需要调用setWebApplicationType(WebApplicationType.NONE)

23.7 访问应用程序参数

如果你需要访问传递给SpringApplication.run(…)的应用程序参数,你可以注入一个org.springframework.boot.ApplicationArguments bean,ApplicationArguments接口提供了对原始String[]参数以及解析optionnon-option参数的访问,如下例所示:

import org.springframework.boot.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.stereotype.*; @Component
public class MyBean { @Autowired
public MyBean(ApplicationArguments args) {
boolean debug = args.containsOption("debug");
List<String> files = args.getNonOptionArgs();
// if run with "--debug logfile.txt" debug=true, files=["logfile.txt"]
}
}

Spring Boot还会在Spring Environment中注册一个CommandLinePropertySource,这允许你使用@Value注解注入单个应用程序参数。

23.8 使用ApplicationRunner或CommandLineRunner

如果你需要在SpringApplication启动之后运行一些特定的代码,你可以实现ApplicationRunnerCommandLineRunner接口,两个接口都以相同的方式工作,并提供了一个单独的run方法,在SpringApplication.run(…)完成之前调用。

CommandLineRunner接口提供对应用程序参数的访问作为一个简单的字符串数组,而ApplicationRunner使用前面讨论的ApplicationArguments接口。下面的示例展示了一个使用run方法的CommandLineRunner:

import org.springframework.boot.*;
import org.springframework.stereotype.*; @Component
public class MyBean implements CommandLineRunner { public void run(String... args) {
// Do something...
} }

如果定义了多个CommandLineRunnerApplicationRunner bean,必须以特定的顺序调用它们,那么你可以额外地实现org.springframework.core.Ordered接口或使用org.springframework.core.annotation.Order注解。

23.9 应用程序退出

每个SpringApplication都向JVM注册一个关闭hook以确保ApplicationContext在退出时优雅地关闭。可以使用所有标准的Spring生命周期回调函数(如DisposableBean接口或@PreDestroy注解)。

此外,当SpringApplication.exit()被调用时如果希望返回特定的退出代码则bean可以实现org.springframework.boot.ExitCodeGenerator接口。然后可以将此退出代码传递给System.exit(),以将其作为状态代码返回,如下面的示例所示:

@SpringBootApplication
public class ExitCodeApplication { @Bean
public ExitCodeGenerator exitCodeGenerator() {
return () -> 42;
} public static void main(String[] args) {
System.exit(SpringApplication
.exit(SpringApplication.run(ExitCodeApplication.class, args)));
} }

此外,ExitCodeGenerator接口也可以由异常来实现,当遇到这样的异常时,Spring Boot返回由实现的getExitCode()方法提供的退出代码。

23.10 管理功能

通过指定spring.application.admin.enabled属性可以为应用程序启用与admin相关的特性,这将在平台MBeanServer上公开SpringApplicationAdminMXBean,你可以使用该特性远程管理你的Spring Boot应用程序,这个特性还可以用于任何服务wrapper实现。

如果你想知道应用程序正在运行哪个HTTP端口,请使用local.server.port的键获取该属性。

在启用该特性时要注意,因为MBean公开了关闭应用程序的方法。

 

SpringApplication常见用法说明的更多相关文章

  1. Linux中find常见用法

    Linux中find常见用法示例 ·find   path   -option   [   -print ]   [ -exec   -ok   command ]   {} \; find命令的参数 ...

  2. php中的curl使用入门教程和常见用法实例

    摘要: [目录] php中的curl使用入门教程和常见用法实例 一.curl的优势 二.curl的简单使用步骤 三.错误处理 四.获取curl请求的具体信息 五.使用curl发送post请求 六.文件 ...

  3. Guava中Predicate的常见用法

    Guava中Predicate的常见用法 1.  Predicate基本用法 guava提供了许多利用Functions和Predicates来操作Collections的工具,一般在 Iterabl ...

  4. find常见用法

    Linux中find常见用法示例 ·find   path   -option   [   -print ]   [ -exec   -ok   command ]   {} \; find命令的参数 ...

  5. iOS 开发多线程篇—GCD的常见用法

    iOS开发多线程篇—GCD的常见用法 一.延迟执行 1.介绍 iOS常见的延时执行有2种方式 (1)调用NSObject的方法 [self performSelector:@selector(run) ...

  6. iOS开发多线程篇—GCD的常见用法

    iOS开发多线程篇—GCD的常见用法 一.延迟执行 1.介绍 iOS常见的延时执行有2种方式 (1)调用NSObject的方法 [self performSelector:@selector(run) ...

  7. [转]EasyUI——常见用法总结

    原文链接: EasyUI——常见用法总结 1. 使用 data-options 来初始化属性. data-options是jQuery Easyui 最近两个版本才加上的一个特殊属性.通过这个属性,我 ...

  8. NSString常见用法总结

    //====================NSStirng 的常见用法==================== -(void)testString { //创建格式化字符串:占位符(由一个%加一个字 ...

  9. [转]Linux中find常见用法示例

    Linux中find常见用法示例[转]·find   path   -option   [   -print ]   [ -exec   -ok   command ]   {} \;find命令的参 ...

随机推荐

  1. 二、NodeJS入门——准备工作(2)——MongoDB安装以及客户端Robomongo安装和使用

    目录     1.介绍     2.下载地址     3.MongoDB安装过程     4.MongoDB的使用     5.MongoDB添加管理员账户     6.RoboMongo安装过程   ...

  2. rabbitmq 延迟队列

    1.rabbitmq 延时的原理,有2个队列,一个是发送消息,设置消息过期时间或者队列过期时间(死信队列),如果达到过期时间后 将改消息发送到指定的队列中进行处理. 链接:https://share. ...

  3. EHLIB 安装方法

    Ehlib安装方法  路人甲 2010-05-05 23:01:37 安装文件自带的Readme.txt中的安装过程如下: 1. Delphi 5.x - 7.x, Delphi 9.X Win32, ...

  4. JavaScript 究竟是怎样执行的?

    摘要: 理解 JS 引擎运行原理. 作者:前端小智 原文:搞懂 JavaScript 引擎运行原理 Fundebug经授权转载,版权归原作者所有. 一些名词 JS 引擎 - 一个读取代码并运行的引擎, ...

  5. selenium控制超链接在当前标签页中打开或重新打开一个标签页

    selenium控制超链接在当前标签页中打开或重新打开一个标签页 在web页面源码中,控制超链接的打开是在当前标签页还是重新打开一个标签页,是由属性target=“_black”进行控制的.如果还有属 ...

  6. kali2.0升级

    1.登录kali2.0系统 2 2.修改软件源APT-sources.list vim /etc/apt/sources.list 3 可以删除该文件中的所有内容,也可以直接在文前添加新的APT源. ...

  7. JVM Code Cache空间不足,导致服务性能变慢

    本文阅读时间大约5分钟. 有业务反馈,线上一个应用运行了一段时间之后,在高峰期之后,突然发现处理能力下降,接口的响应时间变长,但是看Cat上的GC数据,一切都很正常. 通过跳板机上机器查看日志,发现一 ...

  8. 【爬虫】网页抓包工具--Fiddler--Request和Response

    [爬虫]网页抓包工具--Fiddler Fiddler基础知识 Fiddler是强大的抓包工具,它的原理是以web代理服务器的形式进行工作的,使用的代理地址是:127.0.0.1,端口默认为8888, ...

  9. mysql 常用 sql 语句 - 快速查询

    Mysql 常用 sql 语句 - 快速查询 1.mysql 基础 1.1 mysql 交互         1.1.1 mysql 连接             mysql.exe -hPup    ...

  10. 并发编程(二)--利用Process类开启进程、僵尸进程、孤儿进程、守护进程、互斥锁、队列与管道

    一.multiprocessing模块 1.multiprocessing模块用来开启子进程,并在子进程中执行我们定制的任务(比如函数),该模块与多线程模块threading的编程接口类似. 2.mu ...