使用MyBatis框架进行数据库开发前,需要先搭建MyBatis环境,MyBatis环境搭建的基本步骤包括创建工程、引入相关依赖、创建数据库、创建数据库连接信息配置文件、创建MyBatis的核心配置文件。本书采用MyBatis 3.5.2版本搭建MyBatis环境,具体步骤如下。
1.创建工程
启动IntelliJ IDEA开发工具,选择工具栏中的“File”→“New”→“Project”选项,弹出“New Project”对话框,如图1-2所示。
在图1-2所示的“New Project”对话框中,选择左侧菜单中的“Maven”选项,然后单击“Next”按钮,弹出项目命名对话框,如图1-3所示。
图1-2 “New Project”对话框
图1-3 项目命名对话框
在图1-3中,在“Name”文本框中为Maven项目命名,在“Location”文本框中选择项目存放的路径。单击“Artifact Coordinates”选项左侧的下拉按钮可以填写“GroupId”“ArtifactId”和“Version”。其中,“GroupId”通常设置为公司倒置的网络域名,如“com.itheima”;“ArtifactId”通常设置为项目名;“Version”为IDEA 默认版本即可。填写完成之后单击“Finish”按钮完成项目创建。项目结构如图1-4所示。
图1-4 项目结构
2.引入相关依赖
在以往Java项目的开发中,需要在项目中引入许多JAR包以便于调用JAR包中封装好的常用类集。但由于JAR包占用的内存空间较大,给项目的打包和发布带来了极大的不便,基于以上原因,Apache公司开发了项目管理工具Maven。Maven使用Maven仓库管理JAR包,使用Maven管理项目不需要再引入一个个的JAR包,只需将JAR包的依赖引入项目的pom.xml文件中就可以调用JAR包中的类,极大提高了开发人员的编程效率。由于IDEA中集成了Maven,所以本书直接使用IDEA中默认的Maven进行项目构建。
由于本项目要连接数据库并对程序进行测试,所以需要在项目的pom.xml文件中导入MySQL驱动包、JUnit测试包、MyBatis的核心包等相关依赖,具体代码如下:
1 <dependencies> 2 <dependency> 3 <groupId>org.mybatis</groupId> 4 <artifactId>mybatis</artifactId> 5 <version>3.5.2</version> 6 </dependency> 7 <dependency> 8 <groupId>mysql</groupId> 9 <artifactId>mysql-connector-java</artifactId> 10 <version>8.0.11</version> 11 </dependency> 12 <dependency> 13 <groupId>junit</groupId> 14 <artifactId>junit</artifactId> 15 <version>4.12</version> 16 <scope>test</scope> 17 </dependency> 18 </dependencies> 19 <build> 20 <resources> 21 <resource> 22 <directory>src/main/java</directory> 23 <includes> 24 <include>**/*.properties</include> 25 <include>**/*.xml</include> 26 </includes> 27 <filtering>true</filtering> 28 </resource> 29 </resources> 30 </build>
上述代码中,第2~6行代码是MyBatis的核心包;第7~11行代码是MySQL驱动包;第12~17行代码是JUnit测试包;由于IDEA不会自动编译src/main/java目录下的XML文件,第19~30行代码是将项目中src/main/java目录下的XML等资源文件编译进classes文件夹。
由于本书使用的是IDEA默认集成的Maven,所以在第一次引入依赖时,需要在联网状态下进行,且引入依赖需要较长时间,读者耐心等待依赖引入完成即可。
3.创建数据库
在MySQL中创建一个名称为mybatis的数据库,具体SQL语句如下:
create database mybatis;
4.创建数据库连接信息配置文件
在项目的src/main/resources目录下创建数据库连接的配置文件,这里将其命名为db.properties,在该文件中配置数据库连接的参数。db.properties文件的具体内容如文件1-1所示。
mysql.driver=com.mysql.cj.jdbc.Driver mysql.url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=UTC&\ characterEncoding=utf8&useUnicode=true&useSSL=false mysql.username=root mysql.password=root
5.创建MyBatis的核心配置文件
在项目的src/main/resources目录下创建MyBatis的核心配置文件,该文件主要用于项目的环境配置,如数据库连接相关配置等。核心配置文件可以随意命名,但通常将其命名为mybatis-config.xml。如无特殊说明,本书中的MyBatis核心配置文件均命名为mybatis-config.xml。mybatis-config.xml的具体实现如文件1-2所示。
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE configuration 3 PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 4 "http://mybatis.org/dtd/mybatis-3-config.dtd"> 5 <configuration> 6 <!-- 环境配置 --> 7 <!-- 加载类路径下的属性文件 --> 8 <properties resource="db.properties"/> 9 <environments default="development"> 10 <environment id="development"> 11 <transactionManager type="JDBC"/> 12 <!-- 数据库连接相关配置 ,db.properties文件中的内容--> 13 <dataSource type="POOLED"> 14 <property name="driver" value="${mysql.driver}" /> 15 <property name="url" value="${mysql.url}" /> 16 <property name="username" value="${mysql.username}" /> 17 <property name="password" value="${mysql.password}" /> 18 </dataSource> 19 </environment> 20 </environments> 21 </configuration>
在文件1-2中,第2~4行代码是核心配置文件的约束信息;第8行代码用于加载数据库连接信息配置文件db.properties;第13~18行代码是数据库连接参数的配置。
至此,MyBatis的开发环境就搭建完成了。