package reactivestreams
Implementation of the reactivestreams protocol for fs2
- Source
- package.scala
scala> import fs2._ scala> import fs2.interop.reactivestreams._ scala> import cats.effect.{IO, Resource}, cats.effect.unsafe.implicits.global scala> scala> val upstream: Stream[IO, Int] = Stream(1, 2, 3).covary[IO] scala> val publisher: Resource[IO, StreamUnicastPublisher[IO, Int]] = upstream.toUnicastPublisher scala> val downstream: Stream[IO, Int] = Stream.resource(publisher).flatMap(_.toStreamBuffered[IO](bufferSize = 16)) scala> scala> downstream.compile.toVector.unsafeRunSync() res0: Vector[Int] = Vector(1, 2, 3)
- See also
- Alphabetic
- By Inheritance
- reactivestreams
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
- implicit final class PublisherOps[A] extends AnyVal
- implicit final class StreamOps[F[_], A] extends AnyRef
-
final
class
StreamSubscriber[F[_], A] extends Subscriber[A]
Implementation of a
org.reactivestreams.Subscriber.Implementation of a
org.reactivestreams.Subscriber.This is used to obtain a
fs2.Streamfrom an upstream reactivestreams system. -
final
class
StreamUnicastPublisher[F[_], A] extends Publisher[A]
Implementation of a
org.reactivestreams.PublisherImplementation of a
org.reactivestreams.PublisherThis is used to publish elements from a Stream to a downstream reactive-streams system.
- Note
Not longer unicast, this Publisher can be reused for multiple Subscribers: each subscription will re-run the Stream from the beginning. However, a _parallel_
Dispatcheris required to allow concurrent subscriptions. Please, refer to theapplyfactory in the companion object that only requires a stream.- See also
https://github.com/reactive-streams/reactive-streams-jvm#1-publisher-code
Value Members
-
def
fromPublisher[F[_], A](p: Publisher[A], bufferSize: Int)(implicit arg0: Async[F]): Stream[F, A]
Creates a lazy stream from an
org.reactivestreams.Publisher.Creates a lazy stream from an
org.reactivestreams.Publisher.The publisher only receives a subscriber when the stream is run.
- bufferSize
setup the number of elements asked each time from the
org.reactivestreams.Publisher. A high number can be useful if the publisher is triggering from IO, like requesting elements from a database. The publisher can use thisbufferSizeto query elements in batch. A high number will also lead to more elements in memory.
-
def
subscribeStream[F[_], A](stream: Stream[F, A], subscriber: Subscriber[A])(implicit F: Async[F]): F[Unit]
Allows subscribing a
org.reactivestreams.Subscriberto a Stream.Allows subscribing a
org.reactivestreams.Subscriberto a Stream.The returned program will run until all the stream elements were consumed. Cancelling this program will gracefully shutdown the subscription.
- stream
the Stream that will be consumed by the subscriber.
- subscriber
the Subscriber that will receive the elements of the stream.
- object StreamSubscriber
- object StreamUnicastPublisher
Deprecated Value Members
-
def
fromPublisher[F[_], A](p: Publisher[A])(implicit arg0: Async[F]): Stream[F, A]
Creates a lazy stream from an
org.reactivestreams.Publisher.Creates a lazy stream from an
org.reactivestreams.Publisher.The publisher only receives a subscriber when the stream is run.
- Annotations
- @deprecated
- Deprecated
(Since version 3.1.4) Use fromPublisher method with a buffer size. Use a buffer size of 1 to keep the same behavior.