MyBatis全方位指南：从入门到精通

最新推荐文章于 2025-09-14 22:22:08 发布

原创最新推荐文章于 2025-09-14 22:22:08 发布 · 1k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#spring #mvc #java

Java基础专栏收录该内容

35 篇文章

订阅专栏

Spring MVC详解：控制器、视图解析器与拦截器

Spring MVC是Spring框架的一个重要模块，用于构建基于MVC设计模式的Web应用程序。本文将详细介绍Spring MVC中的三个核心组件：控制器（Controller）、视图解析器（View Resolver）与拦截器（Interceptor），帮助读者更好地理解它们的作用与应用场景。

1. 控制器（Controller）

控制器是Spring MVC中的核心组件，负责接收用户的请求并映射到相应的处理方法。在Spring MVC中，控制器通常由一个类来担任，该类继承自Controller接口或实现HandleMapping接口。控制器的主要职责包括：

接收请求：控制器接收到用户的请求后，对请求进行解析，提取出请求的参数和类型。
映射请求：根据请求的URL或方法名，控制器将请求映射到相应的处理方法。
处理请求：调用业务层处理请求，并将处理结果返回给用户。

应用场景

假设我们有一个在线书店的Web应用程序，用户可以通过访问不同的URL来查看书籍列表、购买书籍等。在这个场景中，我们可以定义一个控制器来处理用户的请求：

@Controller
public class BookController {
    @RequestMapping("/books")
    public ModelAndView listBooks() {
        // 查询数据库获取书籍列表
        List<Book> books = bookService.getAllBooks();
        // 创建ModelAndView对象，将书籍列表传递给视图
        ModelAndView modelAndView = new ModelAndView("bookList", "books", books);
        return modelAndView;
    }
    @RequestMapping("/book/{id}")
    public ModelAndView viewBook(@PathVariable("id") int id) {
        // 查询数据库获取指定书籍信息
        Book book = bookService.getBookById(id);
        // 创建ModelAndView对象，将书籍信息传递给视图
        ModelAndView modelAndView = new ModelAndView("bookDetail", "book", book);
        return modelAndView;
    }
}

实用技巧

在控制器中，我们可以使用@RequestMapping注解来指定请求的URL和HTTP方法。例如，@GetMapping用于处理GET请求，@PostMapping用于处理POST请求。
控制器中的处理方法可以接受多个参数，包括请求参数、路径变量、请求头等。这些参数可以通过HttpServletRequest、HttpServletResponse、Model和ModelMap等对象来获取。
控制器中的处理方法可以返回多个类型，包括String、ModelAndView、ResponseEntity等。其中，ModelAndView对象用于将数据传递给视图，ResponseEntity对象用于返回HTTP响应。

2. 视图解析器（View Resolver）

视图解析器负责将控制器处理后的数据渲染为视图，并将其返回给用户。在Spring MVC中，视图解析器通常由一个类来实现，该类继承自ViewResolver接口。视图解析器的主要职责包括：

解析视图名称：将控制器返回的视图名称（例如：“bookList”）解析为实际的视图路径（例如：“/WEB-INF/views/bookList.jsp”）。
渲染视图：根据视图路径找到对应的视图模板，将控制器处理后的数据填充到视图中，并将渲染后的视图返回给用户。

应用场景

在在线书店的Web应用程序中，我们可能需要使用不同的视图来展示书籍列表、书籍详情等。为了实现这一点，我们可以定义一个视图解析器来处理不同的视图需求：

@Configuration
public class ViewResolverConfig {
    @Bean
    public ViewResolver viewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".jsp");
        return resolver;
    }
}

实用技巧

