BeanUtils开发包的使用
对内省技术有了一定的了解之后,我们就可以来学习一下BeanUtils开发包的使用了。
我们先假设一个情景,有一个JSP文件,如果要将该JSP文件中表单数据封装到Servlet文件应该怎么办?此时<jsp:setProperty property="*"/>方法显然就不奏效了,因为它是JSP文件特有的动作指令。当然,在ServletRqeuest接口中存在方法getParameterMap(),所以可以通过该方法得到表单数据的Map集合,然后利用内省技术将Map集合中的数据保存到bean对象对应的属性中去。
显然这是很麻烦的一件事情,但是也不用担心,Apache组织开发了一套用于操作JavaBean的API,此时,就引出了我们今天的主题,BeanUtils开发包,它考虑到了很多实际开发中的应用场景,当然也就包括我上面提到的情景,那么BeanUtils该如何使用呢?
首先要下载BeanUtils的jar包,Apache公司的很多项目都是有相互的依赖的,所以这时候需要下载两个jar包,1、commons-beanutils 2、commons-logging
beanutils依赖于logging的jar包。
下载好了压缩包后,解压就会得到两个压缩包,分别解压开。
将红色方框内的两个jar包复制到项目中去,接下来通过一个案例来入门使用一下BeanUtils开发包。
创建一个Person类
public class Person {
private String name;
private String city;
private String hobby;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getCity() {
return city;
}
public void setCity(String city) {
this.city = city;
}
public String getHobby() {
return hobby;
}
public void setHobby(String hobby) {
this.hobby = hobby;
}
}
接下来新建demo.jsp文件
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<!-- 使用BeanUtils 将 form参数封装到JavaBean 对象中 -->
<form action="/demo/demoservlet" method="post">
姓名:<input type="text" name="name"><br>
城市:<input type="text" name="city"><br>
爱好:<input type="text" name="hobby"><br>
<input type="submit" value="提交">
</form>
</body>
</html>
然后创建DemoServlet.java文件
public class DemoServlet extends HttpServlet {
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
request.setCharacterEncoding("utf-8");//处理乱码
//将form参数自动封装到Person对象
Person person = new Person();
try {
BeanUtils.populate(person, request.getParameterMap());
} catch (IllegalAccessException e) {
e.printStackTrace();
} catch (InvocationTargetException e) {
e.printStackTrace();
}
System.out.println(person.getName());
System.out.println(person.getCity());
System.out.println(person.getHobby());
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
运行一下该项目,对表单进行如下输入
点击提交,控制台输出如下信息
由此可以得知,表单中的数据被正确地保存到了bean对象中。该工具包的功能远不止如此,我们改进一下该案例
将Person类作如下修改
public class Person {
private String name;
private String city;
private String hobby;
//添加age属性
private int age;
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getCity() {
return city;
}
public void setCity(String city) {
this.city = city;
}
public String getHobby() {
return hobby;
}
public void setHobby(String hobby) {
this.hobby = hobby;
}
}
将demo.jsp作如下修改
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<!-- 使用BeanUtils 将 form参数封装到JavaBean 对象中 -->
<form action="/demo/demoservlet" method="post">
姓名:<input type="text" name="name"><br>
城市:<input type="text" name="city"><br>
爱好:<input type="text" name="hobby"><br>
<!-- 增加年龄输入框 -->
年龄:<input type="text" name="age"><br>
<input type="submit" value="提交">
</form>
</body>
</html>
对DemoServlet.java文件作如下修改
public class DemoServlet extends HttpServlet {
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
request.setCharacterEncoding("utf-8");//处理乱码
//将form参数自动封装到Person对象
Person person = new Person();
try {
BeanUtils.populate(person, request.getParameterMap());
} catch (IllegalAccessException e) {
e.printStackTrace();
} catch (InvocationTargetException e) {
e.printStackTrace();
}
System.out.println(person.getName());
System.out.println(person.getCity());
System.out.println(person.getHobby());
//打印person对象的age属性值
System.out.println(person.getAge());
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
重新运行一遍程序,对表单进行输入
控制台输出信息为
会发现,即使Person类中存在数据类型不相同的属性(即使在表单中输入的年龄数据类型为String,却依然可以存放入属性类型为int的属性age中),工具类仍然可以处理并且传递,是不是很good呢?
继续升华一下我们的项目,在Person类中添加一个类型为Date的属性birthday,并在demo.jsp文件中添加输入生日的文本框,最后在DemoServlet.java文件中添加输出birthday属性的代码。
对改进后的表单进行如下输入
点击提交按钮后,网页报错了
报错说明日期格式写错了,但是日期格式到底如何输入呢?到这里,就必须得明白封装的原理,不然,接下来的代码编写将无法进行。
我们打开commons-beanutils文件夹,在apidocs目录下有一个index.html文件,打开它,这就是工具包的文档
点击红色方框进入查看,也许你一瞬间就明白了,里面有各种数据格式的转换器,所以为什么String类型的age能够转换为int类型存入对象中,相信你一定明白了,它是通过IntegerConverter转换器实现类型转换的。
默认情况下,form表单中的String类型参数会封装到JavaBean中的String类型属性
当JavaBean中属性类型与form表单提交的参数类型不一致时,就需要类型转换器。
现在的目的就是将String类型的日期转换为Date类型的日期。
会发现,在org.apache.commons.beanutils.converters包下虽然有DateConverter日期转换器,但是文档并没有详细说明它的用法和输入日期的格式,既然如此,我们只能自定义一个日期转换器来实现我们的目的。
通过文档可以知道,所有的转换器都实现了Converter接口,所以我们自定义转换器也需要实现该接口。
编写内部类MyDateConverter类并实现接口
class MyDateConverter implements Converter{
//需要将value数据转换为c的类型
public Object convert(Class c, Object value) {
String s = (String) value;//value代表的是用户输入的生日
DateFormat dateFormat = new SimpleDateFormat("yyyy年MM月dd日");
try {
Object result = dateFormat.parseObject(s);//将String解析为Date
} catch (ParseException e) {
e.printStackTrace();
}
return null;
}
}
此时,自定义的日期转换器就编写完成了,然后,在调用populate方法前,应该注册转换器,所以整体DemoServlet.java文件作如下修改
public class DemoServlet extends HttpServlet {
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
request.setCharacterEncoding("utf-8");//处理乱码
//将form参数自动封装到Person对象
Person person = new Person();
//在封装数据之前,注册转换器
ConvertUtils.register(new MyDateConverter(), Date.class);//第二个参数为想要转换的数据类型
try {
BeanUtils.populate(person, request.getParameterMap());
} catch (IllegalAccessException e) {
e.printStackTrace();
} catch (InvocationTargetException e) {
e.printStackTrace();
}
System.out.println(person.getName());
System.out.println(person.getCity());
System.out.println(person.getHobby());
System.out.println(person.getAge());
System.out.println(person.getBirtyday());
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
class MyDateConverter implements Converter{
//需要将value数据转换为c的类型
public Object convert(Class c, Object value) {
String s = (String) value;//value代表的是用户输入的生日
DateFormat dateFormat = new SimpleDateFormat("yyyy年MM月dd日");
try {
Object result = dateFormat.parseObject(s);//将String解析为Date
return result;
} catch (ParseException e) {
e.printStackTrace();
}
return null;
}
}
}
对表单进行输入
控制台输出如下
由此说明,自定义的日期转换器实现了日期转换,我们的目的已经达到。