MyBatis自诞生以来一直是一个以XML驱动的框架。配置是基于XML的，映射语句也是在XML中定义的。随着MyBatis 3的推出，有了新的选择。MyBatis 3建立在一个全面而强大的基于Java的配置API之上。该配置API是基于XML的MyBatis配置以及新的基于注解的配置的基础。注解提供了一种简单的方式来实现简单的映射语句，而不引入过多的开销。

注意：不幸的是，Java注解在表达能力和灵活性方面存在一定的限制。尽管我们花费了大量时间进行调查、设计和试验，但最强大的MyBatis映射无法只使用注解构建，除非变得荒谬可笑。C#的属性（例如）没有这些限制，因此MyBatis.NET将享受到一个更丰富的替代XML的选择。尽管如此，基于Java注解的配置也有其优点。

以下是一些注解：

Mapper Annotation Examples-注解例子

以下示例展示了使用@SelectKey注解在插入之前从序列中获取一个值：

@Insert("insert into table3 (id, name) values(#{nameId}, #{name})")
@SelectKey(statement="call next value for TestSequence", keyProperty="nameId", before=true, resultType=int.class)
int insertTable3(Name name);

以下示例展示了如何使用@SelectKey注解在插入后获取自动生成的主键值：

@Insert("insert into table2 (name) values(#{name})")
@SelectKey(statement="call identity()", keyProperty="nameId", before=false, resultType=int.class)
int insertTable2(Name name);

以下示例展示了如何使用@Flush注解调用SqlSession#flushStatements()方法：

@Flush
List<BatchResult> flush();

以下示例展示了如何通过指定@Results注解的id属性来命名一个ResultMap：

@Results(id = "userResult", value = {@Result(property = "id", column = "uid", id = true),@Result(property = "firstName", column = "first_name"),@Result(property = "lastName", column = "last_name")
})
@Select("select * from users where id = #{id}")
User getUserById(Integer id);@Results(id = "companyResults")
@ConstructorArgs({@Arg(column = "cid", javaType = Integer.class, id = true),@Arg(column = "name", javaType = String.class)
})
@Select("select * from company where id = #{id}")
Company getCompanyById(Integer id);

以下示例展示了使用@SelectProvider注解的单个参数：

@SelectProvider(type = UserSqlBuilder.class, method = "buildGetUsersByName")
List<User> getUsersByName(String name);class UserSqlBuilder {public static String buildGetUsersByName(final String name) {return new SQL(){{SELECT("*");FROM("users");if (name != null) {WHERE("name like #{value} || '%'");}ORDER_BY("id");}}.toString();}
}

以下示例展示了使用@Provider注解的多个参数：

@SelectProvider(type = UserSqlBuilder.class, method = "buildGetUsersByName")
List<User> getUsersByName(@Param("name") String name, @Param("orderByColumn") String orderByColumn);class UserSqlBuilder {// If not use @Param, you should be define same arguments with mapper methodpublic static String buildGetUsersByName(final String name, final String orderByColumn) {return new SQL(){{SELECT("*");FROM("users");WHERE("name like #{name} || '%'");ORDER_BY(orderByColumn);}}.toString();}// If use @Param, you can define only arguments to be usedpublic static String buildGetUsersByName(@Param("orderByColumn") final String orderByColumn) {return new SQL(){{SELECT("*");FROM("users");WHERE("name like #{name} || '%'");ORDER_BY(orderByColumn);}}.toString();}
}

该示例展示了使用全局配置将一个SQL提供器类共享给所有映射器方法的用法（自3.5.6版起可用）:

Configuration configuration = new Configuration();
configuration.setDefaultSqlProviderType(TemplateFilePathProvider.class); // Specify an sql provider class for sharing on all mapper methods
// ...

// Can omit the type/value attribute on sql provider annotation
// If omit it, the MyBatis apply the class that specified on defaultSqlProviderType.
public interface UserMapper {@SelectProvider // Same with @SelectProvider(TemplateFilePathProvider.class)User findUser(int id);@InsertProvider // Same with @InsertProvider(TemplateFilePathProvider.class)void createUser(User user);@UpdateProvider // Same with @UpdateProvider(TemplateFilePathProvider.class)void updateUser(User user);@DeleteProvider // Same with @DeleteProvider(TemplateFilePathProvider.class)void deleteUser(int id);
}// Can omit the type/value attribute on sql provider annotation
// If omit it, the MyBatis apply the class that specified on defaultSqlProviderType.
public interface UserMapper {@SelectProvider // Same with @SelectProvider(TemplateFilePathProvider.class)User findUser(int id);@InsertProvider // Same with @InsertProvider(TemplateFilePathProvider.class)void createUser(User user);@UpdateProvider // Same with @UpdateProvider(TemplateFilePathProvider.class)void updateUser(User user);@DeleteProvider // Same with @DeleteProvider(TemplateFilePathProvider.class)void deleteUser(int id);
}

该示例展示了使用ProviderMethodResolver的默认实现的用法（自MyBatis 3.5.1版或更高版本起可用）:

@SelectProvider(UserSqlProvider.class)
List<User> getUsersByName(String name);// Implements the ProviderMethodResolver on your provider class
class UserSqlProvider implements ProviderMethodResolver {// In default implementation, it will resolve a method that method name is matched with mapper methodpublic static String getUsersByName(final String name) {return new SQL(){{SELECT("*");FROM("users");if (name != null) {WHERE("name like #{value} || '%'");}ORDER_BY("id");}}.toString();}
}

该示例展示了在`@Statement`注解上使用`databaseId`属性的用法（自3.5.5版起可用）:

@Select(value = "SELECT SYS_GUID() FROM dual", databaseId = "oracle") // Use this statement if DatabaseIdProvider provide "oracle"
@Select(value = "SELECT uuid_generate_v4()", databaseId = "postgres") // Use this statement if DatabaseIdProvider provide "postgres"
@Select("SELECT RANDOM_UUID()") // Use this statement if the DatabaseIdProvider not configured or not matches databaseId
String generateId();