官网：http://www.mybatis.org/mybatis-3/index.html
在使用mybatis作为ORM框架时，我通常更喜欢使用注解而非xml配置文件的方式。
业务场景：添加记录之后需要返回自己自增长的主键字段值。
通常，我们会将DAO层写成如下代码（以添加员工Staff为例）：
public interface StaffDAO { @InsertProvider(type=StaffProvider.class, method="buildSinleStaff") @Options(useGeneratedKeys=true, keyProperty="staff_id", keyColumn="staff_id") public int addStaff(Staff staff);}
显然，希望在执行addStaff()后返回新添加的员工记录的主键字段值，在这里为staff_id（staff_id为主键字段，且为自增类型）。
但是！！！经过多次验证，依然发现，返回值始终为：1！
跟踪mybatis源码发现，返回值其实是添加的记录数，而不是新加记录的主键字段值，所以永远为1。
mybatis添加记录时序图：
查看org.apache.ibatis.executor.statement.PreparedStatementHandler源码实现：
@Overridepublic int update(Statement statement) throws SQLException { PreparedStatement ps = (PreparedStatement) statement; ps.execute(); int rows = ps.getUpdateCount(); Object parameterObject = boundSql.getParameterObject(); KeyGenerator keyGenerator = mappedStatement.getKeyGenerator(); keyGenerator.processAfter(executor, mappedStatement, ps, parameterObject); return rows;}
显然，返回值是受影响的记录数量，即：添加的记录数。
那么如何才能取得新添加记录的主键字段值呢？继续跟踪源码（org.apache.ibatis.executor.statement.PreparedStatementHandler）：
@Overridepublic int update(Statement statement) throws SQLException { PreparedStatement ps = (PreparedStatement) statement; ps.execute(); int rows = ps.getUpdateCount(); Object parameterObject = boundSql.getParameterObject(); KeyGenerator keyGenerator = mappedStatement.getKeyGenerator(); keyGenerator.processAfter(executor, mappedStatement, ps, parameterObject); return rows;}
显然，在执行插入记录操作之后，还执行了如下操作：
Object parameterObject = boundSql.getParameterObject();KeyGenerator keyGenerator = mappedStatement.getKeyGenerator();keyGenerator.processAfter(executor, mappedStatement, ps, parameterObject);
在org.apache.ibatis.executor.keygen.Jdbc3KeyGenerator中实现对主键字段的处理：
private void populateKeys(ResultSet rs, MetaObject metaParam, String[] keyProperties, TypeHandler<?>[] typeHandlers) throws SQLException { for (int i = 0; i < keyProperties.length; i++) { TypeHandler<?> th = typeHandlers[i]; if (th != null) { Object value = th.getResult(rs, i + 1); metaParam.setValue(keyProperties[i], value); } }}
恍然大悟！
在使用mybatis注解@Options(useGeneratedKeys=true)获取新添加记录的自增长主键字段值时，需要在执行添加操作之后，直接访问对象的主键字段属性即可取得对应值。
回归到业务代码：
staffService.addStaff(staff);long staffId = staff.getStaff_id(); // 执行添加操作之后获取对象主键字段值
最后需要说明：在mybatis中使用注解实现添加记录时，可以使用@Insert或者@InsertProvider 2个注解，都可以使用@Options注解获取新添加记录的自增长主键字段值。
【参考】
http://isilic.iteye.com/blog/1810782 Mybatis使用：Sql Annotation
