接口 MessageSource
- 所有已知子接口:
ApplicationContext,ConfigurableApplicationContext,ConfigurablePortletApplicationContext,ConfigurableWebApplicationContext,HierarchicalMessageSource,WebApplicationContext
- 所有已知实现类:
AbstractApplicationContext,AbstractMessageSource,AbstractRefreshableApplicationContext,AbstractRefreshableConfigApplicationContext,AbstractRefreshablePortletApplicationContext,AbstractRefreshableWebApplicationContext,AbstractResourceBasedMessageSource,AbstractXmlApplicationContext,AnnotationConfigApplicationContext,AnnotationConfigWebApplicationContext,ClassPathXmlApplicationContext,DelegatingMessageSource,FileSystemXmlApplicationContext,GenericApplicationContext,GenericGroovyApplicationContext,GenericWebApplicationContext,GenericXmlApplicationContext,GroovyWebApplicationContext,ReloadableResourceBundleMessageSource,ResourceAdapterApplicationContext,ResourceBundleMessageSource,StaticApplicationContext,StaticMessageSource,StaticPortletApplicationContext,StaticWebApplicationContext,XmlPortletApplicationContext,XmlWebApplicationContext
public interface MessageSource
Strategy interface for resolving messages, with support for the parameterization and internationalization of such messages.Spring provides two out-of-the-box implementations for production:
ResourceBundleMessageSource: built on top of the standardResourceBundle, sharing its limitations.ReloadableResourceBundleMessageSource: highly configurable, in particular with respect to reloading message definitions.
- 作者:
- Rod Johnson, Juergen Hoeller
- 另请参阅:
ResourceBundleMessageSource,ReloadableResourceBundleMessageSource
方法概要
所有方法 实例方法 抽象方法 修饰符和类型 方法 说明 StringgetMessage(String code, Object[] args, String defaultMessage, Locale locale)Try to resolve the message.StringgetMessage(String code, Object[] args, Locale locale)Try to resolve the message.StringgetMessage(MessageSourceResolvable resolvable, Locale locale)Try to resolve the message using all the attributes contained within theMessageSourceResolvableargument that was passed in.
方法详细资料
getMessage
String getMessage(String code, Object[] args, String defaultMessage, Locale locale)
Try to resolve the message. Return default message if no message was found.- 参数:
code- the message code to look up, e.g. 'calculator.noRateSet'. MessageSource users are encouraged to base message names on qualified class or package names, avoiding potential conflicts and ensuring maximum clarity.args- an array of arguments that will be filled in for params within the message (params look like "{0}", "{1,date}", "{2,time}" within a message), ornullif nonedefaultMessage- a default message to return if the lookup failslocale- the locale in which to do the lookup- 返回:
- the resolved message if the lookup was successful, otherwise the default message passed as a parameter (which may be
null) - 另请参阅:
getMessage(MessageSourceResolvable, Locale),MessageFormat
getMessage
String getMessage(String code, Object[] args, Locale locale) throws NoSuchMessageException
Try to resolve the message. Treat as an error if the message can't be found.- 参数:
code- the message code to look up, e.g. 'calculator.noRateSet'. MessageSource users are encouraged to base message names on qualified class or package names, avoiding potential conflicts and ensuring maximum clarity.args- an array of arguments that will be filled in for params within the message (params look like "{0}", "{1,date}", "{2,time}" within a message), ornullif nonelocale- the locale in which to do the lookup- 返回:
- the resolved message (never
null) - 抛出:
NoSuchMessageException- if no corresponding message was found- 另请参阅:
getMessage(MessageSourceResolvable, Locale),MessageFormat
getMessage
String getMessage(MessageSourceResolvable resolvable, Locale locale) throws NoSuchMessageException
Try to resolve the message using all the attributes contained within theMessageSourceResolvableargument that was passed in.NOTE: We must throw a
NoSuchMessageExceptionon this method since at the time of calling this method we aren't able to determine if thedefaultMessageproperty of the resolvable isnullor not.- 参数:
resolvable- the value object storing attributes required to resolve a message (may include a default message)locale- the locale in which to do the lookup- 返回:
- the resolved message (never
nullsince even aMessageSourceResolvable-provided default message needs to be non-null) - 抛出:
NoSuchMessageException- if no corresponding message was found (and no default message was provided by theMessageSourceResolvable)- 另请参阅:
MessageSourceResolvable.getCodes(),MessageSourceResolvable.getArguments(),MessageSourceResolvable.getDefaultMessage(),MessageFormat