ModelAndView (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.web.servlet
Class ModelAndView

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

public class ModelAndView
extends Object
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.

Class to represent a model and view returned by a handler used by a DispatcherServlet. The view can take the form of a reference to a View object, or a String view name which will need to be resolved by a ViewResolver object. The model is a Map, allowing the use of multiple data objects keyed by name.

Author:: Rod Johnson, Juergen Hoeller
See Also:: DispatcherServlet, ViewResolver, HandlerAdapter.handle(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.lang.Object), Controller.handleRequest(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)

Constructor Summary

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

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

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

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

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

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

ModelAndView(View view, 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(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.

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

String getViewName()
          Return the view name to be resolved by the DispatcherServlet via a ViewResolver, or null if we are using a View object.

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. true if the view has been specified via a name to be resolved by the DispatcherServlet via a ViewResolver.

void setView(View view)
          Set a View object for this ModelAndView.

void setViewName(String viewName)
          Set a view name for this ModelAndView, to be resolved by the DispatcherServlet via a ViewResolver.

String toString()
          Return diagnostic information about this model and view.

Methods inherited from class java.lang.Object

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

Constructor Summary
`ModelAndView()` Default constructor for bean-style usage: populating bean properties instead of passing in constructor arguments.
`ModelAndView(String viewName)` Convenient constructor when there is no model data to expose.
`ModelAndView(String viewName, Map model)` Creates new ModelAndView given a view name and a model.
`ModelAndView(String viewName, String modelName, Object modelObject)` Convenient constructor to take a single model object.
`ModelAndView(View view)` Convenient constructor when there is no model data to expose.
`ModelAndView(View view, Map model)` Creates new ModelAndView given a View object and a model.
`ModelAndView(View view, 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(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.
`View`	`getView()` Return the View object, or `null` if we are using a view name to be resolved by the DispatcherServlet via a ViewResolver.
`String`	`getViewName()` Return the view name to be resolved by the DispatcherServlet via a ViewResolver, or `null` if we are using a View object.
`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. true if the view has been specified via a name to be resolved by the DispatcherServlet via a ViewResolver.
`void`	`setView(View view)` Set a View object for this ModelAndView.
`void`	`setViewName(String viewName)` Set a view name for this ModelAndView, to be resolved by the DispatcherServlet via a ViewResolver.
`String`	`toString()` Return diagnostic information about this model and view.

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(View), setViewName(String)

ModelAndView

public ModelAndView(View 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
See Also:: addObject(java.lang.String, java.lang.Object)

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 DispatcherServlet
See Also:: addObject(java.lang.String, java.lang.Object)

ModelAndView

public ModelAndView(View view,
                    Map model)

Creates new ModelAndView given a View object and a model.

Parameters:: view - View object to render; 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,
                    Map model)

Creates new ModelAndView given a view name and a model.

Parameters:: viewName - name of the View to render, to be resolved by the DispatcherServlet; 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(View view,
                    String modelName,
                    Object modelObject)

Convenient constructor to take a single model object.

Parameters:: view - View object to render; modelName - name of the single entry in the model; modelObject - the single model object

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 DispatcherServlet; modelName - name of the single entry in the model; modelObject - the single model object

Method Detail

setView

public void setView(View view)

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

getView

public View getView()

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

setViewName

public void setViewName(String viewName)

Set a view name for this ModelAndView, to be resolved by the DispatcherServlet 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 DispatcherServlet via a ViewResolver, or null if we are using a View object.

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 DispatcherServlet via a ViewResolver.

getModelInternal

protected Map getModelInternal()

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

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(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. May not be 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 postHandle method of a HandlerInterceptor.

See Also:: isEmpty(), HandlerInterceptor.postHandle(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.lang.Object, org.springframework.web.servlet.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.

See Also:: clear()

toString

public String toString()

Return diagnostic information about this model and view.

Overrides:: toString in class Object

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

ModelAndView (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

org.springframework.web.servlet Class ModelAndView

ModelAndView

ModelAndView

ModelAndView

ModelAndView

ModelAndView

ModelAndView

ModelAndView

setView

getView

setViewName

getViewName

isReference

getModelInternal

getModel

addObject

addAllObjects

clear

isEmpty

toString

org.springframework.web.servlet
Class ModelAndView