我们可以通过如下的声明，控制控件在调用后返回一个Map(或者HashMap)对象:

　　@SQL(statement = “select id,name,value from demo where id={demoId}”)
public HashMap getDemoById(int demoId) ;

　　在业务方法声明为返回单条记录时，如果该记录的对应字段为空，那么返回结果的对应字段将根据对应属性的类型被初始化null、0或者false，如果SQL语句实际执行时没有找到符合条件的记录，控件的默认返回结果为null，如果SQL语句实际执行时返回了多条记录，那么控件将默认将符合条件的第一条记录作为返回结果。

　　使用控件返回多条记录

　　SQL查询语句的返回结果通常是一个以上的记录，JDBC控件支持使用数组、Iterator对象、ResultSet对象和XMLBeans对象来返回可能的多条记录。控件开发者需要根据不同的情况选择合适的返回对象，既要考虑让控件使用者操作简单，也要考虑可能引起的其他问题。

　　使用数组返回多条记录对控件使用者而言是最好的方式，因为数组的遍历不需要更多的JavaAPI知识。然而数组只能在数据库操作完成以后一次性生成，因此整个ResultSet对象将被缓存，所以如果查询结果是一个非常大的ResultSet的时候，可能会造成系统内存耗尽的情况，这种情况下，使用数组返回多条记录的控件开发者必须考虑数据的分批提取策略。

　　使用Iterator对象返回多条记录对控件的使用者提出了更高的要求，这种情况下，Iterator对象封装了ResulSet的数据获取行为，控件使用者在调用Iterator对象的next方法时，容器会调用ResultSet的对应方法从数据库中获取对应的记录，这种方式不存在ResultSet集大或者小的问题。当时这种方式不适合在PageFlow中使用，因为PageFlow的Action调用完成后跳转到显示页面使用Iterator对象时，数据库连接通常已经被关闭了，ResultSet已经无法获取相应的数据了，所以Iterator对象中的数据也无法得到。

　　JDBC控件也支持直接返回ResulSet对象，以便控件使用者能够自由的控制SQL语句操作结果。

　　如何使用数组返回多条记录

　　这种情况下你可以有两种选择:返回JavaBean对象数组或者Map(或者HashMap)数组。这两种情况的区别请参考章节<<如何返回单条记录>>中的相关内容。

　　我们可以使用下面这段代码声明业务方法返回JavaBean对象数组:

　　@SQL(statement = “select id,name,value from demo”)
public Demo[] getDemos() ;

　　如果需要声明业务方法返回的结果被封装成Map(或者HashMap)数组，请参考使用下面的这段代码:

　　@SQL(statement = “select id,name,value from demo”)
public Map[] getDemos() ;

　　如果SQL语句执行后没有符合条件的记录返回，上面的这两种情况下将返回一个长度为0的数组。

　　如何使用Iterator对象返回多条记录

　　和上面的情况一样，你可以选择Iterator中包含的对象是JavaBean对象或者是Map(或者HashMap)对象。

　　我们可以使用下面这段代码声明业务方法返回Iterator中包含的是JavaBean对象:

　　@SQL(statement = “select id,name,value from demo”,
iteratorElementType=Demo.class)
public java.util.Iterator getDemos() ;

　　如果需要声明业务方法返回的Iterator中使用Map(或者HashMap)封装单条记录的所有属性，请参考使用下面的这段代码，其中的iteratorElementType声明返回Iterator结果中包含的是HashMap对象:

　　@SQL(statement = “select id,name,value from demo”,
iteratorElementType=java.util.HashMap.class)
public java.util.Iterator getDemos() ;

　　后面这种情况下，返回结果中的HashMap对象的所有键(Key)都已经被变成了大写，控件使用者在访问时请注意这一点，不然可能引起程序的不正常运行。

　　如何使用ResultSet对象返回多条记录

　　这种方式的声明代码如下:

　　@SQL(statement=“SELECT * FROM customer”)
public java.sql.ResultSet findAllCustomersResultSet();

　　基于大家熟知的性能方面的考虑，不推荐控件开发者使用这种方式来返回多条记录。

　　结束语

　　数据库资源是企业应用中的主要资源形式之一，所以如何访问数据库资源是企业应用中的重要内容。控件架构中的JDBC控件大大的简化了数据库访问资源的复杂性、难度，开发者只需要通过简单的继承org.apache.beehive.controls.system.jdbc.JdbcControl，然后通过提供相应的注释就可以完成数据库资源的访问和操作结果的返回。

　　本文中，作者首先通过简单的例子介绍了JDBC控件使用的基本步骤，然后详细的介绍了JDBC控件提供的主要注释和使用方法，最后介绍了如何通过JDBC控件返回操作结果的方式方法。