OpenAPI 仕様およびツールの制限事項

short の数値 (short および java.lang.Short) は int32 にマップされ、正規の integer の数値として処理されます。

結果として、ルール・プロジェクトまたは意思決定サービスで short または java.lang.Short を使用する場合には、HTDS によって提供された OpenAPI 定義ファイルから生成されたクライアントまたはインターフェースでは、short の数値ではなく integer の数値を入力できます。 このため、short の最大値より大きい数値を入力すると、実行エラーで終了します。

認識されない型 (Unrecognized Type): [null]

この問題は、 OpenAPI 定義ファイルの生成に使用される swagger-core Java ライブラリーの動作が正しくないことが原因です。 password データ型の使用は避けてください。

次善策として、注釈のない (または、少なくとも password データ型のない) String フィールドを使用し、生成された OpenAPI 定義ファイルを変更して、対応するフィールドに "format": "password" を指定できます。 これは Swagger Editor で作業し (テスト・フォームはそれを考慮し、入力されたときに文字が非表示になります)、Swagger Codegen ツールではクライアントを適切に生成できます (フィールドは標準の String 型で表現されます)。

password データ型とは異なり、この binary データ型は、HTDS によって OpenAPI 定義ファイルが適切に生成されるのを阻害しません。

ただし、Swagger Codegen ツールを使用して Java クライアントを生成すると、注釈付きフィールドは byte[] フィールドとして表され、実行時にルール・セット実行エラーになります。

この特定のユースケースでは、Swagger Editor を使用すれば、このような問題は発生しません。

この特定のユース・ケースでは、Swagger Editor を使用するときにこのような問題は発生しません。これは、バイトがストリングとして表され、HTDS REST がそれらを受け入れて実際のバイトに変換するためです。

例えば、型 String[] のフィールドは List<String> になります。

byte が XOM フィールドまたはルール・セット・パラメーターとして使用されている場合、 swagger V3 core は byte を string 型および byte形式の swagger StringSchemaに変換します。 バイトの rang 制限事項 ([-128, 127]) は満たされなくなります。

使用される値が制限事項の範囲外であれば、結果は間違いとなるはずです。

char が XOM フィールドまたはルール・セット・パラメーターとして使用される場合、 swagger V3 core は char を string型の swagger StringSchemaに変換します。 char の長さは満たされなくなります。

ストリング値の長さが 1 より大きい型を使用すると、実行時にエラーが発生します。

short が XOM フィールドまたはルール・セット・パラメーターとして使用されている場合、 swagger V3 core は short を integer 型および int32形式の swagger IntegerSchemaに変換します。 int32 の rang は [-2147483648, 2147483647] であるので、short [-32768, 32767] の rang 制約事項は満たされなくなります。

使用される値が short rang の範囲外であれば、結果は間違いとなるはずです。