BlogJava-云自无心水自闲-随笔分类-iBatis

mybatis3.0.2已经发布

云自无心水自闲 — Mon, 13 Sep 2010 04:42:00 GMT

这是mybatis从ibatis更名过来后，发布的第2个版本（第1个版本是3.0.1)。
在这个版本中只修复了4个bug(感觉数目有点少，难道是因为上一个版本的bug真的如此之少?)，增加了一个小功能.
作者的话：尽管只有5个修改，但我还是觉得值得为此发布一个新版本。
这5个修改是：
1、在org.apache.ibatis.Session中增加了一个新方法：void select(String statement, ResultHandler handler);
原来只有：
void select(String statement, Object parameter, ResultHandler handler);
void select(String statement, Object parameter, RowBounds rowBounds, ResultHandler handler);

2、修复了ManagedConnection中关闭连接的问题
3、修复了schema migration中，语句提交(statement commit)不正确的问题
4、修复了延迟加载已经预读取属性时的问题
5、修复了schema migration中，FileInputStream没有正确关闭的问题

云自无心水自闲 2010-09-13 12:42 发表评论

iBatis已经更名为MyBatis，并搬迁到Google Code

云自无心水自闲 — Mon, 24 May 2010 11:58:00 GMT

现在打开iBatis的主页：ibatis.apache.org会发现作者发布了一个新闻或者说是声明。

大意是因为各种原因，已经把iBatis更名为MyBatis, 并且搬迁到Google Code中了。

新的主页地址是： http://www.mybatis.org

另外，MyBatis3.0.1的正式版已经在http://code.google.com/p/mybatis/可以下载了。

云自无心水自闲 2010-05-24 19:58 发表评论

iBatis3正式版的候选版已经释出

云自无心水自闲 — Tue, 20 Apr 2010 03:21:00 GMT

4月17日，iBatis3.0的GA版本的候选版本(candidate)已经在主页上公布出来了（ibatis.apache.org)
根据其描述，只有PMC的投票才会被真正的计算。但是同时又补充说明，其实很多PMC的投票是参考社区用户的投票结果的。
所以也鼓励大家发表自己的看法，并期待大家的反馈。

原文：
After well over a year of development and testing effort, iBATIS 3.0 is now ready for prime time. I've uploaded the new bundles for iBATIS 3 Core and Migrations. It is this release that we'll vote on for GA status. I'll leave the vote open for a good while (maybe a couple of weeks), just to give everyone a chance to try it out. As usual, only PMC votes actually count, but many PMC members will vote based on the community votes. So please offer your feedback. Otherwise, enjoy iBATIS 3.0!

云自无心水自闲 2010-04-20 11:21 发表评论

IBatis3Beta10已经释出，不出意外的话，这就将是最后的GA版

云自无心水自闲 — Mon, 08 Mar 2010 11:50:00 GMT

2月25日，IBatis3发布了Beta10，在主页上宣称，一个月来Beta9的公测都没有收到真正的Bug提交。
所有收到的问题都是新的功能要求。
所以，如果没有意外的话，Beta10将会用于投票表决是否作为GA（General Available）版本。

云自无心水自闲 2010-03-08 19:50 发表评论

IBatis3中使用自定义数据源C3P0

云自无心水自闲 — Mon, 01 Feb 2010 04:57:00 GMT

IBatis2中提供了3种DataSource的配置：JNDI, Apache DBCP, IBatis自带的SimpleDataSource。但在IBatis3中只提供了两种DataSource: UNPOOLED, POOLED。
如果要实现自定义的DataSource，就需要通过扩展DataSourceFactory。本文就演示一下这个过程。
准备工作：Connection Pool的选择，通过搜索发现目前比较流行的免费数据库连接池主要有3种：Apache DBCP, C3P0, Proxool。
看了一下，Proxool的最新版本是0.9.1(2008-08-23), C3P0的最新版本是0.9.1.2(2007-05-21), DBCP最新版本是1.2.2(2007-04-04)
好像这3个项目都已经挺长时间没有更新了。但是总体评价上C3P0无论从稳定上还是效率上都要好一点。
（具体这3个项目谁更优秀，并不是本文的重点，本文主要是介绍一下如何在IBatis3中自定义数据源）
大致步骤：
1、实现org.apache.ibatis.datasource.DataSourceFactory接口，主要是2个方法
a、public DataSource getDataSource() 如何具体地得到一个数据源
b、public void setProperties(Properties properties) 如何设置数据源的参数属性
2、实现javax.sql.DataSource，这个就是提供给DataSourceFactory的实例
3、在IBatis3中引用新加入的数据源

