package com.vaadin.data.util;
// 用到了 java.beans 的一些工具，可以学习一下。
import java.beans.BeanInfo;
import java.beans.Introspector;
import java.beans.PropertyDescriptor;
/** 正如源文件注释所说，这个 Item 是为了任何普通的 pojo / java bean 准备的。
*/
public class BeanItem extends PropertysetItem {
/** 就是那个 bean */
private final Object bean;
/** 这个初始化方法用 bean 的所有的 property 来生成 Item。property 是用名字来识别的。
* 这个版本仅仅支持 introspectable bean properties（就是说 java introspection 可以发现的，
* 是吗？），只支持 getter/setter，单独的 is / are 方法不支持。
*
* 看 getPropertyDescriptors 怎样得到 property 吧。
*/
public BeanItem(Object bean) {
this(bean, getPropertyDescriptors(bean.getClass()));
}
/** 这个方法用已经准备好的 propertyDescriptors 来初始化。这个可不是公开的初始化方法，内部使用的。
*/
BeanItem(Object bean,
LinkedHashMap<String, PropertyDescriptor> propertyDescriptors) {
// 总之，调用 addItemProperty。看那里吧。
}
/** 用一系列指定的 property 名字来初始化，更灵活一些。 */
public BeanItem(Object bean, Collection<?> propertyIds) {
// 总之还是调用 getPropertyDescriptors 得到一系列的 PropertyDescriptor，然后按照给出的 id 顺次 addItemProperty(name, p)
}
// 另一个版本
public BeanItem(Object bean, String[] propertyIds) {
this(bean, Arrays.asList(propertyIds));
}
/** 这个是检查 bean 得到一系列 property descriptor 的地方 */
static LinkedHashMap<String, PropertyDescriptor> getPropertyDescriptors(
final Class<?> beanClass) {
// 以下利用了 java 提供的方法。注意，这里不是全部代码，只是我感兴趣的地方
try {
final BeanInfo info = Introspector.getBeanInfo(beanClass);
final PropertyDescriptor[] pds = info.getPropertyDescriptors();
// 把全部不是 Object 的get方法加入到 map 中
for (int i = 0; i < pds.length; i++) {
final Method getMethod = pds[i].getReadMethod();
if ((getMethod != null)
&& getMethod.getDeclaringClass() != Object.class) {
pdMap.put(pds[i].getName(), pds[i]);
}
}
} catch (final java.beans.IntrospectionException ignored) {
}
return pdMap;
}
/** 还用说吗？ */
public Object getBean() {
return bean;
}
}