在视图解析器中，我们可以通过设置前缀和后缀来指定视图的路径。这样，视图解析器在渲染视图时，会自动添加相应的路径前缀和后缀。
视```
视图解析器支持多种视图技术，例如JSP、Thymeleaf、FreeMarker等。我们可以根据项目需求选择合适的视图技术，并在视图解析器中进行配置。
在视图解析器中，我们可以使用ViewResolver接口的resolveViewName方法来解析视图名称。该方法会根据视图名称查找对应的视图路径，如果找不到对应的视图，可以返回null或抛出异常。

3. 拦截器（Interceptor）

拦截器是Spring MVC中的一个高级特性，用于在请求处理前后添加额外的处理逻辑。拦截器可以用于实现全局的日志记录、权限验证、事务管理等功能。在Spring MVC中，拦截器由一个类来实现，该类需要实现HandlerInterceptor接口。拦截器的主要职责包括：

预处理请求：在控制器处理请求之前，拦截器可以对请求进行预处理，例如检查用户权限、添加日志等。
处理请求：在控制器处理请求之后，拦截器可以对请求进行处理，例如添加响应头、修改响应内容等。
后处理请求：在控制器处理请求之后，拦截器可以对请求进行后处理，例如记录日志、释放资源等。

应用场景

在在线书店的Web应用程序中，我们可能需要对用户的请求进行权限验证，以确保只有登录用户才能访问购买书籍的功能。为了实现这一点，我们可以定义一个拦截器来处理权限验证：

@Configuration
public class InterceptorConfig {
    @Bean
    public HandlerInterceptor bookShopInterceptor() {
        return new HandlerInterceptor() {
            @Override
            public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
                // 检查用户是否登录
                if (request.getSession().getAttribute("user") == null) {
                    // 如果没有登录，重定向到登录页面
                    response.sendRedirect("/login");
                    return false;
                }
                return true;
            }
        };
    }
}

实用技巧

拦截器中的preHandle方法在控制器处理请求之前调用，可以用于实现请求预处理功能。例如，我们可以在这个方法中检查用户权限、验证请求参数等。
拦截器中的postHandle方法在控制器处理请求之后调用，可以用于实现请求后处理功能。例如，我们可以在这个方法中添加响应头、修改响应内容等。
拦截器中的afterCompletion方法在请求处理完成后调用，可以用于实现请求后处理功能。例如，我们可以在这个方法中记录日志、释放资源等。
为了保证拦截器的执行顺序，我们可以使用@Order注解来指定拦截器的执行顺序。例如，以下代码表示第一个拦截器的执行顺序高于第二个拦截器：

@Order(1)
@Configuration
public class FirstInterceptorConfig {
    // ...
}
@Order(2)
@Configuration
public class SecondInterceptorConfig {
    // ...
}
```# MyBatis入门：映射文件、动态SQL与结果映射
本文将为你介绍MyBatis的核心概念：映射文件、动态SQL和结果映射。通过阅读，你将了解到如何在Java项目中使用MyBatis来简化数据库操作，并提供一些实用的技巧和案例。
## MyBatis简介
在开始学习MyBatis之前，我们先来了解一下为什么需要MyBatis。在传统的Java项目中，我们通常使用JDBC来操作数据库，但是这种方式存在一些问题：
1. 代码冗长：每次操作数据库都需要编写大量的代码，包括创建连接、执行SQL、处理结果等。
2. 代码耦合：数据库操作的代码与业务逻辑的代码紧密耦合，不利于代码维护和扩展。
为了解决这些问题，MyBatis应运而生。MyBatis是一个半ORM（对象关系映射）框架，它允许我们将SQL语句与Java对象进行映射，从而简化数据库操作并提高代码的可读性和可维护性。
## 映射文件
MyBatis的核心之一是映射文件。映射文件定义了SQL语句与Java对象之间的映射关系。通过映射文件，我们可以将SQL语句与Java方法进行绑定，实现对数据库的操作。
### 应用场景
假设我们有一个用户表（user），其中包含id、name和email列。我们想要查询用户表中的所有记录，并将结果映射到User对象。
首先，我们需要创建一个User类，用于表示用户表中的记录：
```java
public class User {
    private int id;
    private String name;
    private String email;
    // getter和setter方法
}

然后，我们创建一个映射文件userMapper.xml，用于定义SQL语句与User对象之间的映射关系：

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectAll" resultType="User">
        SELECT * FROM user
    </select>
</mapper>

在这个映射文件中，我们定义了一个名为"selectAll"的SQL语句，它将查询用户表中的所有记录，并将结果映射到User对象。

实用技巧

使用MyBatis的Mapper接口和映射文件，可以实现数据库操作的解耦，使得业务逻辑代码更加简洁。
在映射文件中，可以使用MyBatis提供的各种SQL语句标签，如、、和，来简化SQL语句的编写。

动态SQL

MyBatis另一个核心特性是动态SQL。动态SQL允许我们在XML映射文件中编写可变的SQL语句，根据不同的条件生成不同的SQL语句。

应用场景

假设我们想要查询用户表中年龄大于30岁的用户。我们可以使用MyBatis的<if>标签来实现动态SQL：

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectUsersByAge" parameterType="int" resultType="User">
        SELECT * FROM user
        <if test="age > 30">
            WHERE age > 30
        </if>
    </select>
</mapper>

在这个例子中，我们使用<if>标签来检查参数age是否大于30。如果条件成立，SQL语句将添加WHERE age > 30子句。

实用技巧

使用MyBatis的动态SQL，可以根据不同的条件生成不同的SQL语句，提高代码的灵活性。
MyBatis提供了多种动态SQL标签，如<if>、<choose>、<when>、<otherwise>和<foreach>，可以根据实际需求选择合适的标签。

结果映射

结果映射是MyBatis的核心特性之一。它允许我们将SQL查询的结果映射到Java对象。通过结果映射，我们可以将多列的数据映射到单一的Java对象。

应用场景

假设我们有一个订单表（order），其中包含id、customer_id和amount列。我们想要查询订单表中的所有记录，并将结果映射到Order对象。
首先，我们需要创建一个Order类，用于表示订单表中的记录：

public class Order {```
    private int id;
    private int customerId;
    private double amount;
    // getter和setter方法
}

