Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Add OpenAPI 3.2 support

オープン
#136 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
45/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
java, openapi

調査の方向性

The OpenAPIContract class is the entry point for loading contracts. Look for version parsing and schema validation logic. The new HTTP QUERY operation type needs to be recognized in the routing layer. Check existing tests for OpenAPI 3.0/3.1 to understand the validation and routing integration. 'Done' means an OpenAPI 3.2.1 spec with a query operation is correctly parsed and routes are generated.

索引モデルが issue の本文から書いたものです。

説明

enhancement help wanted
Describe the feature

OpenAPI 3.2 introduces query as a first-class Path Item operation, which allows APIs to describe the new HTTP QUERY method directly in the contract.

Vert.x 5.2 adds HTTP QUERY support at the HTTP/Web layer, but vertx-openapi currently only recognizes OpenAPI 3.0.x and 3.1.x documents.

As a result, an OpenAPI contract using:

openapi: 3.2.1

cannot currently be loaded by OpenAPIContract.

A manual Vert.x QUERY route can be used as a workaround, so this does not block using the QUERY method itself. However, the endpoint cannot be fully contract-driven through vertx-openapi and would not benefit from the usual OpenAPI routing/validation capabilities. It would be useful to add OpenAPI 3.2 support to vertx-openapi, including support for the new query operation.

Contribution

No response

主要言語
Java
スター
15
フォーク
19
PR マージ指標
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

eclipse-vertx/vertx-openapi のほかの issue

eclipse-vertx/vertx-openapi の issue をすべて見る

似ている issue

Java の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。