Add WsResponseBuilder to build web socket session response

[sazid]

PR Type

Feature

PR Checklist

• Tests for the changes have been added / updated.
• Documentation comments have been added / updated.
• A changelog entry has been made for the appropriate packages.
• Format code with the latest stable rustfmt
• (Team) Label with affected crates and semver status.

Overview

New: You can now start a websocket session with a frame size or a actix_http::ws::Codec by using the ws:WsResponseBuilder.

Example:

const MAX_FRAME_SIZE: usize = 10_000;
ws::WsResponseBuilder::new(WsActor, &req, stream)
    .codec(Codec::new()) // optional
    .protocols(&["A", "B"]) // optional
    .frame_size(MAX_FRAME_SIZE) // optional
    .start()

There are two terminal methods for the builder. This is in line with two existing start() and start_with_addr() fns.

• start() which starts the actor and returns a response.
• start_with_addr() which starts the actor and returns both the addr of the actor and the response.

Fixes #1873

[robjtede]

i'd like to see one test where the frame size is exceeded producing an error

[brockelmore]

Any update on this PR/when it will land? Seems stale, can fill in and complete any tasks that remain to be done

Edit: ping on this, definitively stale at this point, how can I step in to push it along?

[robjtede]

thanks for getting this started @sazid and for everyone else's patience :)