/*
* Copyright 2014 Red Hat, Inc.
*
* Red Hat licenses this file to you under the Apache License, version 2.0
* (the "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package io.vertx.reactivex.core.http;
import io.vertx.reactivex.RxHelper;
import io.vertx.reactivex.ObservableHelper;
import io.vertx.reactivex.FlowableHelper;
import io.vertx.reactivex.impl.AsyncResultMaybe;
import io.vertx.reactivex.impl.AsyncResultSingle;
import io.vertx.reactivex.impl.AsyncResultCompletable;
import io.vertx.reactivex.WriteStreamObserver;
import io.vertx.reactivex.WriteStreamSubscriber;
import java.util.Map;
import java.util.Set;
import java.util.List;
import java.util.Iterator;
import java.util.function.Function;
import java.util.stream.Collectors;
import io.vertx.core.Handler;
import io.vertx.core.AsyncResult;
import io.vertx.core.json.JsonObject;
import io.vertx.core.json.JsonArray;
import io.vertx.lang.rx.RxGen;
import io.vertx.lang.rx.TypeArg;
import io.vertx.lang.rx.MappingIterator;
An HTTP and WebSockets server.
You receive HTTP requests by providing a requestHandler
. As requests arrive on the server the handler will be called with the requests.
You receive WebSockets by providing a webSocketHandler
. As WebSocket connections arrive on the server, the WebSocket is passed to the handler.
NOTE: This class has been automatically generated from the original
non RX-ified interface using Vert.x codegen. /**
* An HTTP and WebSockets server.
* <p>
* You receive HTTP requests by providing a {@link io.vertx.reactivex.core.http.HttpServer#requestHandler}. As requests arrive on the server the handler
* will be called with the requests.
* <p>
* You receive WebSockets by providing a {@link io.vertx.reactivex.core.http.HttpServer#webSocketHandler}. As WebSocket connections arrive on the server, the
* WebSocket is passed to the handler.
*
* <p/>
* NOTE: This class has been automatically generated from the {@link io.vertx.core.http.HttpServer original} non RX-ified interface using Vert.x codegen.
*/
@RxGen(io.vertx.core.http.HttpServer.class)
public class HttpServer implements io.vertx.reactivex.core.metrics.Measured {
@Override
public String toString() {
return delegate.toString();
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
HttpServer that = (HttpServer) o;
return delegate.equals(that.delegate);
}
@Override
public int hashCode() {
return delegate.hashCode();
}
public static final TypeArg<HttpServer> __TYPE_ARG = new TypeArg<>( obj -> new HttpServer((io.vertx.core.http.HttpServer) obj),
HttpServer::getDelegate
);
private final io.vertx.core.http.HttpServer delegate;
public HttpServer(io.vertx.core.http.HttpServer delegate) {
this.delegate = delegate;
}
public HttpServer(Object delegate) {
this.delegate = (io.vertx.core.http.HttpServer)delegate;
}
public io.vertx.core.http.HttpServer getDelegate() {
return delegate;
}
private static final TypeArg<io.vertx.reactivex.core.http.HttpServerRequest> TYPE_ARG_0 = new TypeArg<io.vertx.reactivex.core.http.HttpServerRequest>(o1 -> io.vertx.reactivex.core.http.HttpServerRequest.newInstance((io.vertx.core.http.HttpServerRequest)o1), o1 -> o1.getDelegate());
private static final TypeArg<io.vertx.reactivex.core.http.ServerWebSocket> TYPE_ARG_1 = new TypeArg<io.vertx.reactivex.core.http.ServerWebSocket>(o1 -> io.vertx.reactivex.core.http.ServerWebSocket.newInstance((io.vertx.core.http.ServerWebSocket)o1), o1 -> o1.getDelegate());
Whether the metrics are enabled for this measured object
Returns: true
if metrics are enabled
/**
* Whether the metrics are enabled for this measured object
* @return <code>true</code> if metrics are enabled
*/
public boolean isMetricsEnabled() {
boolean ret = delegate.isMetricsEnabled();
return ret;
}
Return the request stream for the server. As HTTP requests are received by the server, instances of HttpServerRequest
will be created and passed to the stream . Returns: the request stream
/**
* Return the request stream for the server. As HTTP requests are received by the server,
* instances of {@link io.vertx.reactivex.core.http.HttpServerRequest} will be created and passed to the stream .
* @return the request stream
*/
public io.vertx.reactivex.core.streams.ReadStream<io.vertx.reactivex.core.http.HttpServerRequest> requestStream() {
if (cached_0 != null) {
return cached_0;
}
io.vertx.reactivex.core.streams.ReadStream<io.vertx.reactivex.core.http.HttpServerRequest> ret = io.vertx.reactivex.core.streams.ReadStream.newInstance((io.vertx.core.streams.ReadStream)delegate.requestStream(), TYPE_ARG_0);
cached_0 = ret;
return ret;
}
Set the request handler for the server to requestHandler
. As HTTP requests are received by the server, instances of HttpServerRequest
will be created and passed to this handler. Params: - handler –
Returns: a reference to this, so the API can be used fluently
/**
* Set the request handler for the server to <code>requestHandler</code>. As HTTP requests are received by the server,
* instances of {@link io.vertx.reactivex.core.http.HttpServerRequest} will be created and passed to this handler.
* @param handler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.reactivex.core.http.HttpServer requestHandler(Handler<io.vertx.reactivex.core.http.HttpServerRequest> handler) {
delegate.requestHandler(new Handler<io.vertx.core.http.HttpServerRequest>() {
public void handle(io.vertx.core.http.HttpServerRequest event) {
handler.handle(io.vertx.reactivex.core.http.HttpServerRequest.newInstance((io.vertx.core.http.HttpServerRequest)event));
}
});
return this;
}
Set a connection handler for the server.
The handler will always be called on the event-loop thread.
Params: - handler –
Returns: a reference to this, so the API can be used fluently
/**
* Set a connection handler for the server.
* <br/>
* The handler will always be called on the event-loop thread.
* @param handler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.reactivex.core.http.HttpServer connectionHandler(Handler<io.vertx.reactivex.core.http.HttpConnection> handler) {
delegate.connectionHandler(new Handler<io.vertx.core.http.HttpConnection>() {
public void handle(io.vertx.core.http.HttpConnection event) {
handler.handle(io.vertx.reactivex.core.http.HttpConnection.newInstance((io.vertx.core.http.HttpConnection)event));
}
});
return this;
}
Set an exception handler called for socket errors happening before the HTTP connection
is established, e.g during the TLS handshake.
Params: - handler – the handler to set
Returns: a reference to this, so the API can be used fluently
/**
* Set an exception handler called for socket errors happening before the HTTP connection
* is established, e.g during the TLS handshake.
* @param handler the handler to set
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.reactivex.core.http.HttpServer exceptionHandler(Handler<java.lang.Throwable> handler) {
delegate.exceptionHandler(handler);
return this;
}
Return the WebSocket stream for the server. If a WebSocket connect handshake is successful a new ServerWebSocket
instance will be created and passed to the stream . Returns: the WebSocket stream
/**
* Return the WebSocket stream for the server. If a WebSocket connect handshake is successful a
* new {@link io.vertx.reactivex.core.http.ServerWebSocket} instance will be created and passed to the stream .
* @return the WebSocket stream
*/
public io.vertx.reactivex.core.streams.ReadStream<io.vertx.reactivex.core.http.ServerWebSocket> webSocketStream() {
if (cached_1 != null) {
return cached_1;
}
io.vertx.reactivex.core.streams.ReadStream<io.vertx.reactivex.core.http.ServerWebSocket> ret = io.vertx.reactivex.core.streams.ReadStream.newInstance((io.vertx.core.streams.ReadStream)delegate.webSocketStream(), TYPE_ARG_1);
cached_1 = ret;
return ret;
}
Set the WebSocket handler for the server to wsHandler
. If a WebSocket connect handshake is successful a new ServerWebSocket
instance will be created and passed to the handler. Params: - handler –
Returns: a reference to this, so the API can be used fluently
/**
* Set the WebSocket handler for the server to <code>wsHandler</code>. If a WebSocket connect handshake is successful a
* new {@link io.vertx.reactivex.core.http.ServerWebSocket} instance will be created and passed to the handler.
* @param handler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.reactivex.core.http.HttpServer webSocketHandler(Handler<io.vertx.reactivex.core.http.ServerWebSocket> handler) {
delegate.webSocketHandler(new Handler<io.vertx.core.http.ServerWebSocket>() {
public void handle(io.vertx.core.http.ServerWebSocket event) {
handler.handle(io.vertx.reactivex.core.http.ServerWebSocket.newInstance((io.vertx.core.http.ServerWebSocket)event));
}
});
return this;
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Params: - port – the port to listen on
- host – the host to listen on
- listenHandler – the listen handler
Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually
* listening (or has failed).
* @param port the port to listen on
* @param host the host to listen on
* @param listenHandler the listen handler
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen(int port, String host, Handler<AsyncResult<io.vertx.reactivex.core.http.HttpServer>> listenHandler) {
delegate.listen(port, host, new Handler<AsyncResult<io.vertx.core.http.HttpServer>>() {
public void handle(AsyncResult<io.vertx.core.http.HttpServer> ar) {
if (ar.succeeded()) {
listenHandler.handle(io.vertx.core.Future.succeededFuture(io.vertx.reactivex.core.http.HttpServer.newInstance((io.vertx.core.http.HttpServer)ar.result())));
} else {
listenHandler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
}
}
});
return this;
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Params: - port – the port to listen on
- host – the host to listen on
Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually
* listening (or has failed).
* @param port the port to listen on
* @param host the host to listen on
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen(int port, String host) {
return
listen(port, host, ar -> { });
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Params: - port – the port to listen on
- host – the host to listen on
Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually
* listening (or has failed).
* @param port the port to listen on
* @param host the host to listen on
* @return
*/
public io.reactivex.Single<io.vertx.reactivex.core.http.HttpServer> rxListen(int port, String host) {
return AsyncResultSingle.toSingle($handler -> {
listen(port, host, $handler);
});
}
Tell the server to start listening on the given address supplying
a handler that will be called when the server is actually
listening (or has failed).
Params: - address – the address to listen on
- listenHandler – the listen handler
Returns:
/**
* Tell the server to start listening on the given address supplying
* a handler that will be called when the server is actually
* listening (or has failed).
* @param address the address to listen on
* @param listenHandler the listen handler
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen(io.vertx.reactivex.core.net.SocketAddress address, Handler<AsyncResult<io.vertx.reactivex.core.http.HttpServer>> listenHandler) {
delegate.listen(address.getDelegate(), new Handler<AsyncResult<io.vertx.core.http.HttpServer>>() {
public void handle(AsyncResult<io.vertx.core.http.HttpServer> ar) {
if (ar.succeeded()) {
listenHandler.handle(io.vertx.core.Future.succeededFuture(io.vertx.reactivex.core.http.HttpServer.newInstance((io.vertx.core.http.HttpServer)ar.result())));
} else {
listenHandler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
}
}
});
return this;
}
Tell the server to start listening on the given address supplying
a handler that will be called when the server is actually
listening (or has failed).
Params: - address – the address to listen on
Returns:
/**
* Tell the server to start listening on the given address supplying
* a handler that will be called when the server is actually
* listening (or has failed).
* @param address the address to listen on
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen(io.vertx.reactivex.core.net.SocketAddress address) {
return
listen(address, ar -> { });
}
Tell the server to start listening on the given address supplying
a handler that will be called when the server is actually
listening (or has failed).
Params: - address – the address to listen on
Returns:
/**
* Tell the server to start listening on the given address supplying
* a handler that will be called when the server is actually
* listening (or has failed).
* @param address the address to listen on
* @return
*/
public io.reactivex.Single<io.vertx.reactivex.core.http.HttpServer> rxListen(io.vertx.reactivex.core.net.SocketAddress address) {
return AsyncResultSingle.toSingle($handler -> {
listen(address, $handler);
});
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Params: - port – the port to listen on
- listenHandler – the listen handler
Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually listening (or has failed).
* @param port the port to listen on
* @param listenHandler the listen handler
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen(int port, Handler<AsyncResult<io.vertx.reactivex.core.http.HttpServer>> listenHandler) {
delegate.listen(port, new Handler<AsyncResult<io.vertx.core.http.HttpServer>>() {
public void handle(AsyncResult<io.vertx.core.http.HttpServer> ar) {
if (ar.succeeded()) {
listenHandler.handle(io.vertx.core.Future.succeededFuture(io.vertx.reactivex.core.http.HttpServer.newInstance((io.vertx.core.http.HttpServer)ar.result())));
} else {
listenHandler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
}
}
});
return this;
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Params: - port – the port to listen on
Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually listening (or has failed).
* @param port the port to listen on
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen(int port) {
return
listen(port, ar -> { });
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Params: - port – the port to listen on
Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually listening (or has failed).
* @param port the port to listen on
* @return
*/
public io.reactivex.Single<io.vertx.reactivex.core.http.HttpServer> rxListen(int port) {
return AsyncResultSingle.toSingle($handler -> {
listen(port, $handler);
});
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Params: - listenHandler – the listen handler
Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually listening (or has failed).
* @param listenHandler the listen handler
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen(Handler<AsyncResult<io.vertx.reactivex.core.http.HttpServer>> listenHandler) {
delegate.listen(new Handler<AsyncResult<io.vertx.core.http.HttpServer>>() {
public void handle(AsyncResult<io.vertx.core.http.HttpServer> ar) {
if (ar.succeeded()) {
listenHandler.handle(io.vertx.core.Future.succeededFuture(io.vertx.reactivex.core.http.HttpServer.newInstance((io.vertx.core.http.HttpServer)ar.result())));
} else {
listenHandler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
}
}
});
return this;
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually listening (or has failed).
* @return
*/
public io.vertx.reactivex.core.http.HttpServer listen() {
return
listen(ar -> { });
}
Like listen
but supplying a handler that will be called when the server is actually listening (or has failed). Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#listen} but supplying a handler that will be called when the server is actually listening (or has failed).
* @return
*/
public io.reactivex.Single<io.vertx.reactivex.core.http.HttpServer> rxListen() {
return AsyncResultSingle.toSingle($handler -> {
listen($handler);
});
}
Like close
but supplying a handler that will be called when the server is actually closed (or has failed). Params: - completionHandler – the handler
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#close} but supplying a handler that will be called when the server is actually closed (or has failed).
* @param completionHandler the handler
*/
public void close(Handler<AsyncResult<Void>> completionHandler) {
delegate.close(completionHandler);
}
Like close
but supplying a handler that will be called when the server is actually closed (or has failed). /**
* Like {@link io.vertx.reactivex.core.http.HttpServer#close} but supplying a handler that will be called when the server is actually closed (or has failed).
*/
public void close() {
close(ar -> { });
}
Like close
but supplying a handler that will be called when the server is actually closed (or has failed). Returns:
/**
* Like {@link io.vertx.reactivex.core.http.HttpServer#close} but supplying a handler that will be called when the server is actually closed (or has failed).
* @return
*/
public io.reactivex.Completable rxClose() {
return AsyncResultCompletable.toCompletable($handler -> {
close($handler);
});
}
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.
/**
* 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
* @return the actual port the server is listening on.
*/
public int actualPort() {
int ret = delegate.actualPort();
return ret;
}
private io.vertx.reactivex.core.streams.ReadStream<io.vertx.reactivex.core.http.HttpServerRequest> cached_0;
private io.vertx.reactivex.core.streams.ReadStream<io.vertx.reactivex.core.http.ServerWebSocket> cached_1;
public static HttpServer newInstance(io.vertx.core.http.HttpServer arg) {
return arg != null ? new HttpServer(arg) : null;
}
}