1. 从代码中可以看出，IBatis3与IBatis2不同，不再通过一个Configuration类来进行数据源属性的设置，而是使用反射机制直接调用数据源的方法来设置参数。
这就要求配置文件中的参数名称必须与数据源类中的方法名匹配.

1 public class C3p0DataSourceFactory implements DataSourceFactory {
2
3     private DataSource dataSource;
4
5     public C3p0DataSourceFactory() {
6         dataSource = new C3p0DataSource();
7     }
8
9     public DataSource getDataSource() {
10         return dataSource;
11     }
12
13     public void setProperties(Properties properties) {
14         Properties driverProperties = new Properties();
15         MetaObject metaDataSource = MetaObject.forObject(dataSource);
16         for (Object key : properties.keySet()) {
17             String propertyName = (String) key;
18             if (propertyName.startsWith(DRIVER_PROPERTY_PREFIX)) {
19                 String value = properties.getProperty(propertyName);
20                 driverProperties.setProperty(propertyName
21                         .substring(DRIVER_PROPERTY_PREFIX_LENGTH), value);
22             } else if (metaDataSource.hasSetter(propertyName)) {
23                 String value = (String) properties.get(propertyName);
24                 Object convertedValue = convertValue(metaDataSource,
25                         propertyName, value);
26                 metaDataSource.setValue(propertyName, convertedValue);
27             } else {
28                 throw new DataSourceException("Unkown DataSource property: "
29                         + propertyName);
30             }
31         }
32         if (driverProperties.size() > 0) {
33             metaDataSource.setValue("driverProperties", driverProperties);
34         }
35     }
36
37     @SuppressWarnings("unchecked")
38     private Object convertValue(MetaObject metaDataSource, String propertyName,
39             String value) {
40         Object convertedValue = value;
41         Class targetType = metaDataSource.getSetterType(propertyName);
42         if (targetType == Integer.class || targetType == int.class) {
43             convertedValue = Integer.valueOf(value);
44         } else if (targetType == Long.class || targetType == long.class) {
45             convertedValue = Long.valueOf(value);
46         } else if (targetType == Boolean.class || targetType == boolean.class) {
47             convertedValue = Boolean.valueOf(value);
48         }
49         return convertedValue;
50     }
51
52     private static final String DRIVER_PROPERTY_PREFIX = "driver.";
53     private static final int DRIVER_PROPERTY_PREFIX_LENGTH = DRIVER_PROPERTY_PREFIX
54             .length();
55
56 }
57

2. 数据源类，其中的一堆setter就是用于设置属性的。

