/*
 * 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; } }