⭐前言
大家好，我是yma16，本文分享关于前端vue3分享——项目封装axios、使用env环境变量。
该系列往期文章：
csdn新星计划vue3+ts+antd赛道——利用inscode搭建vue3(ts)+antd前端模板
什么是axios
axios是一个流行的JavaScript库，用于在浏览器和Node.js环境中进行HTTP请求。下面是axios的原理：
Axios是基于Promise构建的，它可以使用async/await，因此在发出请求时，返回的是一个Promise对象。这个Promise对象中包含了请求成功和请求失败的回调函数。
Axios发送的请求被封装成一个请求对象。请求对象包括请求url、请求方法、请求头、请求数据等信息。在创建这个请求对象时，可以设置全局的默认值，这些默认值可以用于所有请求。
Axios是通过XMLHttpRequest对象来实现请求的。在浏览器中，XMLHttpRequest是通过ActiveXObject对象创建的。在Node.js中，它使用http或https模块来实现请求。
Axios可以进行拦截器的设置，它提供了全局请求拦截器和全局响应拦截器。这些拦截器可以用于在请求或响应之前进行一些处理，比如添加请求头或对响应进行一些处理。
Axios还提供了取消请求的功能。这个功能是通过一个CancelToken对象来实现的。使用这个对象可以在发送请求后取消这个请求。这对于用户取消请求或者在组件销毁时取消请求非常有用。
Axios提供了一些高级功能，比如支持请求和响应的转换、自动处理不同数据格式（如JSON、FormData、Binary等）以及在Node.js中处理代理等。
vite处理环境变量
Vite 的工作原理主要分为两部分：开发时编译和生产时打包。在开发时，Vite 利用 ES Modules 特性实现了单文件组件快速编译和热更新。在生产时，Vite 利用 Rollup 进行打包，生成静态文件。
在开发模式下，Vite 会通过一个简单的 HTTP 服务器来服务于应用程序。当浏览器请求应用程序时，Vite 会查找所有的入口文件，并生成一个映射表，把每个文件的依赖关系记录下来。当应用程序需要加载某个模块时，Vite 会首先解析该模块的依赖，并根据依赖关系加载其他模块。在加载过程中，Vite 会利用浏览器的缓存机制，以及服务端的缓存机制来优化加载速度。
对于环境变量的处理，Vite 的原理是通过对项目中 import.meta 对象的支持来实现的。import.meta 对象提供了当前模块的元数据信息，包括模块的 URL 和环境变量等信息。在 Vite 中，用户可以在 vite.config.js 配置文件中设置环境变量，然后通过 import.meta.env 对象来访问这些变量，从而动态地读取环境变量。在打包时，Vite 会自动将这些环境变量编译到生成的静态文件中，从而实现在生产环境中使用环境变量的功能。
⭐vue3封装统一的axios请求
官方文档：https://www.axios-http.cn/docs/interceptors
封装一个简单的axios，在每次请求的请求头都加上 headers: {'X-Custom-Header': 'yma16'}
💖 请求拦截器
http.ts
import axios from "axios"; // 实例 const createInstance = (baseURL:string)=>{ return axios.create({ baseURL:baseURL, timeout: 1000, headers: {'X-Custom-Header': 'yma16'} }) }; // @ts-ignore const http:any=createInstance(''); // 添加请求拦截器 http.interceptors.request.use(function (config:any) { // 在发送请求之前做些什么 return config; }, function (error:any) { // 对请求错误做些什么 return Promise.reject(error); }); // 添加响应拦截器 http.interceptors.response.use(function (response:any) { // 2xx 范围内的状态码都会触发该函数。 // 对响应数据做点什么 return response; }, function (error:any) { // 超出 2xx 范围的状态码都会触发该函数。 // 对响应错误做点什么 return Promise.reject(error); }); export {http};
在api调用的时候引入http
这是登录的api
import {http} from "../..//http/index"; export const loginUser: any = (params: any) => { return http.post("/cloudApi/user/login", params); }; export const registerUser: any = (params: any) => { return http.post("/cloudApi/user/register", params); };
登录查看请求头出现X-Custom-Header:yma16
⭐vue3使用env环境变量
💖 vite env变量规则
变量规则
以 VITE_ 为前缀的变量才会暴露给经过 vite 处理的代码
在.env 定义
VITE_APP_HOST= http://localhost:9090/
在.env.development定义
VITE_APP_HOST= http://localhost:9090/
在.env.production定义
VITE_APP_HOST= https://yongma16.xyz/back-front/
使用import.meta调用env环境变量
在util工具目录下编写一个全局获取变量的方法globalEnv
export const globalEnv=()=>{ return import.meta.env };
💖 vite.config获取env参数
vite.config获取env参数使用oadEnv
process.cwd() 可以获取当前路径
vite开发环境代理切换
mode参数为config参数的模式
mode 本运行为development
修改vite.config.ts
import { defineConfig,loadEnv } from "vite"; import vue from "@vitejs/plugin-vue"; // @ts-ignore import { resolve } from "path"; // @ts-ignore import Components from "unplugin-vue-components/vite"; // @ts-ignore import { AntDesignVueResolver } from "unplugin-vue-components/resolvers"; // https://vitejs.dev/config/ export default defineConfig(({mode})=>{ // 运行模式 console.log('mode',mode) // 当前路径 console.log('process.cwd()',process.cwd()) // @ts-ignore const env=loadEnv(mode,process.cwd()) console.log('env',env) const proxy={ "^/cloudApi/": { target: env.VITE_APP_HOST, changeOrigin: true, ws: true, rewrite: (path) => path.replace(/^\/cloudApi/, ""), }, }; return { // 打包相对路径 base: './', server: { port: 3000, open: true, cors: true, proxy: { ...proxy }, }, "css": { preprocessorOptions: { less: { javascriptEnabled: true, patterns: [resolve(__dirname, "./src/style/main.less")], }, }, }, resolve: { alias: { "@": resolve(__dirname, "src"), }, }, plugins: [ vue(), Components({ resolvers: [AntDesignVueResolver()], }), ], } });
⭐总结
项目封装axios、vite使用env环境变量主要是统一代码规范，便于开发且后续好维护。
💖 编码sliod原则
SOLID 原则是一种设计原则，用于指导编写可维护、可扩展、易于理解和可复用的代码。
- 单一职责原则 (Single Responsibility Principle, SRP): 一个类或模块只负责一项职责，降低耦合度。
- 开闭原则 (Open/Closed Principle, OCP): 类和模块应该对扩展开放，对修改关闭，通过抽象化来实现。
- 里氏替换原则 (Liskov Substitution Principle, LSP): 子类应该可以替换父类并且仍能正常运行。
- 接口隔离原则 (Interface Segregation Principle, ISP): 不应该强迫使用者依赖于他们不需要的接口。
- 依赖反转原则 (Dependency Inversion Principle, DIP): 抽象不应该依赖细节，细节应该依赖于抽象。
这些原则可以帮助开发者设计出高质量的面向对象代码，并促进代码的可维护性和可扩展性，提高代码的复用度。
⭐结束
本文分享到这结束，如有错误或者不足之处欢迎指出！
