javax.portlet
Interface RenderResponse

All Superinterfaces

MimeResponse, PortletResponse

All Known Implementing Classes:

RenderResponseWrapper

public interface RenderResponse
extends MimeResponse

The RenderResponse defines an object to assist a portlet in sending a response to the portal. It extends the MimeResponse interface to provide specific render response functionality to portlets.
The portlet container creates a RenderResponse object and passes it as argument to the portlet's render method.

See Also

RenderRequest, PortletResponse, MimeResponse

Field Summary

Fields inherited from interface javax.portlet.MimeResponse

CACHE_SCOPE, ETAG, EXPIRATION_CACHE, MARKUP_HEAD_ELEMENT, NAMESPACED_RESPONSE, PRIVATE_SCOPE, PUBLIC_SCOPE, USE_CACHED_CONTENT

Method Summary

void	setContentType(String type) Sets the MIME type for the render response.
void	setNextPossiblePortletModes(Collection<PortletMode> portletModes) This method allows the portlet to tell the portal the next possible portlet modes that the make sense from the portlet point of view.
void	setTitle(String title) This method sets the title of the portlet.

Methods inherited from interface javax.portlet.MimeResponse

createActionURL, createRenderURL, createResourceURL, flushBuffer, getBufferSize, getCacheControl, getCharacterEncoding, getContentType, getLocale, getPortletOutputStream, getWriter, isCommitted, reset, resetBuffer, setBufferSize

Methods inherited from interface javax.portlet.PortletResponse

addProperty, addProperty, addProperty, createElement, encodeURL, getNamespace, setProperty

Method Detail

setTitle

void setTitle(String title)

This method sets the title of the portlet.

The value can be a text String

Parameters

title - portlet title as text String or resource URI

setNextPossiblePortletModes

void setNextPossiblePortletModes(Collection<PortletMode> portletModes)

This method allows the portlet to tell the portal the next possible portlet modes that the make sense from the portlet point of view.

If set, the portal should honor these enumeration of portlet modes and only provide the end user with choices to the provided portlet modes or a subset of these modes based on access control considerations.

If the portlet does not set any next possible portlet modes the default is that all portlet modes that the portlet has defined supporting in the portlet deployment descriptor are meaningful new portlet modes.

Parameters

portletModes - Enumeration of PortletMode objects with the next possible portlet modes that the make sense from the portlet point of view, must not be null or an empty enumeration.

Since:

2.0

setContentType

void setContentType(String type)

Sets the MIME type for the render response. The portlet should set the content type before calling MimeResponse.getWriter() or MimeResponse.getPortletOutputStream().

Calling setContentType after getWriter or getOutputStream does not change the content type.

The portlet container will ignore any character encoding specified as part of the content type for render calls.

Specified by:

setContentType in interface MimeResponse

Parameters

type - the content MIME type

Throws

IllegalArgumentException - if the given type is not in the list returned by PortletRequest.getResponseContentTypes

See Also

PortletRequest.getResponseContentTypes(), MimeResponse.getContentType()