Update to new version of the class

Author: alexander-schranz

components/http_foundation.rst

@@ -636,39 +636,59 @@ Streaming a JSON Response
 
 .. versionadded:: 6.2
 
-The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class allows
-an API to return a lot of data as JSON and keep the used resources low by make usage
-of Generators.
+The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class was
+introduced in Symfony 6.2. It allows an API to return a lot of data as JSON and keep
+the used resources low by make usage of Generators.
 
-It expects a JSON structure with one or multiple replacers identifiers, as example
-the `'__articles__'`. As a second argument it requires one or multiple Generators
-which items can be converted to a JSON via ``json_encode`` method. The key of the
-Generators requires to be the used replacer identifiers::
+It expects an array which represents the JSON structure and the list which should be
+streamed are represented in the array as ``\Generator``. The response will stream this
+JSON with generators in to most efficient way and keep resources as low as possible::
 
  use Symfony\Component\HttpFoundation\StreamedJsonResponse;
 
+ function loadArticles(): \Generator { // any method or function returning a Generator
+ yield ['title' => 'Article 1'];
+ yield ['title' => 'Article 2'];
+ yield ['title' => 'Article 3'];
+ });
+
  $response = new StreamedJsonResponse(
- // json structure with replace identifiers
+ // json structure with generators in which will be streamed as a list
  [
  '_embedded' => [
- 'articles' => '__articles__',
+ 'articles' => loadArticles(), // any \Generator can be used which will be streamed as list of data
  ],
  ],
- // array of generators with replace identifier used as key
- [
- '__articles__' => (function (): \Generator { // any method or function returning a Generator
- yield ['title' => 'Article 1'];
- yield ['title' => 'Article 2'];
- yield ['title' => 'Article 3'];
- })(),
- ]
  );
 
 .. tip::
 
  If loading data via doctrine the ``toIterable`` method of ``Doctrine`` can be
  used to keep also the resources low and fetch only one row one by one.
- See the `Doctrine Batch processing`_ documentation for more.
+ See the `Doctrine Batch processing`_ documentation for more::
+
+ public function __invoke(): Response
+ {
+ return new StreamedJsonResponse(
+ [
+ '_embedded' => [
+ 'articles' => $this->loadArticles(),
+ ],
+ ],
+ );
+ }
+
+ public function loadArticles(): \Generator
+ {
+ $queryBuilder = $entityManager->createQueryBuilder();
+ $queryBuilder->from(Article::class, 'article');
+ $queryBuilder->select('article.id')
+ ->addSelect('article.title')
+ ->addSelect('article.description');
+
+ return $queryBuilder->getQuery()->toIterable();
+ }
+
 
 Serving Files
 ~~~~~~~~~~~~~