diff --git a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/CollectionTypeDescriptor.java b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/CollectionTypeDescriptor.java index a9ba2bb25cc..eb9f11c844e 100644 --- a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/CollectionTypeDescriptor.java +++ b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/CollectionTypeDescriptor.java @@ -18,6 +18,11 @@ package org.springframework.ui.binding.support; import org.springframework.util.Assert; import org.springframework.util.ObjectUtils; +/** + * A type descriptor for a parameterizable collection type such as a java.util.List<?>. + * @author Keith Donald + * @since 3.0 + */ public class CollectionTypeDescriptor { private Class type; @@ -38,7 +43,7 @@ public class CollectionTypeDescriptor { } /** - * The element type. + * The parameterized collection element type. */ public Class getElementType() { return elementType; diff --git a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultFieldModel.java b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultFieldModel.java index e79e85ebcc4..5a0a8f30001 100644 --- a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultFieldModel.java +++ b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultFieldModel.java @@ -41,6 +41,11 @@ import org.springframework.ui.format.Formatter; import org.springframework.ui.message.MessageBuilder; import org.springframework.ui.message.ResolvableArgument; +/** + * Default FieldModel implementation suitable for use in most environments. + * @author Keith Donald + * @since 3.0 + */ public class DefaultFieldModel implements FieldModel { private ValueModel valueModel; diff --git a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModel.java b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModel.java index 998f0c254c0..b2dea844896 100644 --- a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModel.java +++ b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModel.java @@ -32,20 +32,19 @@ import org.springframework.core.convert.support.DefaultTypeConverter; import org.springframework.ui.binding.FieldModel; import org.springframework.ui.binding.FieldNotFoundException; import org.springframework.ui.binding.PresentationModel; -import org.springframework.ui.binding.binder.Binder; -import org.springframework.ui.binding.config.FieldModelConfiguration; import org.springframework.ui.binding.config.Condition; +import org.springframework.ui.binding.config.FieldModelConfiguration; import org.springframework.ui.format.Formatter; import org.springframework.util.Assert; /** - * A generic {@link Binder binder} suitable for use in most environments. + * A default PresentationModel implementation suitable for use in most environments. * @author Keith Donald * @since 3.0 * @see #setFormatterRegistry(FormatterRegistry) * @see #setMessageSource(MessageSource) * @see #setTypeConverter(TypeConverter) - * @see #bind(Map) + * @see #field(String) */ public class DefaultPresentationModel implements PresentationModel { @@ -103,9 +102,9 @@ public class DefaultPresentationModel implements PresentationModel { } /** - * Add a a new FieldModelRule for the property at the path specified. - * @param propertyPath binding rule property path in format prop.nestedProp - * @return a builder for the binding rule + * Add a FieldModel rule at the domain object property path. + * @param propertyPath the domain object property path in format <prop>[.nestedProp] + * @return a builder for the field model configuration */ public FieldModelConfiguration field(String propertyPath) { FieldPath path = new FieldPath(propertyPath); @@ -116,6 +115,9 @@ public class DefaultPresentationModel implements PresentationModel { return rule; } + /** + * The domain-layer model this presentation model coordinates with. + */ public Object getDomainModel() { return domainModel; } diff --git a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModelFactory.java b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModelFactory.java index de4dd5fb8c0..c4bc1901d9a 100644 --- a/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModelFactory.java +++ b/org.springframework.context/src/main/java/org/springframework/ui/binding/support/DefaultPresentationModelFactory.java @@ -22,8 +22,9 @@ import org.springframework.ui.binding.PresentationModel; import org.springframework.ui.binding.PresentationModelFactory; /** - * BindingFactoryLocator implementation that uses a {@link IdentityHashMap} to map models to BindingFactories. + * Default PresentationModelFactory implementation that uses a {@link IdentityHashMap} to map domain models to PresentationModels. * @author Keith Donald + * @since 3.0 */ public class DefaultPresentationModelFactory implements PresentationModelFactory {