1 public class C3p0DataSource implements DataSource {
2
3     private ComboPooledDataSource dataSource;
4     public C3p0DataSource() {
5         this.dataSource = new ComboPooledDataSource();
6     }
7
8     public Connection getConnection() throws SQLException {
9         return dataSource.getConnection();
10     }
11
12     public Connection getConnection(String username, String password)
13             throws SQLException {
14         return dataSource.getConnection(username, password);
15     }
16
17     public PrintWriter getLogWriter() throws SQLException {
18         return dataSource.getLogWriter();
19     }
20
21     public int getLoginTimeout() throws SQLException {
22         return dataSource.getLoginTimeout();
23     }
24
25     public void setLogWriter(PrintWriter out) throws SQLException {
26         dataSource.setLogWriter(out);
27     }
28
29     public void setLoginTimeout(int seconds) throws SQLException {
30         dataSource.setLoginTimeout(seconds);
31     }
32
33
34     public synchronized void setDriver(String driver) {
35         try {
36             dataSource.setDriverClass(driver);
37         } catch (Exception e) {
38         }
39     }
40
41     public void setUrl(String url) {
42         dataSource.setJdbcUrl(url);
43     }
44
45     public void setUsername(String username) {
46           dataSource.setUser(username);
47     }
48
49     public void setPassword(String password) {
50         dataSource.setPassword(password);
51     }
52
53     public void setInitialPoolSize(int initialPoolSize) {
54         dataSource.setInitialPoolSize(initialPoolSize);
55     }
56
57     public void setMaxPoolSize(int maxPoolSize) {
58         dataSource.setMaxPoolSize(maxPoolSize);
59     }
60
61     public void setMinPoolSize(int minPoolSize) {
62         dataSource.setMinPoolSize(minPoolSize);
63     }
64
65     public void setPreferredTestQuery(String preferredTestQuery) {
66         dataSource.setPreferredTestQuery(preferredTestQuery);
67     }
68
69     public void setPoolPingQuery(String poolPingQuery) {
70         dataSource.setPreferredTestQuery(poolPingQuery);
71     }
72 }

3. 在配置文件Configuration.xml中，可以先定义数据源的别称，然后就象POOLED和UNPOOLED一样使用别称来引用数据源。

    ...















    ...

云自无心水自闲 2010-02-01 12:57 发表评论

IBatis3临近发布正式版了

云自无心水自闲 — Fri, 15 Jan 2010 12:49:00 GMT

IBatis3的Beta8版本已经发布了，在官方网站上声称目前的版本已经非常稳定，只有4个已知的问题，其中2个是非功能性的。作者宣称，这样的状况使它对于近期发布GA版本充满信心。
那么IBatis3与IBatis2相比，究竟变化在哪里呢？
最重要的变化是IBatis3中引入了接口绑定（Interface Binding）的概念。在IBatis2中，没有应用Java5的泛型，所以需要大量使用强制类型转换，比如：
Employee employee = (Employee)sqlMapper.queryForList("getEmployee", 5);
//...and...
List employees = sqlMapper.queryForList("listAllEmployees");
但是在IBatis3中，方法改变成：
MapperFactory factory = someConfiguration.buildMapperFactory();
EmployeeMapper employeeMapper = factory.getMapper (EmployeeMapper.class);
Employee emp = empMapper.getEmployee(5);
//...and...
List employees = empMapper.listAllEmployees();
所以IBatis3至少需要使用Java5以上的版本。上面代码中，EmployeeMapper是一个自定义的接口（注意，开发人员只需要定义一个接口，不需要提供具体的实现）
public interface EmployeeMapper {
Employee getEmployee (int employeeId);
List listAllEmployees();
}
这样就行了，IBatis会自动为你生成接口的具体实现。是不是感觉有点酷？

云自无心水自闲 2010-01-15 20:49 发表评论

Tapestry最新版5.1.0.5教程（七）：与IBatis3的整合

云自无心水自闲 — Wed, 06 Jan 2010 04:20:00 GMT

与现在最流行的SSH相比较，Tapestry能够完全替代其中Struts2和Spring，但是他还是需要一个ORM的框架。IBatis由于比较低的学习曲线，也受到很多人的喜爱。尤其是在IBatis3中引入了许多新的概念和想法，使用更加安全和便利。
本文主要介绍如何将Tapestry5.1和IBatis3进行整合。
简要步骤：
1. 准备工作
2. 数据库的建立
3. POJO的建立
4. IBatis相关配置文件的创建
5. Tapestry相关代码的完成
概要说明：
1、准备工作。这一部分是比较简单的，Eclipse之类的开发环境是必需的。Tapestry5.1、IBatis3（目前还是Beta7）、数据库（我使用的是MySql）的下载安装。
2、数据库的建立，由于是示例，所以数据库的建立也非常简单，只有一张User表，3个字段，Id，Name，Password
3、com.sample.User类，对应数据库表的3个字段，生成User类
4、IBatis配置文件：Configuration.xml，UserMapper.xml，jdbc.properties的生成, 前两个必需，最后一个可选.
5、在AppModule里，使用build方法, 添加服务生成IBatis3的SqlSessionFactory, 在需要使用SqlSessionFactory的地方，使用@InjectService注入即可
详细说明：
1、大家到各自的网站上下载相应的包好了。我只罗列一下我所用到的Lib：
    antlr-runtime-3.1.1.jar
    commons-codec-1.3.jar
    commons-lang-2.4.jar
    ibatis-3-core-3.0.0.216.jar
    javassist.jar
    log4j-1.2.14.jar
    mysql-connector-java-5.0.5.jar
    slf4j-api-1.5.10.jar
    slf4j-log4j12-1.5.10.jar
    stax2-api-3.0.1.jar
    tapestry-core-5.1.0.5.jar
    tapestry-ioc-5.1.0.5.jar
    tapestry5-annotations-5.1.0.5.jar
    woodstox-core-lgpl-4.0.7.jar
2、Create Table
DROP TABLE IF EXISTS `test`.`user`;
CREATE TABLE `test`.`user` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(45) NOT NULL,
`password` varchar(45) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB;

3、
package com.sample.model;
public class User {
    private long id;
    private String name;
    private String password;
// getter and setter    ....
}

4、我把Configuration.xml和UserMapper.xml都放在src目录下，这样在部署的时候，就是生成在classes，也就是类路径的根目录下。
Configuration.xml:

PUBLIC "-//ibatis.apache.org//DTD Config 3.0//EN"
"http://ibatis.apache.org/dtd/ibatis-3-config.dtd">





















UserMapper.xml:

    PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"
    "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">




jdbc.properties:
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost/test?autoReconnect=true
jdbc.username=root
jdbc.password=root
pingenable=true
pingquery=SELECT 1
pingoldertime=0
pingnotusetime=3600000

5、
package com.sample.web.services;
public class AppModule {
    public static SqlSessionFactory buildSqlSessionFactory() {
        try {
            String resource = "Configuration.xml";
            Reader reader = Resources.getResourceAsReader(resource);
            return new SqlSessionFactoryBuilder().build(reader);
        } catch (Exception e) {
            logger.warn("failed to build SqlSessionFactory: ", e);
            return null;
        }
    }

    private static Logger logger = LoggerFactory.getLogger(AppModule.class);
}

package com.sample.model;
public interface UserMapper {
    public User selectUser(int id);
}

package com.pc.sample.web.pages;
public class Layout {
    @InjectService("SqlSessionFactory")
    private SqlSessionFactory sqlMapper;
    public String getUserName() {
        if ( sqlMapper == null ) {
            return "null-mapper";
        }
        SqlSession session = sqlMapper.openSession();
        try {
            UserMapper userMapper = session.getMapper(UserMapper.class);
            if ( userMapper == null ) {
                return "null-userMapper";
            }
            User user = userMapper.selectUser(1);
            if ( user == null ) {
                return "null-user";
            }
            return user.getName();
        } catch (Exception e) {
            return "exception-" + e.getMessage();
        } finally {
            session.close();
        }
    }
}

几个注意事项：
1，因为我的IBatis的配置文件Configuration.xml是放在类路径的根目录下，所以在初始化SqlSessionFactory的时候，直接用String resource = "Configuration.xml";就行了，否则需要添加相应的路径，比如：把Configuration.xml与User类放在一起，也就是在 com.sample.model这个package中，那么就要写成：String resource = "com/sample/model/Configuration.xml";
同样，在Configuration.xml中，指定UserMapper.xml的规则也是这样的。
2，UserMapper的使用。Mapper的使用是IBatis3中才有的新功能，也是IBatis用户指南中推荐使用的方式。因为这样使用的话，就完全避免了类型的强制转换，实现了类型安全。
需要注意的是UserMapper只是一个接口。我们不需要提供这个接口的具体实现。IBatis3会自动生成一个具体的实例。

