Vue 使用typescript如何优雅的调用swagger API


Posted in Javascript onSeptember 01, 2020

Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务,后端集成下Swagger,然后就可以提供一个在线文档地址给前端同学。

Vue 使用typescript如何优雅的调用swagger API

前端如何优雅的调用呢?

入门版

根据文档,用axios自动来调用

// 应用管理相关接口
import axios from '../interceptors.js'

// 获取应用列表
export const getList = (data) => {
 return axios({
 url: '/app/list?sort=createdDate,desc',
 method: 'get',
 params: data
 })
}

这里的问题是,有多少个接口,你就要编写多少个函数,且数据结构需要查看文档获取。

进阶版本

使用typescript,编写API,通过Type定义数据结构,进行约束。

问题: 还是需要手写

优雅版本

swagger 其实是一个json-schema描述文档,我们可以基于此,自动生成。

很早之前,写过一个插件 generator-swagger-2-t, 简单的实现了将swagger生成typescript api。

今天,笔者对这个做了升级,方便支持后端返回的泛型数据结构。

安装

需要同时安装 Yeoman 和 -swagger-2-ts

npm install -g generator-swagger-2-ts

然后cd到你的工作目录,执行:

yo swagger-2-ts

按提示

  • 输入swagger-ui 地址,例如http://192.168.86.8:8051/swagger-ui.html
  • 可选生成js 或者 typescript
  • 可以自定义生成的api class名称、api文件名
  • API 支持泛型

也可以通过命令行直接传递参数

yo swagger-2-ts --swaggerUrl=http://localhost:8080/swagger-ui.html --className=API --type=typescript --outputFile=api.ts
  • swaggerUrl: swagger ui url swaggerui地址
  • className: API class name 类名
  • type: typescript or javascipt
  • outputFile: api 文件保存路径

生成代码demo:

export type AccountUserInfo = {
 disableTime?: string
 isDisable?: number
 lastLoginIp?: string
 lastLoginPlace?: string
 lastLoginTime?: string
 openId?: string
}


export type BasePayloadResponse = {
 data?: object
 desc?: string
 retcode?: string

}

/**
 * User Account Controller
 * @class UserAccountAPI
 */
export class UserAccountAPI {
/**
 * changeUserState
 * @method
 * @name UserAccountAPI#changeUserState
 
 * @param accountUserInfo - accountUserInfo 
 
 * @param $domain API域名,没有指定则使用构造函数指定的
 */
 changeUserState(parameters: {
 'accountUserInfo': AccountUserInfo,
 $queryParameters?: any,
 $domain?: string
 }): Promise<AxiosResponse<BasePayloadResponse>> {

 let config: AxiosRequestConfig = {
  baseURL: parameters.$domain || this.$defaultDomain,
  url: '/userAccount/changeUserState',
  method: 'PUT'
 }

 config.headers = {}
 config.params = {}

 config.headers[ 'Accept' ] = '*/*'
 config.headers[ 'Content-Type' ] = 'application/json'

 config.data = parameters.accountUserInfo
 return axios.request(config)
 }

 _UserAccountAPI: UserAccountAPI = null;

 /**
 * 获取 User Account Controller API
 * return @class UserAccountAPI
 */
 getUserAccountAPI(): UserAccountAPI {
 if (!this._UserAccountAPI) {
  this._UserAccountAPI = new UserAccountAPI(this.$defaultDomain)
 }
 return this._UserAccountAPI
 }
}


/**
 * 管理系统接口描述
 * @class API
 */
export class API {
 /**
 * API构造函数
 * @param domain API域名
 */
 constructor(domain?: string) {
 this.$defaultDomain = domain || 'http://localhost:8080'
 }
}

使用

import { API } from './http/api/manageApi'
// in main.ts
let api = new API("/api/")
api.getUserAccountAPI().changeUserState({
 isDisable: 1
 openId: 'open id'
})

Vue中最佳实践

main.ts 全局定义

import { API } from './http/api/manageApi'

Vue.prototype.$manageApi = new API('/api/')

增加.d.ts

增加types文件,方便使用智能提示

import { API } from '@/http/api/manageApi'
import { MarkAPI } from '@/http/api/mark-center-api'
declare module "vue/types/vue" {
 interface Vue {
 $manageApi: API
 $markApi: MarkAPI
 }
}

实际使用

现在可以在vue里直接调用了。

Vue 使用typescript如何优雅的调用swagger API

this.$manageApi
  .getUserAccountAPI().changeUserState({isDisable: 1, openId: 'open id'})

