org.springframework.web.portlet
Class ModelAndView

java.lang.Object
  org.springframework.web.portlet.ModelAndView

public class ModelAndView
extends Object

Holder for both Model and View in the web MVC framework. Note that these are entirely distinct. This class merely holds both to make it possible for a controller to return both model and view in a single return value.

Represents a model and view returned by a handler, to be resolved by a DispatcherPortlet. The view can take the form of a String view name which will need to be resolved by a ViewResolver object; alternatively a view object can be specified directly. The model is a Map, allowing the use of multiple objects keyed by name.

Since:

2.0

Author:

Juergen Hoeller

See Also:

DispatcherPortlet, ViewResolver, HandlerAdapter, Controller

Constructor Summary

ModelAndView()
Default constructor for bean-style usage: populating bean properties instead of passing in constructor arguments.

ModelAndView(Object view)
Convenient constructor when there is no model data to expose.

ModelAndView(Object view, Map model)
Create a new ModelAndView given a View object and a model.

ModelAndView(Object view, String modelName, Object modelObject)
Convenient constructor to take a single model object.

ModelAndView(String viewName)
Convenient constructor when there is no model data to expose.

ModelAndView(String viewName, Map model)
Create a new ModelAndView given a view name and a model.

ModelAndView(String viewName, String modelName, Object modelObject)
Convenient constructor to take a single model object.

Method Summary

ModelAndView	addAllObjects(Map modelMap) Add all entries contained in the provided map to the model.
ModelAndView	addObject(Object modelObject) Add an object to the model using parameter name generation.
ModelAndView	addObject(String modelName, Object modelObject) Add an object to the model.
void	clear() Clear the state of this ModelAndView object.
Map	getModel() Return the model map.
protected Map	getModelInternal() Return the model map.
ModelMap	getModelMap() Return the underlying ModelMap instance (never null).
Object	getView() Return the View object, or null if we are using a view name to be resolved by the DispatcherPortlet via a ViewResolver.
String	getViewName() Return the view name to be resolved by the DispatcherPortlet via a ViewResolver, or null if we are using a view object.
boolean	hasView() Indicate whether or not this ModelAndView has a view, either as a view name or as a direct view instance.
boolean	isEmpty() Return whether this ModelAndView object is empty i.e. whether it does not hold any view and does not contain a model.
boolean	isReference() Return whether we use a view reference, i.e.
void	setView(Object view) Set a View object for this ModelAndView.
void	setViewName(String viewName) Set a view name for this ModelAndView, to be resolved by the DispatcherPortlet via a ViewResolver.
String	toString() Return diagnostic information about this model and view.
boolean	wasCleared() Return whether this ModelAndView object is empty as a result of a call to clear() i.e. whether it does not hold any view and does not contain a model.

Methods inherited from class java.lang.Object

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

Constructor Detail

ModelAndView

public ModelAndView()

Default constructor for bean-style usage: populating bean properties instead of passing in constructor arguments.

See Also:

setView(Object), setViewName(String)

ModelAndView

public ModelAndView(String viewName)

Convenient constructor when there is no model data to expose. Can also be used in conjunction with addObject.

Parameters:

viewName - name of the View to render, to be resolved by the DispatcherPortlet's ViewResolver

See Also:

addObject(java.lang.Object)

ModelAndView

public ModelAndView(Object view)

Convenient constructor when there is no model data to expose. Can also be used in conjunction with addObject.

Parameters:

view - View object to render (usually a Servlet MVC View object)

See Also:

addObject(java.lang.Object)

ModelAndView

public ModelAndView(String viewName,
                    Map model)

Create a new ModelAndView given a view name and a model.

Parameters:

viewName - name of the View to render, to be resolved by the DispatcherPortlet's ViewResolver

model - Map of model names (Strings) to model objects (Objects). Model entries may not be null, but the model Map may be null if there is no model data.

ModelAndView

public ModelAndView(Object view,
                    Map model)

Create a new ModelAndView given a View object and a model.

Parameters:

view - View object to render (usually a Servlet MVC View object)

model - Map of model names (Strings) to model objects (Objects). Model entries may not be null, but the model Map may be null if there is no model data.

ModelAndView

public ModelAndView(String viewName,
                    String modelName,
                    Object modelObject)

Convenient constructor to take a single model object.

Parameters:

viewName - name of the View to render, to be resolved by the DispatcherPortlet's ViewResolver

modelName - name of the single entry in the model

modelObject - the single model object

ModelAndView

public ModelAndView(Object view,
                    String modelName,
                    Object modelObject)

Convenient constructor to take a single model object.

Parameters:

view - View object to render (usually a Servlet MVC View object)

modelName - name of the single entry in the model

modelObject - the single model object

Method Detail

setViewName

public void setViewName(String viewName)

Set a view name for this ModelAndView, to be resolved by the DispatcherPortlet via a ViewResolver. Will override any pre-existing view name or View.

getViewName

public String getViewName()

Return the view name to be resolved by the DispatcherPortlet via a ViewResolver, or null if we are using a view object.

setView

public void setView(Object view)

Set a View object for this ModelAndView. Will override any pre-existing view name or View.

The given View object will usually be a Servlet MVC View object. This is nevertheless typed as Object to avoid a Servlet API dependency in the Portlet ModelAndView class.

getView

public Object getView()

Return the View object, or null if we are using a view name to be resolved by the DispatcherPortlet via a ViewResolver.

hasView

public boolean hasView()

Indicate whether or not this ModelAndView has a view, either as a view name or as a direct view instance.

isReference

public boolean isReference()

Return whether we use a view reference, i.e. true if the view has been specified via a name to be resolved by the DispatcherPortlet via a ViewResolver.

getModelInternal

protected Map getModelInternal()

Return the model map. May return null. Called by DispatcherPortlet for evaluation of the model.

getModelMap

public ModelMap getModelMap()

Return the underlying ModelMap instance (never null).

getModel

public Map getModel()

Return the model map. Never returns null. To be called by application code for modifying the model.

addObject

public ModelAndView addObject(Object modelObject)

Add an object to the model using parameter name generation.

Parameters:

modelObject - the object to add to the model (never null)

See Also:

ModelMap.addObject(Object)

addObject

public ModelAndView addObject(String modelName,
                              Object modelObject)

Add an object to the model.

Parameters:

modelName - name of the object to add to the model

modelObject - object to add to the model (never null)

Returns:

this ModelAndView, convenient to allow usages like return modelAndView.addObject("foo", bar);

addAllObjects

public ModelAndView addAllObjects(Map modelMap)

Add all entries contained in the provided map to the model.

Parameters:

modelMap - a map of modelName -> modelObject pairs

Returns:

this ModelAndView, convenient to allow usages like return modelAndView.addAllObjects(myModelMap);

clear

public void clear()

Clear the state of this ModelAndView object. The object will be empty afterwards.

Can be used to suppress rendering of a given ModelAndView object in the postHandleRender method of a HandlerInterceptor.

See Also:

isEmpty(), HandlerInterceptor.postHandleRender(javax.portlet.RenderRequest, javax.portlet.RenderResponse, java.lang.Object, org.springframework.web.portlet.ModelAndView)

isEmpty

public boolean isEmpty()

Return whether this ModelAndView object is empty i.e. whether it does not hold any view and does not contain a model.

wasCleared

public boolean wasCleared()

Return whether this ModelAndView object is empty as a result of a call to clear() i.e. whether it does not hold any view and does not contain a model. Returns false if any additional state was added to the instance after the call to clear().

See Also:

clear()

toString

public String toString()

Return diagnostic information about this model and view.

Overrides:

toString in class Object