一:使用Mybatis框架前需要使用maven工具
maven简介
maven是一个辅助工具,可用于管理软件中用到的jar包,以及jar包之间的依赖关系
maven三要素
创建一个maven项目时需要填写的三个要素:
groupId 公司或组织的唯一标识
artifactId 项目的唯一标识
version 版本SNAPSHOT(快照版) RELEASE(发布版)
maven项目的目录结构
项目目录
|-src
|-main 正式代码
|-java java源码
|-resources 配置文件
|-test 测试代码
|-java 测试的java源码
|-resources 测试的配置文件
|-webapp
|-jsp
|-WEB-INF
|-css
|-js
pom.xml maven自身的配置文件
创建一个moven工程之配置pom.xml文件
1)pom.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>
<groupId>com.westos</groupId>
<artifactId>mybatis</artifactId>
<version>1.0</version>
</project>
- 此时可以加入管理jar包的依赖项
<!-- 依赖项 -->
<dependencies>
<dependency>
<groupId>jar的组织id</groupId>
<artifactId>jar的项目id</artifactId>
<version>版本</version>
</dependency>
</dependencies>
- 常见jar包依赖:
<!-- mysql 驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.12</version>
</dependency>
<!-- 单元测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<!-- mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<!-- 开发web程序需要用到-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>javax.servlet.jsp-api</artifactId>
<version>2.2.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<!-- 开发文件上传 -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.3</version>
</dependency>
4)我们需要在下好的mybatis文件里找到settings.xml文件放入C:\Users\Administrator.m2,然后在依赖项里面配置jar包的详细信息,点击Idea右下角的Import Changes,这时
配置好的jar包会在本地仓库找, 第一次因为本地仓库没有,就会联网到网上去下载这些jar包
下载后会把他们存入本地仓库 C:\Users\Administrator.m2\repository
国外仓库搜索地址:https://mvnrepository.com
ali仓库搜索地址:http://maven.aliyun.com/mvn/search
二. mybatis
ORM 框架
object relationship mapping
java对象 关系型数据库 映射
定义java对象与数据库表之前的映射关系,让增删改查操作变得简洁
1)在pom中加入mybatis
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>x.x.x</version>
</dependency>
- 编写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>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/eshop?serverTimezone=GMT%2B8&useSSL=false&useServerPrepStmts=true&cachePrepStmts=true&rewriteBatchedStatements=true&useCursorFetch=true&defaultFetchSize=100&allowPublicKeyRetrieval=true"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
</mappers>
</configuration>
-
编写实体类和数据库表
create table user(
username varchar(20) primary key ,
passowrd varchar(20) not null
); -
编写映射文件
主要管理sql语句
习惯是 实体类名Mapper.xml
UserMapper.xml
ProductMapper.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">
<!-- namespace="mapper的包名.mapper的文件名" 主要是防止sql名字冲突 -->
<mapper namespace="com.westos.mapper.UserMapper">
<!-- id="SQL语句的唯一标识"
parameterType="sql语句需要的参数类型"
-->
<!-- User(username,password) -->
<insert id="insert" parameterType="com.westos.entity.User">
insert into user (username, password) values (#{username},#{password})
</insert>
</mapper>
把映射文件的位置加入mybatis-config.xml中
常见错误
Mapped Statements collection does not contain value for com.westos.mapper.UserMapper.selectAll
可能原因1: <mapper>
没有加入到 mybatis-config.xml配置文件中
原因2: namespace 或id 写错了
Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: org.apache.ibatis.builder.BuilderException: Error parsing Mapper XML. Cause: org.apache.ibatis.builder.BuilderException: Error resolving class. Cause: org.apache.ibatis.type.TypeException: Could not resolve type alias ‘com.westos.aaa.User’. Cause: java.lang.ClassNotFoundException: Cannot find class: com.westos.aaa.User
检查类型名称是否写对了
调试技巧
让mybatis中的sql语句显示出来
日志包(将程序运行过程中的重要信息记录为日志)
slf4j 是一套日志接口
logback 是slf4j的实现
- 添加日志jar包
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
- 日志配置文件
logback.xml 把它放入 src/main/resources目录、
例:我这里设置的com.westos.mapper,当我运行这个目录下的代码是就会在控制台里生成日志信息
<logger name="com.westos.mapper" level="debug" additivity="false">
<appender-ref ref="STDOUT_SIMPLE" />
</logger>