Fork me on GitHub
Edit on GitHub << back to Core Developer Guide

Stream Result

A custom Result type for sending 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

These parameters can also be set by exposing a similarly named getter method on your Action. For example, you can provide getContentType() to override that parameter for the current action. To do it you you must explicitly define this param as an expression i.e. <param name="contentType">${contentType}</param>

Please be aware that this was changed since Struts 2.5.2, previously each parameter was automatically resolved by looking throughout the ValueStack, now you must explicitly define which parameter must be evaluated, even inputName.

Examples

Annotation based Configuration

To configure Actions and Results with Annotations you need to activate the Struts2 Convention Plugin in your Struts2 application.

package com.mycompany.webapp.actions;

import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

import org.apache.struts2.convention.annotation.Result;

import com.opensymphony.xwork2.Action;
import com.opensymphony.xwork2.ActionSupport;

@Result(
	name = "success", 
	type = "stream", 
	params = { 
		"contentType", "${type}", 
		"inputName", "${stream}", 
		"bufferSize", "1024", 
		"contentDisposition", "attachment;filename=\"${filename}\"" 
	}
)
public class FileDisplay extends ActionSupport {

	private String type = "image/jpeg";
	private String filename;
	private InputStream stream;

	public String execute() throws Exception {

		filename = "myimage.jpg";
		File img = new File("/path/to/image/image.jpg");
		stream = new FileInputStream(img);

		return Action.SUCCESS;
	}
	
	private String getType() {
		return this.type;
	}
	
	private String getFilename() {
		return this.filename;
	}
	
	private String getStream() {
		return this.stream;
	}
}

XML based Configuration

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