- html - 出于某种原因,IE8 对我的 Sass 文件中继承的 html5 CSS 不友好?
- JMeter 在响应断言中使用 span 标签的问题
- html - 在 :hover and :active? 上具有不同效果的 CSS 动画
- html - 相对于居中的 html 内容固定的 CSS 重复背景?
我最近在学习 OpenAPI,想了解最佳实践。
假设我有一个名为 Person
的资源, 定义于 components/schemas
如下:
Person:
type: object
required:
- id
- name
- age
properties:
id:
readOnly: true
type: integer
name:
type: string
age:
type: integer
id
只读,因为当我这样做时
post
或
patch
,ID 将作为 URL 的一部分传递。见
https://swagger.io/docs/specification/data-models/data-types/
name
和
age
当客户端尝试使用
post
创建新人时必须出现方法,或
get
一个人,因此他们被定义为
required
.
patch
: 如果我只想更新一个人的
age
怎么办或
name
独立?理想情况下,我想做类似的事情
PATCH /person/1
{"age": 40}
name
按照要求,我做不到。我可以想到几种解决方案,但它们都有缺陷:
required
限制。但是如果我这样做,我将失去对 post
的验证。和 get
. patch
使用单独的架构,例如PersonUpdate
, 与 required
移除。显然,这会导致冗余。 patch
,我确实传递了所有字段,但对于那些我不想更新的字段,我传递了一个无效值,例如PATCH /Person/1
{"age": 40, "name": null}
nullable
,并让服务器忽略这些值。但是如果我确实想将 name 设置为
null
怎么办?在数据库?
PUT
用于更新,并始终传递所有必填字段。但是如果我的数据已经过时怎么办?例如。当我这样做时 PUT /Person/1
{"age": 40, "name": "Old Name"}
name
到“新名称”,我正在覆盖它。
patch
时传递了额外的字段指示服务器应该关心的字段,是否使用查询参数,如 ?fields=age
,或将其添加到 JSON 正文中。所以我可以更改 requestBody
类似于 requestBody:
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Person'
- type: object
properties:
_fields:
type: array
items:
type: string
PATCH /Person/1
{"age": 40, "name": null, _fields: ["age"]}
name
至
null
还有
PATCH /Person/1
{"age": 40, "name": null, _fields: ["age", "name"]}
最佳答案
我想出了以下解决方案:
Person:
type: object
allOf:
- $ref: '#/components/schemas/PersonProperties'
- required:
- id
- name
- age
UpdatePerson:
type: object
allOf:
- $ref: '#/components/schemas/PersonProperties'
PersonProperties:
type: object
properties:
id:
readOnly: true
type: integer
name:
type: string
age:
type: integer
PersonProperties
充当构成人员模型的简单属性集合。它没有指定任何
required
领域。
Person
重用
PersonProperties
的所有属性并且,另外指定需要哪一个。
PersonUpdate
重用
PersonProperties
的所有属性并允许部分更新。
id
是
readOnly
,您还可以在
required: [id]
上添加
PersonProperties
并从
id
上的
required
列表中删除
Person
)
关于api - 如何正确使用 OpenAPI 使用补丁方法更新资源?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/62358406/
有人告诉我,如果我只有一个“东西”,比如家(不是多个家),我应该在 routes.rb 中使用资源 :home,而不是资源 :home。但是当我查看路由时,POST 函数似乎想要 home#creat
Activity 开始。这些代码框架顺利通过。 // Initialize array adapters. One for already paired devices and //
资源 search-hadoop.com search-hadoop.com索引所有邮件列表,非常适合历史搜索。当你遇到问题时首先在这里搜索,因为很可能有人已经遇到了你的问题。 邮件列表 在A
我是 WPF 的新手,正在努力使用位于单独程序集中的样式。这就是我正在做的:- 我有一个带有\Themes 文件夹的类库项目,其中包含一个“generic.xaml”,它合并了\Themes 内的子文
我正在编写一个使用虚拟树状文件结构的插件。基本上它就像一个包含文件的标准文件系统,区别在于这些文件实际上并不存在于文件系统中的特定位置,而只是 java 对象。 这些当前由使用 SettingProv
如果我在 XAML 中使用以下内容,我会收到错误消息: 错
我正在使用 laravel 资源来获取 api 的数据: return [ 'id' => $this->id, 'unread' =>
我有以下 pom.xml: 4.0.0 mycompany resource-fail 0.0.1-SNAPSHOT BazBat
许多GDI +类都实现IDisposable,但是我不确定何时应该调用Dispose。对于使用new或静态方法(例如Graphics.CreateGraphics)创建的实例来说,这很明显。但是,由属
我正在构建一组 RESTful 资源,其工作方式如下:(我将使用“people”作为示例): 获取/people/{key} - 返回一个人对象 (JSON) GET/people?first_nam
已关闭。此问题不符合Stack Overflow guidelines 。目前不接受答案。 要求我们推荐或查找工具、库或最喜欢的场外资源的问题对于 Stack Overflow 来说是偏离主题的,因为
我有一个使用 $resource 的简单 Controller : var Regions = $resource('mocks/regions.json'); $scope.regions =
在 Azure 门户中,如何查看不同资源之间的依赖关系。我特别想查看哪些资源正在使用我要删除的存储。 最佳答案 您可以使用应用程序洞察应用程序 map 来执行此操作: 您还可以打开存储帐户的日志记录:
我正在使用 ionic 生成资源(图标和启动画面)。我正在使用 ionic v2.1.0 和 cordova v6.4.0。 到目前为止我一直在使用(它在以前的版本中工作): cordova plat
是否可以使用 Assets 包含子文件夹中的文件? 示例:[base_url]/assets/css/pepper-grinder/jquery-ui-1.8.11.custom.min.css 最佳
我正在阅读一些尝试教授 Android 开发的书。在书中,作者概述了 res/下的一些目录。他提到 res/menu 包含基于 XML 的菜单规范。他还提到了保存“通用文件”的 res/raw。当我创
关闭。这个问题是opinion-based 。目前不接受答案。 想要改进这个问题吗?更新问题,以便 editing this post 可以用事实和引文来回答它。 . 已关闭 9 年前。 Improv
我在服务器上使用 express-resource。在我的 AngularJS Controller 中: var User = $resource('/services/users/:use
因此,每当我运行我的应用程序时,它都会立即崩溃并给出以下错误: No package identifier when getting value for resource number 0x00000
对于我正在创建的(网络)应用程序,我需要使用基本身份验证在我的 UIWebView 中加载页面。 现在设置我使用的授权 header : NSString *result = [NSString st
我是一名优秀的程序员,十分优秀!