在Java中,$ref限制如下:
- $ref只能用于定義OpenAPI規范中的“definitions”或“parameters”部分,用來引用其他定義或參數。
- $ref中的值必須是一個字符串,并且必須以“#/”開頭,后面跟隨引用的路徑。
- 被引用的定義必須在同一個OpenAPI規范文件中或者是外部引用的文件中。
- $ref不能引用自身,即不能形成循環引用。
- $ref不能引用響應體的定義,只能引用請求參數的定義。
- $ref引用的路徑必須是正確的,否則會導致解析錯誤。
總的來說,$ref在Java中主要用于引用其他定義或參數,幫助簡化和重用OpenAPI規范中的結構和內容。