Apache Struts 2 Documentation > Home > Guides > Core Developers Guide > Result Types > Stream Result
Added by Patrick Lightbody, last edited by Musachy Barroso on Jan 02, 2007  (view change) show comment

A custom Result type for send raw data (via an InputStream) directly to the HttpServletResponse. Very useful for allowing users to download content.

If you are running your app server under HTTPS and having issues with PDF's or other file streams you should take a look at HTTPS and IE Issues

Parameters

  • contentType - the stream mime-type as sent to the web browser (default = text/plain).
  • contentLength - the stream length in bytes (the browser displays a progress bar).
  • contentDispostion - the content disposition header value for specifing the file name (default = inline, values are typically filename="document.pdf".
  • inputName - the name of the InputStream property from the chained action (default = inputStream).
  • bufferSize - the size of the buffer to copy from input to output (default = 1024).

Examples

<result name="success" type="stream">
  <param name="contentType">image/jpeg</param>
  <param name="inputName">imageStream</param>
  <param name="contentDisposition">filename="document.pdf"</param>
  <param name="bufferSize">1024</param>
</result>