Apache BeanUtils 官方入门文档

  Apache BeanUtils 是 Apache开源软件组织下面的一个项目,被广泛使用于Spring、Struts、Hibernate等框架,有数千个jar包依赖于它。它通过JDK中反射和自省

的功能,提供了许多实用但JDK并未直接提供的功能。我找到了官方的入门文档,用自己的语言翻译出来,希望大家指正。

  最早可能要从JavaBean说起,这个名称来源于一个针对组件架构的Java API,按照JavaBeans设计原则来编写Java类会让开发者更容易理解你的类所能提供的功能,就好像允许那些能够意

JavaBeans的工具来使用Java的内省能力来知道你的类所提供的的属性和操作。并用一种具有视觉吸引力的方式展现在开发工具上(我的理解就是,在用Eclipse或IntelliJ idea时在对象名后面按小数点后会

弹出方法列表 )。

JavaBeans规范定义了完整的特性集合来判断任意一个Java类是否是JavaBean,你应该考虑把阅读这个文档作为你Java编程技能的重要部分。部分重要特性如下:

  • 类的标志限定符必须是public,并且提供一个public的无参构造器。这将允许工具和应用来动态创建你的bean的新的实例,而不用提前知道哪一个Java类名将被使用。(关于这点,在StackOverFlow上有一个讨论,我也参与了回答)
  • 既然拥有一个无参构造器,那么配置bean的行为必须和初始化分离,这通常是通过定义一系列的属性。通过它们你可以修改bean的行为或数据。属性的命名通常是用驼峰命名法。
  • 通常,每个属性会分别有一个public的getter和setter方法来取得或是设置属性值。JavaBeans规范定义了命名惯例。
 public class Employee {
             public Employee();   // Zero-arguments constructor
             public String getFirstName();
             public void setFirstName(String firstName);
             public String getLastName();
             public void setLastName(String lastName);
             public Date getHireDate();
             public void setHireDate(Date hireDate);
             public boolean isManager();
             public void setManager(boolean manager);
             public String getFullName();
}
  • 对于boolean变量有一个例外,如果你觉得isManager比getManager更容易理解,你可以用isManager来命名

  为什么需要Apache BeanUtils?

  标准的Java语法机制让你很容易地通过getFullName()取得Employee中的FullName。例如

Employee employee = ...;
System.out.println("Hello " + employee.getFirstName() + "!");

  但是当你在更复杂的环境中,你不一定能能提前知道哪个Bean将被使用,哪个属性要取得或被修改时,你怎么办?Java语言提供了像java.beans.Introspector的类,能够在运行时检查类,并确定属性

的setter/getter方法名,再加上 Reflection 可以动态执行方法的能力 来做这样的事。但是,这些API很难用,还暴露了Java类底层很多不必要的细节。BeanUtils里的API就是设计用来在运行时简化它们,

而不是在编译的时候。

  所有JavaBean支持的属性类型可以被分为三类——一些是被JavaBean规范支持,一些是只被BeanUtils包接受。

  • Simple。只有一个可以被取得或修改的值。int,java.lang.String,或是被Java语言、其他的引用或是类库所定义的更复杂的对象。
  • Indexed。一个有下标的属性存储着一个有序的集合。
  • Mapped-作为标准JavaBean APIs的扩展,BeanUtils认为任何拥有一个java.util.Map的值的属性都是"mapped"。你可以通过一个String的key来set/get单独的值。

  下面用一个自己写的例子来入门。粘贴进编辑器直接运行。

package beanUtils;

import java.util.HashMap;
import java.util.Map;

/**
 * Created by Andrew on 2015/12/4.
 */
public class Employee {
    String firstName;
    String lastName;
    Employee[] subordinate;
    Map<String, Address> address;

    public Employee(){
        firstName = "Adnrew";
        lastName = "Chen";
        subordinate = new Employee[]{new Employee("Shirley","Liu"),new Employee("Alex","Wang")};
        address = new HashMap<>();
        address.put("home", new Address("Changsha YueLuShan"));
    }

    private Employee(String firstName,String lastName){
        this.firstName = firstName;
        this.lastName = lastName;
    }

    public Address getAddress(String type) {
        return address.get(type);
    }

    public void setAddress(String type, Address address) {
        this.address.put(type, address);
    }

    public Employee getSubordinate(int index) {
        return subordinate[index];
    }

    public void setSubordinate(int index, Employee subordinate) {
        this.subordinate[index] = subordinate;
    }

    public String getFirstName() {
        return firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }public String getLastName() {
        return this.lastName;
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
    }

    @Override
    public String toString() {
        return firstName+" "+lastName;
    }
}
package beanUtils;

import org.apache.commons.beanutils.BeanUtils;
import org.apache.commons.beanutils.PropertyUtils;

import java.lang.reflect.InvocationTargetException;

/**
 * Created by Andrew on 2015/12/4.
 */
public class BeanUtilsTest {

