XmlViewResolver (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.view
Class XmlViewResolver

java.lang.Object
  org.springframework.context.support.ApplicationObjectSupport
      org.springframework.web.context.support.WebApplicationObjectSupport
          org.springframework.web.servlet.view.AbstractCachingViewResolver
              org.springframework.web.servlet.view.XmlViewResolver

All Implemented Interfaces:: DisposableBean, ApplicationContextAware, Ordered, ViewResolver

public class XmlViewResolver
extends AbstractCachingViewResolver
implements Ordered, DisposableBean
extends AbstractCachingViewResolver
implements Ordered, DisposableBean

Implementation of ViewResolver that uses bean definitions in an XML file, specified by resource location. The file will typically be located in the WEB-INF directory; default is "/WEB-INF/views.xml".

This ViewResolver does not support internationalization. Consider ResourceBundleViewResolver if you need to apply different view resources per locale.

Note: This ViewResolver implements the Ordered interface to allow for flexible participation in ViewResolver chaining. For example, some special views could be defined via this ViewResolver (giving it 0 as "order" value), while all remaining views could be resolved by a UrlBasedViewResolver.

Since:: 18.06.2003
Author:: Juergen Hoeller
See Also:: ResourceLoader.getResource(java.lang.String), ResourceBundleViewResolver, UrlBasedViewResolver

Field Summary

static String DEFAULT_LOCATION
          Default if no other location is supplied

Fields inherited from class org.springframework.context.support.ApplicationObjectSupport

logger

Constructor Summary

XmlViewResolver()


Method Summary

void destroy()
          Close the view bean factory on context shutdown.

protected String getCacheKey(String viewName, Locale locale)
          This implementation returns just the view name, as XmlViewResolver doesn't support localized resolution.

int getOrder()
          Return the order value of this object, higher value meaning greater in terms of sorting.

protected void initApplicationContext()
          Pre-initialize the factory from the XML file.

protected BeanFactory initFactory()
          Initialize the view bean factory from the XML file.

protected View loadView(String viewName, Locale locale)
          Subclasses must implement this method.

void setLocation(Resource location)
          Set the location of the XML file that defines the view beans.

void setOrder(int order)


Methods inherited from class org.springframework.web.servlet.view.AbstractCachingViewResolver

clearCache, createView, isCache, removeFromCache, resolveViewName, setCache

Methods inherited from class org.springframework.web.context.support.WebApplicationObjectSupport

getServletContext, getTempDir, getWebApplicationContext, isContextRequired

Methods inherited from class org.springframework.context.support.ApplicationObjectSupport

getApplicationContext, getMessageSourceAccessor, requiredContextClass, setApplicationContext

Methods inherited from class java.lang.Object

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

Field Summary
`static String`	`DEFAULT_LOCATION` Default if no other location is supplied

Fields inherited from class org.springframework.context.support.ApplicationObjectSupport
`logger`

Constructor Summary
`XmlViewResolver()`

Method Summary
`void`	`destroy()` Close the view bean factory on context shutdown.
`protected String`	`getCacheKey(String viewName, Locale locale)` This implementation returns just the view name, as XmlViewResolver doesn't support localized resolution.
`int`	`getOrder()` Return the order value of this object, higher value meaning greater in terms of sorting.
`protected void`	`initApplicationContext()` Pre-initialize the factory from the XML file.
`protected BeanFactory`	`initFactory()` Initialize the view bean factory from the XML file.
`protected View`	`loadView(String viewName, Locale locale)` Subclasses must implement this method.
`void`	`setLocation(Resource location)` Set the location of the XML file that defines the view beans.
`void`	`setOrder(int order)`

Methods inherited from class org.springframework.web.servlet.view.AbstractCachingViewResolver
`clearCache, createView, isCache, removeFromCache, resolveViewName, setCache`

Methods inherited from class org.springframework.web.context.support.WebApplicationObjectSupport
`getServletContext, getTempDir, getWebApplicationContext, isContextRequired`

Methods inherited from class org.springframework.context.support.ApplicationObjectSupport
`getApplicationContext, getMessageSourceAccessor, requiredContextClass, setApplicationContext`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

DEFAULT_LOCATION

public static final String DEFAULT_LOCATION

Default if no other location is supplied

See Also:: Constant Field Values

Constructor Detail

XmlViewResolver

public XmlViewResolver()

Method Detail

setOrder

public void setOrder(int order)

getOrder

public int getOrder()

Description copied from interface: Ordered

Return the order value of this object, higher value meaning greater in terms of sorting. Normally starting with 0 or 1, Integer.MAX_VALUE indicating greatest. Same order values will result in arbitrary positions for the affected objects.

Higher value can be interpreted as lower priority, consequently the first object has highest priority (somewhat analogous to Servlet "load-on-startup" values).

Specified by:: getOrder in interface Ordered

Returns:: the order value

setLocation

public void setLocation(Resource location)

Set the location of the XML file that defines the view beans.

The default is "/WEB-INF/views.xml".

Parameters:: location - the location of the XML file.

initApplicationContext

protected void initApplicationContext()
                               throws BeansException

Pre-initialize the factory from the XML file. Only effective if caching is enabled.

Overrides:: initApplicationContext in class ApplicationObjectSupport

Throws:: ApplicationContextException - in case of initialization errors; BeansException - if thrown by ApplicationContext methods
See Also:: ApplicationObjectSupport.setApplicationContext(org.springframework.context.ApplicationContext)

getCacheKey

protected String getCacheKey(String viewName,
                             Locale locale)

This implementation returns just the view name, as XmlViewResolver doesn't support localized resolution.

Overrides:: getCacheKey in class AbstractCachingViewResolver

loadView

protected View loadView(String viewName,
                        Locale locale)
                 throws BeansException

Description copied from class: AbstractCachingViewResolver

Subclasses must implement this method. There need be no concern for efficiency, as this class will cache views.

Not all subclasses may support internationalization: A subclass that doesn't can simply ignore the locale parameter.

NOTE: As of Spring 1.2, subclasses are supposed to fully initialize the View objects before returning them, also applying bean container initialization callbacks.

Specified by:: loadView in class AbstractCachingViewResolver

Parameters:: viewName - the name of the view to retrieve; locale - the Locale to retrieve the view for
Returns:: the View instance, or null if not found (optional, to allow for ViewResolver chaining)
Throws:: BeansException
See Also:: AbstractCachingViewResolver.resolveViewName(java.lang.String, java.util.Locale)

initFactory

protected BeanFactory initFactory()
                           throws BeansException

Initialize the view bean factory from the XML file. Synchronized because of access by parallel threads.

Throws:: BeansException - in case of initialization errors

destroy

public void destroy()
             throws BeansException

Close the view bean factory on context shutdown.

Specified by:: destroy in interface DisposableBean

Throws:: BeansException