sealed
trait
AckLevel extends AnyRef
Value Members
-
final
def
!=(arg0: AnyRef): Boolean
-
final
def
!=(arg0: Any): Boolean
-
final
def
##(): Int
-
final
def
==(arg0: AnyRef): Boolean
-
final
def
==(arg0: Any): Boolean
-
final
def
asInstanceOf[T0]: T0
-
def
clone(): AnyRef
-
final
def
eq(arg0: AnyRef): Boolean
-
def
equals(arg0: Any): Boolean
-
def
finalize(): Unit
-
final
def
getClass(): Class[_]
-
def
hashCode(): Int
-
final
def
isInstanceOf[T0]: Boolean
-
final
def
ne(arg0: AnyRef): Boolean
-
final
def
notify(): Unit
-
final
def
notifyAll(): Unit
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
-
def
toString(): String
-
final
def
wait(): Unit
-
final
def
wait(arg0: Long, arg1: Int): Unit
-
final
def
wait(arg0: Long): Unit
Inherited from AnyRef
Inherited from Any
AckLevel is used in Asynchronous write messages to determine how to react to writes. This is useful when interacting with a connection from an actor and needing to handle backpressure when writing large amounts of data.
If AckFailure is selected, WriteStatus's of "Partial" (data partially written but buffered, next write will fail), "Zero" (no data was written, buffer full), and "Failed" (error, probably disconnected) will generate WriteAck messages.
If AckSuccess is selected, "Partial" and "Success" (data fully written) will generate WriteAck
The simplest approach is to AckAll and only send ByteStrings one at a time, waiting for the WriteAck message each time. The highest-throughput approach is to use AckFailure, and send messages as fast as possible, but be aware that you will be entirely responsible for resending failed messages.
WriteAck Messages are only sent to the ConnectionHandler's watcher (if one exists, see the WatchedHandler trait), which may NOT necessarily be the sender of the message.
If you receive a Partial status, you should not send any more data until receiving a ReadyForData message