Java基于数据源的数据库访问

时间:2023-07-06 14:53:50

☞ 概述

  最早接触的Java访问数据库,是通过jdbc接口。后来工作之后,一般是在服务器(如weblogic)配置数据源,通过JNDI使用数据源;最近需要在程序中动态构造数据源,查了些资料,备录于此。

☞ 体系结构

Java基于数据源的数据库访问

我暂时没有系统的学习过UML,对各种图的规范画法不了解。所以上面的图仅供参考,不保证其合乎规范。

对于上图,需要说明:

  1. 组件之间的依赖关系,从上至下;即上面的组件依赖于下面的。
  2. spring-jdbc和commons-dbcp分别是对应jar包的名称;忽略了版本号。

上述5个组件的作用分别如下:

  1. 数据库驱动包
    各数据库厂商提供的jdbc实现;其实数据源也是基于jdbc技术的。
  2. properties配置文件
    jdbc链接的相关配置,和数据源的相关配置。
  3. commons-dbcp
    提供数据源的实现,依赖与配置文件和驱动包。
  4. spring-jdbc
    主要是使用其中的JdbcTemplate工具类,而它依赖于数据源;JdbcTemplate提供了很多实用的方法,具体请参考spring的api。
  5. 业务代码
    基于JdbcTemplate进行数据库交互

☞ 组件内容

  1. 配置文件
    在这里,我们是通过 org.apache.commons.dbcp.BasicDataSourceFactory.createDataSource(java.util.Properties prop) 来创建数据源实例,但是要求Properties的属性名称要和BasicDataSourceFactory声明的Field的名称相一致。除了jdbc链接的相关配置之外,其他的应该(猜测)都有其默认值,不是必须要配置的。配置文件的内容如下:
    driverClassName=oracle.jdbc.driver.OracleDriver
    url=jdbc:oracle:thin:@dzzx-db1.hnisi.com.cn:1523/zxkfk
    username=***
    password=*** # if you want to change the following config, make sure you konw their meanings, otherwise you should not to change them
    initialSize=10
    maxIdle=3
    minIdle=2
    maxActive=10
    maxWait=10000

    各属性的名称,可以参考BasicDataSourceFactory源代码,这里仅对我用到的几个进行介绍:

    • driverClassName

      驱动类名称
    • url
      数据库连接url,不同数据库的写法有所不同
    • username
      数据库用户名
    • password
      数据库用户密码
    • initialSize
      数据源连接池初始连接数
    • maxIdle
      连接池中允许空闲连接的最大数
    • minIdle
      连接池中允许空闲连接的最小数
    • maxActive
      连接池中允许的活动连接的最大数
    • maxWait
      连接的最长等待时间,单位为毫秒

    在上述配置项中,前四个是必要的jdbc连接配置,在jdbc编程中经常遇到;后面五个是数据源连接池相关的配置,根据其介绍,我们可以用一个猜想的场景对其进行不严谨的解释:

    按照上述配置,初始情况下会有10个数据库连接(initialSize)
    在初始情况下一般不会有数据库访问,即10连接都是空闲的,所以连接会被释放,连接数将减少到3(maxIdle) -- 所以配置时initialSize=maxIdle较好
    等到有连接被请求使用了,此时空闲连接数将减少,等少于2(minIdle)时,会创建新的连接
    如果业务代码请求连接,10秒(maxWait)还没有获取到,可能会抛出异常
    业务代码使用完,释放连接之后,连接池中空闲的连接数会增加,所以将会减少连接,保持maxIdle的限制

    再次声明,上述的模式只是猜测,没有经过测试。

  2. 创建数据源
    我们通过 java.io.InputStream java.lang.Class.getResourceAsStream(String name) 来加载资源文件,获得InputStrInputStreameam实例;
    通过 void java.util.Properties.load(InputStream inStream) 来加载属性配置到Properties实例;
    通过 DataSource org.apache.commons.dbcp.BasicDataSourceFactory.createDataSource(Properties prop) 来获取数据源实例。
    Properties prop = new Properties();
    InputStream is = SendUtil.class.getResourceAsStream("/cn/sinobest/jzpt/jgbm/common/message/sendMessage.properties");
    prop.load(is);
    DataSource ds = BasicDataSourceFactory.createDataSource(prop);

    当然,也可以不用工厂模式,以普通的方式创建数据源:

    BasicDataSource bds = new BasicDataSource();
    bds.setDriverClassName("oracle.jdbc.driver.OracleDriver");
    bds.setUrl("jdbc:oracle:thin:@dzzx-db1.hnisi.com.cn:1523/zxkfk");
    bds.setUsername("***");
    bds.setPassword("***");
    bds.setInitialSize(10);
    bds.setMaxIdle(3);
    bds.setMinIdle(2);
    bds.setMaxActive(10);
    bds.setMaxWait(10 * 1000);
  3. 访问数据库
    我比较喜欢使用 org.springframework.jdbc.core.JdbcTemplate 这个工具类,他对增删改查都有封装,支持批处理;没有特殊的语法,写过jdbc代码的可以很容易过渡。我们只需要对其提供数据源实例,由他负责数据库连接的获取和释放,我们只管提供sql语句、参数和参数类型,其他的都不用我们操心。我的使用样例如下:
    String sql = "insert into S_SMS_WAITING_LIST (systemid,receiver,msg_content,senttime) values(?, ?, ?, ?)"
    String systemid="1";
    String phone="159********";
    String content="您有一条短信";
    String currtime=new Timestamp(System.currentTimeMillis());
    Object[] args = {systemid, phone, content, currtime};
    int[] argTypes = {Types.VARCHAR, Types.VARCHAR, Types.VARCHAR, Types.TIMESTAMP};
    JdbcTemplate jdbcTem = new JdbcTemplate(ds); // 上一步创建的数据源
    jdbcTem.update(sql, args, argTypes);

    更多JdbcTemplate的方法,请查询相关API。

2015-08-19 19:42:02