|
快速应用JDBC控件访问数据库资源(6) public int getDemosCount();]
控件调用后的结果将返回一个int数值，而如果你声明的业务方法如下:
@SQL(statement = “select count(*) from demo”)
public Integer getDemosCount();
控件调用后的结果将返回一个Integer对象。
返回结果为简单字段时，如果SQL语句执行后没有符合要求的结果，控件将根据声明的返回类型返回不同的值，如果声明返回结果为数值型，那么返回结果为0;如果声明返回结果为boolean，那么将返回false，而如果声明的返回结果为类类型，那么控件调用返回结果为null。
使用控件返回单条记录
当SQL查询语句需要返回单条记录时，控件支持两种不同的返回类型:JavaBean对象或者Map(或者HashMap)对象。如果能够确定返回对象的属性，通常采用返回JavaBean对象，比如要查找id为1000的系统访问者的详细信息，通常我们知道系统访问者的所有细节，所以使用JavaBean对象作为访问信息。如果无法确定返回对象的详细属性或者时返回对象的属性经常发生变化，比如我们的业务方法中可能返回一个系统访问者的信息，也可能返回的是一个管理员的信息，那么我们可以选择使用Map(或者HashMap)对象声明为业务方法的返回对象。
返回JavaBean对象
这种情况下，控件将在SQL语句执行结束后，自动构造一个返回结果声明类型的对象，调用它的相关setter方法初始化这个对象，然后返回这个对象。如果初始化过程中没有找到合适的setter方法，系统将抛出违例信息。
我们可以通过如下的声明，控制控件在调用后返回一个Demo对象:
@SQL(statement = “select id,name,value from demo
where id={demoId}”)
public Demo getDemoById(int demoId) ;
可声明为返回JavaBean类型的Java类必须符合以下条件:
·Java类必须提供和statement中声明的返回字段对应的getter和setter方法。这些getter和setter方法必须支持大小写敏感。Java类中必须包含但不仅限于这些getter和setter方法。
·Java类中每个getter和setter方法定义的数据类型必须和数据库表中的数据类型保持一致。
如果该Java类是某个类的内部类，那么这个类必须使用public static关键字定义类声明。
返回Map(或者HashMap)对象
在不确定返回对象详细信息的情况下，我们可以声明返回对象类型为Map(或者HashMap)，这种情况下，控件在SQL调用完成以后，将调用Map(或者HashMap)的put方法，将返回结果映射为Map(或者HashMap)对象，返回Map(或者HashMap)对象对象中键--值对的键就是数据表字段名称，键是大小写敏感的，返回Map(或者HashMap)对象中的所有键都被变成了大写字母，值就是数据表字段包含的值，值的类型和数据库中对应字段的类型有关。
我们可以通过如下的声明，控制控件在调用后返回一个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”)
| 
