Skip to content

用户相关的页面还剩下两个,这节我们来写一下:

首先是修改密码的页面,把注册页面的表单拿过来改改就行:

javascript
import { Button, Form, Input, message } from 'antd';
import { useForm } from 'antd/es/form/Form';
import './update_password.css';
import { useCallback } from 'react';
import { Link, useNavigate } from 'react-router-dom';

export interface UpdatePassword {
    email: string;
    captcha: string;
    password: string;
    confirmPassword: string;
}

const layout1 = {
    labelCol: { span: 6 },
    wrapperCol: { span: 18 }
}

const layout2 = {
    labelCol: { span: 0 },
    wrapperCol: { span: 24 }
}

export function UpdatePassword() {
    const [form] = useForm();
    const navigate = useNavigate();

    const onFinish = useCallback(async (values: UpdatePassword) => {
        console.log(values);
    }, []);

    const sendCaptcha = useCallback(async function () {
        console.log('send captcha')
    }, []);
    

    return <div id="updatePassword-container">
        <h1>会议室预订系统</h1>
        <Form
            form={form}
            {...layout1}
            onFinish={onFinish}
            colon={false}
            autoComplete="off"
        >
            <Form.Item
                label="邮箱"
                name="email"
                rules={[
                    { required: true, message: '请输入邮箱!' },
                    { type: "email", message: '请输入合法邮箱地址!'}
                ]}
            >
                <Input />
            </Form.Item>

            <div className='captcha-wrapper'>
                <Form.Item
                    label="验证码"
                    name="captcha"
                    rules={[{ required: true, message: '请输入验证码!' }]}
                >
                    <Input />
                </Form.Item>
                <Button type="primary" onClick={sendCaptcha}>发送验证码</Button>
            </div>

            <Form.Item
                label="密码"
                name="password"
                rules={[{ required: true, message: '请输入密码!' }]}
            >
                <Input.Password />
            </Form.Item>

            <Form.Item
                label="确认密码"
                name="confirmPassword"
                rules={[{ required: true, message: '请输入确认密码!' }]}
            >
                <Input.Password />
            </Form.Item>

            <Form.Item
                {...layout1}
                label=" "
            >
                <Button className='btn' type="primary" htmlType="submit">
                    修改
                </Button>
            </Form.Item>
        </Form>
    </div>   
}

css 部分如下:

css
#updatePassword-container {
    width: 400px;
    margin: 100px auto 0 auto;
    text-align: center;
}
#updatePassword-container .btn {
    width: 100%;
}
#updatePassword-container .captcha-wrapper {
    display: flex;
    justify-content: flex-end;
}

跑起来是这样的:

然后再调用下后端接口。

这时我发现一个问题:

之前写的 update_password 接口需要登录,然后用 @UserInfo 从 reqeust.user 取 userId。

但其实这个页面是从这里点进来的:

这时候并没有登录,只是通过邮箱验证身份,然后修改密码。

但是邮箱我们并没有添加唯一约束,只有 username 是在注册的时候做了唯一检查:

所以需要通过 username 来找到修改密码的用户。

可以改成前端传 username,然后后端验证过邮箱验证码之后,再根据 username 查询摇改密码的用户。

此外,我们在 User 的 entity 这里给 username 添加唯一约束:

然后可以看到 typeorm 确实给 username 添加了唯一索引:

在 mysql workbench 里也可以看到:

然后修改下 update_password 接口:

把 @RequireLogin、@ApiBearAuth 还有 @UsrInfo 去掉。

修改 UpdatePasswordDto,添加 username 属性:

javascript
@IsNotEmpty({
    message: '用户名不能为空'
})
@ApiProperty()
username: string;

然后改下 UserService 的 updatePassword 方法:

改成根据 username 查询用户,并且还要验证下邮箱是否正确。

javascript
const foundUser = await this.userRepository.findOneBy({
  username: passwordDto.username
});

if(foundUser.email !== passwordDto.email) {
    throw new HttpException('邮箱不正确', HttpStatus.BAD_REQUEST);
}

还有,发送验证码接口的 @RequireLogin 和 @ApiBearerAuth 也要去掉:

测试下:

请求 /user/update_password/captcha 接口发送验证码:

然后请求 /user/update_password 接口:

提示修改密码成功。

我们在页面登录下试试:

用最新密码登录,提示登录成功。

postman 里跑通流程之后,我们在页面里加一下。

