Class NetServer
- java.lang.Object
-
- io.vertx.rxjava3.core.net.NetServer
-
-
Field Summary
Fields Modifier and Type Field Description static io.vertx.lang.rx.TypeArg<NetServer>
__TYPE_ARG
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description int
actualPort()
The actual port the server is listening on.Completable
close()
Close the server.NetServer
connectHandler(Handler<NetSocket> handler)
Supply a connect handler for this server.boolean
equals(Object o)
NetServer
getDelegate()
int
hashCode()
boolean
isMetricsEnabled()
Whether the metrics are enabled for this measured objectSingle<NetServer>
listen()
Start listening on the port and host as configured in theNetServerOptions
used when creating the server.Single<NetServer>
listen(int port)
Start listening on the specified port and host "0.0.0.0", ignoring port and host configured in theNetServerOptions
used when creating the server.Single<NetServer>
listen(int port, String host)
Start listening on the specified port and host, ignoring port and host configured in theNetServerOptions
used when creating the server.Single<NetServer>
listen(SocketAddress localAddress)
Start listening on the specified local address, ignoring port and host configured in theNetServerOptions
used when creating the server.static NetServer
newInstance(NetServer arg)
Completable
rxClose()
Close the server.Single<NetServer>
rxListen()
Start listening on the port and host as configured in theNetServerOptions
used when creating the server.Single<NetServer>
rxListen(int port)
Start listening on the specified port and host "0.0.0.0", ignoring port and host configured in theNetServerOptions
used when creating the server.Single<NetServer>
rxListen(int port, String host)
Start listening on the specified port and host, ignoring port and host configured in theNetServerOptions
used when creating the server.Single<NetServer>
rxListen(SocketAddress localAddress)
Start listening on the specified local address, ignoring port and host configured in theNetServerOptions
used when creating the server.Completable
rxShutdown()
Shutdown with a 30 seconds timeout (shutdown(30, TimeUnit.SECONDS)
).Completable
rxShutdown(long timeout, TimeUnit unit)
Initiate the server shutdown sequence.Single<Boolean>
rxUpdateSSLOptions(ServerSSLOptions options)
Update the server with new SSLoptions
, the update happens if the options object is valid and different from the existing options object.Single<Boolean>
rxUpdateSSLOptions(ServerSSLOptions options, boolean force)
Update the server with new SSLoptions
, the update happens if the options object is valid and different from the existing options object.Completable
shutdown()
Shutdown with a 30 seconds timeout (shutdown(30, TimeUnit.SECONDS)
).Completable
shutdown(long timeout, TimeUnit unit)
Initiate the server shutdown sequence.String
toString()
Single<Boolean>
updateSSLOptions(ServerSSLOptions options)
Update the server with new SSLoptions
, the update happens if the options object is valid and different from the existing options object.Single<Boolean>
updateSSLOptions(ServerSSLOptions options, boolean force)
Update the server with new SSLoptions
, the update happens if the options object is valid and different from the existing options object.void
updateTrafficShapingOptions(TrafficShapingOptions options)
Update traffic shaping optionsoptions
, the update happens if valid values are passed for traffic shaping options.
-
-
-
Field Detail
-
__TYPE_ARG
public static final io.vertx.lang.rx.TypeArg<NetServer> __TYPE_ARG
-
-
Method Detail
-
getDelegate
public NetServer getDelegate()
- Specified by:
getDelegate
in interfaceMeasured
-
isMetricsEnabled
public boolean isMetricsEnabled()
Whether the metrics are enabled for this measured object- Specified by:
isMetricsEnabled
in interfaceMeasured
- Returns:
true
if metrics are enabled
-
connectHandler
public NetServer connectHandler(Handler<NetSocket> handler)
Supply a connect handler for this server. The server can only have at most one connect handler at any one time. As the server accepts TCP or SSL connections it creates an instance ofNetSocket
and passes it to the connect handler.- Parameters:
handler
-- Returns:
- a reference to this, so the API can be used fluently
-
listen
public Single<NetServer> listen()
Start listening on the port and host as configured in theNetServerOptions
used when creating the server.The server may not be listening until some time after the call to listen has returned.
- Returns:
- a future completed with the listen operation result
-
rxListen
public Single<NetServer> rxListen()
Start listening on the port and host as configured in theNetServerOptions
used when creating the server.The server may not be listening until some time after the call to listen has returned.
- Returns:
- a future completed with the listen operation result
-
listen
public Single<NetServer> listen(int port, String host)
Start listening on the specified port and host, ignoring port and host configured in theNetServerOptions
used when creating the server.Port
0
can be specified meaning "choose an random port".Host
0.0.0.0
can be specified meaning "listen on all available interfaces".The server may not be listening until some time after the call to listen has returned.
- Parameters:
port
-host
-- Returns:
- a future completed with the listen operation result
-
rxListen
public Single<NetServer> rxListen(int port, String host)
Start listening on the specified port and host, ignoring port and host configured in theNetServerOptions
used when creating the server.Port
0
can be specified meaning "choose an random port".Host
0.0.0.0
can be specified meaning "listen on all available interfaces".The server may not be listening until some time after the call to listen has returned.
- Parameters:
port
-host
-- Returns:
- a future completed with the listen operation result
-
listen
public Single<NetServer> listen(int port)
Start listening on the specified port and host "0.0.0.0", ignoring port and host configured in theNetServerOptions
used when creating the server.Port
0
can be specified meaning "choose an random port".The server may not be listening until some time after the call to listen has returned.
- Parameters:
port
-- Returns:
- a future completed with the listen operation result
-
rxListen
public Single<NetServer> rxListen(int port)
Start listening on the specified port and host "0.0.0.0", ignoring port and host configured in theNetServerOptions
used when creating the server.Port
0
can be specified meaning "choose an random port".The server may not be listening until some time after the call to listen has returned.
- Parameters:
port
-- Returns:
- a future completed with the listen operation result
-
listen
public Single<NetServer> listen(SocketAddress localAddress)
Start listening on the specified local address, ignoring port and host configured in theNetServerOptions
used when creating the server.The server may not be listening until some time after the call to listen has returned.
- Parameters:
localAddress
- the local address to listen on- Returns:
- a future completed with the listen operation result
-
rxListen
public Single<NetServer> rxListen(SocketAddress localAddress)
Start listening on the specified local address, ignoring port and host configured in theNetServerOptions
used when creating the server.The server may not be listening until some time after the call to listen has returned.
- Parameters:
localAddress
- the local address to listen on- Returns:
- a future completed with the listen operation result
-
close
public Completable close()
Close the server. This will close any currently open connections. The close may not complete until after this method has returned.- Returns:
- a future completed with the listen operation result
-
rxClose
public Completable rxClose()
Close the server. This will close any currently open connections. The close may not complete until after this method has returned.- Returns:
- a future completed with the listen operation result
-
shutdown
public Completable shutdown()
Shutdown with a 30 seconds timeout (shutdown(30, TimeUnit.SECONDS)
).- Returns:
- a future completed when shutdown has completed
-
rxShutdown
public Completable rxShutdown()
Shutdown with a 30 seconds timeout (shutdown(30, TimeUnit.SECONDS)
).- Returns:
- a future completed when shutdown has completed
-
shutdown
public Completable shutdown(long timeout, TimeUnit unit)
Initiate the server shutdown sequence.Connections are taken out of service and notified the close sequence has started through
NetSocket.shutdownHandler(io.vertx.core.Handler<java.lang.Void>)
. When all connections are closed the client is closed. When thetimeout
expires, all unclosed connections are immediately closed.- Parameters:
timeout
- the amount of time after which all resources are forcibly closedunit
- the of the timeout- Returns:
- a future notified when the client is closed
-
rxShutdown
public Completable rxShutdown(long timeout, TimeUnit unit)
Initiate the server shutdown sequence.Connections are taken out of service and notified the close sequence has started through
NetSocket.shutdownHandler(io.vertx.core.Handler<java.lang.Void>)
. When all connections are closed the client is closed. When thetimeout
expires, all unclosed connections are immediately closed.- Parameters:
timeout
- the amount of time after which all resources are forcibly closedunit
- the of the timeout- Returns:
- a future notified when the client is closed
-
actualPort
public int actualPort()
The actual port the server is listening on. This is useful if you bound the server specifying 0 as port number signifying an ephemeral port- Returns:
- the actual port the server is listening on.
-
updateSSLOptions
public Single<Boolean> updateSSLOptions(ServerSSLOptions options)
Update the server with new SSL
options
, the update happens if the options object is valid and different from the existing options object.The boolean succeeded future result indicates whether the update occurred.
- Parameters:
options
- the new SSL options- Returns:
- a future signaling the update success
-
rxUpdateSSLOptions
public Single<Boolean> rxUpdateSSLOptions(ServerSSLOptions options)
Update the server with new SSL
options
, the update happens if the options object is valid and different from the existing options object.The boolean succeeded future result indicates whether the update occurred.
- Parameters:
options
- the new SSL options- Returns:
- a future signaling the update success
-
updateSSLOptions
public Single<Boolean> updateSSLOptions(ServerSSLOptions options, boolean force)
Update the server with new SSL
options
, the update happens if the options object is valid and different from the existing options object.The
options
object is compared using itsequals
method against the existing options to prevent an update when the objects are equals since loading options can be costly, this can happen for share TCP servers. When object are equals, settingforce
totrue
forces the update.The boolean succeeded future result indicates whether the update occurred.
- Parameters:
options
- the new SSL optionsforce
- force the update when options are equals- Returns:
- a future signaling the update success
-
rxUpdateSSLOptions
public Single<Boolean> rxUpdateSSLOptions(ServerSSLOptions options, boolean force)
Update the server with new SSL
options
, the update happens if the options object is valid and different from the existing options object.The
options
object is compared using itsequals
method against the existing options to prevent an update when the objects are equals since loading options can be costly, this can happen for share TCP servers. When object are equals, settingforce
totrue
forces the update.The boolean succeeded future result indicates whether the update occurred.
- Parameters:
options
- the new SSL optionsforce
- force the update when options are equals- Returns:
- a future signaling the update success
-
updateTrafficShapingOptions
public void updateTrafficShapingOptions(TrafficShapingOptions options)
Update traffic shaping optionsoptions
, the update happens if valid values are passed for traffic shaping options. This update happens synchronously and at best effort for rate update to take effect immediately.- Parameters:
options
- the new traffic shaping options
-
-