开源地址

https://github.com/jadepeng/generator-swagger-2-ts

总结

到此这篇关于Vue 使用typescript如何优雅的调用swagger API的文章就介绍到这了,更多相关Vue 使用typescript内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章希望大家以后多多支持三水点靠木!

Javascript 相关文章推荐
用js遍历 table的脚本
Jul 23 Javascript
Extjs列表详细信息窗口新建后自动加载解决方法
Apr 02 Javascript
javascript 面向对象的JavaScript类
May 04 Javascript
javascript动态添加表格数据行(ASP后台数据库保存例子)
May 08 Javascript
js中javascript:void(0) 真正含义
Nov 05 Javascript
window.location.reload 刷新使用分析(去对话框)
Nov 11 Javascript
vue.js学习笔记:如何加载本地json文件
Jan 17 Javascript
微信小程序实现移动端滑动分页效果(ajax)
Jun 13 Javascript
基于JQuery的Ajax方法使用详解
Aug 16 jQuery
npm 下载指定版本的组件方法
May 17 Javascript
微信小程序时间戳转日期的详解
Apr 30 Javascript
解决echarts图表使用v-show控制图表显示不全的问题
Jul 19 Javascript
vue路由切换时取消之前的所有请求操作
Sep 01 #Javascript
jQuery实现动态加载瀑布流
Sep 01 #jQuery
vue Treeselect下拉树只能选择第N级元素实现代码
Aug 31 #Javascript
vue treeselect获取当前选中项的label实例
Aug 31 #Javascript
vue 监听 Treeselect 选择项的改变操作
Aug 31 #Javascript
搭建vscode+vue环境的详细教程
Aug 31 #Javascript
vue组件中实现嵌套子组件案例
Aug 31 #Javascript
You might like
Codeigniter控制器controller继承问题实例分析
2016/01/19 PHP
thinkphp框架实现路由重定义简化url访问地址的方法分析
2020/04/04 PHP
用javascript来实现动画导航效果的代码
2007/12/16 Javascript
写出更好的JavaScript之undefined篇(上)
2009/11/22 Javascript
JavaScript 学习笔记(十三)Dom创建表格
2010/01/21 Javascript
Jquery中使用setInterval和setTimeout的方法
2013/04/08 Javascript
拖动table标题实现改变td的大小(css+js代码)
2013/04/16 Javascript
jQuery中:image选择器用法实例
2015/01/03 Javascript
jQuery+css3实现Ajax点击后动态删除功能的方法
2015/08/10 Javascript
JS实现仿腾讯微博无刷新删除微博效果代码
2015/10/16 Javascript
开启BootStrap学习之旅
2016/05/04 Javascript
详解webpack4升级指南以及从webpack3.x迁移
2018/06/12 Javascript
layui插件表单验证提交触发提交的例子
2019/09/09 Javascript
vue实现百度语音合成的实例讲解
2019/10/14 Javascript
在Python3中使用asyncio库进行快速数据抓取的教程
2015/04/02 Python
详解Django中的权限和组以及消息
2015/07/23 Python
Python3.6安装及引入Requests库的实现方法
2018/01/24 Python
python MysqlDb模块安装及其使用详解
2018/02/23 Python
Python使用try except处理程序异常的三种常用方法分析
2018/09/05 Python
画pytorch模型图,以及参数计算的方法
2019/08/17 Python
使用python脚本自动生成K8S-YAML的方法示例
2020/07/12 Python
HTML5的结构和语义(1):前言
2008/10/17 HTML / CSS
HTML5重塑Web世界它将如何改变互联网
2012/12/17 HTML / CSS
Html5元素及基本语法详解
2016/08/02 HTML / CSS
外贸主管求职简历的自我评价
2013/10/23 职场文书
美术教学感言
2014/02/22 职场文书
淘宝活动总结范文
2014/06/26 职场文书
金融管理专业求职信
2014/07/10 职场文书
我的中国梦演讲稿400字
2014/08/19 职场文书
党员个人对照检查材料
2014/10/01 职场文书
财务稽核岗位职责
2015/04/13 职场文书
对公司的意见和建议
2015/06/04 职场文书
和领导吃饭祝酒词
2015/08/11 职场文书
2019职场单身人才调研报告:互联网行业单身比例最高
2019/08/07 职场文书
Java设计模式之享元模式示例详解
2022/03/03 Java/Android
Python之matplotlib绘制饼图
2022/04/13 Python