欢迎来到我的博客
博主是一名大学在读本科生，主要学习方向是前端。
目前已经更新了【Vue】、【React–从基础到实战】、【TypeScript】等等系列专栏
目前正在学习的是 R e a c t 框架React框架React框架，中间穿插了一些基础知识的回顾
博客主页codeMak1r.小新的博客

本文目录

  • 登陆模块
    • 1.基本结构模块
    • 2. 创建表单结构
    • 3. 表单校验实现
    • 4. 获取登录表单数据
    • 5. 封装http工具模块
    • 6. 配置登录Mobx
    • 7. 实现登录逻辑
    • 8. token持久化
      • 封装工具函数
      • 持久化设置
    • 9. axios请求拦截器注入token
    • 10. 路由导航守卫

本文被专栏【React–从基础到实战】收录
坚持创作✏️，一起学习，码出未来‍！

最近在学习React过程中，找到了一个实战小项目，在这里与大家分享。
本文遵循项目开发流程，逐步完善各个需求
前文——《项目前置准备》

登陆模块

1.基本结构模块

本节目标: 能够使用antd搭建基础布局

实现步骤

  1. 在 Login/index.js 中创建登录页面基本结构
  2. 在 Login 目录中创建 index.scss 文件，指定组件样式
  3. 将 logo.png 和 login.png 拷贝到 assets 目录中

代码实现

pages/Login/index.js

import { Card } from 'antd'import logo from '@/assets/logo.png'import './index.scss'const Login = () => {return (<div className="login"><Card className="login-container"><img className="login-logo" src={logo} alt="" />{/* 登录表单 */}</Card></div>)}export default Login

pages/Login/index.scss

