io.vertx.rxjava.core.http.WebSocket 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 client-side WebSocket.
*
*
* NOTE: This class has been automatically generated from the {@link io.vertx.core.http.WebSocket original} non RX-ified interface using Vert.x codegen.
*/
@RxGen(io.vertx.core.http.WebSocket.class)
public class WebSocket implements io.vertx.rxjava.core.http.WebSocketBase {
@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;
WebSocket that = (WebSocket) o;
return delegate.equals(that.delegate);
}
@Override
public int hashCode() {
return delegate.hashCode();
}
public static final TypeArg __TYPE_ARG = new TypeArg<>( obj -> new WebSocket((io.vertx.core.http.WebSocket) obj),
WebSocket::getDelegate
);
private final io.vertx.core.http.WebSocket delegate;
public WebSocket(io.vertx.core.http.WebSocket delegate) {
this.delegate = delegate;
}
public WebSocket(Object delegate) {
this.delegate = (io.vertx.core.http.WebSocket)delegate;
}
public io.vertx.core.http.WebSocket 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 WriteStreamSubscriber subscriber;
public synchronized WriteStreamSubscriber toSubscriber() {
if (subscriber == null) {
Function conv = io.vertx.rxjava.core.buffer.Buffer::getDelegate;
subscriber = RxHelper.toSubscriber(getDelegate(), conv);
}
return subscriber;
}
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());
/**
* Same as but with an handler called when the operation completes
* @param data
* @param handler
*/
public void write(io.vertx.rxjava.core.buffer.Buffer data, Handler> handler) {
delegate.write(data.getDelegate(), handler);
}
/**
* Same as but with an handler called when the operation completes
* @param data
*/
public void write(io.vertx.rxjava.core.buffer.Buffer data) {
write(data, ar -> { });
}
/**
* Same as but with an handler called when the operation completes
* @param data
* @return
*/
public Single rxWrite(io.vertx.rxjava.core.buffer.Buffer data) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
write(data, fut);
}));
}
/**
* Same as but with an handler called when the operation completes
* @param data
* @param handler
*/
public void end(io.vertx.rxjava.core.buffer.Buffer data, Handler> handler) {
delegate.end(data.getDelegate(), handler);
}
/**
* Same as but with an handler called when the operation completes
* @param data
*/
public void end(io.vertx.rxjava.core.buffer.Buffer data) {
end(data, ar -> { });
}
/**
* Same as but with an handler called when the operation completes
* @param data
* @return
*/
public Single rxEnd(io.vertx.rxjava.core.buffer.Buffer data) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
end(data, fut);
}));
}
/**
* This will return true if there are more bytes in the write queue than the value set using {@link io.vertx.rxjava.core.http.WebSocket#setWriteQueueMaxSize}
* @return true if write queue is full
*/
public boolean writeQueueFull() {
boolean ret = delegate.writeQueueFull();
return ret;
}
/**
* 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);
}));
}
/**
* When a WebSocket is created it automatically registers an event handler with the event bus - the ID of that
* handler is given by this method.
*
* Given this ID, a different event loop can send a binary frame to that event handler using the event bus and
* that buffer will be received by this instance in its own event loop and written to the underlying connection. This
* allows you to write data to other WebSockets which are owned by different event loops.
* @return the binary handler id
*/
public String binaryHandlerID() {
String ret = delegate.binaryHandlerID();
return ret;
}
/**
* When a WebSocket is created it automatically registers an event handler with the eventbus, the ID of that
* handler is given by textHandlerID.
*
* Given this ID, a different event loop can send a text frame to that event handler using the event bus and
* that buffer will be received by this instance in its own event loop and written to the underlying connection. This
* allows you to write data to other WebSockets which are owned by different event loops.
* @return
*/
public String textHandlerID() {
String ret = delegate.textHandlerID();
return ret;
}
/**
* Returns the WebSocket sub protocol selected by the WebSocket handshake.
*
* On the server, the value will be null when the handler receives the WebSocket callback as the
* handshake will not be completed yet.
* @return
*/
public String subProtocol() {
String ret = delegate.subProtocol();
return ret;
}
/**
* Returns the close status code received from the remote endpoint or null when not yet received.
* @return
*/
public Short closeStatusCode() {
Short ret = delegate.closeStatusCode();
return ret;
}
/**
* Returns the close reason message from the remote endpoint or null when not yet received.
* @return
*/
public String closeReason() {
String ret = delegate.closeReason();
return ret;
}
/**
* Returns the HTTP headers when the WebSocket is first obtained in the handler.
*
* The headers will be null on subsequent interactions.
* @return the headers
*/
public io.vertx.rxjava.core.MultiMap headers() {
io.vertx.rxjava.core.MultiMap ret = io.vertx.rxjava.core.MultiMap.newInstance((io.vertx.core.MultiMap)delegate.headers());
return ret;
}
/**
* Writes a ping frame to the connection. This will be written in a single frame. Ping frames may be at most 125 bytes (octets).
*
* This method should not be used to write application data and should only be used for implementing a keep alive or
* to ensure the client is still responsive, see RFC 6455 Section section 5.5.2.
*
* There is no handler for ping frames because RFC 6455 clearly
* states that the only response to a ping frame is a pong frame with identical contents.
* @param data the data to write, may be at most 125 bytes
* @param handler called when the ping frame has been successfully written
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.WebSocketBase writePing(io.vertx.rxjava.core.buffer.Buffer data, Handler> handler) {
delegate.writePing(data.getDelegate(), handler);
return this;
}
/**
* Writes a ping frame to the connection. This will be written in a single frame. Ping frames may be at most 125 bytes (octets).
*
* This method should not be used to write application data and should only be used for implementing a keep alive or
* to ensure the client is still responsive, see RFC 6455 Section section 5.5.2.
*
* There is no handler for ping frames because RFC 6455 clearly
* states that the only response to a ping frame is a pong frame with identical contents.
* @param data the data to write, may be at most 125 bytes
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.WebSocketBase writePing(io.vertx.rxjava.core.buffer.Buffer data) {
return
writePing(data, ar -> { });
}
/**
* Writes a ping frame to the connection. This will be written in a single frame. Ping frames may be at most 125 bytes (octets).
*
* This method should not be used to write application data and should only be used for implementing a keep alive or
* to ensure the client is still responsive, see RFC 6455 Section section 5.5.2.
*
* There is no handler for ping frames because RFC 6455 clearly
* states that the only response to a ping frame is a pong frame with identical contents.
* @param data the data to write, may be at most 125 bytes
* @return a reference to this, so the API can be used fluently
*/
public Single rxWritePing(io.vertx.rxjava.core.buffer.Buffer data) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
writePing(data, fut);
}));
}
/**
* Writes a pong frame to the connection. This will be written in a single frame. Pong frames may be at most 125 bytes (octets).
*
* This method should not be used to write application data and should only be used for implementing a keep alive or
* to ensure the client is still responsive, see RFC 6455 section 5.5.2.
*
* There is no need to manually write a pong frame, as the server and client both handle responding to a ping from with a pong from
* automatically and this is exposed to users. RFC 6455 section 5.5.3 states that pongs may be sent unsolicited in order
* to implement a one way heartbeat.
* @param data the data to write, may be at most 125 bytes
* @param handler called when the pong frame has been successfully written
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.WebSocketBase writePong(io.vertx.rxjava.core.buffer.Buffer data, Handler> handler) {
delegate.writePong(data.getDelegate(), handler);
return this;
}
/**
* Writes a pong frame to the connection. This will be written in a single frame. Pong frames may be at most 125 bytes (octets).
*
* This method should not be used to write application data and should only be used for implementing a keep alive or
* to ensure the client is still responsive, see RFC 6455 section 5.5.2.
*
* There is no need to manually write a pong frame, as the server and client both handle responding to a ping from with a pong from
* automatically and this is exposed to users. RFC 6455 section 5.5.3 states that pongs may be sent unsolicited in order
* to implement a one way heartbeat.
* @param data the data to write, may be at most 125 bytes
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.WebSocketBase writePong(io.vertx.rxjava.core.buffer.Buffer data) {
return
writePong(data, ar -> { });
}
/**
* Writes a pong frame to the connection. This will be written in a single frame. Pong frames may be at most 125 bytes (octets).
*
* This method should not be used to write application data and should only be used for implementing a keep alive or
* to ensure the client is still responsive, see RFC 6455 section 5.5.2.
*
* There is no need to manually write a pong frame, as the server and client both handle responding to a ping from with a pong from
* automatically and this is exposed to users. RFC 6455 section 5.5.3 states that pongs may be sent unsolicited in order
* to implement a one way heartbeat.
* @param data the data to write, may be at most 125 bytes
* @return a reference to this, so the API can be used fluently
*/
public Single rxWritePong(io.vertx.rxjava.core.buffer.Buffer data) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
writePong(data, fut);
}));
}
/**
* Set a text message handler on the connection. This handler will be called similar to the
* , but the buffer will be converted to a String first
* @param handler the handler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.WebSocketBase textMessageHandler(Handler handler) {
delegate.textMessageHandler(handler);
return this;
}
/**
* Set a binary message handler on the connection. This handler serves a similar purpose to {@link io.vertx.rxjava.core.http.WebSocket#handler}
* except that if a message comes into the socket in multiple frames, the data from the frames will be aggregated
* into a single buffer before calling the handler (using {@link io.vertx.rxjava.core.http.WebSocketFrame#isFinal} to find the boundaries).
* @param handler the handler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.WebSocketBase binaryMessageHandler(Handler handler) {
delegate.binaryMessageHandler(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;
}
/**
* Set a pong frame handler on the connection. This handler will be invoked every time a pong frame is received
* on the server, and can be used by both clients and servers since the RFC 6455 section 5.5.2 and section 5.5.3 do not
* specify whether the client or server sends a ping.
*
* Pong frames may be at most 125 bytes (octets).
*
* There is no ping handler since ping frames should immediately be responded to with a pong frame with identical content
*
* Pong frames may be received unsolicited.
* @param handler the handler
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava.core.http.WebSocketBase pongHandler(Handler handler) {
delegate.pongHandler(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;
}
/**
*
*
* Calls {@link io.vertx.rxjava.core.http.WebSocketBase#close}
* @param handler
*/
public void end(Handler> handler) {
delegate.end(handler);
}
/**
*
*
* Calls {@link io.vertx.rxjava.core.http.WebSocketBase#close}
*/
public void end() {
end(ar -> { });
}
/**
*
*
* Calls {@link io.vertx.rxjava.core.http.WebSocketBase#close}
* @return
*/
public Single rxEnd() {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
end(fut);
}));
}
/**
* Same as {@link io.vertx.rxjava.core.http.WebSocketBase#close} but with an handler called when the operation completes
* @param handler
*/
public void close(Handler> handler) {
delegate.close(handler);
}
/**
* Same as {@link io.vertx.rxjava.core.http.WebSocketBase#close} but with an handler called when the operation completes
*/
public void close() {
close(ar -> { });
}
/**
* Same as {@link io.vertx.rxjava.core.http.WebSocketBase#close} but with an handler called when the operation completes
* @return
*/
public Single rxClose() {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
close(fut);
}));
}
/**
* Same as {@link io.vertx.rxjava.core.http.WebSocketBase#close} but with an handler called when the operation completes
* @param statusCode
* @param handler
*/
public void close(short statusCode, Handler> handler) {
delegate.close(statusCode, handler);
}
/**
* Same as {@link io.vertx.rxjava.core.http.WebSocketBase#close} but with an handler called when the operation completes
* @param statusCode
*/
public void close(short statusCode) {
close(statusCode, ar -> { });
}
/**
* Same as {@link io.vertx.rxjava.core.http.WebSocketBase#close} but with an handler called when the operation completes
* @param statusCode
* @return
*/
public Single rxClose(short statusCode) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
close(statusCode, fut);
}));
}
/**
* Same as but with an handler called when the operation completes
* @param statusCode
* @param reason
* @param handler
*/
public void close(short statusCode, String reason, Handler> handler) {
delegate.close(statusCode, reason, handler);
}
/**
* Same as but with an handler called when the operation completes
* @param statusCode
* @param reason
*/
public void close(short statusCode, String reason) {
close(statusCode, reason, ar -> { });
}
/**
* Same as but with an handler called when the operation completes
* @param statusCode
* @param reason
* @return
*/
public Single rxClose(short statusCode, String reason) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
close(statusCode, reason, fut);
}));
}
/**
* @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_0 != null) {
return cached_0;
}
io.vertx.rxjava.core.net.SocketAddress ret = io.vertx.rxjava.core.net.SocketAddress.newInstance((io.vertx.core.net.SocketAddress)delegate.remoteAddress());
cached_0 = 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_1 != null) {
return cached_1;
}
io.vertx.rxjava.core.net.SocketAddress ret = io.vertx.rxjava.core.net.SocketAddress.newInstance((io.vertx.core.net.SocketAddress)delegate.localAddress());
cached_1 = ret;
return ret;
}
/**
* @return true if this {@link io.vertx.rxjava.core.http.HttpConnection} is encrypted via SSL/TLS.
*/
public boolean isSsl() {
boolean ret = delegate.isSsl();
return ret;
}
/**
* @return true if the WebSocket is closed
*/
public boolean isClosed() {
boolean ret = delegate.isClosed();
return ret;
}
public io.vertx.rxjava.core.http.WebSocket exceptionHandler(Handler handler) {
delegate.exceptionHandler(handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket 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.WebSocket pause() {
delegate.pause();
return this;
}
public io.vertx.rxjava.core.http.WebSocket resume() {
delegate.resume();
return this;
}
public io.vertx.rxjava.core.http.WebSocket fetch(long amount) {
delegate.fetch(amount);
return this;
}
public io.vertx.rxjava.core.http.WebSocket endHandler(Handler endHandler) {
delegate.endHandler(endHandler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket setWriteQueueMaxSize(int maxSize) {
delegate.setWriteQueueMaxSize(maxSize);
return this;
}
public io.vertx.rxjava.core.http.WebSocket drainHandler(Handler handler) {
delegate.drainHandler(handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket writeFrame(io.vertx.rxjava.core.http.WebSocketFrame frame, Handler> handler) {
delegate.writeFrame(frame.getDelegate(), handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket writeFrame(io.vertx.rxjava.core.http.WebSocketFrame frame) {
return
writeFrame(frame, ar -> { });
}
public Single rxWriteFrame(io.vertx.rxjava.core.http.WebSocketFrame frame) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
writeFrame(frame, fut);
}));
}
public io.vertx.rxjava.core.http.WebSocket writeFinalTextFrame(String text, Handler> handler) {
delegate.writeFinalTextFrame(text, handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket writeFinalTextFrame(String text) {
return
writeFinalTextFrame(text, ar -> { });
}
public Single rxWriteFinalTextFrame(String text) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
writeFinalTextFrame(text, fut);
}));
}
public io.vertx.rxjava.core.http.WebSocket writeFinalBinaryFrame(io.vertx.rxjava.core.buffer.Buffer data, Handler> handler) {
delegate.writeFinalBinaryFrame(data.getDelegate(), handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket writeFinalBinaryFrame(io.vertx.rxjava.core.buffer.Buffer data) {
return
writeFinalBinaryFrame(data, ar -> { });
}
public Single rxWriteFinalBinaryFrame(io.vertx.rxjava.core.buffer.Buffer data) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
writeFinalBinaryFrame(data, fut);
}));
}
public io.vertx.rxjava.core.http.WebSocket writeBinaryMessage(io.vertx.rxjava.core.buffer.Buffer data, Handler> handler) {
delegate.writeBinaryMessage(data.getDelegate(), handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket writeBinaryMessage(io.vertx.rxjava.core.buffer.Buffer data) {
return
writeBinaryMessage(data, ar -> { });
}
public Single rxWriteBinaryMessage(io.vertx.rxjava.core.buffer.Buffer data) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
writeBinaryMessage(data, fut);
}));
}
public io.vertx.rxjava.core.http.WebSocket writeTextMessage(String text, Handler> handler) {
delegate.writeTextMessage(text, handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket writeTextMessage(String text) {
return
writeTextMessage(text, ar -> { });
}
public Single rxWriteTextMessage(String text) {
return Single.create(new SingleOnSubscribeAdapter<>(fut -> {
writeTextMessage(text, fut);
}));
}
public io.vertx.rxjava.core.http.WebSocket closeHandler(Handler handler) {
delegate.closeHandler(handler);
return this;
}
public io.vertx.rxjava.core.http.WebSocket frameHandler(Handler handler) {
delegate.frameHandler(new Handler() {
public void handle(io.vertx.core.http.WebSocketFrame event) {
handler.handle(io.vertx.rxjava.core.http.WebSocketFrame.newInstance((io.vertx.core.http.WebSocketFrame)event));
}
});
return this;
}
/**
* @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.net.SocketAddress cached_0;
private io.vertx.rxjava.core.net.SocketAddress cached_1;
public static WebSocket newInstance(io.vertx.core.http.WebSocket arg) {
return arg != null ? new WebSocket(arg) : null;
}
}