首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

超简单-自动生成接口文档

一、开头 开发的小伙伴应该会遇到这个问题吧! 项目设计阶段写的接口文档,需求的不断的改动,导致前期定义的接口已面目全非。如果没有及时更新接口文档,那么这些接口文档对前端开发人员将是一场灾难!...解决方案二:项目集成 Swagger 插件,在项目打包的时候,生成 html/pdf 形式的接口文档,供其他人使用。...通过解析 controller 类上注解和方法上的注解,生成获取所有对外暴露方法的定义的接口,然后通过 web 页面呈现所有接口定义。...3.3示例项目 项目地址: https://github.com/dakuohao/api-doc 三、最后 本文的思考来源于工作。...项目接口文档本应该就是根据代码同时发布的,在多加一步操作,将生成的接口文档自动部署到服务上,就实现接口文档的自动更新,一劳永逸!

2.1K10
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    你用受控模式写组件?图啥呢?

    而一旦你给 input 设置了 value,那用户就不能修改它了,可以输入触发 onChange 事件,但是表单的值不会变。...用户输入之后在 onChange 事件里拿到输入,然后通过代码去设置 value。 这就是受控模式。 其实绝大多数情况下,非受控就可以了,因为我们只是要拿到用户的输入,不需要手动去修改表单值。...但是基础组件不能这样,你得都支持,让调用者自己去选择。 ant design 的 Calendar 组件就是这样的: ColorPicker 组件也是: 它同时支持了受控组件和非受控组件。...value,然后切换日期的时候回调 onChange 函数: value 的值的维护在调用方。...受控模式只在需要对用户的输入做一些修改然后再设置到 value 的情况用。 再就是如果需要结合 Form 表单用,那是要支持受控模式,因为 Form 会通过 Store 来统一管理所有表单项。

    16410

    基于Ant Design Vue封装一个表单控件

    为啥还要封装 ant design vue 都已经提供那么的组件了,还不够用吗?..., this.form); }, }, }; 在Form表单里面也是这样的设置方式,而表单里面有很多各种各样的控件,一个一个写起来实在是太累。...统一属性 除了标签之外,属性也要一致,否则还是不能for。那么怎么办呢?不同的控件需要的属性都不一样呀,这个好办,我们整合成两个就行 v-model value 这个必须单独拿出来。...表单 好了,准备工作都做好了,我们可以开始for循环了。 找了半天,antdv没有提供单纯的table,只好手动找class了,于是代码变成了这样。...为啥不直接用antdv提供的 Form 表单? 这个嘛,思路不太一样。好吧,其实是官网的代码,在本地还没有调试成功,等研究明白了还是会用的。

    3.2K30

    Vue 折腾记 - (17) 基于Ant Design Vue 封装一个配置式的表单组件

    前言 在写这个的时候,还是不信邪的用了vue jsx的风格去写东西, 当组件的东西多了起来之后,各种报错;没错,最终我又回归到传统的写法; 上一篇写了个搜索的封装,到写这个的时候发现有所可以优化的地方。...样式依旧需要自己修正(在维护大佬没有修正的情况下) 演示的代码用法 <template #field="{options...fieldName: 'formField1', placeholder: '文本输入区域', // 默认控件的空值文本 rules:...', type: 'number', fieldName: 'formField2', placeholder: '这只是一个数字的文本输入框...排查了许久,目前还没找出具体缘由; ---- 总结 antd vue版本目前的功能复现上,还是有所欠缺,可能vue和react实现的机子不一致导致; 不管怎么说,不考虑极端情况下,目前这个库用起来感觉还好

    4.2K40

    Vue 折腾记 - (16) 基于Ant Design Vue 封装一个配置式的表单搜索组件

    所以这次就排除了Element UI,而采用了Ant Design Vue; 在分析整个项目原型后,发现又可以抽离类似之前的React表格搜索组件 React 折腾记 - (6) 基于React 16....仔细翻了下Ant Design Vue的文档,发下可以类似React的套路实现 怎么来实现 要实现一个结合业务可复用的东东,首先我们必须先梳理我们要实现的功能点。...补全当初写react版本一些欠缺考虑的东东(比如返回的查询对象上) ---- 用法 就普通的引入,具体暴露的props和change如下 子项会覆盖全局带过来的同名特性,优先级比较高 选项 类型 解释...fieldName: 'formField1', placeholder: '文本输入区域' // 默认控件的空值文本 },...placeholder: '这只是一个数字的文本输入框' }, { labelText: '单选框', type:

    8.5K00

    微前端x重构实践落地总结

    更让人头疼的是,产品经理并不会让我们有大把大把时间专门搞重构,我们要边重构边做需求。在这样的挑战下,我想到了微前端解决方案,下面就跟大家分享这次 微前端在重构上的落地实践吧。...当在切换新页面时,本质上是在子应用里做路由切换,而不是从 A 应用切换到 B 应用了。...ant-design 的 Modal、PopoverDrawer 的实现方式就是要挂在到 document.body 上的,这么一隔离,它们一挂在整个元素起飞了。...importnant 的优先级是最高的,如果微应用也用了这个 .ant-xxx 类,就很容易被主应用的样式影响了。所以在加载微应用时,还需要处理 ant-design 之间的样式冲突问题。...微前端就可以解决重构的过程中边做新需求边重构的问题,使得新老页面都能共存,不会一下子整个业务都停掉来做重构工作。

    1.1K20

    类型即正义:TypeScript 从入门到实践(序章)

    提示Ant Design [19]是蚂蚁金服孵化的一套企业级产品设计体系,提供了完备的 TS 类型定义,使得我们可以很方便的在 TS 项目中使用,在最近发布了 4.0 版本,致力于创造高效愉悦的工作体验...Mobile[21] 开箱即用的中台前端/设计解决方案:Ant Design Pro[22] 插画设计:海兔[23] 一款为设计者提升工作效率的 Sketch 工具集 :Kitchen[24] 后面图雀社区计划围绕...✌️ 安装依赖 好了,大致介绍了 antd 组件库及 Ant Design 周边之后,我们马上来写代码引入 antd,打开命令行,在其中输入如下命令: $ npm install antd 运行上面的命令安装完依赖之后就可以在项目中使用了...准备样式部分 准备了逻辑代码之后,为了让我们最后的待办事项在样式上更美观一点,也利于我们讲解时的操作,我们需要给项目加一点样式,打开 src/App.css 对其中的代码做出对应的修改如下: .App...所有的准备工作已经就绪,在开始下一节真正的 TS 学习之前,我们先来回顾一下我们在这个小节中所完成的工作: 使用 CRA 的 TypeScript 脚本初始化了一个 TS 版的 React 项目 安装了

    1.5K20

    我们应该如何优雅的处理 React 中受控与非受控

    这也就意味着,如果组件外部的状态并不改变(这里指组件的 props 中的 value)时,即使用户在页面上展示的 input 如何输入 input 框中渲染的值也是不会发生任何改变的。...熟悉 Ant-Design 等存在表单校验的 React 组件库的朋友,可以稍微回忆下它们的表单使用。...之后当用户在页面上的 input 元素中输入任何值表单值都会跟随用户输入而实时变化而并不受任何组件状态的控制,这就被称为非受控组件。...类似 Ant-Design 中的 Input 组件。它既接收显示传入 value 和 onChange 的组合方式,同时也支持传入 defaultValue 的非受控方式实现。...结尾 这次的分享稍微显得有一些基础,不过我们可以发现一个看起非常简单的受控和非受控的概念在 useMergedState 中也的确藏着不少的知识点。 希望这篇文章可以在日常工作中对大家有所帮助。

    6.6K10

    前端自动化测试

    前言 本文主要是介绍基于React+Ant Design(以下用Antd表示Ant Design)的项目,在对于自己封装的,或者基于Antd封装的公共组件的自动化测试技术的选型和实践。...: 保证当前组件的质量,即当前业务的正常使用 在新需求下,旧的组件如果能满足新需求50%以上的功能,应当升级旧组件满足新需求,同时兼容旧业务 除该组件Owner之外第二人,在修改组件的过程中,避免因为对代码的不熟悉...在test中,后缀名为xxx.test.js的文件,在运行测试时会自动执行,snapshots为自动生成的页面快照。...( <YearPicker showTime format="YYYY" onChange={this.onChange} defaultValue...,测试是否能按照预期清除输入框内填充的默认值 测试设置值,点击输入框,弹出选择框,选择值,检查输入框中的值是否为选择的值

    2K20

    Jenkins声明式Declarative Pipeline

    或特定阶段是在Jenkins Master节点还是Jenkins Slave节点上运行。...写在顶层环境变量,可以让所有stage下的step共享这些变量;也可以单独定义在某一个stage下,只能供这个stage去调用变量,其他的stage不能共享这些变量。...语法 5、Stage阶段(至少有一个) 包含在stages{}中 至少有一个 6、Tools工具 包含在pipeline{}或stage{} 支持的工具: Maven JDK Gradle 7、输入用户输入...可以在属性之后添加可选参数比较器,以指定如何为匹配评估任何模式:EQUALS 用于简单字符串比较(默认),GLOB 用于 ANT 样式路径 glob(与例如变更集相同),或 REGEXP 用于正则表达式匹配...可以在属性后添加可选参数比较器,以指定如何为匹配评估任何模式:EQUALS 用于简单字符串比较,GLOB(默认)用于 ANT 样式路径 glob(与例如变更集相同),或 REGEXP 用于正则表达式匹配

    3.5K20

    Antd源码浅析(二)InputNumber组件 一

    前言 上篇我们讲了Icon组件,Icon组件是Antd源码库中实现比较简单的组件,适合大家入门,这篇文章主要和大家一起分析一下数字输入框组件,即InputNumber,难度适中,但蕴含的Antd里较为经典的开发场景...参数校验 对于参数校验,当然需要对照InputNumber的文档看了,官方的使用说明如下: 属性如下: 成员 说明 类型 默认值 autoFocus 自动获取焦点 boolean false defaultValue...: string; // Antd预留给自己的预设class,这里在defaultProps中默认设置为'ant-input-number' min?: number; max?...: number; } 对于其中TypeScript形式类型校验,可以参考上篇文章,这里Antd文档给出了其自定义的参数列表,省略了默认的普通参数,所以通过对于源码的学习,能够清晰的知道在官方文档之外,...= c} 这是通过ref回调的方式,在组件render完获取实例,优于React提供的旧版的this.refs.inputNumberRef字符串形式,但在最新版React16.2的文档中,官方建议使用

    2.2K40

    SpringMvc入门

    url-pattern的配置 使用@RequestMapping映射请求 一个方法处理一个请求,不能两个方法处理一个请求,不然报错 类上加上注解,访问时的路径需要多加一层 @RequestMapping...,精确优先 路径上可以有占位符,占位符语法就是在任意路径的地方上写一个{变量名} 路径上的占位符只能占掉一层路径 获取路径上的占位符-----@PathVariable() 获取路径上的多层占位符 REST...在web.xml中配置这个filter 发送其他形式的请求 1.创建一个post表单 2.在表单中携带一个_method的参数 3.这个_method的值,就是DELETE,PUT 高版本tomcat...--- 使用@RequestMapping映射请求 一个方法处理一个请求,不能两个方法处理一个请求,不然报错 类上加上注解,访问时的路径需要多加一层 /* * 为当前类的所有的方法的请求地址指定了一个基准路径...属性和produces属性 ---- ant风格的URL----URL地址可以写模糊的通配符 *号优先级比?

    76040

    Swagger最基础整理(附赠项目源码和视频)

    一、Swagger简介 1、Swagger简介 Swagger是一套围绕Open API规范构建的开源工具,可以帮助设计,构建,记录和使用REST API。...在Swagger Hub中可以完成上面项目的所有工作,需要注册账号,分免费版和收费版。...使用Swagger,就是把相关的信息存储在它定义的描述文件里面(yml或json格式),再通过维护这个描述文件可以去更新接口文档,以及生成各端代码。...,表示对类的说明 @Api:用在请求的类上,表示对类的说明 tags="说明该类的作用,可以在UI界面上看到的注解" value="该参数没什么意义,在UI界面上也看到,所以不需要配置" @ApiOperation...:用在请求的方法上,说明方法的用途、作用 @ApiOperation:用在请求的方法上,说明方法的用途、作用 value="说明方法的用途、作用" notes="方法的备注说明" @ApiImplicitParams

    34750

    Ant Design 4.0 发布,来看看如何升级?

    如果你仍在使用 React 15,请参考React 16 升级文档 其余 React 16 废弃生命周期 API 请参考 迁移导引 4.0 有哪些不兼容的变化 设计规范调整 行高从 1.5(21px)...DatePicker 交互重做,面板和输入框分离,范围选择现可单独选择开始和结束时间。 Table 默认背景颜色从透明修改为白色。 Tabs 火柴棍样式缩短为和文字等长。...移除了 Select 的 combobox 模式,请使用 AutoComplete 替代。 图标升级 在 antd@3.9.0 中,我们引入了 svg 图标(为何使用 svg 图标?)。...onPanelChange 在面板值变化时也会触发。 自定义单元格样式的类名从 ant-calendar-date 改为 ant-picker-cell-inner。...对于无法自动修改的部分,codemod 会在命令行进行提示,建议按提示手动修改。修改后可以反复运行上述命令进行检查。 ? 注意 codemod 不能涵盖所有场景,建议还是要按不兼容的变化逐条排查。

    6K10

    antd mobile 作者教你写 React 受控组件和非受控组件

    以 antd-mobile 现在的 5.17 版本为例,几乎全部的涉及到输入值、切换、展开收起的组件,都是需要做到既受控又非受控的。...所以,为了更好的可复用性,我们把上面的逻辑抽离成一个自定义 Hook: 这样,在各种组件中,我们可以直接使用 usePropsValue,用法和 useState 非常接近: 不过,我们忽略了 defaultValue...,在 antd-mobile 中,value onChange defaultValue 总是成组出现的: 接下来,让我们对它再做一点优化,让它变得更像 useState。...GitHub 上收到了一条 issue:TabBar 的 onChange 为什么在同 key 的情况也会触发 #5409[1]。...” 参考资料 [1] TabBar 的 onChange 为什么在同 key 的情况也会触发 #5409: https://github.com/ant-design/ant-design-mobile

    2K10
    领券