|
快速应用JDBC控件访问数据库资源(3) 70. /**
71. *
72. * @param name
73. * @return
74. */
75. @SQL(statement = "select id,name,value from demo
76. where name like {sql: name}")
77. public Demo[] getDemosFilterByName(String name);
78. }
控件调用
我们可以编写DemoMySQLControl控件的测试类，然后通过如下方式来完成控件中业务方法的调用。
在测试类中采用声明式控件实例化方式来实例化DemoMySQLControl控件。
·@Control
DemoMySQLControl _control;
调用控件的相关业务方法来实现业务逻辑。
下面的代码段可以完成Demo对象的新增功能。
Demo demo = new Demo();
demo.setName(“name”);
demo.setValue(“value”);
_control.createDemo(demo);
实例分析
从上面的例子中我们可以看到，通过继承JDBC控件来完成JDBC数据源的访问是一件非常简单的事情，开发者需要完成的工作被简化为两项:编写表征访问对象的JavaBean和使用声明完成业务方法和逻辑的实现，这样的开发过程大大的简化了开发者的工作，极大地减少了开发者的代码编写量。
下面我们详细的分析一下继承JDBC控件的子类DemoMySQLControl:
15. @ControlExtension
在程序的第15行，我们使用@ControlExtension来注释将要创建的这个接口继承了另外的控件接口
16.@JdbcControl.ConnectionDriver(
17.databaseDriverClass = “org.gjt.mm.mysql.Driver”,
18.databaseURL = "jdbc:mysql://localhost/estore ",
19.userName = “root”, password = “king”)
在程序的第16~19行我们使用@JdbcControl.ConnectionDriver注释来为将要创建的接口指定一些需要传递的参数，这里主要是一些数据库访问时所需要的JDBC驱动类、JDBC访问URL、数据库访问用户名和密码等必要信息。
20.public interface DemoMySQLControl extends JdbcControl { 在程序的第20行使用extends关键字表示将要创建的接口DemoMySQLControl和JdbcControl接口之间的继承关系
27.@SQL(statement = "insert into demo(name,value)
28.values({demo.name},{demo.value})")
在程序的第27~28行使用@SQL关键字注释接下来定义的这个业务方法所需要执行的业务逻辑，其中的{}表示对传入参数的调用，{}包含的内容表示了需要处理的参数，这些参数的表示方法遵循面向对象的属性调用方式，JDBC控件的解析器会将这些代码转化为对应的getter方法调用。
29.public void createDemo(Demo demo);
在程序的第29行，采用常用的接口方法声明了该控件的一个访问接口。
后面的代码采用和27~29行相应的原理定义了其它需要实现的业务方法。需要注意的是，定义查询类方法时，如果只需要返回一条记录，目前通常的做法是返回一个Demo对象。如果返回的记录有超过一条的可能性，返回的是符合查询条件的Demo对象数组、List对象等，请参考《JDBC控件返回类型》部分的内容。
前面的内容中，我们已经通过继承JDBC控件完成了访问数据库资源的全部内容，现在你可以编写单元测试代码来测试控件是否符合要求了。请大家参考《控件入门》中的步骤完成JDBC控件的编译和单元测试工作。
到现在为止，我们已经知道了如何使用JDBC控件和注释来访问数据库资源的基本步骤和方法，但是还没有学习如何使用注释来让JDBC控件和业务内容的结合起来。这部分的内容分作两部分进行介绍:一是如何通过注释定制JDBC控件，提供访问数据库的信息(比如数据库访问方式、URL、用户名和密码等)，一是如何确定每次业务方法执行的返回对象。
使用注释订制JDBC控件
本节中的内容将给大家介绍如何使用JDBC控件提供的注释根据不同的环境和要求来订制JDBC控件，完成JDBC数据源的访问和业务逻辑的封装。
JDBC控件支持的四个注释:ConnectionDataSource、ConnectionDriver、ConnectionOptions、SQL。四个注释中ConnectionDataSource、ConnectionDriver、ConnectionOptions是用于类级别的注释，用于描述JDBC控件继承类，SQL注释是方法级别的注释，用于描述JDBC继承类中的业务方法。
使用ConnectionDataSource注释可以指定JDBC控件访问数据库时根据采用DataSource方式获取数据库连接。使用ConnectionDriver注释可以指定JDBC控件访问数据库时使用指定的参数通过DriverManager获取数据库连接。ConnectionOptions注释描述了数据库访问时的一些扩展特性，比如数据库访问时是否使用READONLY优化(仍然可以进行UPDATE操作)等。
下面开始详细的介绍这些注释，并且通过提供简单的代码段来说明如何使用这些注释来配置JDBC控件的继承类。
ConnectionDriver注释
ConnectionDriver用于注释JDBC控件的继承类，控制JDBC控件在访问数据库的时候通过DriverManager获取数据库连接。ConnectionDriver注释支持5个参数:databaseDriverClass、databaseURL、userName、password、properties。
·databaseDriverClass
String类型，用于设定数据库驱动类的全名。使用ConnectionDriver注释时必须设置的参数。
比如访问MySQL数据库，可以使用databaseDriverClass= “org.gjt.mm.mysql.Driver”，访问Oracle数据库的时候可以使用databaseDriverClass= “oracle.jdbc.driver.OracleDriver”
·databaseURL
String类型，用于设定数据库访问的JDBC URL，使用ConnectionDriver注释时必须设置的参数。
比如访问MySQL可以使用databaseURL=“ jdbc:mysql://localhost/estore”，访问Oracle数据库时可以使用databaseURL=“ jdbc:oracle:thin:@localhost:1521:www”
·userName
String类型，设置访问数据库时使用的用户名，可选参数。
·password
String类型，设置访问数据库时使用的密码，可选参数。
·properties
String类型，设置访问数据库时的一些其它参数，可以一次性传递多个参数，两个参数之间用逗号隔开。
在《第一个JDBC控件的例子》中，我们提供的代码已经演示了如何使用ConnectionDriver注释JDBC控件，请参见 清单2 。
ConnectionDriver注释的JDBC控件运行时，必须保证databaseDriverClass中指定的数据库驱动类位于classpath中，否则控件运行时将抛出违例。
ConnectionDataSource注释
ConnectionDataSource注释用于指定JDBC控件在访问数据库时通过DataSource获取数据库连接，它有两个属性:jndiName和jndiContextFactory。
·jndiName
String类型，用于设置DataSource在目标容器内的jndiName属性
·jndiContextFactory
Class类型，用于设置数据库访问时可以获取jndi上下文环境的类，被传入的参数类必须继承org.apache.beehive.controls.system.jdbc.JdbcControl. JndiContextFactory类，并且覆盖JndiContextFactory类的getContext()方法，getContext()将获取访问目标容器的上下文环境(Context)。
下面的章节中我们将看到如何通过JDBC控件和ConnectionDataSource注释访问Tomcat服务器，获取jndiName为jndi/samplesDataSource的DataSource资源，该DataSource连接到MySQL数据库的Demo实例，Web应用部署在Tomcat环境中。
| 
