wl-request v1.2.8

STL 网络请求插件

包含 get,post,put,delete 四个封装方法 如果不够用可以使用实例后的 axios 属性进行原始请求

内置导出 HttpService 类

实例化参数(*为必传) 两个参数

下面是 ReqBaseConfig 的说明 如果传了 options 则下方*必传

import HttpService from '@stl/request'
const http = new HttpService()
// 如果有基础路径也可以
const http2 = new HttpService('baseUrl')

实例属性与方法说明

@Prop: axios 初始请求模块

就是Axios的原始实例化对象

@Prop: SYMBOL_FILENAME 全局唯一文件名key

2.0新增字段
场景在于使用FormData类型的数据
配合Content-Type: multipart/form-data
想要达到以上的配合使用
需要queryType:formd,且包含SYMBOL_FILENAME为key的文件名
检测到含有SYMBOL_FILENAME字段的数据会自动以multipart/form-data形式发送
例：要传的数据本身为{file:xxx}
需要加上{file:xxx, [SYMBOL_FILENAME]:filename}
并且不需要手动指定请求头  如有特殊需要可以设置

@Method: get get 请求

参数说明:
@Param url:string 地址
@Param options:AxiosOptions 请求其他配置(下面会有类型说明)
@Return ResponseData | undefined

// GET示例代码
export function getList(params: Params) {
  return http.get('url', { params })
}

@Method: post post 请求

参数说明:
@Param url:string 地址
@Param data:any 参数
@Param options:AxiosOptions 请求其他配置(下面会有类型说明)
@Return ResponseData | undefined

// POST示例代码
export function sendPost(data: Params) {
  return http.post('url', data, options)
}

@Method: put put 请求

参数说明:
@Param url:string 地址
@Param data:any 参数
@Param options:AxiosOptions 请求其他配置(下面会有类型说明)
@Return ResponseData | undefined

// PUT示例代码
export function sendPut(data: Params) {
  return http.put('url', data, options)
}

@Method: delete delete 请求

参数说明:
@Param url:string 地址
@Param options:AxiosOptions 请求其他配置(下面会有类型说明)
@Return ResponseData | undefined

// PUT示例代码
export function sendDelete(params: Params) {
  return http.delete('url', { params })
}

AxiosOptions 说明 除说明的部分以外 同 Axios 原配置

Codes 说明

// CODES示例代码
export function sendPost(data: Params) {
  return http.post('url', data, {
    codes: {
      sures: ['正确的SubCode'],
      err: ['我是错误且需要报消息的SubCode'],
    },
  })
}

// queryType示例代码
// queryType:text
export function sendPost(data: Params) {
  return http.post('url', data, {
    queryType: 'text',
  })
}
/*
会将参数同时赋值在params中
url?content=qweqw&productType=16
*/

// queryType:json
export function sendPost(data: Params) {
  return http.post('url', data, {
    queryType: 'json',
  })
}
/*
会将data中的参数序列化一次再返回 以保证正确的JSON传递

*/

// queryType:formd
export function sendPost(data: Params) {
  return http.post('url', data, {
    queryType: 'formd',
  })
}
/*
会以FormData的形式传递数据
但是默认是以 application/x-www-form-urlencoded的类型
如果上传文件 需要自己改成 multipart/form-data 同样在options传递headers即可
*/

// queryType:forms
export function sendPost(data: Params) {
  return http.post('url', data, {
    queryType: 'forms',
  })
}
/*
会将参数以qs模块进行序列化再进行传递数据
默认就是直接序列化  如果有特殊参数需求 可以传入queryOptions
同 qs的设置一致
*/