HTTPTransactionHandler

Members

Functions

detachTransaction

void detachTransaction()

Called once after a transaction successfully completes. It will be called even if a read or write error happened earlier. This is a terminal callback, which means that the HTTPTransaction object that gives this call will be invalid after this function completes.

onBody

void onBody(const ubyte[] chain)

Can be called multiple times per transaction. If you had previously called pauseIngress(), this callback will be delayed until you call resumeIngress().

onChunkComplete

void onChunkComplete()

Can be called multiple times per transaction. If you had previously called pauseIngress(), this callback will be delayed until you call resumeIngress(). This signifies the end of a chunk.

onChunkHeader

void onChunkHeader(size_t length)

Can be called multiple times per transaction. If you had previously called pauseIngress(), this callback will be delayed until you call resumeIngress(). This signifies the beginning of a chunk of length 'length'. You will receive onBody() after this. Also, the length will be greater than zero.

onEOM

void onEOM()

Can be called once per transaction. If you had previously called pauseIngress(), this callback will be delayed until you call resumeIngress(). After this callback is received, there will be no more normal ingress callbacks received (onEgress*() and onError() may still be invoked). The Handler should consider ingress complete after receiving this message. This Transaction is still valid, and work may still occur on it until detachTransaction is called.

onEgressPaused

void onEgressPaused()

If the remote side's receive buffer fills up, this callback will be invoked so you can attempt to stop sending to the remote side.

onEgressResumed

void onEgressResumed()

This callback lets you know that the remote side has resumed reading and you can now continue to send data.

onError

void onError(HTTPErrorCode erromsg)

Can be called at any time before detachTransaction(). This callback implies that an error has occurred. To determine if ingress or egress is affected, check the direciont on the HTTPException. If the direction is INGRESS, it MAY still be possible to send egress.

onHeadersComplete

void onHeadersComplete(HTTPMessage msg)

Called at most once per transaction. This is usually the first ingress callback. It is possible to get a read error before this however. If you had previously called pauseIngress(), this callback will be delayed until you call resumeIngress().

setTransaction

void setTransaction(HTTPTransaction txn)

Called once per transaction. This notifies the handler of which transaction it should talk to and will receive callbacks from.

• HTTPTransaction

• HTTPTransactionHandler