在构建复杂交互界面时,开发者常会遇到一个经典难题:如何优雅地区分单击(click)和双击(dblclick)事件?这个问题看似简单,却涉及浏览器事件机制、定时器控制和设计模式等多个技术维度。当我们需要开发图形编辑器、游戏UI或自定义组件库时,精确控制这两种基础交互行为往往成为用户体验的关键所在。
传统解决方案通常采用固定延迟的定时器来区分两种事件,但这种方法在动态交互场景中往往显得生硬且不可靠。本文将带你从浏览器事件流原理出发,通过融合防抖(debounce)与节流(throttle)的设计思想,构建一个可配置、高精度的事件派发系统。无论你是开发可视化工具还是复杂表单组件,这套方案都能提供更专业的交互控制能力。
当用户与页面元素交互时,浏览器会按照特定顺序触发一系列事件。对于鼠标操作,这个流程尤为复杂:
code复制mousedown -> mouseup -> click
-> mousedown -> mouseup -> click -> dblclick
关键时间参数:
注意:不同浏览器对连续点击的时间判定存在细微差异,在跨平台开发时需要特别关注。
双击事件的处理还需要考虑DOM事件流的特性:
这种传播机制意味着:
stopPropagation()可能破坏预期的双击检测逻辑最常见的解决方案是通过setTimeout延迟click事件处理:
javascript复制let clickTimer = null;
element.addEventListener('click', (e) => {
clearTimeout(clickTimer);
clickTimer = setTimeout(() => {
handleSingleClick(e);
}, 250);
});
element.addEventListener('dblclick', (e) => {
clearTimeout(clickTimer);
handleDoubleClick(e);
});
这种方案存在几个明显缺陷:
下表对比了不同延迟设置的优劣:
| 延迟时间(ms) | 优点 | 缺点 |
|---|---|---|
| 200 | 响应迅速 | 容易误判快速单击 |
| 300 | 平衡性较好 | 仍可能误判 |
| 500 | 准确度高 | 明显感知延迟 |
| 动态调整 | 自适应性强 | 实现复杂度高 |
我们可以将这个问题抽象为事件流处理模型:
javascript复制class ClickManager {
constructor(options = {}) {
this.delay = options.delay || 300;
this.state = 'idle';
this.timer = null;
}
handleClick() {
switch(this.state) {
case 'idle':
this.startPendingState();
break;
case 'pending':
this.transitionToDoubleClick();
break;
case 'cooldown':
// 忽略快速连续点击
break;
}
}
startPendingState() {
this.state = 'pending';
this.timer = setTimeout(() => {
this.emitSingleClick();
this.state = 'idle';
}, this.delay);
}
transitionToDoubleClick() {
clearTimeout(this.timer);
this.emitDoubleClick();
this.state = 'cooldown';
setTimeout(() => {
this.state = 'idle';
}, 100);
}
}
基于上述原理,我们可以构建一个更健壮的解决方案:
javascript复制function createEventDispatcher(config) {
const {
delay = 300,
onSingleClick = () => {},
onDoubleClick = () => {},
maxClicks = 2
} = config;
let clickCount = 0;
let lastClickTime = 0;
let timer = null;
return function handleEvent(e) {
const now = Date.now();
const isFastClick = now - lastClickTime < delay;
lastClickTime = now;
clickCount = isFastClick ? clickCount + 1 : 1;
clearTimeout(timer);
if (clickCount >= maxClicks) {
onDoubleClick(e);
clickCount = 0;
return;
}
timer = setTimeout(() => {
if (clickCount === 1) {
onSingleClick(e);
}
clickCount = 0;
}, delay);
};
}
// 使用示例
const button = document.getElementById('action-btn');
button.addEventListener('click', createEventDispatcher({
onSingleClick: () => console.log('Single action'),
onDoubleClick: () => console.log('Double action'),
delay: 250
}));
通过分析用户的实际点击模式,我们可以动态调整延迟阈值:
javascript复制const dynamicDelay = (baseDelay, history = []) => {
if (history.length < 3) return baseDelay;
const avgInterval = history
.slice(-3)
.reduce((sum, [,interval]) => sum + interval, 0) / 3;
return Math.min(
baseDelay * 1.5,
Math.max(
baseDelay * 0.7,
avgInterval * 0.8
)
);
};
# 1. 概述
## 1.1 什么是MyBatis
- MyBatis 是一款优秀的**持久层框架**
- 它支持自定义 SQL、存储过程以及高级映射
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录
## 1.2 持久化
数据持久化
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 内存:**断电即失**
- 数据库(jdbc),io文件持久化
## 1.3 持久层
Dao层、Service层、Controller层
- 完成持久化工作的代码块
- 层界限十分明显
## 1.4 为什么需要MyBatis
- 帮助程序员将数据存入到数据库中
- 方便
- 传统的JDBC代码太复杂了。简化、框架、自动化
- 不用MyBatis也可以。更容易上手
- 优点:
- 简单易学
- 灵活
- sql和代码的分离,提高了可维护性
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql
# 2. 第一个MyBatis程序
思路:搭建环境 --> 导入MyBatis --> 编写代码 --> 测试
## 2.1 搭建环境
搭建数据库
```sql
CREATE DATABASE `mybatis`;
USE `mybatis`;
CREATE TABLE `user`(
`id` INT(20) NOT NULL PRIMARY KEY,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`name`,`pwd`) VALUES
(1,'狂神','123456'),
(2,'张三','123456'),
(3,'李四','123456')
新建项目
xml复制<!--导入依赖-->
<dependencies>
<!--mysql驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!--mybatis-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.2</version>
</dependency>
<!--junit-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
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核心配置文件-->
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>
</configuration>
java复制//sqlSessionFactory --> sqlSession
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
//使用Mybatis第一步:获取sqlSessionFactory对象
String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
java复制//实体类
public class User {
private int id;
private String name;
private String pwd;
public User() {
}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", pwd='" + pwd + '\'' +
'}';
}
}
java复制public interface UserDao {
List<User> getUserList();
}
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=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.kuang.dao.UserDao">
<!--select查询语句-->
<select id="getUserList" resultType="com.kuang.pojo.User">
select * from mybatis.user
</select>
</mapper>
注意点:
org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.
MapperRegistry是什么?
核心配置文件中注册mappers
java复制public class UserDaoTest {
@Test
public void test(){
//第一步:获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//方式一:getMapper
UserDao userDao = sqlSession.getMapper(UserDao.class);
List<User> userList = userDao.getUserList();
for (User user : userList) {
System.out.println(user);
}
//关闭SqlSession
sqlSession.close();
}
}
可能会遇到的问题:
namespace中的包名要和Dao/mapper接口的包名一致
选择,查询语句;
java复制//根据ID查询用户
User getUserById(int id);
xml复制<select id="getUserById" parameterType="int" resultType="com.kuang.pojo.User">
select * from mybatis.user where id = #{id}
</select>
java复制@Test
public void getUserById() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}
xml复制<!--对象中的属性,可以直接取出来-->
<insert id="addUser" parameterType="com.kuang.pojo.User">
insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd});
</insert>
xml复制<update id="updateUser" parameterType="com.kuang.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id = #{id} ;
</update>
xml复制<delete id="deleteUser" parameterType="int">
delete from mybatis.user where id = #{id};
</delete>
注意点:
假设,我们的实体类,或者数据库中的表,字段或者参数过多,我们应当考虑使用Map!
java复制//万能的Map
int addUser2(Map<String,Object> map);
xml复制<!--对象中的属性,可以直接取出来 传递map的key-->
<insert id="addUser2" parameterType="map">
insert into mybatis.user (id, pwd) values (#{userid},#{passWord});
</insert>
java复制@Test
public void addUser2(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<String, Object>();
map.put("userid",5);
map.put("passWord","2222333");
mapper.addUser2(map);
sqlSession.commit();
sqlSession.close();
}
Map传递参数,直接在sql中取出key即可!【parameterType="map"】
对象传递参数,直接在sql中取对象的属性即可!【parameterType="Object"】
只有一个基本类型参数的情况下,可以直接在sql中取到!
多个参数用Map,或者注解!
模糊查询怎么写?
java复制List<User> userList = mapper.getUserLike("%李%");
xml复制select * from mybatis.user where name like "%"#{value}"%"
mybatis-config.xml
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
xml复制configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
MyBatis 可以配置成适应多种环境
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
学会使用配置多套运行环境!
MyBatis默认的事务管理器就是JDBC,连接池:POOLED
我们可以通过properties属性来实现引用配置文件
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。【db.properties】
编写一个配置文件
db.properties
properties复制driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456
在核心配置文件中映入
xml复制<!--引入外部配置文件-->
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="pwd" value="11111"/>
</properties>
xml复制<!--可以给实体类起别名-->
<typeAliases>
<typeAlias type="com.kuang.pojo.User" alias="User"/>
</typeAliases>
也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:
扫描实体类的包,它的默认别名就为这个类的类名,首字母小写!
xml复制<!--可以给实体类起别名-->
<typeAliases>
<package name="com.kuang.pojo"/>
</typeAliases>
在实体类比较少的时候,使用第一种方式。
如果实体类十分多,建议使用第二种。
第一种可以DIY别名,第二种则不行,如果非要改,需要在实体上增加注解
java复制@Alias("user")
public class User {}
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。


MapperRegistry:注册绑定我们的Mapper文件;
方式一:【推荐使用】
xml复制<!--每一个Mapper.XML都需要在Mybatis核心配置文件中注册!-->
<mappers>
<mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>
方式二:使用class文件绑定注册
xml复制<!--每一个Mapper.XML都需要在Mybatis核心配置文件中注册!-->
<mappers>
<mapper class="com.kuang.dao.UserMapper"/>
</mappers>
注意点:
方式三:使用扫描包进行注入绑定
xml复制<!--每一个Mapper.XML都需要在Mybatis核心配置文件中注册!-->
<mappers>
<package name="com.kuang.dao"/>
</mappers>
注意点:

生命周期,和作用域,是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder:
SqlSessionFactory:
SqlSession:

这里的每一个Mapper,就代表一个具体的业务!
数据库中的字段

新建一个项目,拷贝之前的,测试实体类字段不一致的情况
java复制public class User {
private int id;
private String name;
private String password;
}
测试出现问题

xml复制// select * from mybatis.user where id = #{id}
//类型处理器
// select id,name,pwd from mybatis.user where id = #{id}
解决方法:
xml复制<select id="getUserById" resultType="com.kuang.pojo.User">
select id,name,pwd as password from mybatis.user where id = #{id}
</select>
结果集映射
code复制id name pwd
id name password
xml复制<!--结果集映射-->
<resultMap id="UserMap" type="User">
<!--column数据库中的字段,property实体类中的属性-->
<result column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>
<select id="getUserById" resultMap="UserMap">
select * from mybatis.user where id = #{id}
</select>
resultMap 元素是 MyBatis 中最重要最强大的元素。ResultMap 的优秀之处——你完全可以不用显式地配置它们。如果一个数据库操作,出现了异常,我们需要排错。日志就是最好的助手!
曾经:sout、debug
现在:日志工厂!

在Mybatis中具体使用哪一个日志实现,在设置中设定!
STDOUT_LOGGING标准日志输出
在mybatis核心配置文件中,配置我们的日志!
xml复制<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>

什么是Log4j?
xml复制<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
properties复制#将等级为DEBUG的日志信息输出到console和file这两个目的地,console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file
#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/kuang.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG
xml复制<settings>
<setting name="logImpl" value="LOG4J"/>
</settings>

简单使用
在要使用Log4j的类中,导入包import org.apache.log4j.Logger;
日志对象,参数为当前类的class
java复制static Logger logger = Logger.getLogger(UserDaoTest.class);
日志级别
java复制logger.info("info:进入了testLog4j");
logger.debug("debug:进入了testLog4j");
logger.error("error:进入了testLog4j");
思考:为什么要分页?
sql复制语法:SELECT * from user limit startIndex,pageSize;
SELECT * from user limit 3; #[0,n]
使用Mybatis实现分页,核心SQL
java复制//分页
List<User> getUserByLimit(Map<String,Integer> map);
xml复制<!--分页-->
<select id="getUserByLimit" parameterType="map" resultMap="UserMap">
select * from mybatis.user limit #{startIndex},#{pageSize}
</select>
java复制@Test
public void getUserByLimit(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
HashMap<String, Integer> map = new HashMap<String, Integer>();
map.put("startIndex",1);
map.put("pageSize",2);
List<User> userList = mapper.getUserByLimit(map);
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
不再使用SQL实现分页
java复制//分页2
List<User> getUserByRowBounds();
xml复制<!--分页2-->
<select id="getUserByRowBounds" resultMap="UserMap">
select * from mybatis.user
</select>
java复制@Test
public void getUserByRowBounds(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
//RowBounds实现
RowBounds rowBounds = new RowBounds(1, 2);
//通过Java代码层面实现分页
List<User> userList = sqlSession.selectList("com.kuang.dao.UserMapper.getUserByRowBounds",null,rowBounds);
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}

了解即可,万一以后公司的架构师,说要使用,你需要知道它是什么东西!
关于接口的理解
三个面向区别
java复制@Select("select * from user")
List<User> getUsers();
xml复制<!--绑定接口-->
<mappers>
<mapper class="com.kuang.dao.UserMapper"/>
</mappers>
本质:反射机制实现
底层:动态代理!
Mybatis详细的执行流程!
我们可以在工具类创建的时候实现自动提交事务!
java复制public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession(true);
}
编写接口,增加注解
java复制public interface UserMapper {
@Select("select * from user")
List<User> getUsers();
// 方法存在多个参数,所有的参数前面必须加上 @Param("id")注解
@Select("select * from user where id = #{id}")
User getUserByID(@Param("id") int id);
@Insert("insert into user(id,name,pwd) values (#{id},#{name},#{password})")
int addUser(User user);
@Update("update user set name=#{name},pwd=#{password} where id = #{id}")
int updateUser(User user);
@Delete("delete from user where id = #{uid}")
int deleteUser(@Param("uid") int id);
}
测试类
【注意:我们必须要将接口注册绑定到我们的核心配置文件中!】
关于@Param()注解
#{} ${}区别
java复制Project Lombok is a java library that automatically plugs into your editor and build tools, spicing up your java.
Never write another getter or equals method again, with one annotation your class has a fully featured builder, Automate your logging variables, and much more.
使用步骤:
在IDEA中安装Lombok插件!
在项目中导入lombok的jar包
xml复制<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.10</version>
</dependency>
在