在更改密码页面加上 username 表单项:

javascript
<Form.Item
    label="用户名"
    name="username"
    rules={[
        { required: true, message: '请输入用户名!' },
    ]}
>
    <Input />
</Form.Item>

类型中也加上 username:

然后在 interfaces.ts 添加这两个接口:

javascript
export async function updatePasswordCaptcha(email: string) {
    return await axiosInstance.get('/user/update_password/captcha', {
        params: {
            address: email
        }
    });
}

export async function updatePassword(data: UpdatePassword) {
    return await axiosInstance.post('/user/update_password', data);
}

更改密码页面里调用下:

javascript
const sendCaptcha = useCallback(async function () {
    const address = form.getFieldValue('email');
    if(!address) {
        return message.error('请输入邮箱地址');
    }

    const res = await updatePasswordCaptcha(address);
    if(res.status === 201 || res.status === 200) {
        message.success(res.data.data);
    } else {
        message.error('系统繁忙,请稍后再试');
    }
}, []);

发送验证码接口的调用逻辑和注册时一模一样。

更改密码接口的调用逻辑也和注册差不多:

javascript
const onFinish = useCallback(async (values: UpdatePassword) => {
    if(values.password !== values.confirmPassword) {
        return message.error('两次密码不一致');
    }
    const res = await updatePassword(values);

    const { message: msg, data} = res.data;

    if(res.status === 201 || res.status === 200) {
        message.success('密码修改成功');
        setTimeout(() => {
            navigate('/login');
        }, 1500);
    } else {
        message.error(data || '系统繁忙,请稍后再试');
    }
}, []);

测试下:

填入邮箱,点击发送验证码。

提示发送成功。

邮箱里也收到了这个验证码。

然后填入新密码,点击修改密码按钮:

提示修改成功,然后会跳到登录页面:

在登录页面用新密码登录,提示登录成功。

这样,修改密码功能的前后端就都完成了。

然后还有一个更改个人信息的页面。

这个页面有所不同。

前面几个功能都是未登录时的,而这个修改个人信息的功能需要登录之后才能用。

而且界面上方是有公共的导航栏的。

所以这个页面要声明一个 /index 的路由作为父级路由,然后 /index/update_info 作为子路由。

添加一个 index/index.tsx 页面

javascript
import { UserOutlined } from "@ant-design/icons";
import { Outlet } from "react-router-dom";
import './index.css';

export function Index() {
    return <div id="index-container">
        <div className="header">
            <h1>会议室预定系统</h1>
            <UserOutlined className="icon"/>
        </div>
        <div className="body">
            <Outlet></Outlet>
        </div>
    </div>
}

这里用到了 antd 的 icon 组件,需要安装用到的包:

npm install @ant-design/icons --save

css 如下:

css
#index-container{
    height: 100vh;
    display: flex;
    flex-direction: column;
}
#index-container .header{
    height: 80px;
    border-bottom: 1px solid #aaa;
    line-height: 80px;
    display: flex;
    justify-content: space-between;
    padding: 0 20px;
}
#index-container h1{
    margin: 0;
}

#index-container .icon {
    font-size: 40px;
    margin-top: 20px;
}
#index-container .body{
    flex: 1;
}

整体是竖直的 flex 布局,高度 100vh,上面 80px 下面 flex:1

然后 header 部分是 水平的 flex 布局。

把它添加到 /index 的路由,并且添加两个子路由:

javascript
{
    path: "/",
    element: <Index></Index>,
    errorElement: <ErrorPage />,
    children: [
      {
        path: 'aaa',
        element: <div>aaa</div>
      },
      {
        path: 'bbb',
        element: <div>bbb</div>
      }
    ]
},

测试下:

没啥问题。

然后在下面添加 update_info 路由,并实现 page/update_info/UpdateInfo 组件:

javascript
import { Button, Form, Input, message } from 'antd';
import { useForm } from 'antd/es/form/Form';
import { useCallback } from 'react';
import './update_info.css';
import { useNavigate } from 'react-router-dom';

export interface UserInfo {
    headPic: string;
    nickName: string;
    email: string;
    captcha: string;
}

const layout1 = {
    labelCol: { span: 6 },
    wrapperCol: { span: 18 }
}

