Flow action dump

The dump action terminates the request processing and dumps out (intermediate) data to the client.

Syntax

  • in="..." defines the input location (optional, default is fit://request/content)
  • minify="true|false" controls JS/CSS minification (optional, default is true)
<dump />
<dump in="fit://request/content" />
<dump in="fit://site/public/error.html" />

Usage

Before sending out the data specified in in, the dump action makes the following modifications:

  • The meta data of in is used to determine the Content-Type header
  • New cookies received from upstream servers are sent

The following modifications are applied to the content:

  • remaining fit: URIs are stripped or translated
  • JavaScript and CSS content is minified, if not disabled

Use Cases

The action is handy in debugging situations to terminate the conf/flow.xml at a certain position. In this example we dump the main content after applying regular expressions but before parsing the content:

<flow>
  <default-request />
  <regex ... />
  <!-- debug: terminate after regexes -->
  <dump minify="false" />

  <parse />
  <xslt ... />
</flow>

Dumping the results of a request conditionally mimics the pass mode where the loaded content is passed unchanged. This can be used to proxy parts of a site through FIT without modifications, which may be desirable to aggregate a spread-out multi channel site into a single domain:

<flow>
  <default-request />
  <dump if="client/hw/type = 'desktop'" />

  <!-- mobile and tablet handling follows -->
  <parse />
</flow>