Object

com.thoughtworks.raii

asynchronouspool

Related Doc: package raii

Permalink

object asynchronouspool

The namespace that contains the implementation of the asynchronous resource pool.

Source
asynchronouspool.scala
Example:
  1. Given a factory that creates resources,

    import scalaz.Tags.Parallel
    import scalaz._
    import scalaz.syntax.tag._
    import scalaz.syntax.all._
    import com.thoughtworks.future._
    import com.thoughtworks.raii.asynchronous._
    import com.thoughtworks.raii.asynchronouspool._
    import java.lang.AutoCloseable
    trait MyResource extends AutoCloseable {
      def inUse(): Unit
    }
    val myResourceStub0 = stub[MyResource]
    println(s"myResourceStub0: ${myResourceStub0.isInstanceOf[MyResource]}")
    println(s"myResourceStub0: ${myResourceStub0.isInstanceOf[MyResource]}")
    val myResourceStub1 = stub[MyResource]
    val myResourceStub2 = stub[MyResource]
    val myResourceFactoryMock = mockFunction[MyResource]
    myResourceFactoryMock.expects().returns(myResourceStub0)
    myResourceFactoryMock.expects().returns(myResourceStub1)
    myResourceFactoryMock.expects().returns(myResourceStub2)

    then it can be converted to a resource pool, which holds some instances of MyResource.

    def w = myResourceFactoryMock()
    val myResourcePool: Do[Do[MyResource]] = pool(Do.autoCloseable(w), capacity = 3)

    When some clients are using the resource pool,

    def client(doMyResource: Do[MyResource], operationsPerClient: Int): Do[Unit] = {
      Do.nested[Unit](doMyResource.flatMap { myResource =>
        Do.execute {
            myResource.inUse
          }
          .replicateM_(operationsPerClient)
      })
    }
    def allClients(doMyResource: Do[MyResource], numberOfClients: Int, operationsPerClient: Int): ParallelDo[Unit] = {
      implicit def keepLastException = new Semigroup[Throwable] {
        override def append(f1: Throwable, f2: => Throwable) = f2
      }
      Applicative[ParallelDo].replicateM_(numberOfClients, Parallel(client(doMyResource, operationsPerClient)))
    }
    def usingPool(numberOfClients: Int, operationsPerClient: Int) = {
      myResourcePool.flatMap { doMyResource =>
        allClients(doMyResource, numberOfClients, operationsPerClient).unwrap
      }
    }

    then the operations from these clients should be distributed on those MyResources, and those MyResources should be closed after being used.

    usingPool(numberOfClients = 10, operationsPerClient = 10).run.map { _: Unit =>
      ((myResourceStub0.inUse _): () => Unit).verify().repeated(30 to 40)
      ((myResourceStub0.close _): () => Unit).verify().once()
      ((myResourceStub1.inUse _): () => Unit).verify().repeated(30 to 40)
      ((myResourceStub1.close _): () => Unit).verify().once()
      ((myResourceStub2.inUse _): () => Unit).verify().repeated(30 to 40)
      ((myResourceStub2.close _): () => Unit).verify().once()
      succeed
    }.toScalaFuture
Linear Supertypes
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. asynchronouspool
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. final class ClosedPoolException extends IllegalStateException

    Permalink

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  5. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  6. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  7. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  8. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  9. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  10. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  11. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  12. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  13. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  14. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  15. def pool[A](doA: Do[A], capacity: Int): Do[Do[A]]

    Permalink
  16. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  17. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  18. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  19. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  20. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped