apache / apache/servicecomb-java-chassis

Java-Chassis生成的契约无法反映hibernate参数校验注解

オープン
#3,232 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
Proposal
主要言語
Java
スター
1.9k
フォーク
814
平均マージ
8日 23時間
マージ済み PR(30日)
1

説明

## 框架版本

Java-Chassis 1.3.7

## 复现demo

REST 接口方法如下:
```java
@Path("/test")
@POST
public Person test(@QueryParam("query") String query, @Valid Person person) {
person.setName(person.getName() + query);
return person;
}
```

body参数类型定义如下:
```java
public class Person {
@Length(min = 4,max = 5) // org.hibernate.validator.constraints.Length
private String name;

@Range(min = 20,max=30 ) // org.hibernate.validator.constraints.Range
private int age;

// 省略后面的 getter setter 方法
}
```

启动服务后调用 `test` 接口方法, 确认参数校验的逻辑是生效的.
但是契约中显示的 `Person` 类型字段信息不会包含参数限制信息.

Swagger 2.0 本身的数据模型是有对参数校验字段的表达的支持的, 参考[Swagger 2.0 文档](https://swagger.io/specification/v2/), 包含 `maximum`/`exclusiveMaximum`/`minimum`/`exclusiveMinimum`/`maxLength`/`minLength`/`pattern` 等元素.

Swagger 本身的工具类已经支持了 `javax.validation` 包中的注解. 但对于 hibernate 的注解则不支持:
![image](https://user-images.githubusercontent.com/22049770/181217637-d17e2890-b4b8-44c7-b20c-27274e364477.png)

相关代码逻辑在 `io.swagger.jackson.ModelResolver#applyBeanValidatorAnnotations` 方法中.

请问 Java-Chassis 能否扩展一下, 增加对 hibernate 注解的支持?

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

調査の方向性

io.swagger.jackson.ModelResolver#applyBeanValidatorAnnotations から始め、REST テストメソッドの Person ボディに対して生成された contract を調査します。既存の javax.validation の処理と Hibernate の @Length および @Range を比較し、その contract が対応する length および range の制約を公開していることを確認します。

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

評価

技術スタック
java
領域
api
issue の種類
機能追加
難易度
4/5
見積もり時間
3〜5日
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
38/100

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

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