用户模块接口写完之后,这节我们开始写页面。
先写下用户端页面,涉及到到登录、注册、修改密码、修改个人信息这 4 个:
先新建个 react 项目:
npx create-react-app --template=typescript meeting_room_booking_system_frontend_u
ser
进入项目目录,把开发服务跑起来:
npm run start
浏览器访问 http://localhost:3000 可以看到这个界面:
就说明 react 项目成功跑起来了。
然后我们添加 router:
npm install --save react-router-dom
在 index.tsx 加上路由的配置:
import ReactDOM from 'react-dom/client';
import './index.css';
import { RouterProvider, createBrowserRouter, Link, Outlet } from 'react-router-dom';
function Aaa() {
return <div>aaa</div>;
}
function Bbb(){
return <div>bbb</div>;
}
function Layout() {
return <div>
<div><Link to="/aaa">to aaa</Link></div>
<div><Link to="/bbb">to bbb</Link></div>
<div>
<Outlet/>
</div>
</div>
}
function ErrorPage() {
return <div>error</div>;
}
const routes = [
{
path: "/",
element: <Layout/>,
errorElement: <ErrorPage/>,
children: [
{
path: "aaa",
element: <Aaa />,
},
{
path: "bbb",
element: <Bbb />,
}
],
}
];
const router = createBrowserRouter(routes);
const root = ReactDOM.createRoot(
document.getElementById('root') as HTMLElement
);
root.render(<RouterProvider router={router}/>);
配置了 3 个路由:
访问 / 的时候,渲染 Layout 组件。
访问 /aaa 的时候,渲染 Aaa 组件。
访问 /bbb 的时候,渲染 Bbb 组件。
以及出错的时候,渲染 ErrorPage 组件。
其中,aaa 和 bbb 是 / 的子路由,渲染在 Layout 组件的 Outlet 的地方。
这就是 React Router 的基本用法。
测试下:
都没问题。
然后创建 3 个组件:Login、Register、UpdatePassword
把 src 目录下其余文件去掉:
然后添加这 3 个组件还有 ErrorPage 组件:
Login.tsx
export function Login() {
return <div>login</div>
}
Register.tsx
export function Register() {
return <div>register</div>
}
UpdatePassword.tsx
export function UpdatePassword() {
return <div>UpdatePassword</div>
}
ErrorPage.tsx
export function ErrorPage() {
return <div>ErrorPage</div>
}
改下 index.tsx 配置对应的路由:
import ReactDOM from 'react-dom/client';
import './index.css';
import { RouterProvider, createBrowserRouter, Link, Outlet } from 'react-router-dom';
import { Register } from './Register';
import { Login } from './Login';
import { UpdatePassword } from './UpdatePassword';
import { ErrorPage } from './ErrorPage';
const routes = [
{
path: "/",
element: <div>index</div>,
errorElement: <ErrorPage />,
},
{
path: "login",
element: <Login />,
},
{
path: "register",
element: <Register />,
},
{
path: "update_password",
element: <UpdatePassword />,
}
];
const router = createBrowserRouter(routes);
const root = ReactDOM.createRoot(
document.getElementById('root') as HTMLElement
);
root.render(<RouterProvider router={router}/>);
测试下:
都没啥问题。
然后来写 Login 页面,也就是这个:
引入 Ant Design 组件库:
npm install antd --save
在 Login 组件引入 DatePicker 组件:
import { DatePicker } from "antd";
export function Login() {
return <div><DatePicker/></div>
}
没啥问题,说明 antd 引入成功了。
然后我们把登录页面写一下:
import { Button, Checkbox, Form, Input } from 'antd';
import './login.css';
interface LoginUser {
username: string;
password: string;
}
const onFinish = (values: LoginUser) => {
console.log(values);
};
const layout1 = {
labelCol: { span: 4 },
wrapperCol: { span: 20 }
}
const layout2 = {
labelCol: { span: 0 },
wrapperCol: { span: 24 }
}
export function Login() {
return <div id="login-container">
<h1>会议室预订系统</h1>
<Form
{...layout1}
onFinish={onFinish}
colon={false}
autoComplete="off"
>
<Form.Item
label="用户名"
name="username"
rules={[{ required: true, message: '请输入用户名!' }]}
>
<Input />
</Form.Item>
<Form.Item
label="密码"
name="password"
rules={[{ required: true, message: '请输入密码!' }]}
>
<Input.Password />
</Form.Item>
<Form.Item
{...layout2}
>
<div className='links'>
<a href=''>创建账号</a>
<a href=''>忘记密码</a>
</div>
</Form.Item>
<Form.Item
{...layout2}
>
<Button className='btn' type="primary" htmlType="submit">
登录
</Button>
</Form.Item>
</Form>
</div>
}
其中,layout 是 label 和 wrapper 的比例分配,antd 的栅格系统一共分了 24 份。
上面两个 Form.Item 是 label 4 份,wrapper 20 份。
下面两个 Form.Item 是 label 0 份,wrapper 24 份。
colon 为 false 是去掉 label 后的冒号
然后 css 部分如下:
#login-container {
width: 400px;
margin: 100px auto 0 auto;
text-align: center;
}
#login-container .links {
display: flex;
justify-content: space-between;
}
#login-container .btn {
width: 100%;
}
访问 /login,可以看到现在的登录页面:
输入用户名、密码,点击登录:
控制台打印了拿到的表单值。
我们在前端项目安装下 axios:
npm install --save axios
然后把服务端跑起来:
跑之前先把端口配置改为 3005,因为前端开发服务用了 3000 端口:
然后在后端项目执行:
npm run start:dev
登录接口有哪些参数呢?
可以看 swagger 接口文档:
访问 http://localhost:3005/api-doc
在 postman 里测试下登录接口:
然后在点击登录按钮之后,用 axios 调用它:
在前端项目创建个 interfaces.ts
import axios from "axios";
const axiosInstance = axios.create({
baseURL: 'http://localhost:3005/',
timeout: 3000
});
export async function login(username: string, password: string) {
return await axiosInstance.post('/user/login', {
username, password
});
}
在这里集中管理接口。
然后 onFinish 里调用:
const onFinish = async (values: LoginUser) => {
const res = await login(values.username, values.password);
if(res.status === 201 || res.status === 200) {
message.success('登录成功');
console.log(res.data);
} else {
message.error(res.data.data || '系统繁忙,请稍后再试');
}
};
登录下:
提示跨域错误:
我们在服务端开启下跨域支持:
再试下:
因为这个时候接口返回 400
axios 对于 400 多、500 多的请求,都会抛出错误。
所以我们加一个响应的拦截器处理下:
在 interface.ts 添加:
axiosInstance.interceptors.response.use(
(response) => {
return response;
},
async (error) => {
return error.response;
}
);
再次调用,就能正常处理了:
如果你把返回的值改为 Promise.reject
axiosInstance.interceptors.response.use(
(response) => {
return response;
},
async (error) => {
return Promise.reject(error.response);
}
);
就又恢复原样了:
因为 axios 默认就是这样处理的,400 多和 500 多的请求,会返回 reject。
把它改回来,然后测试下正常的请求:
提示登录成功,并且返回了用户信息和 token。
再输入错误的用户名、密码试试:
会返回 400 和具体的错误。
然后完善下 onFinish 方法:
const onFinish = async (values: LoginUser) => {
const res = await login(values.username, values.password);
const { code, message: msg, data} = res.data;
if(res.status === 201 || res.status === 200) {
message.success('登录成功');
localStorage.setItem('access_token', data.accessToken);
localStorage.setItem('refresh_token', data.refreshToken);
localStorage.setItem('user_info', JSON.stringify(data.userInfo));
} else {
message.error(data || '系统繁忙,请稍后再试');
}
};
返回 success 的时候,把 access_token、refresh_token、user_info 存入 localStorage
否则,提示错误。
测试下:
登录成功之后,在 Application > Local Storage 里就可以看到这三个值
用户不存在或者密码错误的时候,也提示了对应的错误:
这样,登录的前后端功能就都完成了。
然后来写下注册:
实现下 Register 页面组件:
import { Button, Form, Input, message } from 'antd';
import './register.css';
import { login, registerCaptcha } from './interfaces';
import { useForm } from 'antd/es/form/Form';
export interface RegisterUser {
username: string;
nickName: string;
password: string;
confirmPassword: string;
email: string;
captcha: string;
}
const onFinish = async (values: RegisterUser) => {
const res = await login(values.username, values.password);
const { code, message: msg, data} = res.data;
if(res.status === 201 || res.status === 200) {
message.success('登录成功');
localStorage.setItem('access_token', data.accessToken);
localStorage.setItem('refresh_token', data.refreshToken);
localStorage.setItem('user_info', JSON.stringify(data.userInfo));
setTimeout(() => {
navigate('/');
}, 1000);
} else {
message.error(data || '系统繁忙,请稍后再试');
}
};
const layout1 = {
labelCol: { span: 6 },
wrapperCol: { span: 18 }
}
const layout2 = {
labelCol: { span: 0 },
wrapperCol: { span: 24 }
}
export function Register() {
const [form] = useForm();
async function sendCaptcha() {
const address = form.getFieldValue('email');
const res = await registerCaptcha(address);
console.log(res);
}
return <div id="register-container">
<h1>会议室预订系统</h1>
<Form
form={form}
{...layout1}
onFinish={onFinish}
colon={false}
autoComplete="off"
>
<Form.Item
label="用户名"
name="username"
rules={[{ required: true, message: '请输入用户名!' }]}
>
<Input />
</Form.Item>
<Form.Item
label="昵称"
name="nickName"
rules={[{ required: true, message: '请输入昵称!' }]}
>
<Input />
</Form.Item>
<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
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
{...layout2}
>
<div className='links'>
已有账号?去<a href=''>登录</a>
</div>
</Form.Item>
<Form.Item
{...layout1}
label=" "
>
<Button className='btn' type="primary" htmlType="submit">
注册
</Button>
</Form.Item>
</Form>
</div>
}
和登录页面差不多,只不过多了一个验证码。
对应的 register.css 如下:
#register-container {
width: 400px;
margin: 100px auto 0 auto;
text-align: center;
}
#register-container .links {
display: flex;
justify-content: flex-end;
}
#register-container .btn {
width: 100%;
}
#register-container .captcha-wrapper {
display: flex;
justify-content: flex-end;
}
浏览器访问下 http://localhost:3000
填入信息,点击注册,控制台会打印表单值:
然后来调用下注册接口和发送验证码的接口。
在 swagger 文档看下这俩接口:
同样,我们先在 postman 里调用下:
调用发送验证码接口:
邮箱收到了对应的邮件:
然后调用注册接口:
注册成功,数据库也多了一条记录:
我们在页面是实现这个流程:
在 interface.tsx 里添加这两个接口:
export async function registerCaptcha(email: string) {
return await axiosInstance.get('/user/register-captcha', {
params: {
address: email
}
});
}
export async function register(registerUser: RegisterUser) {
return await axiosInstance.post('/user/register', registerUser);
}
先调用发送验证码接口:
绑定点击事件。
使用 useForm 来拿到 form 的 api
async function sendCaptcha() {
const address = form.getFieldValue('email');
if(!address) {
return message.error('请输入邮箱地址');
}
const res = await registerCaptcha(address);
if(res.status === 201 || res.status === 200) {
message.success(res.data.data);
} else {
message.error(res.data.data || '系统繁忙,请稍后再试');
}
}
在 sendCaptcha 里调用接口发送验证码。
测试下:
没啥问题。
不过这个函数每次都创建新的,会导致重复渲染。
所以我们用 useCallback 包裹下:
const sendCaptcha = useCallback(async function () {
const address = form.getFieldValue('email');
if(!address) {
return message.error('请输入邮箱地址');
}
const res = await registerCaptcha(address);
if(res.status === 201 || res.status === 200) {
message.success(res.data.data);
} else {
message.error(res.data.data || '系统繁忙,请稍后再试');
}
}, []);
这是减少不必要渲染的一种性能优化。
然后再来调用注册接口:
const onFinish = async (values: RegisterUser) => {
if(values.password !== values.confirmPassword) {
return message.error('两次密码不一致');
}
const res = await register(values);
if(res.status === 201 || res.status === 200) {
message.success('注册成功');
} else {
message.error(res.data.data || '系统繁忙,请稍后再试');
}
}
测试下:
填入信息,点击发送验证码:
去邮箱里看一下验证码:
填入验证码,点击注册:
注册成功,数据库里也看到了这条记录:
这样,注册的前后端流程就走完了。
然后我们给它加上跳转逻辑:
把 onFinish 移到组件内,使用 useCallback 包裹。
然后调用 useNavigate 的 navigate 方法,注册成功后导航到登录也:
const navigate = useNavigate();
const onFinish = useCallback(async (values: RegisterUser) => {
if(values.password !== values.confirmPassword) {
return message.error('两次密码不一致');
}
const res = await register(values);
if(res.status === 201 || res.status === 200) {
message.success('注册成功');
setTimeout(() => {
navigate('/login');
}, 1500);
} else {
message.error(res.data.data || '系统繁忙,请稍后再试');
}
}, []);
登录也要加上导航,登录成功后导航到首页:
const navigate = useNavigate();
const onFinish = useCallback(async (values: LoginUser) => {
const res = await login(values.username, values.password);
const { code, message: msg, data} = res.data;
if(res.status === 201 || res.status === 200) {
message.success('登录成功');
localStorage.setItem('access_token', data.accessToken);
localStorage.setItem('refresh_token', data.refreshToken);
localStorage.setItem('user_info', JSON.stringify(data.userInfo));
setTimeout(() => {
navigate('/');
}, 1000);
} else {
message.error(data || '系统繁忙,请稍后再试');
}
}, []);
还有这几个链接也要改成 router 的 Link:
测试下:
最后,我们再来重构下代码:
现在的代码都是平级放的,我们分几个目录:
添加 page 目录和 interface 目录,把对应的文件移动过去,然后修改下引用它的路径。
这样,登录和注册的前后端功能就都完成了。
案例代码在小册仓库:
总结
这节我们打通了前后端,加上了登录、注册、首页等页面。
首先,引入了 React Router 来做路由,引入了 antd 来做 UI 组件库。
然后,引入了 axios 来发请求。
我们先在 postman 里测试了一遍接口,之后在页面里用 axios 调用了下。
组件里的函数,如果作为参数的话,需要添加 useCallback,这样避免每次都创建新的函数导致不必要的渲染。
经测试,发送邮件验证码正常,注册之后数据库也多了记录,登录成功之后 localStorage 也有了用户信息。
这样,注册登录就实现了完整的前后端功能。
下节,我们继续写其他页面。