然后，我们创建一个映射文件orderMapper.xml，用于定义SQL语句与Order对象之间的映射关系：

<mapper namespace="com.example.mapper.OrderMapper">
    <select id="selectAllOrders" resultMap="orderResultMap">
        SELECT id, customer_id, amount FROM order
    </select>
    <resultMap id="orderResultMap" type="Order">
        <id column="id" property="id" />
        <result column="customer_id" property="customerId" />
        <result column="amount" property="amount" />
    </resultMap>
</mapper>

在这个映射文件中，我们定义了一个名为"selectAllOrders"的SQL语句，它将查询订单表中的所有记录，并将结果映射到Order对象。我们还定义了一个名为"orderResultMap"的结果映射，它将SQL查询的列映射到Order对象的属性。

实用技巧

使用结果映射，可以将多列的数据映射到单一的Java对象，提高代码的可读性和可维护性。
MyBatis提供了丰富的结果映射标签，如<id>、<result>、<collection>、<association>和<discriminator>，可以根据实际需求选择合适的标签。

总结

通过本文的介绍，你应该对MyBatis的核心概念有了更深入的了解。MyBatis的映射文件、动态SQL和结果映射特性可以帮助你简化数据库操作，提高代码的可读性和可维护性。在实际开发中，根据不同的应用场景，灵活运用这些特性，可以让你更加高效地完成数据库相关的开发工作。
记住，学习和使用MyBatis的目的是为了提高工作效率和代码质量，所以在实际项目中，要根据需求和实际情况来选择合适的MyBatis特性。不断实践和探索，你将更加熟练地掌握MyBatis，并能够发挥它的最大潜力。