export function UpdateInfo() {
    const [form] = useForm();
    const navigate = useNavigate();

    const onFinish = useCallback(async (values: UserInfo) => {
        
    }, []);

    const sendCaptcha = useCallback(async function () {
    }, []);

    return <div id="updateInfo-container">
        <Form
            form={form}
            {...layout1}
            onFinish={onFinish}
            colon={false}
            autoComplete="off"
        >
            <Form.Item
                label="头像"
                name="headPic"
                rules={[
                    { required: true, message: '请输入头像!' },
                ]}
            >
                <Input/>
            </Form.Item>

            <Form.Item
                label="昵称"
                name="nickName"
                rules={[
                    { required: true, message: '请输入昵称!' },
                ]}
            >
                <Input />
            </Form.Item>

            <Form.Item
                label="邮箱"
                name="email"
                rules={[
                    { required: true, message: '请输入邮箱!' },
                    { type: "email", message: '请输入合法邮箱地址!'}
                ]}
            >
                <Input />
            </Form.Item>

            <div className='captcha-wrapper'>
                <Form.Item
                    label="验证码"
                    name="captcha"
                    rules={[{ required: true, message: '请输入验证码!' }]}
                >
                    <Input />
                </Form.Item>
                <Button type="primary" onClick={sendCaptcha}>发送验证码</Button>
            </div>

            <Form.Item
                {...layout1}
                label=" "
            >
                <Button className='btn' type="primary" htmlType="submit">
                    修改
                </Button>
            </Form.Item>
        </Form>
    </div>   
}

和前几个页面差不多。

css:

css
#updateInfo-container {
    width: 400px;
    margin: 50px auto 0 auto;
    text-align: center;
}
#updateInfo-container .btn {
    width: 100%;
}
#updateInfo-container .captcha-wrapper {
    display: flex;
    justify-content: flex-end;
}

访问 /update_info 可以看到这个页面:

这个页面涉及到 3 个接口:

  • /user/info 查询用户信息的接口,用来回显数据

  • /user/update 修改用户信息的接口,用来做修改

  • /user/update/captcha 发送验证码的接口

我们看下 swagger 接口文档:

/user/info 接口没有参数,但是需要登录:

/user/update 接口需要在 body 传这么几个参数:

/user/update/captcha 需要传一个邮箱地址:

不知道有没有同学发现这里有点不太合理:

邮箱是用户自己传的,那如果传的不是注册用的邮箱呢?

前面发送验证码需要传邮箱地址,是因为那是注册或者修改密码用,没有登录。

而现在已经登录了,就不应该再传邮箱地址了,应该是放在 jwt 里,然后在 LoginGuard 里取出来注入 controller。

我们改一下:

改一下这个 login 接口,在 jwt 里放 email 的信息:

同时 refresh 接口也要改下放在 jwt 里的信息:

这里要取 user.email,需要在 UserService 的 findUserById 方法里返回下 email:

然后在 LoginGuard 里从 jwt 里取出 email 来:

然后在 /user/update/captcha 就可以直接从 request.user 里拿 email 信息了:

把参数的标注去掉,其余的都不用变,这样就是从 jwt 里取登录用户的 email 来发邮件了。

我们测试下:

先登录:

然后用这个 accessToken 访问下发送验证码接口:

发送成功,收到了这个验证码:

然后调用下查询用户信息的接口:

之后调用修改接口:

在数据库里看下,用户信息已经改过来了:

postman 里接口的流程跑通之后,我们在页面调用下。

首先在 interfaces.ts 里添加这 3 个接口:

javascript
export async function getUserInfo() {
    return await axiosInstance.get('/user/info');
}

export async function updateInfo(data: UserInfo) {
    return await axiosInstance.post('/user/update', data);
}

export async function updateUserInfoCaptcha() {
    return await axiosInstance.get('/user/update/captcha');
}

然后我们先做用户信息的回显:

javascript

useEffect(() => {
    async function query() {
        const res = await getUserInfo();

        const { data } = res.data;

        if(res.status === 201 || res.status === 200) {
            console.log(data);
        }
    }
    query();
}, []);

调用 getUserInfo 接口,返回数据后打印下。

这个接口的访问需要登录,也就是要从 localStorage 里取出 accessToken 放到 header 里。

这种携带 header 的通用逻辑可以放在 axios 的 interceptor 里做。

并且还有 token 过期之后调用 refresh 刷新 token 的逻辑。

这个我们前面写过,直接拿过来放在 interfaces.ts 里:

