目录
Spring Boot 实战篇（十九）：更新用户密码功能的实现
一、前端页面设计
（一）创建更新密码页面
二、后端实现
（一）在服务层添加更新密码方法
（二）在控制器中添加更新密码接口
（三）数据访问层（DAO）相关方法（假设使用 MyBatis）
在保障用户账户安全和提供良好用户体验方面，更新用户密码功能是 Web 应用程序中的重要组成部分。以下将详细介绍使用 Spring Boot 实现更新用户密码功能的步骤，并附上相应的代码示例。
一、前端页面设计
（一）创建更新密码页面
HTML 结构搭建
使用 HTML 构建一个用于更新用户密码的页面，包含输入框用于输入旧密码、新密码和确认新密码，以及一个提交按钮。例如：
更新密码
前端交互逻辑（可选）
在 JavaScript 文件（如updatePassword.js）中，可以编写一些交互逻辑，如点击提交按钮时收集表单数据并发送 POST 请求到后端，以及处理更新成功或失败的提示信息，同时可以进行简单的密码格式校验（如密码长度、复杂度等）。例如：
document.querySelector('form').addEventListener('submit', function (e) {
e.preventDefault();
const oldPassword = document.getElementById('oldPassword').value;
const newPassword = document.getElementById('newPassword').value;
const confirmPassword = document.getElementById('confirmPassword').value;
if (newPassword!== confirmPassword) {
alert('新密码和确认新密码不一致');
return;
}
if (newPassword.length < 8) {
alert('新密码长度至少为8位');
return;
}
const userData = {oldPassword: oldPassword, newPassword: newPassword};
// 发送POST请求到后端更新密码
fetch('/update-password', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(userData)
}).then(response => {
if (response.ok) {
alert('密码更新成功');
} else {
alert('密码更新失败');
}
});
});
二、后端实现
（一）在服务层添加更新密码方法
定义服务层接口方法
在UserService接口中添加updatePassword方法，用于处理更新用户密码的业务逻辑。代码示例：
package com.example.myproject.service;
import com.example.myproject.entity.User;
public interface UserService {
boolean updatePassword(User user, String oldPassword, String newPassword);
}
实现服务层接口方法
在UserServiceImpl类中实现updatePassword方法，步骤如下：
接收用户对象、旧密码和新密码作为参数。根据用户 ID 查询数据库中原始用户信息（调用UserDao的findById方法）。使用密码编码器（假设已经配置好）验证旧密码是否正确。如果旧密码正确，对新密码进行加密。将原始用户对象中的密码更新为加密后的新密码。将更新后的用户对象保存到数据库（调用UserDao的update方法，假设UserDao中有此方法）。代码示例：
package com.example.myproject.service.impl;
import com.example.myproject.dao.UserDao;
import com.example.myproject.entity.User;
import com.example.myproject.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.stereotype.Service;
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserDao userDao;
@Autowired
private BCryptPasswordEncoder passwordEncoder;
@Override
public boolean updatePassword(User user, String oldPassword, String newPassword) {
User originalUser = userDao.findById(user.getId());
if (originalUser!= null) {
if (passwordEncoder.matches(oldPassword, originalUser.getPassword())) {
String encryptedNewPassword = passwordEncoder.encode(newPassword);
originalUser.setPassword(encryptedNewPassword);
return userDao.update(originalUser) > 0;
} else {
return false;
}
}
return false;
}
}
（二）在控制器中添加更新密码接口
创建更新密码接口方法
在UserController中添加一个处理更新密码请求的方法，使用@PostMapping注解标识该方法处理 HTTP POST 请求，请求路径为/update-password（与前端发送请求的路径一致）。在方法中接收前端传来的用户信息（通过@RequestBody注解将 JSON 数据转换为User对象）、旧密码和新密码，调用服务层的updatePassword方法处理更新密码逻辑，并根据结果返回相应的响应给前端。代码示例：
package com.example.myproject.controller;
import com.example.myproject.entity.User;
import com.example.myproject.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
@Autowired
private UserService userService;
@PostMapping("/update-password")
public ResponseEntity
boolean success = userService.updatePassword(user, oldPassword, newPassword);
if (success) {
return new ResponseEntity<>("密码更新成功", HttpStatus.OK);
} else {
return new ResponseEntity<>("密码更新失败", HttpStatus.INTERNAL_SERVER_ERROR);
}
}
}
（三）数据访问层（DAO）相关方法（假设使用 MyBatis）
在UserDao接口中定义更新密码方法
如果使用 MyBatis，在UserDao接口中定义update方法（如果之前没有定义，或者可以根据实际情况调整该方法的参数和功能），用于更新数据库中的用户密码。代码示例：
package com.example.myproject.dao;
import com.example.myproject.entity.User;
public interface UserDao {
User findById(Long id);
int update(User user);
}
在UserDao.xml中编写更新密码的 SQL 语句
在src/main/resources/mapper/UserDao.xml文件中，编写更新密码的 SQL 语句与update方法映射。代码示例：
SELECT * FROM user WHERE id = #{id}
UPDATE user SET password = #{password} WHERE id = #{id}
通过以上步骤，我们实现了更新用户密码功能。在实际应用中，还可以进一步优化，如添加更严格的密码复杂度校验（如要求包含数字、字母、特殊字符等）、在密码更新成功后强制用户重新登录以确保安全性、记录密码更新操作日志等，以提高系统的安全性和用户体验。同时，确保密码的加密存储和安全传输，防止密码泄露。