jsp 语言 JSP 与 MyBatis 框架集成实践

JSP阿木 发布于 18 天前 7 次阅读

JSP 与 MyBatis 框架集成实践

随着互联网技术的不断发展，Java Web开发已经成为企业级应用开发的主流。JSP（JavaServer Pages）作为Java Web开发的重要技术之一，提供了动态生成HTML页面的能力。而MyBatis则是一个优秀的持久层框架，能够简化数据库操作。本文将围绕JSP与MyBatis的集成实践，详细探讨如何将两者结合起来，实现高效的Java Web开发。

JSP与MyBatis简介

JSP

JSP（JavaServer Pages）是一种动态网页技术，它允许开发者在HTML页面中嵌入Java代码。JSP页面由HTML标签和Java代码组成，服务器在请求到达时，会自动将JSP页面转换为Servlet，执行其中的Java代码，并生成HTML页面返回给客户端。

MyBatis

MyBatis是一个基于Java的持久层框架，它对JDBC进行了封装，简化了数据库操作。MyBatis使用XML或注解来配置SQL映射，使得数据库操作更加灵活和高效。

JSP与MyBatis集成步骤

1. 环境搭建

我们需要搭建一个Java Web开发环境。以下是所需的基本软件：

- JDK 1.8及以上版本

- Tomcat 8.5及以上版本

- MySQL数据库

- Maven 3.6及以上版本

2. 创建Maven项目

使用Maven创建一个Java Web项目，并添加以下依赖：

xml
<dependencies>

    <!-- JSP相关依赖 -->

    <dependency>

        <groupId>javax.servlet</groupId>

        <artifactId>javax.servlet-api</artifactId>

        <version>4.0.1</version>

        <scope>provided</scope>

    </dependency>

    <dependency>

        <groupId>javax.servlet.jsp</groupId>

        <artifactId>javax.servlet.jsp-api</artifactId>

        <version>2.3.3</version>

        <scope>provided</scope>

    </dependency>

    <dependency>

        <groupId>org.apache.taglibs</groupId>

        <artifactId>standard</artifactId>

        <version>1.1.2</version>

    </dependency>



<!-- MyBatis相关依赖 -->

    <dependency>

        <groupId>org.mybatis</groupId>

        <artifactId>mybatis</artifactId>

        <version>3.5.6</version>

    </dependency>

    <dependency>

        <groupId>org.mybatis.caches</groupId>

        <artifactId>mybatis-redis</artifactId>

        <version>1.0.0</version>

    </dependency>

    <dependency>

        <groupId>org.apache.commons</groupId>

        <artifactId>commons-dbcp2</artifactId>

        <version>2.1.1</version>

    </dependency>



<!-- MySQL驱动 -->

    <dependency>

        <groupId>mysql</groupId>

        <artifactId>mysql-connector-java</artifactId>

        <version>8.0.22</version>

    </dependency>

</dependencies>

3. 配置数据库连接

在`src/main/resources`目录下创建一个名为`db.properties`的文件，用于配置数据库连接信息：

properties
driver=com.mysql.cj.jdbc.Driver

url=jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC

username=root

password=root

4. 创建MyBatis配置文件

在`src/main/resources`目录下创建一个名为`mybatis-config.xml`的文件，用于配置MyBatis：

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="${driver}"/>

                <property name="url" value="${url}"/>

                <property name="username" value="${username}"/>

                <property name="password" value="${password}"/>

            </dataSource>

        </environment>

    </environments>

    <mappers>

        <mapper resource="com/example/mapper/UserMapper.xml"/>

    </mappers>

</configuration>

5. 创建Mapper接口和XML文件

在`src/main/java/com/example/mapper`目录下创建一个名为`UserMapper.java`的接口，用于定义数据库操作：

java
package com.example.mapper;



import com.example.entity.User;



public interface UserMapper {

    User getUserById(int id);

}

在`src/main/resources/com/example/mapper`目录下创建一个名为`UserMapper.xml`的XML文件，用于配置SQL映射：

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="com.example.mapper.UserMapper">

    <select id="getUserById" resultType="com.example.entity.User">

        SELECT  FROM user WHERE id = {id}

    </select>

</mapper>

6. 创建JSP页面

在`src/main/webapp`目录下创建一个名为`user.jsp`的JSP页面，用于展示用户信息：

jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

    <title>User Information</title>

</head>

<body>

<%

    String userId = request.getParameter("id");

    if (userId != null) {

        int id = Integer.parseInt(userId);

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

        User user = userMapper.getUserById(id);

        if (user != null) {

%>

    <h1>User Information</h1>

    <p>ID: <%= user.getId() %></p>

    <p>Name: <%= user.getName() %></p>

    <p>Age: <%= user.getAge() %></p>

<%

        } else {

            out.println("User not found!");

        }

    } else {

        out.println("Please provide a user ID!");

    }

%>

</body>

</html>

7. 配置Spring与MyBatis集成

为了简化MyBatis的使用，我们可以将MyBatis与Spring框架集成。在`src/main/resources`目录下创建一个名为`spring.xml`的Spring配置文件：

xml
<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

       http://www.springframework.org/schema/beans/spring-beans.xsd">



<!-- DataSource -->

    <bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource">

        <property name="driverClassName" value="${driver}"/>

        <property name="url" value="${url}"/>

        <property name="username" value="${username}"/>

        <property name="password" value="${password}"/>

    </bean>



<!-- SqlSessionFactory -->

    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">

        <property name="dataSource" ref="dataSource"/>

        <property name="configLocation" value="classpath:mybatis-config.xml"/>

    </bean>



<!-- MapperScannerConfigurer -->

    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">

        <property name="basePackage" value="com.example.mapper"/>

        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>

    </bean>



<!-- SqlSessionTemplate -->

    <bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate">

        <constructor-arg index="0" ref="sqlSessionFactory"/>

    </bean>

</beans>

在`src/main/java/com/example/config`目录下创建一个名为`SpringConfig.java`的Spring配置类：

java
package com.example.config;



import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import org.springframework.context.annotation.ImportResource;



@Configuration

@ImportResource("classpath:spring.xml")

public class SpringConfig {

    @Bean

    public SqlSessionTemplate sqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {

        return new SqlSessionTemplate(sqlSessionFactory);

    }

}

8. 配置web.xml

在`src/main/webapp/WEB-INF`目录下创建一个名为`web.xml`的文件，用于配置Spring和Servlet：

xml
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"

         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee

         http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"

         version="3.1">



<!-- Spring配置 -->

    <listener>

        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>

    </listener>

    <context-param>

        <param-name>contextConfigLocation</param-name>

        <param-value>classpath:spring.xml</param-value>

    </context-param>



<!-- Servlet配置 -->

    <servlet>

        <servlet-name>dispatcher</servlet-name>

        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>dispatcher</servlet-name>

        <url-pattern>/</url-pattern>

    </servlet-mapping>

</web-app>

总结

本文详细介绍了JSP与MyBatis的集成实践，通过搭建Java Web开发环境、配置数据库连接、创建Mapper接口和XML文件、创建JSP页面以及配置Spring与MyBatis集成等步骤，实现了高效的Java Web开发。在实际项目中，我们可以根据需求对本文所述方法进行扩展和优化。