    public static void main(String[] args) {
        Employee employee = new Employee();
        try {

            System.out.println((String) PropertyUtils.getSimpleProperty(employee, "firstName"));
            System.out.println((String)PropertyUtils.getSimpleProperty(employee, "lastName"));
            System.out.println(PropertyUtils.getIndexedProperty(employee, "subordinate[0]"));
            System.out.println(PropertyUtils.getMappedProperty(employee, "address(home)"));
            System.out.println(PropertyUtils.getNestedProperty(employee, "address(home).city"));

        } catch (IllegalAccessException e) {
            e.printStackTrace();
        } catch (InvocationTargetException e) {
            e.printStackTrace();
        } catch (NoSuchMethodException e) {
            e.printStackTrace();
        }

    }
}

对于Simple属性,直接调用PropertyUtils.getSimpleProperty(employee, "firstName")就可以获得。

对于Indexed属性,PropertyUtils.getIndexedProperty(employee, "subordinate[0]")或是PropertyUtils.getIndexedProperty(employee, "subordinate",0)来获得。

对于Mapped属性,PropertyUtils.getMappedProperty(employee, "address(home)")PropertyUtils.getMappedProperty(employee, "address","home")来获得。

对于更复杂的嵌套属性,假设获取employee的address中key="home"的对象的city属性。我们可以用标准的写法:

String city = employee.getAddress("home").getCity();

通过PropertyUtils,你可以像JavaScript那样通过分隔符 "." 来取得嵌套的属性

String city = (String) PropertyUtils.getNestedProperty(employee, "address(home).city");

更详细的可以查看文档API

之后会更新关于动态Bean的入门。

时间: 2024-10-28 22:16:14

Apache BeanUtils 官方入门文档的相关文章

Android官方入门文档[1]创建一个Android项目

Android官方入门文档[1]创建一个Android项目 创建一个Android项目 这节课教你1.创建与Android Studio中的一个项目2.创建使用命令行工具项目 你也应该阅读?管理项目 Creating an Android Project This lesson teaches you to1.Create a Project with Android Studio2.Create a Project with Command Line Tools You should also

Android官方入门文档[17]构建灵活的UI

Android官方入门文档[17]构建灵活的UI Building a Flexible UI构建灵活的UI This lesson teaches you to1.Add a Fragment to an Activity at Runtime2.Replace One Fragment with Another You should also read?Fragments?Supporting Tablets and Handsets这节课教你1.在运行时新增一个片段给一个活动2.用另一片段

Android官方入门文档[16]创建一个Fragment代码片段

Android官方入门文档[16]创建一个Fragment代码片段 Creating a Fragment创建一个Fragment代码片段 This lesson teaches you to1.Create a Fragment Class2.Add a Fragment to an Activity using XML You should also read?Fragments 这节课教你1.创建一个Fragment代码片段类2.使用XML来添加一个Fragment代码片段给一个活动 你也

Android官方入门文档[3]构建一个简单的用户界面

Android官方入门文档[3]构建一个简单的用户界面 Building a Simple User Interface构建一个简单的用户界面 This lesson teaches you to1.Create a Linear Layout2.Add a Text Field3.Add String Resources4.Add a Button5.Make the Input Box Fill in the Screen Width You should also read?Layouts

Android官方入门文档[10]支持不同的屏幕

Android官方入门文档[10]支持不同的屏幕 Supporting Different Screens支持不同的屏幕 This lesson teaches you to1.Create Different Layouts2.Create Different Bitmaps You should also read?Designing for Multiple Screens?Providing Resources?Iconography design guide 这节课教你1.创建不同的布

Android官方入门文档[2]运行你的应用程序

Android官方入门文档[2]运行你的应用程序 Running Your App运行你的应用程序 This lesson teaches you to1.Run on a Real Device2.Run on the Emulator You should also read?Using Hardware Devices?Managing AVDs with AVD Manager?Managing Projects 这节课教你1.运行在真实设备2.运行在模拟器 你也应该阅读?使用硬件设备?

Android官方入门文档[6]添加Action按钮

Android官方入门文档[6]添加Action按钮 Adding Action Buttons添加Action按钮 This lesson teaches you to1.Specify the Actions in XML2.Add the Actions to the Action Bar3.Respond to Action Buttons4.Add Up Button for Low-level Activities You should also read?Providing Up

Android官方入门文档[18]与其他碎片通信

Android官方入门文档[18]与其他碎片通信 Communicating with Other Fragments与其他碎片通信 This lesson teaches you to1.Define an Interface2.Implement the Interface3.Deliver a Message to a Fragment You should also read?Fragments 这节课教你1.定义一个接口2.实现接口3.传递一个消息给一个代码片段 你也应该阅读?片段 T

Android官方入门文档[8]重叠操作栏

Android官方入门文档[8]重叠操作栏 Overlaying the Action Bar重叠操作栏 This lesson teaches you to1.Enable Overlay Mode 1.For Android 3.0 and higher only 2.For Android 2.1 and higher 2.Specify Layout Top-margin You should also read?Styles and Themes 这节课教你1.启用重叠模式 1.对An