BodyDelegate - what should the write operation look and work like

[owin]

BodyDelegate - what should the write operation look and work like

[loudej]

Notes copied from email thread

So - the four actual methods would be:

Sync Write: write(data, null)

• if host can send data to kernel without entering a wait state: it should send data and return false
• if host can buffer data and send it in the background: it should buffer data and return true
• if host only knows how to do blocking writes: it should send data and return false

Async Write: write(data, callback)

• if host can send data to kernel without entering a wait state: it should send data and return false
• if host can perform async write operation: if should send data async, return true, and invoke callback when complete
• if host only knows how to do blocking write: it should send data and return false

Sync Flush: write(null, null)

• if host is not buffering data and no async writes are outstanding: it should return false immediately
• if host can flush buffered data and wait for outstanding async writes: it should block until that is complete and return false
• if host is buffering and cannot block threads for io to complete: it should return true immediately (to indicate the data remains outstanding)

Async Flush: write(null, callback)

• if host is not buffering data and no async writes are outstanding: it should return false
• if host has buffered data or outstanding async writes: it should return true and invoke callback when those are complete

[loudej]

See also discussion thread https://groups.google.com/d/topic/net-http-abstractions/k7JQP_Rk57Y/discussion