6 The HTTP Server - 6.27 Server Events - 《Micronaut v2.2.3 Documentation》

6.27 Server Events

6.27 Server Events

The HTTP server will emit a number of Bean Events, defined in the io.micronaut.runtime.server.event package, that you can write listeners for. The following table summarizes those events:

Table 1. Server Events
Event	Description
ServerStartupEvent	Emitted when the server completes startup
ServerShutdownEvent	Emitted when the server shuts down
ServiceReadyEvent	Emitted after all ServerStartupEvent listeners have been executed and exposes the EmbeddedServerInstance
ServiceStoppedEvent	Emitted after all ServerShutdownEvent listeners have been executed and exposes the EmbeddedServerInstance

If you do significant work within a listener for a ServerStartupEvent this will slow down you startup time.

The following example defines a ApplicationEventListener that listens for ServerStartupEvent:

Listening for Server Startup Events

import io.micronaut.context.event.ApplicationEventListener;
...
@Singleton
public class StartupListener implements ApplicationEventListener<ServerStartupEvent> {
    @Override
    public void onApplicationEvent(ServerStartupEvent event) {
        // logic here
        ...
    }
}

Alternatively, you can also use the @EventListener annotation on a method of any existing bean that accepts ServerStartupEvent:

Using @EventListener with ServerStartupEvent

import io.micronaut.runtime.server.event.*;
import io.micronaut.runtime.event.annotation.*;
...
@Singleton
public class MyBean {
    @EventListener
    public void onStartup(ServerStartupEvent event) {
        // logic here
        ...
    }
}