pekko/akka-docs/rst/scala/http/routing-dsl/directives/basic-directives/withMaterializer.rst

.. _-withMaterializer-:

withMaterializer
================

Signature
---------

.. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala
   :snippet: withMaterializer

Description
-----------

Allows running an inner route using an alternative ``Materializer`` in place of the default one.

The materializer can be extracted in an inner route using :ref:`-extractMaterializer-` directly,
or used by directives which internally extract the materializer without sufracing this fact in the API
(e.g. responding with a Chunked entity).

Example
-------

.. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala
   :snippet: withMaterializer-0
Rename FlowMaterializer to Materializer 2015-06-23 18:28:53 +02:00			`.. _-withMaterializer-:`
=doc Significantly extend HTTP documentation with new content and ports from spray docs 2015-05-11 23:05:18 +02:00
Rename FlowMaterializer to Materializer 2015-06-23 18:28:53 +02:00			`withMaterializer`
=docs #18012 complete remaining TODO sections in scala HTTP docs 2015-07-17 16:18:18 +02:00			`================`
=doc Significantly extend HTTP documentation with new content and ports from spray docs 2015-05-11 23:05:18 +02:00
			`Signature`
			`---------`

=doc fix broken links in scala-side HTTP docs 2015-06-19 15:35:24 +02:00			`.. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala`
Rename FlowMaterializer to Materializer 2015-06-23 18:28:53 +02:00			`:snippet: withMaterializer`
=doc Significantly extend HTTP documentation with new content and ports from spray docs 2015-05-11 23:05:18 +02:00
			`Description`
			`-----------`

+htp #18496 add missing directive documentation (scala) 2015-10-01 13:25:41 +02:00			Allows running an inner route using an alternative ``Materializer`` in place of the default one.

			The materializer can be extracted in an inner route using :ref:`-extractMaterializer-` directly,
			`or used by directives which internally extract the materializer without sufracing this fact in the API`
			`(e.g. responding with a Chunked entity).`
=doc Significantly extend HTTP documentation with new content and ports from spray docs 2015-05-11 23:05:18 +02:00
			`Example`
			`-------`

=doc #18104 fixes typo which made includecode2 not work in many places Note that some of the files don't exist, fixing this very soon. 2015-09-16 23:50:35 +02:00			`.. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala`
=htc,doc #18496 lots of small improvements and last missing docs 2015-10-09 15:19:36 +02:00			`:snippet: withMaterializer-0`