org.meanbean.bean.util

Interface BeanPopulator

All Known Implementing Classes:

BasicBeanPopulator

public interface BeanPopulator

Defines an object that affords functionality to populate a bean (set its fields) with specified values.

Author:

Graham Williamson

Method Summary

Modifier and Type	Method and Description
void	populate(Object bean, BeanInformation beanInformation, Map<String,Object> values) Populate the specified bean with the specified values.

Method Detail

populate

void populate(Object bean,
              BeanInformation beanInformation,
              Map<String,Object> values)
       throws IllegalArgumentException,
              BeanPopulationException

Populate the specified bean with the specified values. Values are keyed by property name (e.g. "firstName") and are matched to properties on the bean and their setters (e.g. "setFirstName"). Only properties with a setter method and an entry in the values map will be set. Any entries in the values map that do not exist on the bean are ignored.

Parameters:

bean - The object to populate.

beanInformation - Information about the object to populate.

values - The values to populate the object with, keyed by property name (e.g. "firstName").

Throws:

IllegalArgumentException - If any of the parameters are deemed illegal. For example, if any are null.

BeanPopulationException - If an error occurs when populating the object.