利用spring ApplicationListener事件机制 输出项目成功启动信息

文章介绍了如何在Springboot项目启动成功后利用事件广播机制,即ApplicationReadyEvent事件,来实现自定义信息的输出,例如打印Swagger接口地址。通过创建一个自定义的ApplicationListener监听器并在主应用中添加该监听器,可以在项目启动完成后自动打印出Swagger的URL。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

目标

springboot项目成功启动后,我们有时想输出自定义信息,例如swagger地址。

实现原理

利用springboot的事件广播机制,springboot启动成功后EventPublishingRunListener 会发送一个ApplicationReadyEvent事件。我们可以实现一个自定义的ApplicationListener接收ApplicationReadyEvent事件。

自定义的ApplicationListener

public class ReadyApplicationListener implements ApplicationListener<ApplicationReadyEvent> {

    @SneakyThrows
    @Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
        ConfigurableApplicationContext application = event.getApplicationContext();
        log.info("项目启动成功!");
        Environment env = application.getEnvironment();
        log.info("项目地址 swagger 地址:	 http://{}:{}{}/swagger-ui.html", InetAddress.getLocalHost().getHostAddress(), env.getProperty("server.port"),env.getProperty("server.servlet.context-path")==null?"":env.getProperty("server.servlet.context-path"));

    }
}

在自已的Application加入自定义的ApplicationListener

@Slf4j
@SpringBootApplication
public class DemoApplication {

    @SneakyThrows
    public static void main(String[] args) {
        SpringApplication springApplication = new SpringApplication(DemoApplication.class);
        Set set = springApplication.getListeners();
        set.add(new ReadyApplicationListener()); //加入自定义的ApplicationListener
        springApplication.setListeners( set);
        springApplication.run(args);

  }
}

最后效果

//省略前面日志输出
02-01 13:36:06.515 [main] INFO  s.d.s.w.r.o.CachingOperationNameGenerator:40 - Generating unique operation named: saveUsingPOST_1
02-01 13:36:06.597 [main] INFO  s.d.s.w.r.o.CachingOperationNameGenerator:40 - Generating unique operation named: listUsingGET_1
02-01 13:36:06.634 [main] INFO  o.apache.coyote.http11.Http11NioProtocol:173 - Starting ProtocolHandler ["http-nio-8103"]
02-01 13:36:06.664 [main] INFO  o.s.b.w.embedded.tomcat.TomcatWebServer:203 - Tomcat started on port(s): 8103 (http) with context path '/demo'
02-01 13:36:06.667 [main] INFO  com.demo.DemoApplication:61 - Started DemoApplication in 6.888 seconds (JVM running for 7.452)
02-01 13:36:06.715 [main] INFO  com.demo.ReadyApplicationListener:25 - 项目启动成功!
02-01 13:36:06.717 [main] INFO  com.demo.ReadyApplicationListener:27 - 项目地址 swagger 地址:	 http://172.20.5.42:8103/demo/swagger-ui.html
### 解决Spring Boot应用启动时不显示端口的问题 当Spring Boot应用程序启动时,默认情况下会在控制台打印出嵌入式服务器(如Tomcat)绑定的HTTP端口号。然而,在某些配置下,可能不会自动显示该信息。以下是可能导致此现象的原因以及解决方案。 #### 原因分析 1. **日志级别设置不当** 如果`application.properties`或`application.yml`文件中的日志级别被调整为高于INFO,则可能会隐藏启动过程中关于端口的信息[^1]。 2. **自定义Banner覆盖默认输出** 当设置了自定义banner或者禁用了默认的日志消息时,端口信息可能无法正常显示。 3. **未启用Web支持** 若项目并未显式导入Spring Web模块,即使存在其他依赖项,也可能导致不加载默认的HTTP引擎(例如Tomcat),从而无端口可展示。 4. **安全机制影响** 配置了Spring Security的情况下,如果启用了随机密码功能并仅允许特定用户访问,“实际”的服务地址及其对应的端口信息可能被隐匿起来[^2]。 #### 实现方案 为了确保能够看到Spring Boot应用启动时所使用的具体端口号,可以采取以下措施: - **确认日志等级** 将根包下的logback-spring.xml或其他日志框架配置文件内的全局日志水平设回至INFO及以上即可恢复正常的提示语句;另外也可以单独针对org.springframework.boot.autoconfigure.web.ServerProperties类指定较低级别的记录行为以便观察更多细节变化情况。 - **强制暴露端口数据** 修改配置文件加入如下参数来保证每次运行都会报告监听位置: ```properties management.server.port=8081 # 可选设定管理接口专用端口 server.port=8080 # 显式声明业务处理单元的工作端口 logging.level.org.springframework.boot.autoconfigure=DEBUG ``` - **利用事件监听器捕获动态变更** 创建一个实现ApplicationListener<WebServerInitializedEvent>接口的新组件用于实时获取当前实例化的web容器最终选定的实际数值并通过标准输出流告知开发者们。 ```java import org.springframework.beans.factory.annotation.Value; import org.springframework.boot.context.event.WebServerInitializedEvent; import org.springframework.context.ApplicationListener; public class PortLogger implements ApplicationListener<WebServerInitializedEvent> { @Value("${server.port}") private int port; public void onApplicationEvent(WebServerInitializedEvent event){ System.out.println("The service has started successfully at http://localhost:" + this.port); } } ``` 上述方法均有助于解决Spring Boot应用未能清晰表明其工作端口这一常见疑问点。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值