com.twitter.finagle.kestrel

ReadHandle

abstract class ReadHandle extends AnyRef

An ongoing transactional read (from {{read}}).

A common usage pattern is to attach asynchronous handlers to messages and error by invoking Offer.foreach on them. For example:

val readHandle: ReadHandle = ...
readHandle.messages foreach { msg =>
  try {
    System.out.println(msg.bytes.toString("UTF-8"))
  } finally {
    msg.ack() // if we don't do this, no more msgs will come to us
  }
}
readHandle.error foreach { System.error.println("zomg! got an error " + _.getMessage) }
Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. ReadHandle
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new ReadHandle()

Abstract Value Members

  1. abstract def close(): Unit

    Closes the read.

    Closes the read. Closes are signaled as an error with {{ReadClosedException}} when the close has completed.

  2. abstract val error: Offer[Throwable]

    Indicates an error in the read.

  3. abstract val messages: Offer[ReadMessage]

    An offer to synchronize on the next message.

    An offer to synchronize on the next message. A new message is available only when the previous one has been acknowledged (through {{ReadMessage.ack()}})

Concrete Value Members

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

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

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

    Definition Classes
    AnyRef
  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  6. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  7. def buffered(howmany: Int): ReadHandle

    A copy of this {{ReadHandle}} that is buffered: it will make available {{howmany}} messages at once, proactively acknowledging them.

    A copy of this {{ReadHandle}} that is buffered: it will make available {{howmany}} messages at once, proactively acknowledging them. This allows a consumer to process {{howmany}} items in parallel from one handle.

  8. def clone(): AnyRef

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

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

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

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

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

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

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

    Definition Classes
    AnyRef
  16. final def notify(): Unit

    Definition Classes
    AnyRef
  17. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  18. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  19. def toString(): String

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

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

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

    Definition Classes
    AnyRef
    Annotations
    @throws()

Inherited from AnyRef

Inherited from Any

Ungrouped