MyBatis框架——第一个MyBatis程序(转载)
在创建 MyBatis 项目之前,首先创建 website 数据表,SQL 语句如下。
DROP TABLE IF EXISTS `website`; CREATE TABLE `website` ( `id` int(11) NOT NULL AUTO_INCREMENT, `name` varchar(20) COLLATE utf8_unicode_ci NOT NULL, `url` varchar(30) COLLATE utf8_unicode_ci DEFAULT '', `age` tinyint(3) unsigned NOT NULL, `country` char(3) COLLATE utf8_unicode_ci NOT NULL DEFAULT '', `createtime` timestamp NULL DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
创建 MyBatis 程序的步骤为:下载jar包 -> 部署jar包 -> 编写MyBatis核心配置文件 -> 创建实体类 -> 创建DAO接口 -> 创建SQL映射文件 -> 编写测试类
下面介绍如何使用 Eclipse IDE 创建一个简单的 MyBatis 程序。
1. 创建Web应用,部署jar包
在 Eclipse 中创建 Web 项目 mybatisDemo,并将下载的 MyBatis 的核心 jar 包、依赖 jar 包以及 MySQL 数据库的驱动 jar 包复制到 /WEB-INF/lib 目录中。
下载jar包详细步骤在《MyBatis下载》一节讲解。
2. 创建日志文件
MyBatis 默认使用 log4j 输出日志信息,如果开发者需要查看控制台输出的 SQL 语句,可以在 classpath 路径下配置其日志文件。
在 mybatisDemo 的 src 目录下创建 log4j.properties 文件,其内容如下:
在日志文件中配置了全局的日志配置、MyBatis 的日志配置和控制台输出,其中 MyBatis 的日志配置用于将 net.biancheng 包下所有类的日志记录级别设置为 DEBUG。
该配置文件内容不需要开发者全部手写,可以从 MyBatis 使用手册中的 Logging 小节复制,然后进行简单修改。
3. 创建持久化类
在 src 目录下创建一个名为 net.biancheng.po 的包,在该包中创建持久化类 Website。
注意,在类中声明的属性与数据表 website 的字段一致。
Website 类代码如下。
package net.biancheng.po; import java.util.Date; public class Website { private int id; private String name; private String url; private int age; private String country; private Date createtime; /*省略setter和getter方法*/ @Override public String toString() { return "id" + id + "name" + name + "url" + url + "age" + age + "country" + country + "createtime" + createtime; } }
4. 创建映射文件
在 src 目录下创建 net.biancheng.mapper 包,在该包下创建映射文件 WebsiteMapper.xml。
WebsiteMapper.xml 文件内容如下。
上述代码中,
子元素
在定义的 SQL 语句中:
“#{}”表示一个占位符,相当于“?”,
而“#{name}”表示该占位符待接收参数的名称为 name。
5. 创建配置文件
MyBatis 核心配置文件主要用于配置数据库连接和 MyBatis 运行时所需的各种特性,包含了设置和影响 MyBatis 行为的属性。
在 src 目录下创建 MyBatis 的核心配置文件 mybatis-config.xml,在该文件中配置了数据库环境和映射文件的位置,具体内容如下:
为了方便管理以后各框架集成所需的配置文件,可以在项目工程下新建 Source Folder 类型的 resources 目录,
并在此目录下添加 MyBatis 的核心配置文件,默认文件名为 " configuration.xml"。
但需要注意的是,为了方便在框架集成时更好地区分各个配置文件,我们一般将此文件名命名“mybatis-config.xml”,该文件用于配置数据库连接信息和 MyBatis 的参数。
6. 创建测试类
在 src 目录下创建一个名为 net.biancheng.test 的包,在该包中创建 MyBatisTest 测试类。
在测试类中首先使用输入流读取配置文件,然后根据配置信息构建 SqlSessionFactory 对象。
接下来通过 SqlSessionFactory 对象创建 SqlSession 对象,并使用 SqlSession 对象的方法执行数据库操作。 MyBatisTest 测试类的代码如下:
package net.biancheng.test; import java.io.IOException; import java.io.InputStream; import java.util.List; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibatis.session.SqlSessionFactory; import org.apache.ibatis.session.SqlSessionFactoryBuilder; import net.biancheng.po.Website; public class Test { public static void main(String[] args) throws IOException { // 读取配置文件mybatis-config.xml InputStream config = Resources.getResourceAsStream("mybatis-config.xml"); // 根据配置文件构建SqlSessionFactory SqlSessionFactory ssf = new SqlSessionFactoryBuilder().build(config); // 通过SqlSessionFactory创建SqlSession SqlSession ss = ssf.openSession(); // SqlSession执行文件中定义的SQL,并返回映射结果 // 添加网站 Website website = new Website(); website.setName("编程帮"); website.setUrl("https://www.biancheng.net/"); website.setAge(21); website.setCountry("CN"); ss.insert("net.biancheng.mapper.WebsiteMapper.addWebsite", website); // 查询所有网站 ListlistWeb = ss.selectList("net.biancheng.mapper.WebsiteMapper.selectAllWebsite"); for (Website site : listWeb) { System.out.println(site); } // 提交事务 ss.commit(); // 关闭 SqlSession ss.close(); } }