maven创建普通java项目访问mysql-mybatis

基础资料：

数据库：d1，表：t1，字段：xm，nl（即姓名、年龄），内容（'zs',20;'ls',18）

以下内容由官网“https://mybatis.org/mybatis-3/zh/getting-started.html”整理而来。不尽不实之处请参考官网原文。

思想：

1、在pom.xml文件中除了给出mybatis和jdbc的依赖之外，还应给出资源（配置）文件位置。

2、在mybatis配置文件“mybatis-config.xml”中写入信息。主要为驱动、服务器、表配置文件信息。

3、给出与表记录对应的java类（t1.java）

4、创建接口文件"t1Mapper.java"，约定要进行的数据库操作。（相当于操作数据库表的接口）

操作手册见官网，中文的，很长。一般用，看下面就差不多了。

5、创建表配置文件（如“t1Mapper.xml”），写入操作对应的sql语句。（相当于实现接口）

6、编写调用程序。

---

 步骤：

1、新建项目（ mvn -B archetype:generate -DgroupId=hc -DartifactId=p2 -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 ）。

目录结构：

修改pom.xml文件：

修改jdk版本，略

添加依赖（第13行定位）

    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.13</version>
  </dependency>
  <!-- https://mvnrepository.com/artifact/com.mysql/mysql-connector-j -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.1.0</version>
</dependency>
</dependencies>

添加资源文件（xml），第11行定位

<resources>
            <resource>
                <directory>src/main/java/hc/data</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
  </build>

2、创建并写入mybatis配置文件“mybatis-config.xml”

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "https://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://xxx.xxx.xxx.xxx:xxx/d1?useSSL=false"/>
        <property name="username" value="root"/>
        <property name="password" value="xxxxxxxx"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
    <mapper resource="t1Mapper.xml"/>
  </mappers>
</configuration>

注意：

第11行和第13行按实际情况填写。

第10行，对于mysql5.x，应该不要中间的“cj”。

第17-19行，指出一张表(t1)的操作命令（增删改查）对应的内容

3、在实体（entity）文件夹下，写出需要的表类t1.java（通常为表中记录对应的类，此处为了省事，仅使用字段）

package hc.entity;

public class t1 {
    public String xm;
    public int nl;
}

4、编写接口文件t1Mapper.java，设计操作数据表t1的方法和结果

package hc.data;
import hc.entity.t1;
public interface t1Mapper {
    t1 getByXm(String xm);
}

5、创建“t1Mapper.xml”，对具体操作进行定义。(即用xml的形式，实现t1Mapper.java的接口)

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="hc.data.t1Mapper">
  <select id="getByXm" resultType="hc.entity.t1">
    select * from t1 where xm = #{xm}
  </select>
</mapper>

说明：

第5行，名称空间应对应接口的类全名。

第6行，id是这条命令的名字，对应接口文件的方法名；结果类型为对应的java类（注意带上包名）。

第7行，#模式不用考虑数据类型问题（即引号问题）。

参数如果是类对象，可以在#{}里面直接写属性。

如果有多个参数，可以在类接口里,参数前面用 @Param("变量名") 注解标识出来，在xml中直接使用#{变量名}。

作为返回结果，如果表结构的字段与实体字段有差异，MyBatis会尝试进行转换。如果不行，最简单的做法是在sql里用as对筛选结果字段重命名，贴合实体类。

未尽事宜，可参考前述官网教程。

6、主程序App.java

package hc;

import java.io.InputStream;

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 hc.data.t1Mapper;
import hc.entity.t1;

public class App 
{
    public static void main( String[] args ) throws Exception
    {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        try (SqlSession session = sqlSessionFactory.openSession())
        {
            //t1 myt1 = session.selectOne("getByXm","ls");
            t1Mapper mapper=session.getMapper(t1Mapper.class);
            t1 myt1 = mapper.getByXm("zs");
            System.out.println(myt1.xm);
            System.out.println(myt1.nl);
        }
        catch (Exception e) {
            // TODO: handle exception
            System.out.println(e.getMessage());
        }
    }
}

说明：

按官方说法，工厂应在应用中长期存在；session应随着每次请求申请和释放。此处为简单测试例子，可以不做理会。

第23行与（24、25）行等效。

在第23行中，因为“getByXm”方法在所有程序中唯一，故前缀"hc.data.t1Mapper."可以省去。

cmd运行结果：

 （完）