class Session::CommitOnWrite

• Session::CommitOnWrite
• IO
• Reference
• Object

Overview

Wraps a response's output and runs a block once, just before the first byte is written.

Response headers, Set-Cookie among them, are sent with the first write. A session saved after the endpoint returns is too late for a response that was flushed, streamed, or larger than the output buffer, and its cookie would be lost.

Defined in:

Constructors

• .new(io : IO, &commit : -> )

Instance Method Summary

• #close : Nil

  Closes this IO.

• #closed? : Bool

  Returns true if this IO is closed.

• #commit : Nil
• #committed? : Bool
• #flush : self

  Flushes buffered data, if any.

• #read(slice : Bytes) : NoReturn

  Reads at most slice.size bytes from this IO into slice.

• #write(slice : Bytes) : Nil

  Writes the contents of slice into this IO.

Constructor Detail

Instance Method Detail

io = IO::Memory.new "hello"
slice = Bytes.new(4)
io.read(slice) # => 4
slice          # => Bytes[104, 101, 108, 108]
io.read(slice) # => 1
slice          # => Bytes[111, 101, 108, 108]
io.read(slice) # => 0

io = IO::Memory.new
slice = Bytes.new(4) { |i| ('a'.ord + i).to_u8 }
io.write(slice)
io.to_s # => "abcd"