清单3 src\ org\vivianj\beehive\controls\examples\controls\
jndicontext\JndiContextFactory.java
1. package org.vivianj.beehive.controls.examples.controls.jndicontext;
2.
3. import java.util.Hashtable;
4.
5. import javax.naming.Context;
6. import javax.naming.InitialContext;
7.
8. import org.apache.beehive.controls.system.jdbc.JdbcControl;
9.
10. /**
11. * JndiContextFactory 用于从Tomcat服务器中获取访问JNDI内容的上下文环境
12. */
13. public class JndiContextFactory extends JdbcControl.JndiContextFactory {
14. /**
15. * 获得本地Tomcat服务器中访问JNDI内容的上下文环境
16. *
17. */
18. public Context getContext() {
19.
20. Context ctx = null;
21.
22. try {
23. ctx = (Context)(new InitialContext().lookup("java:/comp/env"));
24. } catch (Exception e) {
25.
26. }
27.
28. return ctx;
29. }
30. } 
　　我们可以使用ConnectionDataSource注释和新创建的JndiContextFactory类来注释JDBC控件了。
　　下面的代码片断就是一个简单的例子，使用这段代码注释的JDBC控件，调用任何业务方法时，将通过本地Tomcat服务器上、JNDI名为“jndi/ samplesDataSource”的DataSource资源获取数据库连接。
@JdbcControl.ConnectionDataSource(
　　jndiName = "jndi/samplesDataSource",
　　jndiContextFactory=JndiContextFactory.class) 
　　ConnectionOptions注释
　　ConnectionOptions可以用于定义访问数据库时的一些扩展特性，可以选择性的和ConnectionDataSource或者ConnectionDriver一起使用。ConnectionOptions支持三个参数:readOnly、resultSetHoldability、typeMappers。
　　·readOnly
　　boolean类型，如果设置为true，数据库连接将优化为ReadOnly的访问方式，但是仍然可以进行更新和删除操作。默认为false。
　　·resultSetHoldability
　　org.apache.beehive.controls.system.jdbc.JdbcControl.HoldabilityType类型，可以选择为HOLD_CURSORS_OVER_COMMIT或者CLOSE_CURSORS_AT_COMMIT，用于设置ResultSet指针的关闭策略，默认值是CLOSE_CURSORS_AT_COMMIT，表示在每次commit之后关闭ResulSet对象指针。
　　·typeMappers
　　org.apache.beehive.controls.system.jdbc.JdbcControl.TypeMapper数组类型。设置SQL自定义类型和Java类型之间的映射。TypeMappers类中指定的Java类型必须实现java.sql.SQLData接口
　　SQL注释
　　SQL注释用于描述JDBC控件继承类中定义的方法，主要设置被注释方法调用时需要执行的SQL语句和其它功能。我们可以回头看一看清单2，里面的每一个业务方法之前均有@SQL注释。
　　SQL注释支持很多属性设置，包括statement、arrayMaxLength等，其中最重要的就是statemet，本节中我们讨论statement属性的设置，其他属性的设置方法请大家参考Beehive的帮助文档，在大多数的情况下最好不要设置这些属性，因为里面可能用到JDBC3.0规范中的新特性，而现在很多数据库驱动并不支持这些特性。
　　statement内容描述了我们需要完成的业务逻辑，在statement中我们可以使用变量的方式访问被注释方法中传递进来的参数，JDBC控件的解析器在运行时保证这些参数的正确传递。
　　statement编写规则
　　SQL注释的statement属性提供了被注释方法调用时执行的SQL语句的内容，SQL语言中可以使用JdbcControl提供的特殊语法直接访问Java对象或者它的属性。编写statement必须满足以下条件。
　　·statement中的sql语句编写方式和要求参考目标数据库的sql语句编写方式和要求。
　　·statement中使用{…}声明变量来获取业务方法调用时所传递参数或者它的属性。
　　·statement中变量声明的第一个字符和最后一个字符不能是空格，也就是说不能出现{ a}或者{a }这样的情况，否则可能执行结果和您期望的会有很大的出入
　　·{}中间的内容是大小写敏感的。如果传入的参数名为a，而{}中引用为A，他们之间将无法匹配。
　　·{}中间的内容可以是参数名(传入的参数是Java基本数据类型时适用)，或者是参数对象的某个成员变量(传入的参数是Java类对象时)。
　　·{}中引用Java对象的字段时，必须保证该字段符合以下条件之一，否则Java控件调用时将会返回一个违例:
　　　* 该字段被public关键字声明为公共字段，可以使用 对象名.字段名 直接访问
　　　* 该字段被private关键字声明为私有字段，但是提供了公共的getter方法，可以通过 对象名.get属性名 方式访问。
　　　* 该Java对象继承了java.util.Map接口，可以通过 对象名.get(“属性名”)方式访问
　　statement中引用业务方法中传递的参数时必须保证这些参数和对应的数据表的字段类型保持一致，不能出现数据表的字段是NUMBER类型，而对应的参数却是String类型。
　　当业务方法传递的日期或者时间类型的参数需要在statement中被引用时，请保证这些传递的日期和时间使用的是java.sql包中的对应类，比如我们应该使用java.sql.Date而不要使用java.util.Date来传递日期类型的变量给statement
　　statement中不能出现单引号。如果确实需要使用单引号，必须采用特别的方法解决。
　　statement创建实例
　　·不从业务方法获取参数
　　下面的业务方法声明可以从demo表中取出所有所有记录，返回一个Demo对象的数组。
@SQL(statement=“select * from demo” )
Public Demo[] getDemos(); 
　　·从业务方法中获取基本类型参数
　　下面的statement中，我们使用{demoId}变量从getDemoById()方法调用中获取传入的参数demoId。
@SQL(statement=“select * from demo where id={demoId}” )
Public Demo[] getDemoById(int demoId); 
　　·从业务方法中获取Java对象类型参数
　　下面的statement中，我们使用{demo.name}变量表示从createDemo ()方法调用中获取传入的Java类对象demo的name属性的内容。
@SQL(statement = “insert into demo(name,value)
　values({demo.name},{demo.value})”)
public void createDemo(Demo demo); 

上一页  [1] [2] [3] [4] [5] 下一页