easy-yapi

easy-yapi copied to clipboard

[Feature] 想做一个文档自动化的场景，希望大佬能给予一点建议

1

**Is your feature request related to a problem? Please describe.** 背景: 我是一位后端开发人员，平时对接口文档的依赖较多。 目前用的是swagger的文档，可以随项目的编译自动生成(因为协同开发的人较多，所以期望选择自动化的文档插件)。但是swagger对代码侵入性较强，且依赖服务的发布成功与否。无法离线浏览(比如服务在未发布时)。 想尝试切换到yapi上，您发布出来的yapi插件非常的好用。最近在使用时有这么一个想法，能否将easy-yapi插件功能和一些自动化脚本结合如jekins，或gitlab的ci，以实现在项目编译时自动触发export-yapi的功能，希望您能给点建议😄 **Describe the solution you'd like** 尝试的思路: 有下载easy-yapi的源码阅读，奈何我对kt的语法实在有点脑壳痛😭，平时使用java+maven为主，groovy和gradle有一点点的使用经验。kt或函数式语法较多的语言接触比较少。 我尽量理一些与export的主线流程去看，比如: com.itangcent.idea.plugin.api.export.yapi.YapiApiExporterTest.DirectorySpringYapiApiExporterTest#testExportSpring //单元测试入口 com.itangcent.idea.plugin.actions.YapiExportAction // 似乎是yapi的插件实现类 您似乎是以 1. 扫描idea项目资源...

xiaShisan

[Question] 如何使文档的字段类型和java类型不同

3

在一些场景下，后端定义BigDecimal类型，但是序列化到前端为String，以保持精度问题。 这个序列化和反序列是框架处理的，需要在yapi中生成文档时按照string去生成，请问这个该怎么处理

bjhx2003

[Bug] dto生成yapi数据类型为null

1

**问题描述** dto生成yapi数据类型为null **过程** 实体类 ``` /** * 直邮任务详情 */ @Data public class DmDetailDto { /** * 销售id */ private Long salesOprId; /** * 产品id */ private Long pdtid; /** *...

xuhaoshen

[Feature] 如何忽略接口上的某一个参数对象

1

举例来说，我可能是通过调用方在Header中传递token，后端在拦截器中统一转换为一个User对象。 效果如下： XXController{ public ResutVO getXXX(@RequestBody Object o1, User user){ } } 其中User其实并不需要调用方传递，此时生成的接口文档，会默认把User按照query param生成。如果我想统一处理这个参数的忽略该怎么处理

bjhx2003

[Bug] PyCharm启动失败

13

Internal error. Please refer to https://jb.gg/ide/critical-startup-errors java.lang.RuntimeException: Cannot invoke (class=aq, method=appFrameCreated, topic=AppLifecycleListener) at com.intellij.util.messages.impl.MessageBusImplKt.invokeListener(MessageBusImpl.kt:676) at com.intellij.util.messages.impl.MessageBusImplKt.deliverMessage(MessageBusImpl.kt:422) at com.intellij.util.messages.impl.MessageBusImplKt.pumpWaiting(MessageBusImpl.kt:401) at com.intellij.util.messages.impl.MessageBusImplKt.access$pumpWaiting(MessageBusImpl.kt:1) at com.intellij.util.messages.impl.MessagePublisher.invoke(MessageBusImpl.kt:460) at jdk.proxy2/jdk.proxy2.$Proxy51.appFrameCreated(Unknown Source) at com.intellij.idea.IdeStarter.openProjectIfNeeded$suspendImpl(IdeStarter.kt:89) at com.intellij.idea.IdeStarter.openProjectIfNeeded(IdeStarter.kt) at...

gzy1144

[Bug] IDEA安装插件后，启动报错

1

Internal error. Please refer to https://jb.gg/ide/critical-startup-errors com.intellij.diagnostic.PluginException: Key com.itangcent.idea.plugin.settings.xml.ApplicationSettingsComponent duplicated; existingAdapter: ServiceAdapter(descriptor=ServiceDescriptor(interface='null', serviceImplementation='com.itangcent.idea.plugin.settings.xml.ApplicationSettingsComponent', testServiceImplementation='null', headlessImplementation='null', overrides=false, configurationSchemaKey='null', preload=FALSE, client=null), pluginDescriptor=PluginDescriptor(name=EasyApi, id=com.itangcent.idea.plugin.easy-api, descriptorPath=easy-api-java.xml, path=~\AppData\Roaming\JetBrains\IntelliJIdea2023.1\plugins\easy-api, version=2.2.9.212.0, package=null, isBundled=false)); descriptor: com.itangcent.idea.plugin.settings.xml.ApplicationSettingsComponent; app: Application...

gpc213

每次导出都会清除我本地的postman变更

2

postman中的本地变更，譬如我调试时设置了一些参数等，都会在我下一次接口导出时清空，即使我导出的是全新的接口，也会将我其他所有旧接口的本地修改全部清空，偶尔还会出现导出一次生成两份一模一样接口的情况，包括把非本次导出的接口一并生成两份 下面是版本号： easyYapi version: 2.6.0.212.0 jetbrains version: IntelliJ IDEA 2023.2 (Ultimate Edition) 我idea的配置: 

fatcatmaster

[ERROR] [malformedRequestError] Found 122 errors with the supplied collection.

3

错误信息 ```shell run easy-yapi [INFO] Start find apis... [TRACE] find config file:/Users/muscleape/Projects/xxx/xxx-server/.easy.api.config [DEBUG] use recommend config [INFO] search api from: com.xxx.xxx.server.controller.api.TestController [INFO] PrivateToken of postman be found [ERROR] [malformedRequestError] Found...

Muscleape

[Feature] 是否可以支持接口备注同步

3

**Is your feature request related to a problem? Please describe.** A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] **Describe the solution you'd...

xiechur

feat: added functionality to choose between apache and okHttp for sending HTTP requests via settings

2

ref: #1130

tangcent