我们开发java项目,肯定会用到java框架,而mybatis就是开发人员常用的框架之一,MyBatis 是一个开源、轻量级的数据持久化框架,我们在使用之前需要将其配置好,那下面我们就给大家讲解一下mybatis配置方法。
pox.xml
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <dependencies> <!--mysql驱动--> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.47</version> </dependency> <!--mybatis--> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.2</version> </dependency> <!--junit--> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> </dependency> <!-- https://mvnrepository.com/artifact/log4j/log4j --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> </dependencies> <!--资源过滤问题--> <build> <resources> <resource> <directory>src/main/java</directory> <includes> <include>**/*.*</include> </includes> </resource> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.*</include> </includes> </resource> </resources> </build> </project>
db.properties
driver = com.mysql.jdbc.Driver url = jdbc: mysql: //localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8 username = root password = 123456
mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <!--configuration核心配置文件--> <configuration> <properties resource="db.properties"></properties> <!--可以设置多套环境,通过environments属性选择运行环境--> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource> </environment> </environments> <!-- 注册Mapper文件,推荐使用resource属性,因为class和name属性需要接口和Mapper文件在同一目录下同时文件名对应 --> <mappers> <mapper resource="com/xxx/dao/UserMapper.xml"/> </mappers> </configuration>
MyBatisUtils.java
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 java.io.IOException; import java.io.InputStream; public class MybatisUtils { private static SqlSessionFactory sqlSessionFactory; static { try { // 使用Mybatis的第一步 : 获取SqlSessionFactory对象 String resource = "mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); sqlSessionFactory = new SqlSessionFactoryBuilder() .build(inputStream); } catch (IOException e) { e.printStackTrace(); } } //有了 SqlSessionFactory,顾名思义,我们就可以从中获得 SqlSession 的实例了。 // SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。 public static SqlSession getSqlSession() { return sqlSessionFactory.openSession(); } }
mybatis第一个程如何写?
1. 创建Web应用,部署jar包
在 Eclipse 中创建 Web 项目 mybatisDemo,并将下载的 MyBatis 的核心 jar 包、依赖 jar 包以及 MySQL 数据库的驱动 jar 包复制到 /WEB-INF/lib 目录中。
2. 创建日志文件
MyBatis 默认使用 log4j 输出日志信息,如果开发者需要查看控制台输出的 SQL 语句,可以在 classpath 路径下配置其日志文件。在 mybatisDemo 的 src 目录下创建 log4j.properties 文件,其内容如下:
# Global logging configuration log4j.rootLogger = ERROR, stdout# MyBatis logging configuration... log4j.logger.net.biancheng = DEBUG# Console output... log4j.appender.stdout = org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout = org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern = % 5 p[ % t] - % m % n
在日志文件中配置了全局的日志配置、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 文件内容如下。
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="net.biancheng.mapper.WebsiteMapper"> <!-- 添加一个网站 --> <insert id="addWebsite" parameterType="net.biancheng.po.Website"> insert into website (name,url,age,country) values(#{name},#{url},#{age},#{country}) </insert> <!-- 查询所有网站信息 --> <select id="selectAllWebsite" resultType="net.biancheng.po.Website"> select * from website </select> </mapper>
上述代码中,<mapper> 元素是配置文件的根元素,它包含了 namespace 属性,该属性值通常设置为“包名+SQL映射文件名”,用于指定唯一的命名空间。
子元素 <select>、<insert> 中的信息用于执行查询、添加操作。在定义的 SQL 语句中,“#{}”表示一个占位符,相当于“?”,而“#{name}”表示该占位符待接收参数的名称为 name。
5. 创建配置文件
MyBatis 核心配置文件主要用于配置数据库连接和 MyBatis 运行时所需的各种特性,包含了设置和影响 MyBatis 行为的属性。
在 src 目录下创建 MyBatis 的核心配置文件 mybatis-config.xml,在该文件中配置了数据库环境和映射文件的位置,具体内容如下:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <settings> <setting name="logImpl" value="LOG4J" /> </settings> <!-- 配置mybatis运行环境 --> <environments default="development"> <environment id="development"> <!-- 使用JDBC的事务管理 --> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <!-- MySQL数据库驱动 --> <property name="driver" value="com.mysql.jdbc.Driver" /> <!-- 连接数据库的URL --> <property name="url" value="jdbc:mysql://localhost:3306/test?characterEncoding=utf8" /> <property name="username" value="root" /> <property name="password" value="root" /> </dataSource> </environment> </environments> <!-- 将mapper文件加入到配置文件中 --> <mappers> <mapper resource="net/biancheng/mapper/WebsiteMapper.xml" /> </mappers> </configuration>
上述映射文件和配置文件都不需要读者完全手动编写,都可以从 MyBatis 使用手册中复制,然后做简单修改。
为了方便管理以后各框架集成所需的配置文件,可以在项目工程下新建 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); // 查询所有网站 List < Website > listWeb = ss.selectList("net.biancheng.mapper.WebsiteMapper.selectAllWebsite"); for (Website site: listWeb) { System.out.println(site); } // 提交事务 ss.commit(); // 关闭 SqlSession ss.close(); } }
运行结果如下:
DEBUG [main] - ==> Preparing: insert into website (name,url,age,country) values(?,?,?,?) DEBUG [main] - ==> Parameters: 编程帮(String), https://www.biancheng.net/(String), 21(Integer), CN(String) DEBUG [main] - <== Updates: 1 DEBUG [main] - ==> Preparing: select * from website DEBUG [main] - ==> Parameters: DEBUG [main] - <== Total: 1 Website[id=1,name=编程帮,url=https://www.biancheng.net/,age=21,country=CN,createtime=Tue Feb 23 10:20:40 CST 2021]
其实创建 MyBatis 程序都是一些步骤性的,只要我们多操作几遍就能创建 MyBatis项目,最后大家如果想要了解更多java架构师知识,敬请关注奇Q工具网。
推荐阅读: