io.vertx.rxjava.core.http.HttpServerRequest Maven / Gradle / Ivy
/*
* 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.rxjava.core.http;
import rx.Observable;
import rx.Single;
import io.vertx.rx.java.RxHelper;
import io.vertx.rx.java.WriteStreamSubscriber;
import io.vertx.rx.java.SingleOnSubscribeAdapter;
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;
/**
* Represents a server-side HTTP request.
*
* Instances are created for each request and passed to the user via a handler.
*
* Each instance of this class is associated with a corresponding {@link io.vertx.rxjava.core.http.HttpServerResponse} instance via
* {@link io.vertx.rxjava.core.http.HttpServerRequest#response}.
* It implements {@link io.vertx.rxjava.core.streams.ReadStream} so it can be used with
* {@link io.vertx.rxjava.core.streams.Pipe} to pipe data with flow control.
*
*
*
* NOTE: This class has been automatically generated from the {@link io.vertx.core.http.HttpServerRequest original} non RX-ified interface using Vert.x codegen.
*/
@RxGen(io.vertx.core.http.HttpServerRequest.class)
public class HttpServerRequest implements io.vertx.rxjava.core.streams.ReadStream {
@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;
HttpServerRequest that = (HttpServerRequest) o;
return delegate.equals(that.delegate);
}
@Override
public int hashCode() {
return delegate.hashCode();
}
public static final TypeArg __TYPE_ARG = new TypeArg<>( obj -> new HttpServerRequest((io.vertx.core.http.HttpServerRequest) obj),
HttpServerRequest::getDelegate
);
private final io.vertx.core.http.HttpServerRequest delegate;
public HttpServerRequest(io.vertx.core.http.HttpServerRequest delegate) {
this.delegate = delegate;
}
public HttpServerRequest(Object delegate) {
this.delegate = (io.vertx.core.http.HttpServerRequest)delegate;
}
public io.vertx.core.http.HttpServerRequest getDelegate() {
return delegate;
}
private Observable observable;
public synchronized Observable toObservable() {
if (observable == null) {
Function conv = io.vertx.rxjava.core.buffer.Buffer::newInstance;
observable = RxHelper.toObservable(delegate, conv);
}
return observable;
}
private static final TypeArg TYPE_ARG_0 = new TypeArg(o1 -> io.vertx.rxjava.core.buffer.Buffer.newInstance((io.vertx.core.buffer.Buffer)o1), o1 -> o1.getDelegate());
private static final TypeArg TYPE_ARG_1 = new TypeArg(o1 -> io.vertx.rxjava.core.http.Cookie.newInstance((io.vertx.core.http.Cookie)o1), o1 -> o1.getDelegate());
/**
* Pause this stream and return a to transfer the elements of this stream to a destination .
*
* The stream will be resumed when the pipe will be wired to a WriteStream.
* @return a pipe
*/
public io.vertx.rxjava.core.streams.Pipe pipe() {
io.vertx.rxjava.core.streams.Pipe ret = io.vertx.rxjava.core.streams.Pipe.newInstance((io.vertx.core.streams.Pipe)delegate.pipe(), TYPE_ARG_0);
return ret;
}
/**
* Pipe this ReadStream to the WriteStream.
*
* Elements emitted by this stream will be written to the write stream until this stream ends or fails.
*
* Once this stream has ended or failed, the write stream will be ended and the handler will be
* called with the result.
* @param dst the destination write stream
* @param handler
*/
public void pipeTo(io.vertx.rxjava.core.streams.WriteStream dst, Handler> handler) {
delegate.pipeTo(dst.getDelegate(), handler);
}
/**
* Pipe this ReadStream to the WriteStream.
*
* Elements emitted by this stream will be written to the write stream until this stream ends or fails.
*
* Once this stream has ended or failed, the write stream will be ended and the handler will be
* called with the result.
* @param dst the destination write stream
*/
public void pipeTo(io.vertx.rxjava.core.streams.WriteStream dst) {
pipeTo(dst, ar -> { });
}
/**
* Pipe this ReadStream to the WriteStream.
*
* Elements emitted by this stream will be written to the write stream until this stream ends or fails.
*
* Once this stream has ended or failed, the write stream will be ended and the handler will be
* called with the result.
* @param dst the destination write stream
* @return
*/
public Single rxPipeTo(io.vertx.rxjava.core.streams.WriteStream dst) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
pipeTo(dst, fut);
}));
}
public io.vertx.rxjava.core.http.HttpServerRequest exceptionHandler(Handler handler) {
delegate.exceptionHandler(handler);
return this;
}
public io.vertx.rxjava.core.http.HttpServerRequest handler(Handler handler) {
delegate.handler(new Handler() {
public void handle(io.vertx.core.buffer.Buffer event) {
handler.handle(io.vertx.rxjava.core.buffer.Buffer.newInstance((io.vertx.core.buffer.Buffer)event));
}
});
return this;
}
public io.vertx.rxjava.core.http.HttpServerRequest pause() {
delegate.pause();
return this;
}
public io.vertx.rxjava.core.http.HttpServerRequest resume() {
delegate.resume();
return this;
}
public io.vertx.rxjava.core.http.HttpServerRequest fetch(long amount) {
delegate.fetch(amount);
return this;
}
public io.vertx.rxjava.core.http.HttpServerRequest endHandler(Handler endHandler) {
delegate.endHandler(endHandler);
return this;
}
/**
* @return the HTTP version of the request
*/
public io.vertx.core.http.HttpVersion version() {
io.vertx.core.http.HttpVersion ret = delegate.version();
return ret;
}
/**
* @return the HTTP method for the request.
*/
public io.vertx.core.http.HttpMethod method() {
io.vertx.core.http.HttpMethod ret = delegate.method();
return ret;
}
/**
* @return true if this {@link io.vertx.rxjava.core.net.NetSocket} is encrypted via SSL/TLS
*/
public boolean isSSL() {
boolean ret = delegate.isSSL();
return ret;
}
/**
* @return the scheme of the request
*/
public String scheme() {
String ret = delegate.scheme();
return ret;
}
/**
* @return the URI of the request. This is usually a relative URI
*/
public String uri() {
String ret = delegate.uri();
return ret;
}
/**
* @return The path part of the uri. For example /somepath/somemorepath/someresource.foo
*/
public String path() {
String ret = delegate.path();
return ret;
}
/**
* @return the query part of the uri. For example someparam=32&someotherparam=x
*/
public String query() {
String ret = delegate.query();
return ret;
}
/**
* @return the request host. For HTTP2 it returns the pseudo header otherwise it returns the header
*/
public String host() {
String ret = delegate.host();
return ret;
}
/**
* @return the total number of bytes read for the body of the request.
*/
public long bytesRead() {
long ret = delegate.bytesRead();
return ret;
}
/**
* @return the response. Each instance of this class has an {@link io.vertx.rxjava.core.http.HttpServerResponse} instance attached to it. This is used to send the response back to the client.
*/
public io.vertx.rxjava.core.http.HttpServerResponse response() {
if (cached_0 != null) {
return cached_0;
}
io.vertx.rxjava.core.http.HttpServerResponse ret = io.vertx.rxjava.core.http.HttpServerResponse.newInstance((io.vertx.core.http.HttpServerResponse)delegate.response());
cached_0 = ret;
return ret;
}
/**
* @return the headers in the request.
*/
public io.vertx.rxjava.core.MultiMap headers() {
if (cached_1 != null) {
return cached_1;
}
io.vertx.rxjava.core.MultiMap ret = io.vertx.rxjava.core.MultiMap.newInstance((io.vertx.core.MultiMap)delegate.headers());
cached_1 = ret;
return ret;
}
/**
* Return the first header value with the specified name
* @param headerName the header name
* @return the header value
*/
public String getHeader(String headerName) {
String ret = delegate.getHeader(headerName);
return ret;
}
/**
* @return the query parameters in the request
*/
public io.vertx.rxjava.core.MultiMap params() {
if (cached_2 != null) {
return cached_2;
}
io.vertx.rxjava.core.MultiMap ret = io.vertx.rxjava.core.MultiMap.newInstance((io.vertx.core.MultiMap)delegate.params());
cached_2 = ret;
return ret;
}
/**
* Return the first param value with the specified name
* @param paramName the param name
* @return the param value
*/
public String getParam(String paramName) {
String ret = delegate.getParam(paramName);
return ret;
}
/**
* @return the remote address for this connection, possibly null (e.g a server bound on a domain socket). If useProxyProtocol is set to true, the address returned will be of the actual connecting client.
*/
public io.vertx.rxjava.core.net.SocketAddress remoteAddress() {
if (cached_3 != null) {
return cached_3;
}
io.vertx.rxjava.core.net.SocketAddress ret = io.vertx.rxjava.core.net.SocketAddress.newInstance((io.vertx.core.net.SocketAddress)delegate.remoteAddress());
cached_3 = ret;
return ret;
}
/**
* @return the local address for this connection, possibly null (e.g a server bound on a domain socket) If useProxyProtocol is set to true, the address returned will be of the proxy.
*/
public io.vertx.rxjava.core.net.SocketAddress localAddress() {
if (cached_4 != null) {
return cached_4;
}
io.vertx.rxjava.core.net.SocketAddress ret = io.vertx.rxjava.core.net.SocketAddress.newInstance((io.vertx.core.net.SocketAddress)delegate.localAddress());
cached_4 = ret;
return ret;
}
/**
* @return the absolute URI corresponding to the the HTTP request
*/
public String absoluteURI() {
String ret = delegate.absoluteURI();
return ret;
}
/**
* Convenience method for receiving the entire request body in one piece.
*
* This saves the user having to manually setting a data and end handler and append the chunks of the body until
* the whole body received. Don't use this if your request body is large - you could potentially run out of RAM.
* @param bodyHandler This handler will be called after all the body has been received
* @return
*/
public io.vertx.rxjava.core.http.HttpServerRequest bodyHandler(Handler bodyHandler) {
delegate.bodyHandler(new Handler() {
public void handle(io.vertx.core.buffer.Buffer event) {
bodyHandler.handle(io.vertx.rxjava.core.buffer.Buffer.newInstance((io.vertx.core.buffer.Buffer)event));
}
});
return this;
}
/**
* Same as {@link io.vertx.rxjava.core.http.HttpServerRequest#body} but with an handler called when the operation completes
* @param handler
* @return
*/
public io.vertx.rxjava.core.http.HttpServerRequest body(Handler> handler) {
io.vertx.rxjava.core.http.HttpServerRequest ret = io.vertx.rxjava.core.http.HttpServerRequest.newInstance((io.vertx.core.http.HttpServerRequest)delegate.body(new Handler>() {
public void handle(AsyncResult ar) {
if (ar.succeeded()) {
handler.handle(io.vertx.core.Future.succeededFuture(io.vertx.rxjava.core.buffer.Buffer.newInstance((io.vertx.core.buffer.Buffer)ar.result())));
} else {
handler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
}
}
}));
return ret;
}
/**
* Same as {@link io.vertx.rxjava.core.http.HttpServerRequest#end} but with an handler called when the operation completes
* @param handler
*/
public void end(Handler> handler) {
delegate.end(handler);
}
/**
* Same as {@link io.vertx.rxjava.core.http.HttpServerRequest#end} but with an handler called when the operation completes
*/
public void end() {
end(ar -> { });
}
/**
* Same as {@link io.vertx.rxjava.core.http.HttpServerRequest#end} but with an handler called when the operation completes
* @return
*/
public Single rxEnd() {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
end(fut);
}));
}
/**
* Establish a TCP tunnel with the client.
*
* This must be called only for CONNECT HTTP method and before any response is sent.
*
*
Calling this sends a 200 response with no content-length header set and
* then provides the NetSocket for handling the created tunnel. Any HTTP header set on the
* response before calling this method will be sent.
*
*
* server.requestHandler(req -> {
* if (req.method() == HttpMethod.CONNECT) {
* // Send a 200 response to accept the connect
* NetSocket socket = req.netSocket();
* socket.handler(buff -> {
* socket.write(buff);
* });
* }
* ...
* });
*
* @param handler the completion handler
*/
public void toNetSocket(Handler> handler) {
delegate.toNetSocket(new Handler>() {
public void handle(AsyncResult ar) {
if (ar.succeeded()) {
handler.handle(io.vertx.core.Future.succeededFuture(io.vertx.rxjava.core.net.NetSocket.newInstance((io.vertx.core.net.NetSocket)ar.result())));
} else {
handler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
}
}
});
}
/**
* Establish a TCP tunnel with the client.
*
* This must be called only for CONNECT HTTP method and before any response is sent.
*
*
Calling this sends a 200 response with no content-length header set and
* then provides the NetSocket for handling the created tunnel. Any HTTP header set on the
* response before calling this method will be sent.
*
*
* server.requestHandler(req -> {
* if (req.method() == HttpMethod.CONNECT) {
* // Send a 200 response to accept the connect
* NetSocket socket = req.netSocket();
* socket.handler(buff -> {
* socket.write(buff);
* });
* }
* ...
* });
*
*/
public void toNetSocket() {
toNetSocket(ar -> { });
}
/**
* Establish a TCP tunnel with the client.
*
* This must be called only for CONNECT HTTP method and before any response is sent.
*
*
Calling this sends a 200 response with no content-length header set and
* then provides the NetSocket for handling the created tunnel. Any HTTP header set on the
* response before calling this method will be sent.
*
*
* server.requestHandler(req -> {
* if (req.method() == HttpMethod.CONNECT) {
* // Send a 200 response to accept the connect
* NetSocket socket = req.netSocket();
* socket.handler(buff -> {
* socket.write(buff);
* });
* }
* ...
* });
*
* @return
*/
public Single rxToNetSocket() {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
toNetSocket(fut);
}));
}
/**
* Call this with true if you are expecting a multi-part body to be submitted in the request.
* This must be called before the body of the request has been received
* @param expect true - if you are expecting a multi-part body
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.HttpServerRequest setExpectMultipart(boolean expect) {
delegate.setExpectMultipart(expect);
return this;
}
/**
* @return true if we are expecting a multi-part body for this request. See {@link io.vertx.rxjava.core.http.HttpServerRequest#setExpectMultipart}.
*/
public boolean isExpectMultipart() {
boolean ret = delegate.isExpectMultipart();
return ret;
}
/**
* Set an upload handler. The handler will get notified once a new file upload was received to allow you to deal
* with the file upload.
* @param uploadHandler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.HttpServerRequest uploadHandler(Handler uploadHandler) {
delegate.uploadHandler(new Handler() {
public void handle(io.vertx.core.http.HttpServerFileUpload event) {
uploadHandler.handle(io.vertx.rxjava.core.http.HttpServerFileUpload.newInstance((io.vertx.core.http.HttpServerFileUpload)event));
}
});
return this;
}
/**
* Returns a map of all form attributes in the request.
*
* Be aware that the attributes will only be available after the whole body has been received, i.e. after
* the request end handler has been called.
*
* {@link io.vertx.rxjava.core.http.HttpServerRequest#setExpectMultipart} must be called first before trying to get the form attributes.
* @return the form attributes
*/
public io.vertx.rxjava.core.MultiMap formAttributes() {
if (cached_5 != null) {
return cached_5;
}
io.vertx.rxjava.core.MultiMap ret = io.vertx.rxjava.core.MultiMap.newInstance((io.vertx.core.MultiMap)delegate.formAttributes());
cached_5 = ret;
return ret;
}
/**
* Return the first form attribute value with the specified name
* @param attributeName the attribute name
* @return the attribute value
*/
public String getFormAttribute(String attributeName) {
String ret = delegate.getFormAttribute(attributeName);
return ret;
}
/**
* Upgrade the connection of the current request to a WebSocket.
*
* This is an alternative way of handling WebSockets and can only be used if no WebSocket handler is set on the
* HttpServer, and can only be used during the upgrade request during the WebSocket handshake.
*
*
Both {@link io.vertx.rxjava.core.http.HttpServerRequest#handler} and {@link io.vertx.rxjava.core.http.HttpServerRequest#endHandler} will be set to get the full body of the
* request that is necessary to perform the WebSocket handshake.
*
*
If you need to do an asynchronous upgrade, i.e not performed immediately in your request handler,
* you need to {@link io.vertx.rxjava.core.http.HttpServerRequest#pause} the request in order to not lose HTTP events necessary to upgrade the
* request.
* @param handler the completion handler
*/
public void toWebSocket(Handler> handler) {
delegate.toWebSocket(new Handler>() {
public void handle(AsyncResult ar) {
if (ar.succeeded()) {
handler.handle(io.vertx.core.Future.succeededFuture(io.vertx.rxjava.core.http.ServerWebSocket.newInstance((io.vertx.core.http.ServerWebSocket)ar.result())));
} else {
handler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
}
}
});
}
/**
* Upgrade the connection of the current request to a WebSocket.
*
* This is an alternative way of handling WebSockets and can only be used if no WebSocket handler is set on the
* HttpServer, and can only be used during the upgrade request during the WebSocket handshake.
*
*
Both {@link io.vertx.rxjava.core.http.HttpServerRequest#handler} and {@link io.vertx.rxjava.core.http.HttpServerRequest#endHandler} will be set to get the full body of the
* request that is necessary to perform the WebSocket handshake.
*
*
If you need to do an asynchronous upgrade, i.e not performed immediately in your request handler,
* you need to {@link io.vertx.rxjava.core.http.HttpServerRequest#pause} the request in order to not lose HTTP events necessary to upgrade the
* request.
*/
public void toWebSocket() {
toWebSocket(ar -> { });
}
/**
* Upgrade the connection of the current request to a WebSocket.
*
* This is an alternative way of handling WebSockets and can only be used if no WebSocket handler is set on the
* HttpServer, and can only be used during the upgrade request during the WebSocket handshake.
*
*
Both {@link io.vertx.rxjava.core.http.HttpServerRequest#handler} and {@link io.vertx.rxjava.core.http.HttpServerRequest#endHandler} will be set to get the full body of the
* request that is necessary to perform the WebSocket handshake.
*
*
If you need to do an asynchronous upgrade, i.e not performed immediately in your request handler,
* you need to {@link io.vertx.rxjava.core.http.HttpServerRequest#pause} the request in order to not lose HTTP events necessary to upgrade the
* request.
* @return
*/
public Single rxToWebSocket() {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
toWebSocket(fut);
}));
}
/**
* Has the request ended? I.e. has the entire request, including the body been read?
* @return true if ended
*/
public boolean isEnded() {
boolean ret = delegate.isEnded();
return ret;
}
/**
* Set a custom frame handler. The handler will get notified when the http stream receives an custom HTTP/2
* frame. HTTP/2 permits extension of the protocol.
* @param handler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.HttpServerRequest customFrameHandler(Handler handler) {
delegate.customFrameHandler(new Handler() {
public void handle(io.vertx.core.http.HttpFrame event) {
handler.handle(io.vertx.rxjava.core.http.HttpFrame.newInstance((io.vertx.core.http.HttpFrame)event));
}
});
return this;
}
/**
* @return the {@link io.vertx.rxjava.core.http.HttpConnection} associated with this request
*/
public io.vertx.rxjava.core.http.HttpConnection connection() {
if (cached_6 != null) {
return cached_6;
}
io.vertx.rxjava.core.http.HttpConnection ret = io.vertx.rxjava.core.http.HttpConnection.newInstance((io.vertx.core.http.HttpConnection)delegate.connection());
cached_6 = ret;
return ret;
}
/**
* @return the priority of the associated HTTP/2 stream for HTTP/2 otherwise null
*/
public io.vertx.core.http.StreamPriority streamPriority() {
io.vertx.core.http.StreamPriority ret = delegate.streamPriority();
return ret;
}
/**
* Set an handler for stream priority changes
*
* This is not implemented for HTTP/1.x.
* @param handler the handler to be called when stream priority changes
* @return
*/
public io.vertx.rxjava.core.http.HttpServerRequest streamPriorityHandler(Handler handler) {
delegate.streamPriorityHandler(handler);
return this;
}
/**
* Get the cookie with the specified name.
* @param name the cookie name
* @return the cookie
*/
public io.vertx.rxjava.core.http.Cookie getCookie(String name) {
io.vertx.rxjava.core.http.Cookie ret = io.vertx.rxjava.core.http.Cookie.newInstance((io.vertx.core.http.Cookie)delegate.getCookie(name));
return ret;
}
/**
* @return the number of cookieMap.
*/
public int cookieCount() {
int ret = delegate.cookieCount();
return ret;
}
/**
* @return a map of all the cookies.
*/
public java.util.Map cookieMap() {
java.util.Map ret = delegate.cookieMap().entrySet().stream().collect(Collectors.toMap(_e -> _e.getKey(), _e -> io.vertx.rxjava.core.http.Cookie.newInstance((io.vertx.core.http.Cookie)_e.getValue())));
return ret;
}
/**
* Marks this request as being routed to the given route. This is purely informational and is
* being provided to metrics.
* @param route The route this request has been routed to.
* @return
*/
public io.vertx.rxjava.core.http.HttpServerRequest routed(String route) {
delegate.routed(route);
return this;
}
/**
* Return the first header value with the specified name
* @param headerName the header name
* @return the header value
*/
public String getHeader(java.lang.CharSequence headerName) {
String ret = delegate.getHeader(headerName);
return ret;
}
/**
* @return SSLSession associated with the underlying socket. Returns null if connection is not SSL.
*/
public javax.net.ssl.SSLSession sslSession() {
javax.net.ssl.SSLSession ret = delegate.sslSession();
return ret;
}
private io.vertx.rxjava.core.http.HttpServerResponse cached_0;
private io.vertx.rxjava.core.MultiMap cached_1;
private io.vertx.rxjava.core.MultiMap cached_2;
private io.vertx.rxjava.core.net.SocketAddress cached_3;
private io.vertx.rxjava.core.net.SocketAddress cached_4;
private io.vertx.rxjava.core.MultiMap cached_5;
private io.vertx.rxjava.core.http.HttpConnection cached_6;
public static HttpServerRequest newInstance(io.vertx.core.http.HttpServerRequest arg) {
return arg != null ? new HttpServerRequest(arg) : null;
}
}