Package org.apache.camel.component.reactive.streams.engine

Class DefaultCamelReactiveStreamsService

  • All Implemented Interfaces:
    AutoCloseable, CamelReactiveStreamsService, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.spi.HasCamelContext, org.apache.camel.spi.HasId, org.apache.camel.StatefulService, org.apache.camel.SuspendableService
    @ManagedResource(description="Managed CamelReactiveStreamsService")
public class DefaultCamelReactiveStreamsService
extends org.apache.camel.support.service.ServiceSupport
implements CamelReactiveStreamsService
    The default implementation of the reactive streams service.

    • Field Summary

      • Fields inherited from class org.apache.camel.support.service.BaseService

        BUILT, FAILED, INITIALIZED, INITIALIZING, lock, NEW, SHUTDOWN, SHUTTING_DOWN, STARTED, STARTING, status, STOPPED, STOPPING, SUSPENDED, SUSPENDING

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      ReactiveStreamsCamelSubscriber attachCamelConsumer​(String name, ReactiveStreamsConsumer consumer)
      Used by Camel to associate the subscriber of the stream with the given name to a specific Camel consumer.
      void attachCamelProducer​(String name, ReactiveStreamsProducer producer)
      Used by Camel to associate the publisher of the stream with the given name to a specific Camel producer.
      TabularData camelPublishers()  
      TabularData camelSubscribers()  
      void detachCamelConsumer​(String name)
      Used by Camel to detach the existing consumer from the given stream.
      void detachCamelProducer​(String name)
      Used by Camel to detach the existing producer from the given stream.
      protected void doInit()  
      protected org.reactivestreams.Publisher<org.apache.camel.Exchange> doRequest​(String name, org.apache.camel.Exchange data)  
      protected void doStart()  
      protected void doStop()  
      org.reactivestreams.Publisher<org.apache.camel.Exchange> from​(String uri)
      Creates a new stream from the endpoint URI (used as Camel Consumer) and returns the associated Publisher.
      <T> org.reactivestreams.Publisher<T> from​(String uri, Class<T> type)
      Creates a new stream of the given type from the endpoint URI (used as Camel Consumer) and returns the associated Publisher.
      org.reactivestreams.Publisher<org.apache.camel.Exchange> fromStream​(String name)
      Returns the publisher associated to the given stream name.
      <T> org.reactivestreams.Publisher<T> fromStream​(String name, Class<T> cls)
      Returns the publisher associated to the given stream name.
      org.apache.camel.CamelContext getCamelContext()  
      String getId()  
      <T> void process​(String uri, Class<T> type, Function<? super org.reactivestreams.Publisher<T>,​?> processor)
      Adds a processing step at the specified endpoint uri (usually a "direct:name") that delegates to the given reactive processor.
      void process​(String uri, Function<? super org.reactivestreams.Publisher<org.apache.camel.Exchange>,​?> processor)
      Adds a processing step at the specified endpoint uri (usually a "direct:name") that delegates to the given reactive processor.
      void sendCamelExchange​(String name, org.apache.camel.Exchange exchange)
      Used by Camel to send the exchange to all active subscriptions on the given stream.
      ReactiveStreamsCamelSubscriber streamSubscriber​(String name)
      Returns the subscriber associated to the given stream name.
      <T> org.reactivestreams.Subscriber<T> streamSubscriber​(String name, Class<T> type)
      Returns the subscriber associated to the given stream name.
      org.reactivestreams.Subscriber<org.apache.camel.Exchange> subscriber​(String uri)
      Creates a new route that pushes data to the endpoint URI and returns the associated Subscriber.
      <T> org.reactivestreams.Subscriber<T> subscriber​(String uri, Class<T> type)
      Creates a new route that pushes data to the endpoint URI and returns the associated Subscriber.
      Function<Object,​org.reactivestreams.Publisher<org.apache.camel.Exchange>> to​(String uri)
      Creates a new route that uses the endpoint URI as producer, and returns a function that pushes the data into the route and returns the Publisher that holds the resulting exchange or the error.
      <T> Function<Object,​org.reactivestreams.Publisher<T>> to​(String uri, Class<T> type)
      Creates a new route that uses the endpoint URI as producer, and returns a function that pushes the data into the route and returns the Publisher that holds the exchange output or an error.
      org.reactivestreams.Publisher<org.apache.camel.Exchange> to​(String uri, Object data)
      Creates a new route that uses the endpoint URI as producer, pushes the given data to the route and returns a Publisher that will eventually return the resulting exchange or an error.
      <T> org.reactivestreams.Publisher<T> to​(String uri, Object data, Class<T> type)
      Creates a new route that uses the endpoint URI as producer, pushes the given data to the route and returns a Publisher that will eventually return the exchange output or an error.
      Function<?,​? extends org.reactivestreams.Publisher<org.apache.camel.Exchange>> toStream​(String name)
      Returns a function that pushes data into the specified Camel stream and returns a Publisher (mono) holding the resulting exchange or an error.
      <T> Function<Object,​org.reactivestreams.Publisher<T>> toStream​(String name, Class<T> type)
      Returns a function that pushes data into the specified Camel stream and returns a Publisher (mono) holding the exchange output or an error.
      org.reactivestreams.Publisher<org.apache.camel.Exchange> toStream​(String name, Object data)
      Pushes the given data into the specified Camel stream and returns a Publisher (mono) holding the resulting exchange or an error.
      <T> org.reactivestreams.Publisher<T> toStream​(String name, Object data, Class<T> type)
      Pushes the given data into the specified Camel stream and returns a Publisher (mono) holding the exchange output or an error.

      • Methods inherited from class org.apache.camel.support.service.BaseService

        build, doBuild, doFail, doLifecycleChange, doResume, doShutdown, doSuspend, fail, getStatus, init, isBuild, isInit, isNew, isRunAllowed, isShutdown, isStarted, isStarting, isStartingOrStarted, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

      • Methods inherited from interface org.apache.camel.Service

        build, close, init, start, stop

      • Methods inherited from interface org.apache.camel.ShutdownableService

        shutdown

      • Methods inherited from interface org.apache.camel.StatefulService

        getStatus, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isSuspending

      • Methods inherited from interface org.apache.camel.SuspendableService

        isSuspended, resume, suspend

    • Constructor Detail

      • DefaultCamelReactiveStreamsService

        public DefaultCamelReactiveStreamsService​(org.apache.camel.CamelContext context,
                                          ReactiveStreamsEngineConfiguration configuration)

    • Method Detail

      • getId

        public String getId()
        Specified by:
        getId in interface org.apache.camel.spi.HasId

      • getCamelContext

        public org.apache.camel.CamelContext getCamelContext()
        Specified by:
        getCamelContext in interface org.apache.camel.spi.HasCamelContext

      • doInit

        protected void doInit()
        Overrides:
        doInit in class org.apache.camel.support.service.BaseService

      • doStart

        protected void doStart()
                throws Exception
        Overrides:
        doStart in class org.apache.camel.support.service.BaseService
        Throws:
        Exception

      • doStop

        protected void doStop()
               throws Exception
        Overrides:
        doStop in class org.apache.camel.support.service.BaseService
        Throws:
        Exception

      • fromStream

        public org.reactivestreams.Publisher<org.apache.camel.Exchange> fromStream​(String name)
        Description copied from interface: CamelReactiveStreamsService
        Returns the publisher associated to the given stream name. A publisher can be used to push Camel exchanges to reactive-streams subscribers.
        Specified by:
        fromStream in interface CamelReactiveStreamsService
        Parameters:
        name - the stream name
        Returns:
        the stream publisher

      • fromStream

        public <T> org.reactivestreams.Publisher<T> fromStream​(String name,
                                                       Class<T> cls)
        Description copied from interface: CamelReactiveStreamsService
        Returns the publisher associated to the given stream name. A publisher can be used to push Camel exchange to external reactive-streams subscribers. The publisher converts automatically exchanges to the given type.
        Specified by:
        fromStream in interface CamelReactiveStreamsService
        Type Parameters:
        T - the type of items emitted by the publisher
        Parameters:
        name - the stream name
        cls - the type of the emitted items
        Returns:
        the publisher associated to the stream

      • streamSubscriber

        public <T> org.reactivestreams.Subscriber<T> streamSubscriber​(String name,
                                                              Class<T> type)
        Description copied from interface: CamelReactiveStreamsService
        Returns the subscriber associated to the given stream name. A subscriber can be used to push items coming from external reactive-streams publishers to Camel routes. The subscriber converts automatically items of the given type to exchanges before pushing them.
        Specified by:
        streamSubscriber in interface CamelReactiveStreamsService
        Type Parameters:
        T - the type of items accepted by the subscriber
        Parameters:
        name - the stream name
        type - the publisher converts automatically exchanges to the given type.
        Returns:
        the subscriber associated with the stream

      • sendCamelExchange

        public void sendCamelExchange​(String name,
                              org.apache.camel.Exchange exchange)
        Description copied from interface: CamelReactiveStreamsService
        Used by Camel to send the exchange to all active subscriptions on the given stream. The callback is used to signal that the exchange has been delivered to the subscribers.
        Specified by:
        sendCamelExchange in interface CamelReactiveStreamsService
        Parameters:
        name - the stream name
        exchange - the exchange to be forwarded to the external subscribers

      • toStream

        public org.reactivestreams.Publisher<org.apache.camel.Exchange> toStream​(String name,
                                                                         Object data)
        Description copied from interface: CamelReactiveStreamsService
        Pushes the given data into the specified Camel stream and returns a Publisher (mono) holding the resulting exchange or an error.
        Specified by:
        toStream in interface CamelReactiveStreamsService
        Parameters:
        name - the stream name
        data - the data to push
        Returns:
        a publisher with the resulting exchange

      • toStream

        public <T> org.reactivestreams.Publisher<T> toStream​(String name,
                                                     Object data,
                                                     Class<T> type)
        Description copied from interface: CamelReactiveStreamsService
        Pushes the given data into the specified Camel stream and returns a Publisher (mono) holding the exchange output or an error.
        Specified by:
        toStream in interface CamelReactiveStreamsService
        Type Parameters:
        T - the generic type of the resulting Publisher
        Parameters:
        name - the stream name
        data - the data to push
        type - the type to which the output should be converted
        Returns:
        a publisher with the resulting data

      • doRequest

        protected org.reactivestreams.Publisher<org.apache.camel.Exchange> doRequest​(String name,
                                                                             org.apache.camel.Exchange data)

      • from

        public org.reactivestreams.Publisher<org.apache.camel.Exchange> from​(String uri)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new stream from the endpoint URI (used as Camel Consumer) and returns the associated Publisher. If a stream has already been created, the existing Publisher is returned.
        Specified by:
        from in interface CamelReactiveStreamsService
        Parameters:
        uri - the consumer uri
        Returns:
        the publisher associated to the uri

      • from

        public <T> org.reactivestreams.Publisher<T> from​(String uri,
                                                 Class<T> type)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new stream of the given type from the endpoint URI (used as Camel Consumer) and returns the associated Publisher. If a stream has already been created, the existing Publisher is returned.
        Specified by:
        from in interface CamelReactiveStreamsService
        Type Parameters:
        T - the type to which Camel should convert exchanges to
        Parameters:
        uri - the consumer uri
        type - the type of items emitted by the publisher
        Returns:
        the publisher associated to the uri

      • subscriber

        public org.reactivestreams.Subscriber<org.apache.camel.Exchange> subscriber​(String uri)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new route that pushes data to the endpoint URI and returns the associated Subscriber. This method always create a new stream.
        Specified by:
        subscriber in interface CamelReactiveStreamsService
        Parameters:
        uri - the target uri
        Returns:
        the subscriber associated to the uri

      • subscriber

        public <T> org.reactivestreams.Subscriber<T> subscriber​(String uri,
                                                        Class<T> type)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new route that pushes data to the endpoint URI and returns the associated Subscriber. This method always create a new stream.
        Specified by:
        subscriber in interface CamelReactiveStreamsService
        Type Parameters:
        T - the type from which Camel should convert data to exchanges
        Parameters:
        uri - the target uri
        type - the type of items that the subscriber can receive
        Returns:
        the subscriber associated to the uri

      • to

        public org.reactivestreams.Publisher<org.apache.camel.Exchange> to​(String uri,
                                                                   Object data)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new route that uses the endpoint URI as producer, pushes the given data to the route and returns a Publisher that will eventually return the resulting exchange or an error.
        Specified by:
        to in interface CamelReactiveStreamsService
        Parameters:
        uri - the producer uri
        data - the data to push
        Returns:
        a publisher with the resulting exchange

      • to

        public Function<Object,​org.reactivestreams.Publisher<org.apache.camel.Exchange>> to​(String uri)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new route that uses the endpoint URI as producer, and returns a function that pushes the data into the route and returns the Publisher that holds the resulting exchange or the error. This is a curryied version of CamelReactiveStreamsService.to(String, Object).
        Specified by:
        to in interface CamelReactiveStreamsService
        Parameters:
        uri - the producer uri
        Returns:
        a function that returns a publisher with the resulting exchange

      • to

        public <T> org.reactivestreams.Publisher<T> to​(String uri,
                                               Object data,
                                               Class<T> type)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new route that uses the endpoint URI as producer, pushes the given data to the route and returns a Publisher that will eventually return the exchange output or an error.
        Specified by:
        to in interface CamelReactiveStreamsService
        Type Parameters:
        T - the generic type of the resulting Publisher
        Parameters:
        uri - the producer uri
        data - the data to push
        type - the type to which the output should be converted
        Returns:
        a publisher with the resulting data

      • to

        public <T> Function<Object,​org.reactivestreams.Publisher<T>> to​(String uri,
                                                                      Class<T> type)
        Description copied from interface: CamelReactiveStreamsService
        Creates a new route that uses the endpoint URI as producer, and returns a function that pushes the data into the route and returns the Publisher that holds the exchange output or an error. This is a curryied version of CamelReactiveStreamsService.to(String, Object, Class).
        Specified by:
        to in interface CamelReactiveStreamsService
        Type Parameters:
        T - the generic type of the resulting Publisher
        Parameters:
        uri - the producer uri
        type - the type to which the output should be converted
        Returns:
        a function that returns a publisher with the resulting data

      • process

        public void process​(String uri,
                    Function<? super org.reactivestreams.Publisher<org.apache.camel.Exchange>,​?> processor)
        Description copied from interface: CamelReactiveStreamsService
        Adds a processing step at the specified endpoint uri (usually a "direct:name") that delegates to the given reactive processor. The processor receives a Publisher of exchanges and returns an object. If the output of the processor is a Publisher, it will be unwrapped before delivering the result to the source route.
        Specified by:
        process in interface CamelReactiveStreamsService
        Parameters:
        uri - the uri where the processor should be attached
        processor - the reactive processor

      • process

        public <T> void process​(String uri,
                        Class<T> type,
                        Function<? super org.reactivestreams.Publisher<T>,​?> processor)
        Description copied from interface: CamelReactiveStreamsService
        Adds a processing step at the specified endpoint uri (usually a "direct:name") that delegates to the given reactive processor. The processor receives a Publisher of items of the given type and returns an object. If the output of the processor is a Publisher, it will be unwrapped before delivering the result to the source route.
        Specified by:
        process in interface CamelReactiveStreamsService
        Type Parameters:
        T - the generic type of the Publisher that should be processed
        Parameters:
        uri - the uri where the processor should be attached
        type - the type to which the body of the exchange should be converted
        processor - the reactive processor

      • camelSubscribers

        @ManagedOperation(description="Information about Camel Reactive subscribers")
public TabularData camelSubscribers()

      • camelPublishers

        @ManagedOperation(description="Information about Camel Reactive publishers")
public TabularData camelPublishers()