javascript
import { message } from "antd";

const axiosInstance = axios.create({
    baseURL: 'http://localhost:3005/',
    timeout: 3000
});

axiosInstance.interceptors.request.use(function (config) {
    const accessToken = localStorage.getItem('access_token');

    if(accessToken) {
        config.headers.authorization = 'Bearer ' + accessToken;
    }
    return config;
})

interface PendingTask {
    config: AxiosRequestConfig
    resolve: Function
  }
let refreshing = false;
const queue: PendingTask[] = [];

axiosInstance.interceptors.response.use(
    (response) => {
        return response;
    },
    async (error) => {
        if(!error.response) {
            return Promise.reject(error);
        }
        let { data, config } = error.response;

        if(refreshing) {
            return new Promise((resolve) => {
                queue.push({
                    config,
                    resolve
                });
            });
        }

        if (data.code === 401 && !config.url.includes('/user/refresh')) {
            
            refreshing = true;

            const res = await refreshToken();

            refreshing = false;

            if(res.status === 200 || res.status === 201) {

                queue.forEach(({config, resolve}) => {
                    resolve(axiosInstance(config))
                })

                return axiosInstance(config);
            } else {
                message.error(res.data);

                setTimeout(() => {
                    window.location.href = '/login';
                }, 1500);
            }
            
        } else {
            return error.response;
        }
    }
)

async function refreshToken() {
    const res = await axiosInstance.get('/user/refresh', {
        params: {
          refresh_token: localStorage.getItem('refresh_token')
        }
    });
    localStorage.setItem('access_token', res.data.access_token || '');
    localStorage.setItem('refresh_token', res.data.refresh_token || '');
    return res;
}

这段逻辑就是在每次发请求之前,在 header 里加上 authorization,带上 access_token。

当响应码是 401 的时候,就刷新 token,刷新失败提示错误信息,然后跳到登录页。

并且通过 refreshing 的标记和 task 队列实现了并发请求只刷新一次。

这部分看不明白的同学建议回头看下 access_token 和 refresh_token 无感刷新那节。

其中,这代码代码可能有同学有疑问:

javascript
if(!error.response) {
    return Promise.reject(error);
}

是为了请求没有发送成功的情况的:

请求没有发送成功时,错误对象没有 response 属性。

接下来,我们先登录下:

给用户图标添加跳到 /update_info 的链接:

然后可以看到控制台打印了当前登录用户的信息:

然后我们做下回显:

javascript
form.setFieldValue('headPic', data.headPic);
form.setFieldValue('nickName', data.nickName);
form.setFieldValue('email', data.email);

这样,回显的数据就有了:

然后实现发送验证码:

javascript
const sendCaptcha = useCallback(async function () {
    const res = await updateUserInfoCaptcha();
    if(res.status === 201 || res.status === 200) {
        message.success(res.data.data);
    } else {
        message.error('系统繁忙,请稍后再试');
    }
}, []);

这里不需要填邮箱地址,服务端会从 jwt 里取。

那这里的邮箱也是不应该修改的,给它加个 disabled:

点击发送验证码。

提示发送成功,邮箱里也收到了这个验证码:

接下来就差更新接口了,我们调用下:

javascript
const onFinish = useCallback(async (values: UserInfo) => {
    const res = await updateInfo(values);

    if(res.status === 201 || res.status === 200) {
        const { message: msg, data} = res.data;
        if(msg === 'success') {
            message.success('用户信息更新成功');
        } else {
            message.error(data);
        }
    } else {
        message.error('系统繁忙,请稍后再试');
    }
}, []);

测试下:

修改信息,点击发送验证码:

填入验证码,点击修改,提示用户信息更新成功。

去数据库里看一下:

确实修改成功了。

这样,修改用户信息的流程就走完了。

案例代码在小册仓库:

用户端前端代码

后端代码

总结

这节我们实现了修改密码和修改个人信息这两个页面。

修改密码页面不需要登录,但我们当时的接口是需要登录的,所以改了一下。

并且给 username 加上了唯一约束,通过 username 来查询用户,然后修改。

修改个人信息页面是登录后的,我们通过 React Router 的路由嵌套写了多级页面。

实现了用户信息的回显和更新的功能。

此外,我们还添加了 axios 拦截器来实现自动携带 token 和刷新 token,饼在 refreshToken 过期时跳转登录页。

这样,用户端的用户相关功能就都完成了。