BeanUtils开发包的使用
- 2020 年 2 月 14 日
- 筆記
对内省技术有了一定的了解之后，我们就可以来学习一下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包。 大家可以下载我上传的压缩包,点击下载，不过新版本的CSDN好像改不了下载积分了，本来是想免费分享的，系统默认设置为了5积分下载，没有积分的小伙伴也可以自己去官网下载或者百度下载。 下载好了压缩包后，解压就会得到两个压缩包，分别解压开。
将红色方框内的两个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; } } }
对表单进行输入
控制台输出如下
由此说明，自定义的日期转换器实现了日期转换，我们的目的已经达到。
