org.springframework.core.convert Documentation Differences

This file contains all the changes in documentation in the package org.springframework.core.convert as colored differences. Deletions are shown like this, and additions are shown like this.

If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.

Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Creates a new conversion executor not found exception. @param sourceType the source type requested to convert from @param targetType the target type requested to convert to @param message a descriptive messageto

Create a new type descriptor from a MethodParameter. Use this constructor when a source or target conversion point is a constructor parameter, method parameter, or method return value. @param methodParameter the method parameter

If this type is a Collection or an Array, creates a element TypeDescriptor from the provided collection or array element. Narrows the elementType property to the class of the provided collection or array element. For example, if this describes a java.util.List<java.lang.Number< and the element argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer. If this describes a java.util.List<?> and the element argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer as well. Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. @param element the collection or array element @return a element type descriptor, narrowed to the type of the provided element @throws IllegalStateException if this type is not a java.util.Collection or Array type @see #narrow(Object)

Create a new type descriptor for an object. Use this factory method to introspect a source object before asking the conversion system to convert it to some another type. If the provided object is null, returns null, else calls .valueOf(Class) to build a TypeDescriptor from the object's class. @param objectsource the source object @return the type descriptor

If this type is a Map, creates a mapKey TypeDescriptor from the provided map key. Narrows the mapKeyType property to the class of the provided map key. For example, if this describes a java.util.Map<java.lang.Number, java.lang.String< and the key argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer. If this describes a java.util.Map<?, ?> and the key argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer as well. Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. @param mapKey the map key @return the map key type descriptor @throws IllegalStateException if this type is not a java.util.Map. @see #narrow(Object)

If this type is a Map, creates a mapValue TypeDescriptor from the provided map value. Narrows the mapValueType property to the class of the provided map value. For example, if this describes a java.util.Map<java.lang.String, java.lang.Number< and the value argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer. If this describes a java.util.Map<?, ?> and the value argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer as well. Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. @param mapValue the map value @return the map value type descriptor @throws IllegalStateException if this type is not a java.util.Map.

Returns true if an object of this type descriptor can be assigned to the location described by the given type descriptor. For example, valueOf(String.class).isAssignableTo(valueOf(CharSequence.class)) returns true because a String value can be assigned to a CharSequence variable. On the other hand, valueOf(Number.class).isAssignableTo(valueOf(Integer.class)) returns false because, while all Integers are Numbers, not all Numbers are Integers.

For arrays, collections, and maps, element and key/value types are checked if declared. For example, a List<String> field value is assignable to a Collection<CharSequence> field, but List<Number> is not assignable to List<Integer>. @return true if this type is assignable to the type represented by the provided type descriptor. @see #getObjectType()