Stream::of()

[thekid]

This pull request adds the possibility to return streams from delegates.

use web\frontend\Stream;

class Users {
  // ...other delegates...

  #[@get('/users/{id}/avatar')]
  public function avatar($id) {
    return Stream::of('JFIF...', 'image/jpeg');
  }
}

The Stream::of() method will accept any of:

• io.File and io.Path instances (for which mime types and content length are calculated if omitted)
• io.streams.InputStreams (which are streamed to the response as being read from)
• Strings or util.Bytes (which are transmitted as-is)

[thekid]

This could be implemented within the xp-forge/web library as follows:

use web\frontend\{Frontend, Templates};
use web\Application;

class Service extends Application {

  public function routes() {
    $templates= ...
    return [
      '/users/{user}/avatar' => function($req, $res) { ... },
      '/users'               => new Frontend(new Users(), $templates)
    ];
  }
}

The benefit would be that the avatar handler can use the full extent of the web API, including partial requests. The downside however is that possibly closely related code would be torn apart.

[thekid]

This could be implemented within the xp-forge/web library as follows [...]

See https://github.com/xp-forge/web/pull/37

[thekid]

Not necessary until now, can be reopened if necessary later on.