org.apache.struts2.dispatcher
Class StreamResult

java.lang.Object
  org.apache.struts2.dispatcher.StrutsResultSupport
      org.apache.struts2.dispatcher.StreamResult

All Implemented Interfaces:

com.opensymphony.xwork2.Result, java.io.Serializable, StrutsStatics

public class StreamResult
extends StrutsResultSupport

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

This result type takes the following 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).

Example:

 <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>
 

See Also:

Serialized Form

Field Summary

protected int	bufferSize
protected java.lang.String	contentDisposition
protected java.lang.String	contentLength
protected java.lang.String	contentType
protected java.lang.String	inputName
protected static org.apache.commons.logging.Log	log

Fields inherited from class org.apache.struts2.dispatcher.StrutsResultSupport

DEFAULT_PARAM, encode, location, parse

Fields inherited from interface org.apache.struts2.StrutsStatics

HTTP_REQUEST, HTTP_RESPONSE, PAGE_CONTEXT, SERVLET_CONTEXT, SERVLET_DISPATCHER, STRUTS_PORTLET_CONTEXT

Constructor Summary

StreamResult()

Method Summary

protected void	doExecute(java.lang.String finalLocation, com.opensymphony.xwork2.ActionInvocation invocation) Executes the result given a final location (jsp page, action, etc) and the action invocation (the state in which the action was executed).
int	getBufferSize()
java.lang.String	getContentDisposition()
java.lang.String	getContentLength()
java.lang.String	getContentType()
java.lang.String	getInputName()
void	setBufferSize(int bufferSize)
void	setContentDisposition(java.lang.String contentDisposition)
void	setContentLength(java.lang.String contentLength)
void	setContentType(java.lang.String contentType)
void	setInputName(java.lang.String inputName)

Methods inherited from class org.apache.struts2.dispatcher.StrutsResultSupport

conditionalParse, execute, setEncode, setLocation, setParse

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

protected static final org.apache.commons.logging.Log log

contentType

protected java.lang.String contentType

contentLength

protected java.lang.String contentLength

contentDisposition

protected java.lang.String contentDisposition

inputName

protected java.lang.String inputName

bufferSize

protected int bufferSize

Constructor Detail

StreamResult

public StreamResult()

Method Detail

getBufferSize

public int getBufferSize()

Returns:

Returns the bufferSize.

setBufferSize

public void setBufferSize(int bufferSize)

Parameters:

bufferSize - The bufferSize to set.

getContentType

public java.lang.String getContentType()

Returns:

Returns the contentType.

setContentType

public void setContentType(java.lang.String contentType)

Parameters:

contentType - The contentType to set.

getContentLength

public java.lang.String getContentLength()

Returns:

Returns the contentLength.

setContentLength

public void setContentLength(java.lang.String contentLength)

Parameters:

contentLength - The contentLength to set.

getContentDisposition

public java.lang.String getContentDisposition()

Returns:

Returns the Content-disposition header value.

setContentDisposition

public void setContentDisposition(java.lang.String contentDisposition)

Parameters:

contentDisposition - the Content-disposition header value to use.

getInputName

public java.lang.String getInputName()

Returns:

Returns the inputName.

setInputName

public void setInputName(java.lang.String inputName)

Parameters:

inputName - The inputName to set.

doExecute

protected void doExecute(java.lang.String finalLocation,
                         com.opensymphony.xwork2.ActionInvocation invocation)
                  throws java.lang.Exception

Description copied from class: StrutsResultSupport

Executes the result given a final location (jsp page, action, etc) and the action invocation (the state in which the action was executed). Subclasses must implement this class to handle custom logic for result handling.

Specified by:

doExecute in class StrutsResultSupport

Parameters:

finalLocation - the location (jsp page, action, etc) to go to.

invocation - the execution state of the action.

Throws:

java.lang.Exception - if an error occurs while executing the result.

See Also:

StrutsResultSupport.doExecute(java.lang.String, com.opensymphony.xwork2.ActionInvocation)