其中的方法名必须与UserMapper.xml中的select语句的id一样。在我的例子中是selectUser.
另外，此方法的返回值的类型必须与UserMapper.xml中配置的returnType一致。
最后要提醒的是UserMapper.xml中的namespace必须是UserMapper的全类名,在本例中就是com.sample.model.UserMapper

云自无心水自闲 2010-01-06 12:20 发表评论

介绍作为iBatis辅助工具的iBator的使用方法

云自无心水自闲 — Wed, 07 Oct 2009 12:18:00 GMT

目前从实际应用来看，ORM的老大自然是Hibernate，可是iBatis因为相对比较直观、学习曲线相对较低，因而也赢得了不少用户的青睐。
本文主要介绍作为iBatis辅助工具的iBator的使用方法。
iBator是一个iBatis相关代码的自动生成工具。
1、安装iBator的插件
在Eclipse中，使用添加站点的方法，输入网址http://ibatis.apache.org/tools/ibator，进行iBator的安装。
2、建议不要直接在使用iBatis的项目里直接使用iBator，推荐另外单独建立一个项目来生成。比如，建立一个项目叫：IbatorPrj
3、右键点击IbatorPrj这个项目，如果刚才的插件安装正确的话，就会看到一个“Add iBATOR to the build path”的选项，点击一下。
4、创建iBator的配置文件。下面是我的例子，大家在实际使用的过程中，需要根据自己的情况进行相应的修改。
主要就是数据库JDBC库的路径、数据库驱动的类名、项目的名称、包名等。

PUBLIC "-//Apache Software Foundation//DTD Apache iBATIS Ibator Configuration 1.0//EN"
"http://ibatis.apache.org/dtd/ibator-config_1_0.dtd">

                                        connectionURL="jdbc:mysql://localhost/sample" userId="root" password="admin">

                                        targetProject="IbatorPrj\src">

5、配置文件生成完毕后，右键点击这个文件，选择“Generate iBatis Artifact”，然后你就在配置的文件夹下找到自动生成的文件了。

云自无心水自闲 2009-10-07 20:18 发表评论

iBatis使用mysql，数据库超时自动关闭问题的解决

云自无心水自闲 — Tue, 13 May 2008 03:08:00 GMT

iBatis自己带了一个simple的数据库连接池，基本的功能都有。但是在处理部分数据库（比如mysql）的连接空闲时间太长（mysql是8小时）自动超时的时候，就比不上象c3p0这样的连接池软件了（c3p0能自动处理数据库连接被关闭的情况)。
我目前采用的方法是iBatis本身提供的一种算得上是取巧的办法，基本思想就是每隔一段时间往数据库发一条查询语句，这样使得数据库空闲时间不会太长，而使得其自动关闭。
方法是在SqlMapConfig.xml的dataSource进行如下配置：










开始的３行是关于数据库连接信息的，不需要说明了。
Pool.PingEnabled：是用于设置开启是否允许检测连接状态
Pool.PingQuery：是用于检测连接的查询语名，当然是越简单越好
Pool.PingConnectionOlderThan：对持续连接时间超过设定值（毫秒）的连接进行检测，我将其设置为０（不进行此项检测），否则，iBatis在超过这个时间后，执行每个sql以前检测连接，对于性能可能会有一定的影响。
Pool.PingConnectionsNotUsedFor：对空闲超过设定值（毫秒）的连接进行检测，我设置为1小时（mysql缺省的关闭时间是8小时)

当然，还有一个办法是使用c3p0这样的连接池
但是需要自己写一部分代码，实现以下接口：

public interface DataSourceFactory {

public void initialize(Map map);

public DataSource getDataSource();

}

云自无心水自闲 2008-05-13 11:08 发表评论