Comments (14)
参数配置require=true 就勾选了
from knife4j.
@xiaoymin 在哪里配置,properties文件里面配吗?
from knife4j.
对于form请求,用OpenAPI3规范的注解,标注require
例如:
@Parameter(name = "id", description = "主键id", required = true, in = ParameterIn.QUERY)
@GetMapping("/getById")
public Result<List<String>> getById(@RequestParam(value = "id") Integer id) {
//...
}
from knife4j.
@xiaoymin 能否优化一下,默认勾选啊。如果参数特别多,配置太麻烦了
from knife4j.
@xiaoymin 能否优化一下,默认勾选啊。如果参数特别多,配置太麻烦了
ui解析是根据规范来的,如果required设置为true,默认就是勾选的,为false,就代表可传可不传。不勾选是合理的
from knife4j.
from knife4j.
@xiaoymin 实际上我是以对象方式呈现的,而且原生/swagger-ui/index.html是支持的
from knife4j.
@Schema
注解,有设置requiredMode属性的
from knife4j.
@xiaoymin 感觉和这个勾选含义和requiredMode含义不同,勾选是为了表达向后端传递不传递这个参数,requiredMode是为了表达是否必须包含内容片段
举个例子:后端需要接收字段参数其值可以为null,和后端接收不到参数是两个概念
from knife4j.
@xiaoymin 感觉和这个勾选含义和requiredMode含义不同,勾选是为了表达向后端传递不传递这个参数,requiredMode是为了表达是否必须包含内容片段
举个例子:后端需要接收字段参数其值可以为null,和后端接收不到参数是两个概念
前端组件交互没有null和空字符的概念,如果body不含参数,就是null,勾选了,传递一个空字符串,也是有值的
默认全部勾选,然后传递一个空字符串过去,后端JSR303验证就会不通过。所以这里和require这个属性绑定,我觉得还是合理的
from knife4j.
@xiaoymin 就是操作起来比较繁琐,如果【参数】是非必须字段,【参数值】填完之后还要打勾才能提交给后端
同一套代码,使用原生/swagger-ui/index.html和/doc.html操作完全不一致。
个人觉得【参数】前面的复选框都可以去掉,保持【参数值】对应文本框或下拉框和requiredMode配置保持一致
from knife4j.
@805728578 非必填字段没有你说的填完之后还要打勾这个操作吧
如果是非必填,但是在输入框输入的时候,就会默认打勾了
from knife4j.
@xiaoymin 针对以上情况,有默认样例值就要打勾
from knife4j.
@805728578 非必填字段没有你说的填完之后还要打勾这个操作吧
如果是非必填,但是在输入框输入的时候,就会默认打勾了
@xiaoymin 针对没有默认值的确实输入时就勾选了,针对有默认值的需要二次勾选
from knife4j.
Related Issues (20)
- 关于 knife4j-aggregation cloud 模式 , 接口工程 No mapping for GET /
- dsecription这个单词是不是写错了
- knife4j-aggregation-spring-boot-starter不支持springboot3
- com.github.xiaoymin.knife4j.extend.filter.basic.ServletSecurityBasicAuthFilter.doFilter(ServletSecurityBasicAuthFilter.java:56) 空指针 HOT 2
- Knife4j文档请求异常 HOT 1
- 文档如何根据@JsonView 注解 显示必要字段 HOT 2
- doc.html响应示例数据格式混乱 HOT 5
- 通过swagger.v3的注解@ApiResponse定义的Response Content无法展示 HOT 1
- @ApiOperationSupport(ignoreParameters = {"id"})不生效 版本信息如下 HOT 1
- knife4j springboot2.0 + openapi3 部署到服务器上 报错部分资源访问异常 HOT 1
- SpringBoot3 报 javax.servlet.Filter java.lang.ClassNotFoundException错误 HOT 2
- knife4j文档请求异常 HOT 2
- Spring Boot3 版本,接口返回子字段含泛型展示错误 HOT 13
- Kotlin DataClass 解析出重复字段 HOT 3
- knife4j 无法展示多个对象属性
- @Tag name属性 和 @Operation summary属性 字符'/' 在页面中展示时被替换为 '-' HOT 2
- 响应参数及响应实例中不能正确展示 $ref 的值 HOT 2
- yml配置不支持showTagStatus参数,文档前端实现包含这个参数 HOT 3
- knife4j-gateway-spring-boot-starter cannot support fully expanded arguments for predicates HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from knife4j.