站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > Spring Framework 2.1.0 API 文档英文版

TypeConverter (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版


The Spring Framework

org.springframework.beans
Interface TypeConverter

All Known Subinterfaces:
BeanWrapper
All Known Implementing Classes:
BeanWrapperImpl, SimpleTypeConverter

public interface TypeConverter

Interface that defines type conversion methods. Typically (but not necessarily) implemented in conjunction with the PropertyEditorRegistry interface.

Since:
2.0
Author:
Juergen Hoeller
See Also:
PropertyEditorRegistry, SimpleTypeConverter, BeanWrapperImpl

Method Summary
 Object convertIfNecessary(Object value, Class requiredType)
          Convert the value to the required type (if necessary from a String).
 Object convertIfNecessary(Object value, Class requiredType, MethodParameter methodParam)
          Convert the value to the required type (if necessary from a String).
 

Method Detail

convertIfNecessary

Object convertIfNecessary(Object value,
                          Class requiredType)
                          throws TypeMismatchException
Convert the value to the required type (if necessary from a String).

Conversions from String to any type will typically use the setAsText method of the PropertyEditor class. Note that a PropertyEditor must be registered for the given class for this to work; this is a standard JavaBeans API. A number of PropertyEditors are automatically registered.

Parameters:
value - the value to convert
requiredType - the type we must convert to (or null if not known, for example in case of a collection element)
Returns:
the new value, possibly the result of type conversion
Throws:
TypeMismatchException - if type conversion failed
See Also:
PropertyEditor.setAsText(String), PropertyEditor.getValue()

convertIfNecessary

Object convertIfNecessary(Object value,
                          Class requiredType,
                          MethodParameter methodParam)
                          throws TypeMismatchException
Convert the value to the required type (if necessary from a String).

Conversions from String to any type will typically use the setAsText method of the PropertyEditor class. Note that a PropertyEditor must be registered for the given class for this to work; this is a standard JavaBeans API. A number of PropertyEditors are automatically registered.

Parameters:
value - the value to convert
requiredType - the type we must convert to (or null if not known, for example in case of a collection element)
methodParam - the method parameter that is the target of the conversion (for analysis of generic types; may be null)
Returns:
the new value, possibly the result of type conversion
Throws:
TypeMismatchException - if type conversion failed
See Also:
PropertyEditor.setAsText(String), PropertyEditor.getValue()

The Spring Framework

Copyright © 2002-2007 The Spring Framework.