io.vertx.rxjava3.core.parsetools.JsonParser 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.rxjava3.core.parsetools;
import io.vertx.rxjava3.RxHelper;
import io.vertx.rxjava3.ObservableHelper;
import io.vertx.rxjava3.FlowableHelper;
import io.vertx.rxjava3.impl.AsyncResultMaybe;
import io.vertx.rxjava3.impl.AsyncResultSingle;
import io.vertx.rxjava3.impl.AsyncResultCompletable;
import io.vertx.rxjava3.WriteStreamObserver;
import io.vertx.rxjava3.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;
/**
* A parser class which allows to incrementally parse json elements and emit json parse events instead of parsing a json
* element fully. This parser is convenient for parsing large json structures.
*
* The parser also parses concatenated json streams or line delimited json streams.
*
* The parser can also parse entire object or array when it is convenient, for instance a very large array
* of small objects can be parsed efficiently by handling array start/end and object
* events.
*
* Whenever the parser fails to parse or process the stream, the {@link io.vertx.rxjava3.core.parsetools.JsonParser#exceptionHandler} is called with
* the cause of the failure and the current handling stops. After such event, the parser should not handle data
* anymore.
*
*
* NOTE: This class has been automatically generated from the {@link io.vertx.core.parsetools.JsonParser original} non RX-ified interface using Vert.x codegen.
*/
@RxGen(io.vertx.core.parsetools.JsonParser.class)
public class JsonParser implements io.vertx.rxjava3.core.streams.ReadStream, Handler {
@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;
JsonParser that = (JsonParser) o;
return delegate.equals(that.delegate);
}
@Override
public int hashCode() {
return delegate.hashCode();
}
public static final TypeArg __TYPE_ARG = new TypeArg<>( obj -> new JsonParser((io.vertx.core.parsetools.JsonParser) obj),
JsonParser::getDelegate
);
private final io.vertx.core.parsetools.JsonParser delegate;
public JsonParser(io.vertx.core.parsetools.JsonParser delegate) {
this.delegate = delegate;
}
public JsonParser(Object delegate) {
this.delegate = (io.vertx.core.parsetools.JsonParser)delegate;
}
public io.vertx.core.parsetools.JsonParser getDelegate() {
return delegate;
}
private io.reactivex.rxjava3.core.Observable observable;
private io.reactivex.rxjava3.core.Flowable flowable;
public synchronized io.reactivex.rxjava3.core.Observable toObservable() {
if (observable == null) {
Function conv = io.vertx.rxjava3.core.parsetools.JsonEvent::newInstance;
observable = ObservableHelper.toObservable(delegate, conv);
}
return observable;
}
public synchronized io.reactivex.rxjava3.core.Flowable toFlowable() {
if (flowable == null) {
Function conv = io.vertx.rxjava3.core.parsetools.JsonEvent::newInstance;
flowable = FlowableHelper.toFlowable(delegate, conv);
}
return flowable;
}
private static final TypeArg TYPE_ARG_0 = new TypeArg(o1 -> io.vertx.rxjava3.core.parsetools.JsonEvent.newInstance((io.vertx.core.parsetools.JsonEvent)o1), o1 -> o1.getDelegate());
/**
* Something has happened, so handle it.
* @param event the event to handle
*/
public void handle(io.vertx.rxjava3.core.buffer.Buffer event) {
delegate.handle(event.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.rxjava3.core.streams.Pipe pipe() {
io.vertx.rxjava3.core.streams.Pipe ret = io.vertx.rxjava3.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
* @return
*/
public io.reactivex.rxjava3.core.Completable pipeTo(io.vertx.rxjava3.core.streams.WriteStream dst) {
io.reactivex.rxjava3.core.Completable ret = rxPipeTo(dst);
ret = ret.cache();
ret.subscribe(io.vertx.rxjava3.CompletableHelper.nullObserver());
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
* @return
*/
public io.reactivex.rxjava3.core.Completable rxPipeTo(io.vertx.rxjava3.core.streams.WriteStream dst) {
return AsyncResultCompletable.toCompletable( handler -> {
delegate.pipeTo(dst.getDelegate(), handler);
});
}
/**
* Create a new JsonParser instance.
* @return
*/
public static io.vertx.rxjava3.core.parsetools.JsonParser newParser() {
io.vertx.rxjava3.core.parsetools.JsonParser ret = io.vertx.rxjava3.core.parsetools.JsonParser.newInstance((io.vertx.core.parsetools.JsonParser)io.vertx.core.parsetools.JsonParser.newParser());
return ret;
}
/**
* Create a new JsonParser instance.
* @param stream
* @return
*/
public static io.vertx.rxjava3.core.parsetools.JsonParser newParser(io.reactivex.rxjava3.core.Flowable stream) {
io.vertx.rxjava3.core.parsetools.JsonParser ret = io.vertx.rxjava3.core.parsetools.JsonParser.newInstance((io.vertx.core.parsetools.JsonParser)io.vertx.core.parsetools.JsonParser.newParser(io.vertx.rxjava3.impl.ReadStreamSubscriber.asReadStream(stream, obj -> obj.getDelegate()).resume()));
return ret;
}
/**
* Handle a Buffer, pretty much like calling {@link io.vertx.core.Handler}.
* @param buffer
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava3.core.parsetools.JsonParser write(io.vertx.rxjava3.core.buffer.Buffer buffer) {
delegate.write(buffer.getDelegate());
return this;
}
/**
* End the stream, this must be called after all the json stream has been processed.
*/
public void end() {
delegate.end();
}
/**
* Flip the parser to emit a stream of events for each new json object.
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava3.core.parsetools.JsonParser objectEventMode() {
delegate.objectEventMode();
return this;
}
/**
* Flip the parser to emit a single value event for each new json object.
*
* Json object currently streamed won't be affected.
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava3.core.parsetools.JsonParser objectValueMode() {
delegate.objectValueMode();
return this;
}
/**
* Flip the parser to emit a stream of events for each new json array.
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava3.core.parsetools.JsonParser arrayEventMode() {
delegate.arrayEventMode();
return this;
}
/**
* Flip the parser to emit a single value event for each new json array.
*
* Json array currently streamed won't be affected.
* @return a reference to this, so the API can be used fluently
*/
public io.vertx.rxjava3.core.parsetools.JsonParser arrayValueMode() {
delegate.arrayValueMode();
return this;
}
public io.vertx.rxjava3.core.parsetools.JsonParser pause() {
delegate.pause();
return this;
}
public io.vertx.rxjava3.core.parsetools.JsonParser resume() {
delegate.resume();
return this;
}
public io.vertx.rxjava3.core.parsetools.JsonParser fetch(long amount) {
delegate.fetch(amount);
return this;
}
public io.vertx.rxjava3.core.parsetools.JsonParser endHandler(io.vertx.core.Handler endHandler) {
delegate.endHandler(endHandler);
return this;
}
public io.vertx.rxjava3.core.parsetools.JsonParser handler(io.vertx.core.Handler handler) {
delegate.handler(new io.vertx.lang.rx.DelegatingHandler<>(handler, event -> io.vertx.rxjava3.core.parsetools.JsonEvent.newInstance((io.vertx.core.parsetools.JsonEvent)event)));
return this;
}
public io.vertx.rxjava3.core.parsetools.JsonParser exceptionHandler(io.vertx.core.Handler handler) {
delegate.exceptionHandler(handler);
return this;
}
public static JsonParser newInstance(io.vertx.core.parsetools.JsonParser arg) {
return arg != null ? new JsonParser(arg) : null;
}
}