All Downloads are FREE. Search and download functionalities are using the official Maven repository.

graphql.execution.reactive.SubscriptionPublisher Maven / Gradle / Ivy

Go to download

GraphqL Java

There is a newer version: 230521-nf-execution
Show newest version
package graphql.execution.reactive;

import graphql.ExecutionResult;
import graphql.Internal;
import graphql.PublicApi;
import org.reactivestreams.Publisher;
import org.reactivestreams.Subscriber;

import java.util.concurrent.CompletionStage;
import java.util.function.Function;


/**
 * Subscription queries return an instance of this class in the {@link ExecutionResult} data element
 * for the subscribed field.
 *
 * 
{@code
 *      ExecutionResult er = graphQL.execute("subscription s { onEntityChanged(id : "1") { selection1, selection2 }}")
 *      SubscriptionPublisher eventPublisher = er.getData("onEntityChanged")
 * }
 * 

 */
@SuppressWarnings("ReactiveStreamsPublisherImplementation")
@PublicApi
public class SubscriptionPublisher implements Publisher {

    private final CompletionStageMappingPublisher mappingPublisher;

    /**
     * Subscription consuming code is not expected to create instances of this class
     *
     * @param upstreamPublisher the original publisher of objects that then have a graphql selection set applied to them
     * @param mapper            a mapper that turns object into promises to execution results which are then published on this stream
     * @param keepOrdered       this indicates that the order of results should be kep in the same order as the source events arrive
     */
    @Internal
    public SubscriptionPublisher(Publisher upstreamPublisher, Function> mapper, boolean keepOrdered) {
        if (keepOrdered) {
            mappingPublisher = new CompletionStageMappingOrderedPublisher<>(upstreamPublisher, mapper);
        } else {
            mappingPublisher = new CompletionStageMappingPublisher<>(upstreamPublisher, mapper);
        }
    }

    /**
     * @return the underlying Publisher that was providing raw objects to the subscription field, whose published values are then mapped
     * to execution results
     */
    public Publisher getUpstreamPublisher() {
        return mappingPublisher.getUpstreamPublisher();
    }

    @Override
    public void subscribe(Subscriber subscriber) {
        mappingPublisher.subscribe(subscriber);
    }
}
    

    

    
            
    
            







    
© 2015 - 2024 Weber Informatics LLC | Privacy Policy