Class JettyWebServer
java.lang.Object
org.springframework.boot.web.embedded.jetty.JettyWebServer
- All Implemented Interfaces:
WebServer
WebServer
that can be used to control a Jetty web server.- Since:
- 2.0.0
- See Also:
-
Constructor Summary
ConstructorDescriptionJettyWebServer
(org.eclipse.jetty.server.Server server) Create a newJettyWebServer
instance.JettyWebServer
(org.eclipse.jetty.server.Server server, boolean autoStart) Create a newJettyWebServer
instance. -
Method Summary
Modifier and TypeMethodDescriptionvoid
destroy()
Destroys the web server such that it cannot be started again.int
getPort()
Return the port this server is listening on.org.eclipse.jetty.server.Server
Returns access to the underlying Jetty Server.void
shutDownGracefully
(GracefulShutdownCallback callback) Initiates a graceful shutdown of the Jetty web server.void
start()
Starts the web server.void
stop()
Stops the web server.
-
Constructor Details
-
JettyWebServer
public JettyWebServer(org.eclipse.jetty.server.Server server) Create a newJettyWebServer
instance.- Parameters:
server
- the underlying Jetty server
-
JettyWebServer
public JettyWebServer(org.eclipse.jetty.server.Server server, boolean autoStart) Create a newJettyWebServer
instance.- Parameters:
server
- the underlying Jetty serverautoStart
- if auto-starting the server
-
-
Method Details
-
start
Description copied from interface:WebServer
Starts the web server. Calling this method on an already started server has no effect.- Specified by:
start
in interfaceWebServer
- Throws:
WebServerException
- if the server cannot be started
-
stop
public void stop()Description copied from interface:WebServer
Stops the web server. Calling this method on an already stopped server has no effect. -
destroy
public void destroy()Description copied from interface:WebServer
Destroys the web server such that it cannot be started again. -
getPort
public int getPort()Description copied from interface:WebServer
Return the port this server is listening on. -
shutDownGracefully
Initiates a graceful shutdown of the Jetty web server. Handling of new requests is prevented and the givencallback
is invoked at the end of the attempt. The attempt can be explicitly ended by invokingstop()
.Once shutdown has been initiated Jetty will reject any new connections. Requests on existing connections will be accepted, however, a
Connection: close
header will be returned in the response.- Specified by:
shutDownGracefully
in interfaceWebServer
- Parameters:
callback
- the callback to invoke when the graceful shutdown completes
-
getServer
public org.eclipse.jetty.server.Server getServer()Returns access to the underlying Jetty Server.- Returns:
- the Jetty server
-