.login {width: 100%;height: 100%;position: absolute;left: 0;top: 0;background: center/cover url('~@/assets/login.png');.login-logo {width: 200px;height: 60px;display: block;margin: 0 auto 20px;}.login-container {width: 440px;height: 360px;position: absolute;left: 50%;top: 50%;transform: translate(-50%, -50%);box-shadow: 0 0 50px rgb(0 0 0 / 10%);}.login-checkbox-label {color: #1890ff;}}

2. 创建表单结构

本节目标: 能够使用antd的Form组件创建登录表单

实现步骤

  1. 打开 antd Form 组件文档
  2. 找到代码演示的第一个示例（基本使用），点击（显示代码），并拷贝代码到组件中
  3. 分析 Form 组件基本结构
  4. 调整 Form 组件结构和样式

代码实现

pages/Login/index.js

import { Form, Input, Button, Checkbox } from 'antd'const Login = () => {return (<Form><Form.Item><Input size="large" placeholder="请输入手机号" /></Form.Item><Form.Item><Input size="large" placeholder="请输入验证码" /></Form.Item><Form.Item><Checkbox className="login-checkbox-label">我已阅读并同意「用户协议」和「隐私条款」</Checkbox></Form.Item><Form.Item><!-- 渲染Button组件为submit按钮 --><Button type="primary" htmlType="submit" size="large" block>登录</Button></Form.Item></Form>)}

3. 表单校验实现

本节目标: 能够为手机号和密码添加表单校验

实现步骤

  1. 为 Form 组件添加 validateTrigger 属性，指定校验触发时机的集合
  2. 为 Form.Item 组件添加 name 属性，这样表单校验才会生效
  3. 为 Form.Item 组件添加 rules 属性，用来添加表单校验

代码实现

page/Login/index.js

const Login = () => {return (<Form validateTrigger={['onBlur', 'onChange']}><Form.Itemname="mobile"rules={[{pattern: /^1[3-9]\d{9}$/,message: '手机号码格式不对',validateTrigger: 'onBlur'},{ required: true, message: '请输入手机号' }]}><Input size="large" placeholder="请输入手机号" /></Form.Item><Form.Itemname="code"rules={[{ len: 6, message: '验证码6个字符', validateTrigger: 'onBlur' },{ required: true, message: '请输入验证码' }]}><Input size="large" placeholder="请输入验证码" maxLength={6} /></Form.Item><Form.Item name="remember" valuePropName="checked"><Checkbox className="login-checkbox-label">我已阅读并同意「用户协议」和「隐私条款」</Checkbox></Form.Item><Form.Item><Button type="primary" htmlType="submit" size="large" block>登录</Button></Form.Item></Form>)}

4. 获取登录表单数据

本节目标: 能够拿到登录表单中用户的手机号码和验证码

实现步骤

  1. 为 Form 组件添加 onFinish 属性，该事件会在点击登录按钮时触发
  2. 创建 onFinish 函数，通过函数参数 values 拿到表单值
  3. Form 组件添加 initialValues 属性，来初始化表单值

代码实现

pages/Login/index.js

// 点击登录按钮时触发 参数values即是表单输入数据const onFinish = values => {console.log(values)}<FormonFinish={ onFinish }initialValues={{mobile: '13911111111',code: '246810',remember: true}}>...</Form>

5. 封装http工具模块

本节目标: 封装axios，简化操作

实现步骤

  1. 创建 utils/http.js 文件
  2. 创建 axios 实例，配置 baseURL，请求拦截器，响应拦截器
  3. 在 utils/index.js 中，统一导出 http

代码实现

utils/http.js

import axios from 'axios'const http = axios.create({baseURL: 'http://geek.itheima.net/v1_0',timeout: 5000})// 添加请求拦截器http.interceptors.request.use((config)=> {return config}, (error)=> {return Promise.reject(error)})// 添加响应拦截器http.interceptors.response.use((response)=> {// 2xx 范围内的状态码都会触发该函数。// 对响应数据做点什么return response}, (error)=> {// 超出 2xx 范围的状态码都会触发该函数。// 对响应错误做点什么return Promise.reject(error)})export { http }

utils/index.js

import { http } from './http'export {http }

6. 配置登录Mobx

本节目标: 基于mobx封装管理用户登录的store

store/login.Store.js

// 登录模块import { makeAutoObservable } from "mobx"import { http } from '@/utils'class LoginStore {token = ''constructor() {makeAutoObservable(this)}// 登录login = async ({ mobile, code }) => {const res = await http.post('http://geek.itheima.net/v1_0/authorizations', {mobile,code})this.token = res.data.token}}export default LoginStore

store/index.js

import React from "react"import LoginStore from './login.Store'class RootStore {// 组合模块constructor() {this.loginStore = new LoginStore()}}// 导入useStore方法供组件使用数据const StoresContext = React.createContext(new RootStore())export const useStore = () => React.useContext(StoresContext)

7. 实现登录逻辑

本节目标: 在表单校验通过之后通过封装好的store调用登录接口

实现步骤

  1. 使用useStore方法得到loginStore实例对象
  2. 在校验通过之后，调用loginStore中的login函数
  3. 登录成功之后跳转到首页

代码实现

import { useStore } from '@/store'const onFinish = async (values) => {// 存储登录成功的tokentry {await loginStore.setToken(values)navigate('/', { replace: true })message.success('At Your Service, Sir!', 2)} catch (error) {message.error(error.response?.data?.message || '登录失败')}};const onFinishFailed = (errorInfo) => {const [name] = errorInfo.errorFields[0].nameif (name === "captcha") message.error('登录失败,请检查验证码是否有误！', 2);if (name === "tel") message.error('登录失败,请检查手机号是否有误！', 2);}return (...)}

8. token持久化

封装工具函数

本节目标: 能够统一处理 token 的持久化相关操作,确保刷新后 token 不丢失。

实现步骤

  1. 创建 utils/token.js 文件
  2. 分别提供 getToken/setToken/clearToken/isAuth 四个工具函数并导出
  3. 创建 utils/index.js 文件，统一导出 token.js 中的所有内容，来简化工具函数的导入
  4. 将登录操作中用到 token 的地方，替换为该工具函数

代码实现

utils/token.js

const TOKEN_KEY = 'geek_pc'const getToken = () => localStorage.getItem(TOKEN_KEY)const setToken = token => localStorage.setItem(TOKEN_KEY, token)const clearToken = () => localStorage.removeItem(TOKEN_KEY)export { getToken, setToken, clearToken }

持久化设置

本节目标: 使用token函数持久化配置

实现步骤

  1. 拿到token的时候一式两份，存本地一份
  2. 初始化的时候优先从本地取，取不到再初始化为控制

代码实现

store/login.Store.js

// 登录模块import { makeAutoObservable } from "mobx"import { setToken, getToken, clearToken, http } from '@/utils'class LoginStore {// 这里哦！！token = getToken() || ''constructor() {makeAutoObservable(this)}// 登录login = async ({ mobile, code }) => {const res = await http.post('http://geek.itheima.net/v1_0/authorizations', {mobile,code})this.token = res.data.token// 还有这里哦！！setToken(res.data.token)} }export default LoginStore

9. axios请求拦截器注入token

《Vue/React项目实现axios请求拦截器注入token》

本节目标: 把token通过请求拦截器注入到请求头中

拼接方式：config.headers.Authorization = Bearer ${token}}

utils/http.js

http.interceptors.request.use(config => {const token = getToken('pc-key')if (token) {config.headers.Authorization = `Bearer ${token}`}return config})

第一次发起请求，是登录请求，此时，localStorage中没有token，getToken获取不到，不走下面这个if函数体，直接return config；

后面再发请求时，由于已经登录了，此时，localStorage中有token，getToken获取到了，走if中的函数体，在发起请求前自动进行预处理，追加一个token，以便于访问需要权限的页面

为请求头对象(headers)中添加token验证的自定义字段(Authorization),作用是为了让需要验证才能使用的API能够使用(请求头中携带了token值则可通过验证)

在最后必须return config

10. 路由导航守卫

【Vue/React实现路由鉴权/导航守卫/路由拦截(react-router v6)】

本节目标: 能够实现未登录时访问拦截并跳转到登录页面（路由鉴权实现）

实现思路

自己封装 AuthRoute 路由鉴权高阶组件，实现未登录拦截，并跳转到登录页面

思路为：判断本地是否有token，如果有，就返回子组件，否则就重定向到登录Login

实现步骤

  1. 在 components 目录中，创建 AuthRoute/index.js 文件
  2. 判断是否登录
  3. 登录时，直接渲染相应页面组件
  4. 未登录时，重定向到登录页面
  5. 将需要鉴权的页面路由配置，替换为 AuthRoute 组件渲染

代码实现

components/AuthRoute/index.js

// 路由鉴权// 1. 判断token是否存在// 2. 如果存在 直接正常渲染// 3. 如果不存在 重定向到登录路由import { Navigate } from "react-router-dom";import { getToken } from "@/utils";// 高阶组件:把一个组件当成另外一个组件的参数传入 然后通过一定的判断 返回新的组件// 这里的AuthRoute就是一个高阶组件function AuthRoute({ children }) {// 获取tokenconst tokenStr = getToken()// 如果token存在 直接正常渲染if (tokenStr) {return <>{children}</>}// 如果token不存在，重定向到登录路由else {return <Navigate to='/login' replace />}}{/* 登录：   非登录：*/ }export { AuthRoute }

注：utils工具函数getToken如下

// 从localstorage中取tokenconst getToken = () => {return window.localStorage.getItem(key)}

src/routes/index.js路由表文件

import Layout from "@/pages/Layout";import Login from "@/pages/Login";import { AuthRoute } from "@/components/AuthRoute";// eslint-disable-next-lineexport default [// 不需要鉴权的组件Login{path: "/login",element: <Login />},// 需要鉴权的组件Layout{path: "/",element: <AuthRoute><Layout /></AuthRoute>}]

下篇文章：Layout布局模块的实现
专栏订阅入口【React–从基础到实战】