苍穹外卖Day01笔记

一、配置文件后缀与类型（XML/Properties/YML）

1. 核心后缀对照表

2. 关键说明

• “per”是.properties的简写误写，核心是key=value格式，如：server.port=8080；
• .xml侧重“复杂结构化配置”（如SQL映射、Maven依赖），.yml侧重“应用运行配置”（端口、数据库），二者分工不同。

二、MyBatis获取SQL的方式&核心注解

1. 获取SQL的2种核心方式

2. MyBatis核心注解解析

（1）@Select：查询SQL注解

• 作用：直接在Mapper接口方法上标注查询SQL，替代XML中的<select>标签；
• 示例：

  // 根据用户名查询员工@Select("SELECT * FROM employee WHERE username = #{username}")EmployeegetByUsername(Stringusername);

（2）@Param：参数绑定注解

• 作用：给方法参数命名，让SQL中能精准匹配参数（多参数必用）；
• 示例（ex）：

  // 多参数查询：@Param指定参数名，SQL中通过#{name}引用@Select("SELECT * FROM employee WHERE name = #{name} AND status = #{status}")List<Employee>getByNameAndStatus(@Param("name")Stringname,@Param("status")Integerstatus);

三、Spring/SSM核心注解

1. @ExceptionHandler：全局异常处理注解

• 归属：Spring MVC注解；
• 作用：统一捕获指定类型的异常，返回自定义响应（避免接口返回原生错误）；
• 示例：

  // 捕获所有RuntimeException异常@ExceptionHandler(RuntimeException.class)publicResulthandleRuntimeException(RuntimeExceptione){log.error("运行时异常：",e);returnResult.error("系统异常，请稍后重试");}

四、JWT令牌

1. 核心定义

JWT（JSON Web Token）是轻量级的身份认证令牌，本质是一段加密的JSON字符串，用于“前后端/服务间身份校验”。

2. 核心用途（苍穹外卖场景）

• 员工登录后，后端生成JWT令牌返回给前端；
• 前端后续请求接口时携带令牌，后端校验令牌合法性（避免重复登录）；
• 令牌包含用户ID、角色等信息，无需每次查询数据库。

3. 关键特点

• 无状态：令牌自身包含所有认证信息，服务端无需存储；
• 加密：防止篡改，保证安全性。

五、接口（API）

1. 通俗定义

接口是前端与后端、服务与服务之间的“通信约定”，规定了“请求地址、请求方式、参数、返回值”，比如：

• 前端调用http://localhost:8080/admin/employee/login（登录接口）；
• 按约定传username/password参数，后端按约定返回“登录成功/失败”结果。

2. 核心要素

• 请求地址：如/admin/employee/login；
• 请求方式：GET（查询）、POST（新增）、PUT（修改）、DELETE（删除）；
• 请求参数：前端传给后端的数据；
• 返回值：后端返回给前端的结果（如统一的Result对象）。

六、Swagger & Knife4j

1. 核心关系

2. 关键说明

• Swagger是“基础骨架”：通过@Api/@ApiOperation注解生成接口文档；
• Knife4j是“美化增强包”：依赖Swagger核心配置，仅需引入依赖+@EnableKnife4j注解，即可替换UI并新增功能；
• 访问地址：Swagger原生（/swagger-ui.html），Knife4j（/doc.html）。

七、核心总结

1. 配置文件：.xml（复杂结构）、.properties（简单键值对）、.yml（Spring Boot主流）；
2. MyBatis：获取SQL分“注解式（@Select/@Param）”和“XML式”，前者适简单SQL，后者适复杂SQL；
3. 异常处理：@ExceptionHandler统一捕获异常，提升接口友好性；
4. 认证：JWT是无状态令牌，用于接口身份校验；
5. 接口：前后端通信的“约定”，包含地址、参数、返回值等要素；
6. 文档：Swagger是基础，Knife4j是增强版，核心是自动生成可视化接口文档。