在上一部分，我们介绍了MyBatis的基础知识，包括映射文件、动态SQL和结果映射。在这一部分，我们将深入探讨MyBatis的一些高级特性，如插件、类型处理器、执行器和事务管理。
## 插件
MyBatis 允许开发者自定义插件来扩展其功能。插件可以拦截MyBatis的SQL执行过程中的各个阶段，从而实现诸如性能分析、日志记录、SQL优化等目的。
### 应用场景
假设我们想要记录每个SQL语句的执行时间，以便进行性能分析。我们可以编写一个插件来拦截SQL的执行，并记录执行时间。
```java
public class MyBatisExecutorInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) {
        long startTime = System.currentTimeMillis();
        Object result = invocation.proceed();
        long endTime = System.currentTimeMillis();
        System.out.println("SQL executed in " + (endTime - startTime) + "ms");
        return result;
    }
}

要使插件生效，我们需要将其注册到MyBatis的配置中：

SqlSessionFactory sqlSessionFactory = ...
Interceptor interceptor = new MyBatisExecutorInterceptor();
sqlSessionFactory.getConfiguration().addInterceptor(interceptor);

实用技巧

MyBatis提供了丰富的拦截点，如ExecutorType.BATCH、StatementType.PREPARED等，可以根据需要选择合适的拦截点。
插件可以用于实现多种功能，如缓存、分页、动态数据源等。

类型处理器

MyBatis 类型处理器（TypeHandler）用于处理Java类型和JDBC类型之间的映射。默认情况下，MyBatis会为常见的Java类型提供对应的类型处理器，但如果你需要处理特殊类型或者自定义类型，你可以自定义类型处理器。

应用场景

假设我们有一个自定义的日期类型CustomDate，我们希望MyBatis在数据库中存储它的ISO8601格式。我们可以编写一个类型处理器来处理这种格式：

public class CustomDateTypeHandler extends BaseTypeHandler<CustomDate> {
    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, CustomDate parameter, JdbcType jdbcType)
        throws SQLException {
        ps.setString(i, parameter.toString());
    }
    // 实现其他必要的方法
}

然后，在映射文件中注册我们的类型处理器：

<typeHandlers>
    <typeHandler handler="com.example.typehandler.CustomDateTypeHandler" />
</typeHandlers>

实用技巧

类型处理器可以用于处理复杂的Java类型，如枚举、自定义对象等。
自定义类型处理器时，要确保实现所有必要的方法，如setNonNullParameter、setNullParameter等。

执行器

MyBatis 提供了多种执行器（Executor）类型，用于执行SQL语句。默认的执行器是SIMPLE，它适用于单条SQL语句的执行。对于批量操作，可以使用BATCH执行器。

应用场景

假设我们需要执行一批插入操作，可以使用BATCH执行器来提高效率：

List<User> users = ...; // 假设这是一个用户列表
SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH);
try {
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    for (User user : users) {
        userMapper.insertUser(user);
    }
    sqlSession.commit();
} finally {
    sqlSession.close();
}

实用技巧

使用BATCH执行器时，注意事务的管理，确保在适当的时候提交事务。
对于复杂的批量操作，可以考虑使用MyBatis的SqlSessionDaoSupport类，它提供了简化的批量操作支持。

事务管理

如果觉得文章对您有帮助，可以关注同名公众号『随笔闲谈』，获取更多内容。欢迎在评论区留言，我会尽力回复每一条留言。如果您希望持续关注我的文章，请关注我的博客。您的点赞和关注是我持续写作的动力，谢谢您的支持！
总结
Spring MVC中的控制器、视图解析器和拦截器是构建Web应用程序的关键组件。通过理解它们的作用和应用场景，我们可以更好地使用Spring MVC来构建高效、可扩展的Web应用程序。

以上是关于Spring MVC中控制器、视图解析器和拦截器的详解。希望这篇文章能够帮助读者更好地理解这三个组件的作用和应用场景，并在实际的开发工作中发挥出更大的价值。# 结语
Spring MVC的三个核心组件——控制器、视图解析器和拦截器，是构建强大且灵活的Web应用程序的基础。通过合理的配置和使用，我们可以实现更加高效的数据处理、视图渲染和请求控制。
在实际开发中，我们应该根据项目的具体需求来选择和定制这些组件。例如，对于不同的业务逻辑，我们可以定义专门的控制器来处理；对于视图渲染，我们可以根据不同的视图技术来选择合适的视图解析器；对于全局性的功能，如权限验证和日志记录，拦截器提供了完美的解决方案。
此外，Spring MVC还提供了许多其他的特性，如请求映射、异常处理、国际化和本地化等，这些都是我们在开发过程中需要掌握的关键点。通过深入理解Spring MVC的这些特性，我们可以更好地应对复杂的Web开发场景，提高开发效率，提升应用程序的质量。
最后，作为一个开发人员，我们应该持续学习最新的技术和最佳实践，不断优化我们的代码和架构设计，以适应不断变化的技术环境。希望这篇文章能够为你提供有价值的信息，并激发你对Spring MVC的深入探索。
> 注意：本文中使用的Markdown格式仅作为展示用途，实际编写代码时，请根据您的开发环境和工具选择合适的格式。

 > 如果觉得文章对您有帮助，可以关注同名**公众号『随笔闲谈』**，获取更多内容。欢迎在评论区留言，我会尽力回复每一条留言。如果您希望持续关注我的文章，请关注我的博客。您的点赞和关注是我持续写作的动力，谢谢您的支持！